3.21 Upgrading Moab Web Services (RPM)

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

3.21.1 Upgrade Steps

Do the following:

1. Confirm the Moab Server RPM upgrade has completed on the host on which MWS Server is also installed. See 3.19 Upgrading Moab Workload Manager (RPM).
2. Upgrade your MongoDB database version to 2.4.x (recommended). See 2.20.1.C Upgrade the MongoDB.
3. Upgrade to Java 8 (recommended). See 3.21.1.A Upgrade to Java 8
4. Upgrade MWS Server. See 3.21.1.B Upgrade MWS Server.

3.21.1.A Upgrade to Java 8

If you wish to upgrade to Java 8, refer to the 2.5.2.A Install Java instructions.

3.21.1.B Upgrade MWS Server

On the MWS Server Host, do the following:

1. Stop Tomcat.
   • If your prior MWS Server version used Tomcat 6, disable the tomcat 6 service.

     [root]# service tomcat6 stop
     [root]# chkconfig tomcat6 off

     

     Tomcat 6 is not supported for MWS 9.0 and after. The MWS RPM will automatically install Tomcat 7.

   • If your prior MWS Server version used Tomcat 7, stop the tomcat 7 service.

     [root]# service tomcat stop

2. Back up the MWS home directory.

   [root]# cp -r /opt/mws /opt/mws-8.1-backup

3. Install the upgrade.

   [root]# yum update moab-web-services*

4. Upgrade the schema of the mws database in MongoDB.
   

   You must perform this step, regardless of whether you upgraded MongoDB to version 2.4.x.

   Run the database migration script provided with MWS. (It is safe to run this script more than once. If for any reason, errors occur during the execution of the script, run it again.)

   [root]# mongo -u mws_user mws /opt/mws/utils/db-migrate.js -p

   

   You may be prompted for the mongo password. The password can be found in the /opt/mws/etc/mws-config.groovy file under the "grails.mongo.password" key.

   

   The script might take several minutes to execute.

