2.10 Upgrading Nitro Web Services

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

In this topic:

• 2.10.1 Upgrade to MongoDB 3.2.x, if you are upgrading Nitro Web Services from a version prior to 2.1.0
• 2.10.2 Back up the MongoDB Databases, if you are upgrading Nitro Web Services from version 2.1.0 or later
• 2.10.3 Upgrade Nitro Web Services
• 2.10.4 Grant Users Nitro Permissions in Viewpoint

2.10.1 Upgrade to MongoDB 3.2.x

Beginning with version 9.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.11 Upgrading to MongoDB 3.2.x for more information.

2.10.2 Back up the MongoDB Databases

On the Nitro Web Services MongoDB host, 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.10.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.4 Preparing for Manual Installation or Upgrade.
2. If you are upgrading Nitro Web Services from a version prior to 2.1.0, confirm the MongoDB database is upgraded to 3.2.x. See 2.11 Upgrading to MongoDB 3.2.x for more information.
3. If you are upgrading Nitro Web Services from version 2.1.0 or later, do the following on the Nitro Web Services MongoDB host.
   1. Stop all services on the host.
   2. Back up the Nitro Web Service MongoDB database.

      [root]# cd /root
      [root]# mongodump -u admin_user -p secret1

   3. Restart the services.
4. Stop the services.

   • Red Hat 6-based systems

     [root]# service nitro-web-services stop
     [root]# service nitro-zmq-job-status-adapter stop

   • Red Hat 7-based or SUSE 12-based systems

     [root]# systemctl stop nitro-web-services.service
     [root]# systemctl stop nitro-zmq-job-status-adapter.service

5. Back up the contents of the /opt/nitro-web-services/etc directory (at least the nitro.cfg and the zmq_job_status_adapter.cfg files).

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

   [root]# rm -rf /opt/nitro-web-services

7. Change the directory to the root of the unpacked Nitro tarball bundle.

   [root]# cd nitro-tarball-bundle-<version>-<OS>

8. Identify and unpack the Nitro Web Services tarball (nitro-web-services-<version>.<OS>.tar.gz).

   [root]# tar xzvpf nitro-web-services-<version>.<OS>.tar.gz

9. Install Nitro Web Services.

   [root]# cd ./nitro-web-services-<version>.<OS>
   [root]# ./install <directory>
   # <directory> is where you want to install Nitro Web Services (defaults to /opt)

10. 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.7.3 Install and Configure Nitro Web Services for more information on the configuration files.

11. Start the services.

    • Red Hat 6-based systems

      [root]# service nitro-web-services start
      [root]# service nitro-zmq-job-status-adapter start

    • Red Hat 7-based or SUSE 12-based systems

      [root]# systemctl start nitro-web-services.service
      [root]# systemctl start nitro-zmq-job-status-adapter.service

2.10.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:

• NitroAdmin – Administrative user, with permission to create Nitro application templates and manage other user's Nitro jobs.
• NitroUser – Basic user, with permission to create and manage their own Nitro jobs.

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

© 2017 Adaptive Computing