Installing/upgrading Viewpoint > Doing a clean installation of Viewpoint

1.2 Doing a clean installation of Viewpoint

If you are installing Moab Viewpoint for Moab Cloud Suite for the first time, complete the instructions found in Before installing Viewpoint, then perform the following steps. If you have not already done so, create the Viewpoint database (see Creating the Viewpoint database).

To install Moab Viewpoint for Moab Cloud Suite for the first time

  1. Open the moab.cfg file located in the Moab home directory and verify that Moab 7.0 runs with a Viewpoint user configured as a level 1 administrator and that proxy is enabled.
  2. ADMINCFG[1] USERS=root,tomcat6

    ADMINCFG[1] ENABLEPROXY=TRUE

    For more information, see "ADMINCFG" in "Appendix F: Scheduler Parameters" in the Moab Workload Manager documentation.

    If Moab and Viewpoint are running on the same machine, that user needs to be named tomcat6 or be the Tomcat user on your system, as in the above addition to the moab.cfg file.

  3. Create the Viewpoint home directory /opt/viewpoint:
  4. mkdir /opt/viewpoint

    If you'd like to override the default configuration location of /opt/viewpoint, define the environment variable VIEWPOINT_HOME with a path such as /home/name/viewpoint

  5. Copy moab.war and reporting.war to the Tomcat /webapps directory.
  6. > 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.

  7. Copy the setup.properties.[dbType] file from /tmp/viewpoint/templates/ to the Viewpoint home directory and change its name to setup.properties, removing the .[dbType]. Modify it according to your database's type, host name, port, name, schema, admin username, and admin password. The included template is based on the sqlserver database type:
  8. > vi /opt/viewpoint/setup.properties.sqlserver
    #dbType=mssql
    #dbHost=hostName
    #dbPort=1433
    #dbName=viewpoint
    #dbSchema=viewpoint
    #dbUser=viewpoint
    #dbPassword=myPassword
  9. Verify that the Tomcat user has read/write privileges to the Viewpoint home directory. For example, you could run the following:
  10. 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).

  11. Start the Tomcat service.
  12. > service tomcat6 start
  13. Back up the setup.properties file and delete it from the Viewpoint home directory.
  14. Configure Viewpoint (see Configuring Viewpoint).

Related topics