CTERA Portal Installations > OpenStack > Upgrading CTERA Portal > Upgrading the Portal Image Via CLI
Upgrading the Portal Image Via CLI
When using CLI to upgrade the portal, you have to stop all the portal servers before upgrading the image.
Note: Customers without Internet access and upgrading the Portal image from version 6.0.x, require manually installing packages for syslog functionality for offline servers:
i Upgrade the portal image with the latest image file, as described in Automating the Portal Image and Software Upgrade Using Ansible, but do not run the setup wizard.
ii Copy the archive file, exported_images.tar.gz, to a local folder on the portal machine.
Note: The file is available for download from CTERA support.
iii Run the following CLI command on all servers (including main, Replica, DB, and Preview servers): portal-syslog-client load_images images_archive_path
where images_archive_path is the path to the local folder where you copied the archive file.
iv Run the setup wizard.
If the setup wizard was run prior to loading the new packages, you must rerun the CLI portal-syslog-client load_images images_archive_path and then restart all servers.
If you do not run the CLI command, the syslog functionality will not work and an error message is generated. However, if you do not run the CLI command, apart from the error message, there is no impact on portals where syslog functionality is not used.
To upgrade the CTERA Portal image:
1 Stop the portal servers.
First stop all application and preview servers. Next stop the main database server and finally stop the replication database server, if available.
a Using SSH, log in as root to the CTERA Portal server.
b Run the following command: portal-manage.sh stop
Once services are stopped, the Done message is displayed on the screen.
2 When all servers are in a stop state, upgrade the portal image.
a Using SSH, log in as root to the CTERA Portal server.
b Copy the upgrade installer into the machine.
c Navigate to the location of the installer and run the following command: tar xvf portal-installer-linux-7.0.xxx.tar.bz2
d Navigate to the cd portal-installer-linux-7.0.xxx subdirectory and run the following command: ./install.sh –u
3 Restart the servers.
First start the main database server. Next start the replication database server, if available. Finally start the application and preview servers.
a Using SSH, log in as root to the CTERA Portal server.
b Start the CTERA Portal: portal-manage.sh start
When the image kernel was also upgraded, an additional restart is also required to complete the kernel upgrade.
i Stop the portal: portal-manage.sh stop
ii Start the portal: portal-manage.sh start
Note: The additional stop and start commands above are mandatory in order to complete the kernel upgrade.