Installing/upgrading Viewpoint > Upgrading Viewpoint

1.4 Upgrading Viewpoint

If you are upgrading to Viewpoint 7.0.2 from an earlier version than 6.1, you must first upgrade to 6.1 (for instructions, see Upgrading from Viewpoint 2.0 to 6.1). To upgrade to Moab Viewpoint for Moab Cloud Suite 7.0.2 from 6.1, complete the instructions found in Before installing Viewpoint, then perform the following steps.

To upgrade from Viewpoint 6.1 to 7.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 and reporting.war files and clean the /moab and /viewpoint 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 and reporting.war to the Tomcat /webapps directory.

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

    > cp /tmp/viewpoint/dist/reporting.war /var/lib/tomcat6/webapps

    Reporting is an optional feature (see Specifying available reports). If you do not want to use the reporting feature, do not copy the reporting.war file as it runs as a service and increases the Viewpoint memory footprint.

  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 sqlserver database type:
    5. > vi /opt/viewpoint/setup.properties.[dbType]
    #dbType=mssql
    #dbHost=hostName
    #dbPort=1433
    #dbName=viewpoint
    #dbSchema=viewpoint
    #dbUser=viewpoint
    #dbPassword=myPassword
    #tempDir=/tmp
  5. Verify that the Tomcat user has read/write privileges to the Viewpoint home directory. For example, you could run the following:
    6. 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).

  6. Start the Tomcat service.
    7. > service tomcat6 start
  7. Back up the setup.properties file and delete it from the Viewpoint home directory.
  8. 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.
  9. Configure Viewpoint (see Configuring Viewpoint).

Viewpoint does not automatically update the navigation to include links to pages that are new to 7.0.2. 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.

Related topics 

 

© 2012 Adaptive Computing