1.1 Before installing Viewpoint

To complete prerequisites before installing/upgrading Moab Viewpoint for Moab HPC Suite 7.0.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.0.3
• Moab Web Services 7.0.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


You must add a memory-increasing configuration setting, like the following, to the other JAVA_OPTS settings in your Tomcat init script in order to avoid potential java.lang.OutOfMemoryError: PermGen space and java.lang.OutOfMemoryError: Java heap space issues.

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

You will need to set the MaxPermSize higher if Moab Web Services and Viewpoint exist in the same Tomcat or to support certain actions, such as running reports. If you receive a PermGen error while running Viewpoint, continue to gradually increase both the MaxPermSize and Xmx equally (the Xmx should always be at least as much as MaxPermSize).

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


Viewpoint supports an Oracle database without error; however, it must be configured manually using hibernate.cfg.xml (see Configuring Viewpoint to communicate with your DBMS), not the UI configurator.Viewpoint's database configuration page displays a false connection error, such as the following, when you use Oracle:

FAILURE - Error getting connection to jdbc url "jdbc:oracle://jdbc/moab@name-oracle:1111" for user "moab"

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. Download the Viewpoint tarball and untar it in the Viewpoint home directory.

> cd /opt/viewpoint > tar -xzvf /temporary/downloads/viewpoint-7.0.0.tgz

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

• moab.war
• licenses/
• sql/
  • mysql/, oracle/
    • drop_tables.sql
    • setup_hpc.sql
• templates/
  • setup.properties.mysql
  • setup.properties.oracle
5. 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

6. 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

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

Related topics 

• Installing/upgrading Viewpoint

© 2012 Adaptive Computing