Upgrading a CTERA Portal
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Upgrading a CTERA Portal

  • Dark
    Light
  • PDF

Article Summary

The procedure to upgrade an existing CTERA Portal installation is dependent on whether the upgrade involves upgrading the portal software or both the portal image and the software.

As a general rule, new releases include both image and software upgrades and CTERA strongly recommends that you upgrade both. The release notes for each release specifies whether a portal image upgrade is required in addition to a portal software upgrade.

When a performing a portal upgrade that includes upgrading the portal image the image must be upgraded before the software.

Warning

When upgradiing from CTERA Portal 7.2.x, you must upgrade the portal image to the latest portal image before upgrading the portal software. After upgrading the portal image, you must reboot every server in the CTERA Portal environment.

Attempting to upgrade the software from version 7.2.x without first upgrading the portal image, fails with an error message.

You upgrade the image via CLI, Upgrading the Portal Image, and the software either from within the portal user interface or via CLI, Upgrading the Portal Software (Via the UI or CLI).

CTERA recommends upgrading software and a new image with the help of CTERA Support.

Upgrading the Portal Image

You have to stop all the portal servers before upgrading the image. The downtime is approximately one hour for each server upgrade. Application servers can be upgraded in parallel to reduce the total downtime.

The upgrade file is archived in a file named portal-installer-linux-x.x.x.tar.bz2, where x.x.x is the version number. This archive file requires approximately 10GB disk space.

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.
    1. Using SSH, log in as root to each CTERA Portal server.
    2. Run the following command: portal-manage.sh stop
      Once serers are stopped, the Done message is displayed on the screen.
  2. When all servers are in a stop state, upgrade the portal image on each server.
    First upgrade and start the main database server. When this server is up and running upgrade and start an application server and verify that the portal is running without problems. Next upgrade and restart all application and preview servers. Finally, upgrade and restart the replication database server.
    You restart each server using the command portal-manage.sh start
    1. Using SSH, log in as root to the CTERA Portal server.
    2. Copy the upgrade installer to the machine.
    3. Navigate to the location of the installer and run the following command to extract the portal image file: tar xvf portal-installer-linux-x.x.x.tar.bz2 where x.x.x is the version number.
    4. Navigate to the portal-installer-linux-x.x.x subdirectory, where x.x.x is the version number, and run the following command: ./install.sh –u
Note

When the release notes specify that the image upgrade also involves a kernel upgrade, an additional restart is also required to complete the kernel upgrade, after restarting each server.

  1. Stop the portal: portal-manage.sh stop
  2. Start the portal: portal-manage.sh start

Upgrading the Portal Software (Via the UI or CLI)

You can upgrade the portal software in the CTERA Portal user interface, or via the command line. Upgrading the portal software takes a few minutes.

To upgrade the CTERA Portal software via the portal user interface:

Warning

It is strongly recommended to contact CTERA Support before using the UI to upgrade the portal software.

  1. In the global administration view, select Main > Servers in the navigation pane.
    The SERVERS page is displayed, listing all the servers for the CTERA Portal.
    image.png
  2. Click Install new version.
    The Update Software window is displayed.
    image.png
  3. Upload the CTERA Portal version provided by CTERA.
    All servers in the CTERA Portal installation are upgraded.

To upgrade the CTERA Portal software via CLI:

  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.
    1. Using SSH, log in as root to the CTERA Portal server.
    2. 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 primary database portal software.
    1. Using SSH, log in as root to the CTERA Portal server.
    2. Upgrade the portal software: portal-manage.sh upgrade upgrade_file
      where upgrade_file is the software file provided by CTERA.
  3. Restart the primary database server: portal-manage.sh start
  4. After the primary database server is running, using SSH, log in as root to the other CTERA Portal servers.
    1. Upgrade the portal software on each CTERA Portal server: portal-manage.sh upgrade upgrade_file
      where upgrade_file is the software file provided by CTERA.
    2. Restart the CTERA Portal servers.
      First start the replication database server, if available. Next, start the application and preview servers.
      1. Using SSH, log in as root to the CTERA Portal server.
      2. Start the CTERA Portal: portal-manage.sh start

Was this article helpful?