You are here: Manual Installation > Upgrading > Nitro Integration > Upgrading Nitro Web Services

2.26 Upgrading Nitro Web Services

This topic contains instructions on how to upgrade Nitro Web Services.

In this topic:

2.26.1 Upgrade to MongoDB 3.2.x

Beginning with version 2.1.0, Nitro Web Services requires MongoDB 3.2.x.

On the Nitro Web Services MongoDB host, do the following:

  1. Check your MongoDB server version.
    [root]# rpm -qa | grep mongo
  2. If the MongoDB server version is older than 3.2.x, then you will need to upgrade the databases. See 2.18 Upgrading to MongoDB 3.2.x for more information.

2.26.2 Back up the MongoDB Databases

This procedure is only applicable if you did not have to upgrade the MongoDB databases earlier in this topic. See 2.26.1 Upgrade to MongoDB 3.2.x for more information.

On the Nitro Web Services MongoDB serverhost, do the following:

  1. Stop all services that are using the MongoDB databases.
  2. Back up the MongoDB databases.
    [root]# cd /root
    [root]# mongodump -u admin_user -p secret1
  3. Restart the services.

2.26.3 Upgrade Nitro Web Services

On the Nitro Web Services Host, do the following:

  1. If you have not already done so, complete the steps to prepare the host. See 2.8 Preparing for Nitro Manual Installation for more information.
  2. Stop the services.
    [root]# systemctl stop nitro-web-services.service
    [root]# systemctl stop nitro-zmq-job-status-adapter.service
  3. Back up the contents of the /opt/nitro-web-services/etc directory (contains the nitro.cfg and the zmq_job_status_adapter.cfg files).

  4. Remove the /opt/nitro-web-services directory.

    [root]# rm -rf /opt/nitro-web-services
  5. Change the directory to the root of the unpacked Nitro tarball bundle.

    [root]# cd nitro-tarball-bundle-<version>-<OS>
  6. Create the /opt/nitro-web-services directory.

    [root]# mkdir -p /opt/nitro-web-services
  7. Identify the Nitro Web Services tarball (nitro-web-services-<version>-<OS>.tar.gz) and unpack the tarball into /opt/nitro-web-services.
    [root]# tar -xzvpf  nitro-web-services-<version>-<OS>.tar.gz -C /opt/nitro-web-services --strip-components=1
  8. Install Nitro Web Services. This step assumes the installation directory is /opt/nitro-web-services.

    [root]# cd /opt/nitro-web-services
    [root]# ./install.sh
  9. Merge any customizations from the nitro.cfg and the zmq_job_status_adapter.cfg files (and any other files) you backed up earlier in this procedure into the new files.

    See the steps in 2.10.3 Install and Configure Nitro Web Services for more information on the configuration files.

  10. Restart the services.
    [root]# systemctl restart nitro-web-services.service
    [root]# systemctl restart nitro-zmq-job-status-adapter.service

2.26.4 Grant Users Nitro Permissions in Viewpoint

Verify that the users who work with Nitro Web Services have the appropriate role in their Viewpoint user principal.

These are the Viewpoint roles for Nitro:

See Creating or Editing Principals in the Moab Viewpoint Reference Guide for instructions on setting up principals.

Related Topics 

© 2017 Adaptive Computing