Upgrading a CTERA Portal

Prev Next

CTERA strongly recommends upgrading the portal with the help of CTERA Support.

When you do not have access to the Internet, you need a zip file from CTERA support – tar xvf file – where file is the zip filename for an offline upgrade. The file contains the packages for the portal upgrade.

Make sure that the required ports are open, as described in Port Requirements.

Upgrading the Portal Offline

You have to shutdown all the portal servers before upgrading the portal.

To upgrade the CTERA Portal:

  1. Shutdown all 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
      When the server has 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.
    Note

    First upgrade and start the main database server. Next upgrade and restart all application and preview servers. Finally, upgrade and restart the replication database server.

    1. Using SSH, log in as root to the CTERA Portal server.
    2. Copy the upgrade zip file to the machine.
    3. Navigate to the location of the zip file and run the following command to extract the portal image file: tar xvf file where file is the zip filename. The file contains the packages for the portal.
    4. Navigate to the directory where the unzipped file is and run the following command: chmod +x upgrade.sh && ./upgrade.sh
    5. Restart the server by running the command portal-manage.sh start

Patch upgrades are relatively quick as only the packages that have changed are updated. An upgrade to the next major version takes more time.

Notes

You can also check that the upgrade has succeeded by running portal-manage.sh status which displays the image version and service, software, version.

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