(Click to open topic with navigation)

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

3.31 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.31.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.21 Preparing for RPM Upgrades for more information.
  2. Stop the Apache service.
    [root]# systemctl stop httpd.service
  3. Install the upgrade.
    • 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
      6. Install the new Viewpoint RPM.
        [root]# zypper install moab-viewpoint
    • If you are upgrading Viewpoint from 9.0.1 or 9.0.2, 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 Viewpoint RPM. 
        [root]# zypper install moab-viewpoint
    • If you are upgrading Viewpoint from 9.1.0 or later, do the following:

      Upgrade the Viewpoint RPM. 

      [root]# zypper install moab-viewpoint

  4. 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/
  5. 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_*

    • 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

      Viewpoint has a number of environment variables used to configure a Viewpoint installation and troubleshoot operating issues. See 5.4.1 General configuration issues for more information about Viewpoint environment variables.

  6. If you are upgrading from Viewpoint 9.0.0, 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

  7. 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
  8. Start the Apache service. 
    [root]# systemctl start httpd.service

3.31.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.31.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]# zypper install moab-viewpoint-filemanager
  2. Restart the File Manager Service. 
    [root]# systemctl restart acfileman.service

3.31.3 Update the Viewpoint License

3.31.4 Verify Base Roles are Present

As part of the Viewpoint upgrade, if you are upgrading from version 9.0.2 or prior, you will need to verify that the base roles are present.

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 MWS administrative user (moab-admin, by default).
  3. Click Configuration from the menu. The Basic Configuration page displays with additional options in the left pane. For example:

    Click to enlarge

  4. Click Roles from the left pane. The Role Management page displays.

    Click to enlarge

  5. If all the roles are there, continue with the procedure in 3.12.8 Grant Users Access to Viewpoint.

    However, if one of the base roles is not present, you will need to recreate (restore) the base roles.

  6. If you need to recreate the base roles, the Recreate Base Roles button displays on the Role Management page. For example:

    Click to enlarge

    • Click Recreate Base Roles. Viewpoint will restore the roles.

You can also modify the default roles and create new roles as needed. See About Roles in the Moab ViewpointReference Guide for more information.

© 2017 Adaptive Computing