You are here

How to migrate reporting data while upgrading

OLD: Affects version(s): 
4.1
4.2

Usually reporting data is migrated by choosing "Keep configuration" during the upgrade process. In some special cases the reporting data reaches a size bigger than the available memory or hard disk partition size used for storing this data during the update. Since the installation routine does not check the size, the installation could fail, leaving an invalid system.

If the reporting data is no longer required, just delete it with the following command before starting the Airlock installation:
# rm -r /data/report/*
When planning to migrate all the reporting data, do the following before the upgrade installation:

  • Make sure that the Airlock configuration has already been saved.
  • Create a backup of the reporting data by following those steps on the Airlock console or SSH as user root:
    # cd /data
    # tar cf /var/tmp/report.tar report
  • Check the size of the system hard disk and find the value in the following Reference Table.

    | Hard Disk size in GB     | max. report.tar size in MB  |
    | 4 to 72                  | 400                         |
    | 80 to 100                | 900                         |
    | 120 to 150               | 1400                        |
    | 200 an more              | 2400                        |
  • If the file size of report.tar is smaller than the corresponding value of the Reference Table suitable for your system, you may start the installation with the option "Keep configuration". The reporting data will automatically be migrated to the new Airlock installation.
  • If the file size of report.tar is bigger than the corresponding value of the Reference Table suitable for your system, follow these steps:
    • Clean up the report directory.
      # rm -r report/*
    • Download the /var/tmp/report.tar by using SCP, e.g. WinSCP.
    • Now start the installation with the option "Keep configuration".
    • After the installation, import the saved report.tar file to the newly installed Airlock 4.2.x, e.g. to /var/tmp by using SCP
    • Unpack the reporting data
      # cd /data
      # tar xf /var/tmp/report.tar
    • Fix the wrong css paths in migrated files
      # find /data/report -name *.html | xargs perl -pi -e 's:"\.\./\.\./css/report\.css":"../../../css/report.css":g'
    •  Set correct permissions# chmod -R 050 /data/report
      # chown -Rh wwwca_in:wwwca /data/report
    • Remove the report.tar file from Airlock# rm /var/tmp/report.tar
Knowledge Base Categories: