1 – Setup > 1.2 Viewpoint installation and setup > Installing Viewpoint
Installing Viewpoint
System requirements
Requirements:
- Moab Workload Manager version 7.2.6
- Moab Web Services version 7.2.6
- Oracle®/Sun® Java® 6 Runtime Environment
![](../../../Resources/Graphics/templateIcons/note.png)
Oracle Java 6 Runtime Environment is the only supported Java environment. All other versions of Java, including Oracle Java 7, OpenJDK/IcedTea, GNU Compiler for Java, and so on are not supported.
- Apache Tomcat™ 6
- Open LDAP™ or Microsoft Active Directory®
Supported web browsers:
- Mozilla Firefox 4.0 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.
Prerequisites to installation
- Make sure that you have installed Apache Tomcat™ 6. You should have already done this while installing Moab Web Services (see the MWS Installation Guide).
- Make sure that you have installed Oracle®/Sun® Java® 6 Runtime Environment. You should have already done this while installing Moab Web Services (see the MWS Installation Guide).
- 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.
- (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.
- 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.d/moab-server.cfg file:
ADMINCFG[1] ENABLEPROXY=TRUE
ALLOWROOTJOBS TRUE
Without this configuration, all jobs submitted in will be submitted as "root," regardless of the user who actually submitted the job.
To install Viewpoint
- Stop Tomcat.
[root]# service tomcat6 stop
- Edit the Tomcat configuration file.
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]# vi /etc/tomcat6/tomcat6.conf
- 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
- 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:
JAVA_OPTS="$JAVA_OPTS -Xms4096m -Xmx4096m -XX:MaxPermSize=512m"
- Create the Viewpoint home directory.
[root]# mkdir /opt/viewpoint
[root]# chown -R tomcat:tomcat /opt/viewpoint
- Unpack the Viewpoint tarball and copy the moab.war file into the Tomcat webapps folder.
[root]# tar -xzvf viewpoint-gatling-snapshot.tar.gz
[root]# cp viewpoint-7.2.6/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.
- Set up the job script upload directory. If you installed Moab and Viewpoint on the same server and plan to use the default directory, you will only need to verify that the tomcat user has write privileges and the moab user has read privileges to $VIEWPOINT_HOME/uploads.
For information about customizing the job script upload directory or setting it up when Moab and Viewpoint run on different servers, see Setting up the job script directory.
- Start Tomcat.
[root]# service tomcat6 start
The default firewall settings on Centos 6 machines 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.
- 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!).
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.
- Once successfully logged in, Viewpoint automatically takes you to the Configuration page. On this page, do the following:
- Set the Moab Web Services connection. (For more information, see Setting the MWS configuration.)
- Authenticate the LDAP connection by manually specifying the bind user password. (For more information, see Setting the LDAP configuration.)
- Change the super user password. (For more information, see Changing the super user password.)
- Edit the customer configuration. (For more information, see Setting customer configuration.)
- Navigate to the Principal Management page (Administration > Principal Management), and create principals for LDAP users and user groups. Assign roles to the principals to enforce user permissions for the users contained in the principal. (For more information, see About principal management.)
If you would like to enable reporting in Viewpoint, please contact your Adaptive Computing sales representative to schedule professional services.
Related topics