1.1 Before installing Viewpoint

To complete prerequisites before installing/upgrading Moab Viewpoint for Moab HPC Suite 7.1.3

1. Verify that you have at least 16 GB of free disk space.
2. Use only components from the following list for the best experience:
• Moab Workload Manager 7.1.3
• Moab Web Services 7.1.3
• Oracle Java SE 6.0


Viewpoint requires the Java Runtime Environment from Sun/Oracle version 6.0 or later (running java -version should return a version number of 1.6.0.). Other implementations of the Java Runtime Environment, such as OpenJDK or GIJ, will not run on Viewpoint as expected.

• Apache Tomcat 6.0


Set the MaxPermSize higher if Moab Web Services and Viewpoint exist in the same Tomcat or to support actions such as running reports. To do so, locate the following line in the /etc/tomcat6/tomcat6.conf. If it is not already present, add it.

JAVA_OPTS="$CATALINA_OPTS -Xmx2g -XX:MaxPermSize=2g"

Change each instance of 2g to 4g.

JAVA_OPTS="$CATALINA_OPTS -Xmx4g -XX:MaxPermSize=4g"

If you receive a PermGen error while running Viewpoint, gradually increase both the MaxPermSize and Xmx equally (the Xmx should always be at least as much as MaxPermSize).

Also, update the JAVA_HOME line to point to the Java Runtime Environment you just installed. For example:

JAVA_HOME=/usr/java/jre1.6.0_35

• Database
• MySQL 5.1 +
• Oracle 10g Express or Enterprise 10.2 +


MySQL and Oracle are currently the only supported databases for Viewpoint. However, the use of other databases with Viewpoint is possible. Please contact Adaptive Computing Support for more information.

To create the Viewpoint database, see Creating the Viewpoint database.



User, database, and schema created should all be named 'viewpoint'.



When you run commands and scripts in the database, you must do so in context. For instance, if you are running a script on a MySQL database, you would include 'viewpoint' before the path, as in the following example:

> mysql -u root -p viewpoint < /your/path/script.sql

For MySQL, the database/catalog name is viewpoint.

• Web Browser
• Mozilla Firefox 3.0-4.0
• Internet Explorer 7-8
3. Stop Tomcat.

> sudo service tomcat6 stop



If you are running other applications in Tomcat, you may need to perform this step later in the process.

4. Create the Viewpoint home directory.

[root]# mkdir /opt/viewpoint

5. Download the Viewpoint tarball and untar it in the Viewpoint home directory, /opt/viewpoint.

> tar -xzvf /tmp/downloads/viewpoint-7.1.3.tgz -C /opt/

> mv /opt/viewpoint-7.1.3 /opt/viewpoint



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

The tarball is extracted into a new directory called viewpoint-7.1.3/. It contains the following directories and files that are important to Viewpoint 7.1.3 installation:

• moab.war
• licenses/
• sql/
  • mysql/, oracle/
    • drop_tables.sql
    • setup_hpc.sql
• templates/
  • setup.properties.mysql
  • setup.properties.oracle
6. Set up the database by running the setup_hpc.sql script. Remember to run it in context.

> mysql -u root -p viewpoint < /tmp/viewpoint/sql/[dbType]/setup_hpc.sql

7. Download the JDBC driver for your database and place it in Tomcat's lib directory. For example, if you are using MySQL, download the MySQL JDBC connector library, untar it, and copy the mysql-connector-java-x.x.x-bin.jar file to Tomcat's /lib directory (normally $CATALINA_HOME/lib).

> cp mysql-connector-java-5.1.6-bin.jar /usr/share/tomcat6/lib

8. If you are installing Viewpoint for the first time, see Doing a clean installation of Viewpoint.
9. If you are reinstalling Viewpoint, including retrying an upgrade, see Reinstalling Viewpoint.
10. If you are upgrading Viewpoint to 7.1.3, see Upgrading Viewpoint.
11. Configure Viewpoint. See Configuring Viewpoint.

Related topics 

• Installing/upgrading Viewpoint

© 2012 Adaptive Computing