Installing/upgrading Viewpoint > Upgrading Viewpoint

1.4 Upgrading Viewpoint

If you are upgrading to Viewpoint 7.1.3 from an earlier version than 6.1, you must first upgrade to 6.1. See Upgrading from Viewpoint 2.0 to 6.1 for instructions. To upgrade to Moab Viewpoint for Moab HPC Suite 7.1.3 from 6.1 or 7.0.0, complete the instructions found in Before installing Viewpoint, then perform the following steps.

To upgrade from Viewpoint to 7.1.0

  1. Back up the Viewpoint home directory, /webapp directories, and, if you have customized it, message.properties file. Also back up your database.

    2. > cp -r /opt/viewpoint /tmp/viewpoint

    > cp -r /var/lib/tomcat6/webapps/moab /tmp/viewpoint/
    > cp -r /tomcat/webapps/moab/WEB-INF/grails-app/i18n/message.properties

    > cp -r /var/lib/tomcat6/webapps/reporting/ /tmp/viewpoint/

  2. Remove the moab.war file (and, if applicable, reporting.war file) and the /moab and /reporting directories from the Tomcat directory. Remove all Viewpoint-related contents from both the Tomcat /work directories.

    3. > rm -rf /usr/share/tomcat6/work/Catalina/localhost/moab* /usr/share/tomcat6/work/Catalina/localhost/reporting* /var/lib/tomcat6/work/Catalina/localhost/moab* /var/lib/tomcat6/work/Catalina/localhost/reporting*

  3. Copy moab.war to the Tomcat /webapps directory. Do not run more than one instance of Viewpoint within Tomcat.

    4. > cp /tmp/viewpoint/moab.war /var/lib/tomcat6/webapps

  4. Move the setup.properties file to the Viewpoint home directory and, if it is not a backed up working copy, change its name to setup.properties, removing the .[dbType]. Modify it according to your database's type, host name, port, name, schema, admin username, admin password, and temporary directory. The included template is based on the mysql database type:

    5. > vi /opt/viewpoint/setup.properties.[dbType]

    #dbType=mysql

    #dbHost=hostName

    #dbPort=1433

    #dbName=viewpoint

    #dbSchema=viewpoint

    #dbUser=viewpoint

    #dbPassword=myPassword

    #tempDir=/tmp

  5. If you are installing Moab Accounting Manager, define the MAM URL in the ViewpointConfig.groovy file.

    6. mam.url="https://<hostname>/cgi-bin/mam/index.cgi?start=login"

  6. Verify that the Tomcat user has read/write privileges to the Viewpoint home directory. For example, you could run the following:

    7. chown -R tomcat6:tomcat6 /opt/viewpoint

    You must grant read privileges for this directory to the Tomcat user. If you do not know the Tomcat user (often tomcat or tomcat6), use the owner of the Tomcat home directory (usually /var/lib/tomcat6).

  7. Run the setup_hpc.sql script. This is located in the sql/[dbType] directory.
  8. Start the Tomcat service.

    9. > service tomcat6 start

    If you are running Fedora, you must navigate to $CATALINA_HOME/bin/ and run startup.sh as root:

    [root]> $CATALINA_HOME/bin/startup.sh

  9. Merge customizations from the backed-up message.properties file and the market.properties file from your backed-up Viewpoint home directory with the same files in your new Viewpoint directories. For information about customizing these files, see Customizing Viewpoint to specific markets or customers.
  10. Configure Viewpoint. To do so, see Configuring Viewpoint.

Viewpoint does not automatically update the navigation to include links to pages that are new to 7.1.3. To update your links, navigate to the webapps/moab/WEB-INF/install/ directory in your Tomcat home (usually var/lib/tomcat6/) open either cloud/ or hpc/, depending on your license. Open the core.xml file and copy any new links to the core.xml file in your Viewpoint home directory. See Creating links on the Viewpoint menu bar. You must also set the pages' associated permissions in order to view and use them. See Setting permissions for a list of all permissions and their related pages.

If you want reporting in Viewpoint, please contact Adaptive Computing Professional Services.

Related topics 

 

© 2012 Adaptive Computing