(Click to open topic with navigation)

Installation > Installing Moab Viewpoint

Installing Moab Viewpoint

These instructions describe how to install and start Moab Viewpoint.

System requirements

Hardware requirements:

  • 16 GB disk space

Software requirements:

  • Moab Workload Manager version 7.5.0
  • Moab Web Services version 7.5.0
  • Oracle® Java® 7 Runtime Environment (Oracle® Java® 6 is also supported)
  • Apache Tomcat™ 6
  • Open LDAP™ or Microsoft Active Directory®

Supported web browsers:

  • Mozilla Firefox 20-25
  • Internet Explorer 8-10

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.

Prerequisites 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® 7 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 build a custom RPM

  1. Install rpm-build.
    2. [root]# yum install rpm-build
  2. Download the latest Viewpoint build (viewpoint-<version>.tar.gz) from the Adaptive Computing website.

    3. The variable marked <version> is the desired version of the suite; for example, 7.5.0.

  3. Untar the downloaded package.
  4. Change directories into the untarred directory.
  5. Edit the ./viewpoint.spec file for RPM customization.
  6. Run ./rpm-build.
  7. Locate the custom RPM in rpm/RPMS/x86_64.

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-7.5.0.tar.gz
[root]# cp viewpoint-7.5.0/moab.war /usr/share/tomcat6/webapps/
[root]# chown -R tomcat:tomcat /usr/share/tomcat6/webapps/moab*

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

  6. Create the /upload directory in /opt/viewpoint/. 
    7. [root]# mkdir /opt/viewpoint/upload

    Verify that the tomcat user has write privileges and the moab user has read privileges to the /upload directory.

  7. If you installed Moab Workload Manager and Viewpoint on separate servers, or if they are installed on the same server but you plan to customize the job script upload directory, follow the instructions in Setting up the job script directory.
  8. Start Tomcat.
    9. [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.

  9. Direct your browser to your Viewpoint URL (for example, http://[hostname or ip address]:8080/moab) to verify that Viewpoint is running.
  10. Log in to Viewpoint with the default super user username and password (moab-admin/changeme!).

    11. The Viewpoint Configuration page displays.

  11. Do the following:
    1. Set the Moab Web Services configuration. (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. Check the MWS Diagnostics to verify that the MWS connections are active. (For more information, see "Fields: MWS Diagnostics" in the Viewpoint Management and User Guide.)
    5. Set the Viewpoint default permissions. (For more information, see "Setting the Viewpoint default permissions" in the Viewpoint Management and User Guide.)

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

Related topics