(Click to open topic with navigation)

You are here: RPM Installation > Upgrading > Upgrading Moab Viewpoint (RPM)

3.30 Upgrading Moab Viewpoint (RPM)

This topic provides instructions to upgrade Moab Viewpoint to the latest release version using the RPM upgrade method. It includes instructions for migrating your database schema to a new version if necessary.

Because many system-level files and directories are accessed during the installation, the instructions in this guide should be executed with root privileges.

You will see that the instructions execute commands as the root user. Please note that the same commands will work for a non-root user with the sudo command.

In this topic:

3.30.1 Upgrade the Viewpoint Server

On the Viewpoint Server Host, do the following:

  1. If you installed Viewpoint Server on its own host or if Viewpoint Server is the first component being upgraded on a host with other RPM installations, complete the steps to prepare the host. See 3.20 Preparing for RPM Upgrades for more information.
  2. Stop the Apache service.
    [root]# service httpd stop
  3. Remove your existing Viewpoint installation.
    • If you are upgrading from Viewpoint 9.0.0, do the following:

      Beginning with the 9.0.1 release, several variables became obsolete. In addition, the configuration files were renamed and/or moved.

      1. Remove these obsolete variables from /etc/httpd/conf.d/viewpoint.conf:

        • IRIS_LOGS_FILENAME
        • IRIS_LOGS_PATH
        • IRIS_SESSION_FILE_PATH
        • IRIS_TEMPLATE_DEBUG

        The IRIS_DEBUG variable must not be used in production; also remove this variable from /etc/httpd/conf.d/viewpoint.conf.

      2. Back up configuration files. 
        [root]# cp -p /opt/viewpoint/config/config.json /etc/httpd/conf.d/viewpoint.conf /tmp
      3. Back up certificates to connect to the file manager (if Viewpoint connects to file manager over SSL).
        [root]# cp -p /opt/viewpoint/webdav_client/client-cert.pem /opt/viewpoint/webdav_client/client-key.pem /opt/viewpoint/webdav_client/ca-cert.pem /tmp
      4. Uninstall Viewpoint and some packages that are no longer needed.
        [root]# rpm -e --nodeps moab-viewpoint
[root]# rpm -q --quiet python-importlib && rpm -e python-importlib
[root]# rpm -q --quiet mod_wsgi && rpm -e mod_wsgi
      5. Remove some leftover files.
        [root]# rm -rf /var/log/viewpoint /opt/viewpoint /etc/httpd/conf.d/viewpoint.conf /etc/cron.daily/viewpoint.sh
    • If you are upgrading Viewpoint from 9.0.1 or later, do the following:
      1. Back up configuration files. 
        [root]# cp -p /opt/viewpoint/lib/viewpoint/config/config.json /opt/viewpoint/etc/viewpoint.cfg /tmp
      2. Back up certificates to connect to the file manager (if Viewpoint connects to file manager over SSL).
        [root]# cp -p /opt/viewpoint/lib/viewpoint/webdav_client/client-cert.pem /opt/viewpoint/lib/viewpoint/webdav_client/client-key.pem /opt/viewpoint/lib/viewpoint/webdav_client/ca-cert.pem /tmp
      3. Uninstall Viewpoint.
        [root]# rpm -e --nodeps moab-viewpoint
  4. Install the new Viewpoint RPM.
    [root]# yum install moab-viewpoint

  5. If you are upgrading from Viewpoint 9.0.0, restore certificates to their new location:

    [root]# cp -p /tmp/client-cert.pem /tmp/client-key.pem /tmp/ca-cert.pem /opt/viewpoint/lib/viewpoint/webdav_client/
  6. Merge customizations into the new viewpoint.conf file.
    • If you are upgrading Viewpoint from 9.0.0, merge the customizations in the old /etc/httpd/conf.d/viewpoint.conf into the /opt/viewpoint/etc/viewpoint.cfg.

      All IRIS_DATABASE* SetEnv entries in /etc/httpd/conf.d/viewpoint.conf are obsolete. Database environment variables are now stored in /opt/viewpoint/etc/viewpoint.cfg. Therefore, move all your uncommented database SetEnv entries into the environment section of /opt/viewpoint/etc/viewpoint.cfg; and edit as needed to reflect the 9.0.2 renaming (see the warning later in this step for more information).

    • If you are upgrading Viewpoint from 9.0.1, merge customizations into the /opt/viewpoint/etc/viewpoint.cfg and edit as needed to reflect the 9.0.2 naming.

      Beginning with version 9.0.2, all IRIS_* variables were renamed to VIEWPOINT_*

  7. After you are finished, your /opt/viewpoint/etc/viewpoint.cfg will look something like this:

    [admin]
username = viewpoint-admin
password = pbkdf2_sha256$20000$ZHeToCJgrSUH$+xmzYdhpqZCJokxO9eGzyr2B6jrfCgLlBT+pBgMis4w=

[environment]
VIEWPOINT_DATABASE_HOST = localhost
VIEWPOINT_DATABASE_PORT = 5432
VIEWPOINT_DATABASE_NAME = moab_viewpoint
VIEWPOINT_DATABASE_USER = moab_viewpoint
VIEWPOINT_DATABASE_PASSWORD = changeme!

[settings]
past_hours = 24
future_hours = 4
  8. Change the admin password in /opt/viewpoint/etc/viewpoint.cfg.

    For security purposes, the admin password is encrypted. In the example above, the default is the encrypted equivalent to "changeme!", which is the default for the Viewpoint instance. Change this default password to a different encrypted password. To encrypt the password, do the following (substituting "changeme!" with your password):

    [root]# echo -n 'changeme!' | /opt/viewpoint/bin/viewpoint makehash
Using default hasher
pbkdf2_sha256$20000$ZHeToCJgrSUH$+xmzYdhpqZCJokxO9eGzyr2B6jrfCgLlBT+pBgMis4w=

    The default hashing algorithm is pbkdf2_sha256. To show the other available algorithms, run /opt/viewpoint/bin/viewpoint makehash --help

  9. Initialize Viewpoint's PostgreSQL database.

    • If you are upgrading from Viewpoint 9.0.0, do the following:

      [root]# /opt/viewpoint/bin/viewpoint migrate --fake-initial

    • If you are upgrading from Viewpoint 9.0.1 or later, do the following:

      [root]# /opt/viewpoint/bin/viewpoint migrate
  10. Start the Apache service. 
    [root]# service httpd start

3.30.1.A Update the Permissions List

Once you have updated the Viewpoint Server, you will need to update the MWS configuration in the Viewpoint Portal to sync the permissions list.

Do the following:

  1. Using a web browser, navigate to your Viewpoint instance. (http://<viewpoint_host>:8081; where <viewpoint_host> is the IP address or name of the Viewpoint Server Host).
  2. Log in as the Viewpoint administrative user (viewpoint-admin, by default). The Configuration page displays with the Basic Configuration page selected.
  3. In the MWS Configuration area, click SAVE.

3.30.2 Upgrade the Viewpoint File Manager Service

On the Moab Server Host where the Viewpoint File Manager Service resides, do the following:

  1. Install the moab-viewpoint-filemanager package. 
    [root]# yum install moab-viewpoint-filemanager
[root]# yum install python-setuptools
  2. Restart the File Manager Service. 
    [root]# service acfileman restart

3.30.3 Update the Viewpoint License

© 2016 Adaptive Computing