(Click to open topic with navigation)

Installing Moab Viewpoint

Installing Moab Viewpoint

These instructions describe how to install and start Moab Viewpoint.

ClosedSystem requirements

Hardware requirements:

  • 16 GB disk space

Software requirements:

  • Moab Workload Manager version 7.2.9
  • Moab Web Services version 7.2.9
  • Oracle® Java® 6 Runtime Environment
  • Apache Tomcat™ 6.0.24 or greater
  • Open LDAP™ or Microsoft Active Directory®

Supported web browsers:

  • Mozilla Firefox 3.5 or later
  • Internet Explorer 7.0 or later

In order for Viewpoint to run correctly in Internet Explorer, you must navigate to Tools > Compatibility View Settings and deselect the Display intranet sites in Compatibility View option.

ClosedPrerequisites to installation
  • Make sure that you have installed Apache Tomcat™ 6. You should have already done this while installing Moab Web Services (see Installing Moab Web Services).
  • Make sure that you have installed Oracle® Java® 6 Runtime Environment. You should have already done this while installing Moab Web Services (see Installing Moab Web Services).
  • If you do not already have an instance of OpenLDAP or Active Directory, install OpenLDAP and set it up with users. For more information, see "Setting up OpenLDAP on CentOS 6" in the Viewpoint Management and User Guide.
  • (Optional, but highly recommended) Configure Viewpoint to trust the LDAP/Active Directory server certificate for a secure LDAP SSL connection. For more information, see "Securing a Viewpoint-LDAP/Active Directory connection" in the Viewpoint Management and User Guide.
  • If you want to enable users to submit jobs through the Viewpoint portal, make sure that the following configuration is set in the /opt/moab/etc/moab.cfg file:
    • ADMINCFG[1] ENABLEPROXY=TRUE
ALLOWROOTJOBS TRUE

To install Moab Viewpoint

  1. Download the latest Viewpoint build (viewpoint-<version>.tar.gz) from the Adaptive Computing website.
  2. Stop Tomcat.
    3. [root]# service tomcat6 stop
  3. Edit the Tomcat configuration file.

    4. Depending on your operating system and sysadmin preferences, you may find the Tomcat configuration file in different places. For example:

    CentOS™ 5 and 6: /etc/sysconfig/tomcat6

    Red Hat® Enterprise Linux 5 and 6: /etc/sysconfig/tomcat6

    SUSE® Linux Enterprise Server 11: /etc/tomcat6/tomcat6.conf

    Ubuntu® 10.04: /etc/default/tomcat6

    Using the example, /etc/tomcat6/tomcat6.conf:

    [root]# nano /etc/tomcat6/tomcat6.conf
    1. Update the JAVA_HOME line to point to the Java Runtime Environment you just installed. For example:
      2. JAVA_HOME=/usr/java/latest
    2. If your Moab Web Services and Viewpoint exist in the same Tomcat, you will want to set the MaxPermSize to allow more memory. Add (if it does not already exist) a line that sets JAVA_OPTS to the following:
      3. JAVA_OPTS="$JAVA_OPTS -Xms4096m -Xmx4096m -XX:MaxPermSize=512m"
  4. Create the Viewpoint home directory.
    5. [root]# mkdir /opt/viewpoint
[root]# chown -R tomcat:tomcat /opt/viewpoint
  5. Unpack the Viewpoint tarball and copy the moab.war file into the Tomcat webapps folder.
    6. [root]# tar -xzvf viewpoint-gatling-snapshot.tar.gz
[root]# cp viewpoint-7.2.9/moab.war /var/lib/tomcat6/webapps
[root]# chown -R tomcat:tomcat /var/lib/tomcat6

    It is recommended that you do not run more than one instance of Viewpoint within Tomcat.

  6. Start Tomcat.
    7. [root]# service tomcat6 start

    The default firewall settings on your system prevent other machines from accessing Viewpoint. You will need to configure your firewall to allow external connections. However, if you want to temporarily turn off your firewall to test that Viewpoint is running you can run:

    [root]# service iptables stop

    Make sure you turn your firewall back on again once it is configured to allow Viewpoint to be accessed externally.

  7. Verify that Viewpoint was correctly installed by directing your browser to the Viewpoint URL (for example: http://[hostname or ip address]:8080/moab), and logging in with the default super user username and password (moab-admin/changeme!).

    8. The super user has all Viewpoint permissions. This means that the super user has rights to access every page and perform every function within Viewpoint.

  8. Navigate to the Configuration page (Administration > Configuration), and do the following:
    1. Set the Moab Web Services connection. (For more information, see "Setting the MWS configuration" in the Viewpoint Management and User Guide.)
    2. Authenticate the LDAP connection by specifying the bind user password. (For more information, see "Setting the LDAP configuration" in the Viewpoint Management and User Guide.)
    3. Change the super user password. (For more information, see "Changing the super user password" in the Viewpoint Management and User Guide.)
    4. Edit the customer configuration. (For more information, see "Setting customer configuration" in the Viewpoint Management and User Guide.)
  9. Navigate to the Principal Management page (Administration > Principal Management), and create principals for LDAP users and user groups. Assign a role to the principals to enforce user permissions for the users contained in the principal. (For more information, see "About principal management" in the Viewpoint Management and User Guide.)

If you would like to enable reporting in Viewpoint, please contact Adaptive Computing Professional Services.

Related topics 

© 2014 Adaptive Computing