Moab Access Portal Administrator's Guide - 1.2 Installing Access Portal
Moab Access Portal®

1.2 Installing Access Portal

  1. If needed, go to the directory where you downloaded the Access Portal tarball.
  2. Extract the contents of the compressed tarball. This will create a new directory containing the contents of the compressed file.

    NOTE: Please use an account that has root or administrator privileges before continuing the installation.
    Example:
    [root@localhost opt]# tar -zxf map-2.2.2.tar.gz
    [root@localhost opt]#
    
  3. Change to the newly created directory.

    Example:
    [root@localhost opt]# cd map-2.2.2
    [root@localhost map-2.2.2]#
    
  4. Run the "./setup" script to begin the automated installation. A series of interactive steps and questions follows:

    • Configuration Files: Either type in a directory (may not yet exist) to store MAP's configuration files or accept the default directory by hitting Enter.
    • Servlet Container Type: Answer the yes-and-no questions about your servlet container type using y or n.
    • Servlet Container Directory: Type in the absolute path where the servlet container stores its web application files. In most cases you can accept the default by simply hitting Enter.
    • Cluster Head Hostname: Type the hostname or IP address of the cluster head node and hit Enter.
  5. Change to the configuration directory. This is where the Moab Access Portal start script is located. (If you accepted the default directory simply type "cd etc" to enter the directory.)

    Example:
    [root@localhost map-2.2.2]# cd etc
    [root@localhost etc]#
    
  6. Execute the "./map-start.sh" script to start/restart the servlet container and Access Portal.

    Example:
    [root@localhost etc]# ./map-start.sh
    
    Using CATALINA_BASE:   /opt/tomcat
    Using CATALINA_HOME:   /opt/tomcat
    Using CATALINA_TMPDIR: /opt/tomcat/temp
    Using JAVA_HOME:       /opt/java
    Using CATALINA_BASE:   /opt/tomcat
    Using CATALINA_HOME:   /opt/tomcat
    Using CATALINA_TMPDIR: /opt/tomcat/temp
    Using JAVA_HOME:       /opt/java
    [root@localhost etc]#
    
  7. Navigate to the Access Portal login page by visiting http://<portal-host:port>/map/ in a Web browser.

    NOTE: Replace <portal-host:port> with the hostname or IP address of the machine running the servlet container and the port being used by the servlet container, which is usually 8080 (e.g., webserver.icluster.org:8080). Check the servlet container's documentation for details about the port number.
  8. Type in the username and password of a Moab ADMIN1 user such as "root" and click Login. If login is successful then Moab Access Portal has been correctly installed.