Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


Note
titleNote

The offline package also includes files that may not be required in your installation. Significantly less data will be transferred if the appliance has access to docker.panagenda.com, since only the files necessary for the upgrade will be downloaded.

...

Logs are available in the log directory, e.g. /opt/panagenda/logs/ia-upgrade_<year>-<month>-<day>_<timestamp>.log.



Troubleshooting


In case there is not enough space left on the root partition (~8GB free space are required), the installation will abort and one of the following error messages will be displayed among the last few output lines:

  • tar: images.tar: Wrote only xxx of xxx bytes
  • unexpected EOF
  • Error response from daemon: failed to create task for container


An alternative method is to place the installer file on a partition that has enough free space and set an environment variable to tell the installer to also use this partition for temporary files. The /opt/panagenda/appdata or /opt/panagenda/pgdata partitions should typically have enough disk space available to hold the temporary files during the upgrade process.


These are the recommended steps for the workaround using the pgdata partition:

  • Unzip the installer so you have the ifa-upgrade-offline.sh file
  • Remove the original installer zip file
  • Create a temporary directory on the pgdata partition:
    mkdir /opt/panagenda/pgdata/tmp
  • Move the installer to this new tmp directory:
    mv ./ifa-upgrade-offline.sh /opt/panagenda/pgdata/tmp/
  • Set an environment variable so the installer will use our new directory for temporary files during the upgrade process
    declare -x TMPDIR="/opt/panagenda/pgdata/tmp/"
  • Execute the update file:
    /opt/panagenda/pgdata/tmp/ifa-upgrade-offline.sh
  • After successful upgrade, please remove all files from the temporary directory:
    rm -Rf /opt/panagenda/pgdata/tmp/*



First Login After the Update

...