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 HPC 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 HPC 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 to the Tomcat /webapps directory.
  6. > cp /tmp/viewpoint/moab.war /var/lib/tomcat6/webapps

  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 MySQL database type:
  8. > vi /opt/viewpoint/setup.properties.sqlserver
    #dbType=mysql
    #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. Run the setup_hpc.sql script. This is located in the sql/[dbType] directory.
  12. Start the Tomcat service.
  13. > service tomcat6 start
  14. Back up the setup.properties file and delete it from the Viewpoint home directory.
  15. Configure Viewpoint (see Configuring Viewpoint).

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

Related topics