5. Merge the changes in the /tmp/mws-install/mws-9.0.2/mws-config.groovy file into your existing /opt/mws/etc/mws-config.groovy.

   1. Depending on your current MWS version, do the following as needed:

      • If Insight is part of your configuration:
        • add the health check information for the Insight Server (insight.server, insight.command.port, insight.command.timeout.seconds); prior to version 9.0.2.
          

          insight.server must be changed to the DNS name for the host on which the Insight Server is running; "localhost" is not valid.

        • add the Insight configuration information (dataSource_insight.username, dataSource_insight.password, dataSource_insight.url); prior to version 9.0.
          

          dataSource_insight.url is "jdbc:postgresql://<insight database host>:5432/moab_insight"; where <insight database host> is the IP address or name of the host on which the Insight PostgreSQL Database Server is running.

      • If Viewpoint is part of your configuration, register Viewpoint as client; prior to version 9.0
      • Change the moab.messageQueue.port to 5570; prior to version 8.0
      • Configure and appender for the audit log; prior to version 8.0
      • Change the layout to "new com.ace.mws.logging.ACPatternLayout()" for the output format of each log entry; prior to version 8.0
      • Remove the mws.suite parameter and the mam.* parameters (they have been moved to /opt/mws/etc/mws.d/); prior to version 8.0
   2. Confirm the value for moab.messageQueue.secretKey matches the value located in /opt/moab/etc/moab-private.cfg; if you have not yet configured a secret key, see Secure communication using secret keys.
   The following is an example of the merged /opt/mws/etc/mws-config.groovy file for MWS 9.0.2:

   // Any settings in this file may be overridden by any
   // file in the mws.d directory.
   
   // Change these to be whatever you like.
   auth.defaultUser.username = "moab-admin"
   auth.defaultUser.password = "changeme!"
   
   // Moab Workload Manager configuration.
   moab.secretKey = "<ENTER-KEY-HERE>"
   moab.server = "localhost"
   moab.port = 42559
   moab.messageDigestAlgorithm = "SHA-1"
   
   // MongoDB configuration.
   // grails.mongo.username = "mws_user"
   // grails.mongo.password = "<ENTER-KEY-HERE>"
   
   // Insight configuration.
   // dataSource_insight.username = "mws"
   // dataSource_insight.password = "changeme!"
   // dataSource_insight.url = "jdbc:postgresql://127.0.0.1:5432/moab_insight"
   // insight.server = "localhost"
   // insight.command.port = 5568
   // insight.command.timeout.seconds = 5
   
   // Message bus configuration.
   moab.messageQueue.port = 5570
   // moab.messageQueue.secretKey = "<ENTER-KEY-HERE>"
   mws.messageQueue.address = "*"
   mws.messageQueue.port = 5564
   
   // Sample OAuth Configuration
   grails.plugin.springsecurity.oauthProvider.clients = [
          [
                  clientId            : "viewpoint",
                  clientSecret        : "<ENTER-CLIENTSECRET-HERE>",
                  authorizedGrantTypes: ["password"]
          ]
   ]
   
   // Sample LDAP Configurations
   
   // Sample OpenLDAP Configuration
   //ldap.server = "192.168.0.5"
   //ldap.port = 389
   //ldap.baseDNs = ["dc=acme,dc=com"]
   //ldap.bindUser = "cn=Manager,dc=acme,dc=com"
   //ldap.password = "*****"
   //ldap.directory.type = "OpenLDAP Using InetOrgPerson Schema"
   
   // Sample Active Directory Configuration
   //ldap.server = "192.168.0.5"
   //ldap.port = 389
   //ldap.baseDNs = ["CN=Users,DC=acme,DC=com","OU=Europe,DC=acme,DC=com"]
   //ldap.bindUser = "cn=Administrator,cn=Users,DC=acme,DC=com"
   //ldap.password = "*****"
   //ldap.directory.type = "Microsoft Active Directory"
   
   log4j = {
      // Configure an appender for the events log.
      def eventAppender = new org.apache.log4j.rolling.RollingFileAppender(
              name: 'events', layout: pattern(conversionPattern: "%m%n"))
      def rollingPolicy = new org.apache.log4j.rolling.TimeBasedRollingPolicy(
              fileNamePattern: '/opt/mws/log/events.%d{yyyy-MM-dd}',
              activeFileName: '/opt/mws/log/events.log')
      rollingPolicy.activateOptions()
      eventAppender.setRollingPolicy(rollingPolicy)
   
      // Configure an appender for the audit log.
      def auditAppender = new org.apache.log4j.rolling.RollingFileAppender(
              name: 'audit',
              layout: new com.ace.mws.logging.ACPatternLayout("%j\t\t\t%c{1}\t\t\t%m%n"))
      def auditRollingPolicy = new org.apache.log4j.rolling.TimeBasedRollingPolicy(
              fileNamePattern: '/opt/mws/log/audit.%d{yyyy-MM-dd}',
              activeFileName: '/opt/mws/log/audit.log')
      auditRollingPolicy.activateOptions()
      auditAppender.setRollingPolicy(auditRollingPolicy)
   
      appenders {
          rollingFile name: 'stacktrace',
                  file: '/opt/mws/log/stacktrace.log',
                  maxFileSize: '100MB'
          rollingFile name: 'rootLog',
                  file: '/opt/mws/log/mws.log',
                  maxFileSize: '100MB', //The maximum file size for a single log file
                  maxBackupIndex: 10, //Retain only the 10 most recent log files, delete older logs to save space
                  layout: new com.ace.mws.logging.ACPatternLayout(), //Configures the output format of each log entry
                  threshold: org.apache.log4j.Level.ERROR //Ignore any logging entries less verbose than this threshold
          rollingFile name: 'jdbc',
                  file: '/opt/mws/log/jdbc.log',
                  maxFileSize: '100MB',
                  maxBackupIndex: 10,
                  layout: new com.ace.mws.logging.ACPatternLayout()
   
          appender eventAppender
          appender auditAppender
      }
   
      // NOTE: This definition is a catch-all for any logger not defined below
      root {
          error 'rootLog'
      }
   							
      // Individual logger configurations
      debug 'com.ace.mws',
              'grails.app.conf.BootStrap',
              'grails.app.controllers.com.ace.mws',
              'grails.app.domain.com.ace.mws',
              'grails.app.filters.com.ace.mws',
              'grails.app.services.com.ace.mws',
              'grails.app.tagLib.com.ace.mws',
              'grails.app.jobs.com.ace.mws',
              'grails.app.gapiParser',
              'grails.app.gapiRequest',
              'grails.app.gapiSerializer',
              'grails.app.translator',
              'plugins'    // MWS plugins
   
          info 'com.ace.mws.gapi.Connection',
              'com.ace.mws.gapi.parsers',
              'grails.app.service.grails.plugins.reloadconfig',
              'com.ace.mws.gapi.serializers'
   
          off 'org.codehaus.groovy.grails.web.errors'
   
          warn additivity: false, jdbc: 'org.apache.tomcat.jdbc'
   
          // Logs event information to the events log, not the rootLog
          trace additivity: false, events: 'com.ace.mws.events.EventFlatFileWriter'
   
          // Logs audit information to the audit log, not the rootLog
          trace additivity: false, audit: 'mws.audit'
   }

6. Merge any changes supplied in the new mws-config-hpc.groovy file in to your installed /opt/mws/etc/mws.d/mws-config-hpc.groovy.
7. Remove unused MWS plugins. Unused plugins must be removed as their presence will prevent MWS from starting up.
   • Remove all plugins from /opt/mws/plugins except for the diagnostics, native, and power-management plugins.

     [root]# cd /opt/mws/plugins
     [root]# rm plugins-reports.jar plugins-storage.jar plugins-vcenter.jar

8. Verify the Tomcat user has read access to the /opt/mws/etc/mws-config.groovy and /opt/mws/etc/mws.d/mws-config-hpc.groovy file.
9. Verify the following lines are added to the end of /etc/tomcat/tomcat.conf.

   CATALINA_OPTS="-DMWS_HOME=/opt/mws -Xms256m -Xmx3g -Dfile.encoding=UTF8"
   JAVA_HOME="/usr/java/latest"

10. Start Tomcat.

    [root]# service tomcat start

© 2016 Adaptive Computing