(Click to open topic with navigation)

6.52 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:

6.52.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 6.31 Preparing the Host – Typical Method or 6.30 Preparing the Host – Offline Method.
  2. Stop the Apache service.
    [root]# service httpd stop
    [root]# systemctl stop httpd.service
    [root]# systemctl stop httpd.service
  3. 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. Remove your existing Viewpoint installation 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
  4. 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. Remove your existing Viewpoint installation.
      [root]# rpm -e --nodeps moab-viewpoint
  5. Install the new Viewpoint RPM.
    [root]# yum install moab-viewpoint
    [root]# zypper install moab-viewpoint

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

  8. 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

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

  9. 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

    bcrypt_sha256 and bcrypt are not supported on Red Hat 7-based systems.

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

6.52.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.

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

6.52.3 Update the Viewpoint License

6.52.4 Verify Base Roles are Present

Viewpoint comes configured with several default (base) roles. See Differences in version 9.0 of the Moab HPC Suite Release Notes for more information.

As part of the Viewpoint upgrade, you will need to verify that the base roles are present.

Do the following:

  1. Assuming that you are still logged in as the Viewpoint administrator, do the following:
    1. Sign out.
    2. Log in as the MWS administrative user (moab-admin, by default).
  2. Click Configuration from the menu. The Basic Configuration page displays with additional options in the left pane. For example:

    Click to enlarge

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

    Click to enlarge

  4. If all the roles shown above are present, continue with the procedure in 6.52 Upgrading Moab Viewpoint (RPM).

    However, if any of the roles displayed on the Role Management page shown above are not present, you will need to recreate (restore) the base roles.

  5. 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.

© 2017 Adaptive Computing