3.14 Installing Remote Visualization

This topic contains instructions on how to install Remote Visualization, including licensing and configuration information.

Remote Visualization uses the FastX product. The Remote Visualization installation includes installing the Remote Visualization Server (gateway server) and Remote Visualization on the Torque MOM Hosts (session servers).

Remote Visualization Server (gateway server) and the Remote Visualization Session Servers, must be configured in order for Remote Visualization to work.

In this topic:

• 3.14.1 Open Necessary Ports
• 3.14.2 Obtain and Install the Remote Visualization License
• 3.14.3 Configure the RLM Plugin
• 3.14.4 Configure Moab to use Moab Web Services as a Resource Manager
• 3.14.5 Install Remote Visualization
• 3.14.6 Configure the Gateway Server
• 3.14.7 Configure a Session Server
• 3.14.8 Copy the Session Server Configuration to the Remaining Session Servers
• 3.14.9 (Optional) Install Graphical Packages on Each Torque MOM Host
• 3.14.10 Configure Moab for Remote Visualization
• 3.14.11 Configure Viewpoint for Remote Visualization
• 3.14.12 Grant Users Remote Visualization Permissions in Viewpoint

3.14.1 Open Necessary Ports

If your site is running firewall software on its hosts, you will need to configure the firewall to allow connections to the necessary ports.

See 2.11 Opening Ports in a Firewall for general instructions and an example of how to open ports in the firewall.

3.14.2 Obtain and Install the Remote Visualization License

Remote Visualization uses the RLM to validate the amount of open and available sessions.

These instructions assume you already have access to an RLM Server. See 3.13 Installing RLM Server for instructions on how to set up a new RLM Server.

Do the following:

1. Email [email protected] and request an activation key. Adaptive Computing will send you the activation key in a return email.
2. Once you have your activation key, do the following on the RLM Server:
   1. Install the license activation script and dependencies.

      [root]# yum -y install perl-Crypt-SSLeay StarNetFastX2

   2. Run the license activation script.

      /usr/lib/fastx2/install/activate

   3. When prompted:
      • Enter the activation key.
      • Enter how many seats (sessions) you want for this license.

      When the license has generated you will see something similar to the following on the last line:

      License activated and saved in /usr/lib/fastx2/rlm/FastX2-<date>.lic

   4. Move the license file to the /opt/rlm directory.

      mv /usr/lib/fastx2/rlm/FastX2-<date>.lic /opt/rlm

      

      This license file references the default RLM Server port (5053). If the RLM Server in your configuration uses a different port, you will need to modify the license file to reflect the actual port.

   5. If you did not install an RLM Server using the file available from Adaptive Computing (for example, because your system configuration already uses one), do the following:
      1. Download the 'starnet.set' file from the Adaptive Computing Moab HPC Suite Download Center.
      2. Copy the 'starnet.set' file into the same directory where the Remote Visualization license resides (/opt/rlm).
   6. Restart RLM.

      [root]# service rlm restart

3.14.3 Configure the RLM Plugin

Moab can schedule available remote visualization sessions by querying the RLM server for the number of active and total available sessions.

In order for Moab to schedule remote visualization sessions, Moab also needs to be configured to use Moab Web Services as a resource manager. See Configuring Moab Workload Manager in the Moab Web Services Reference Guide for more information.

Do the following:

1. Using a web browser, navigate to your MWS instance (http://<server>:8080/mws/) and then log in as the MWS administrative user (moab-admin, by default).
2. Select Plugins and then from the drop-down select Plugins to display the list of MWS plugins (displays Plugin List page).
3. Click Add Plugin (displays Create Plugin page).
4. Select RLM from the Plugin Type drop-down.
5. Click Continue (displays the already built information for this plugin on the Create Plugin page).
6. In the Configuration field, select Resource from the drop-down and then click Add Entry (adds the Resource key to the table). The following is an example of what your Create Plugin page should look like.

   Click to enlarge

7. Enter the key values. The following table describes the required information.

   Key	Value Description
   URL	URL for the RLM Server web interface in the form: <protocol>://<rlm_server_host>:<rlm_web_interface_port>. For example: http://server:5054
   Username	The username in the RLM Web interface; typically user.
   Password	Password used by the user listed in the Username key. This is the password you set when you install the RLM. See Change the Default Passwords.
   ISV	Independent software vender for Remote Visualization. This value must be starnet.
   Product	Name of the licensed product for Remote Visualization. This value must be fastx2.
   Resource	Name of the resource to report to Moab Workload Manager. This value must be remote_visualization.

8. When finished, click Save to save your changes and close this page; otherwise click Cancel to reset all the changes.
   

   The state should be "Started". If the state says "Errored", click Edit, modify the values as needed, click Update. Then from the Plugin Monitoring page, locate the RLM plugin and click the play icon.

9. Log out of your MWS instance and close the web browser.

3.14.4 Configure Moab to use Moab Web Services as a Resource Manager

In order for Moab to schedule remote visualization sessions, Moab also needs to be configured to use Moab Web Services as a resource manager.

On the Moab Server Host, do the following:

1. Add the following lines to /opt/moab/etc/moab.cfg:

   RMCFG[mws]                      TYPE=MWS
   RMCFG[mws]                      BASEURL=http://localhost:8080/mws

   The BASEURL must match the configured URL of MWS.

2. Add the following line to /opt/moab/etc/moab-private.cfg:

   CLIENTCFG[RM:mws] USERNAME=moab-admin PASSWORD=changeme!

   

   USERNAME and PASSWORD must match the values of auth.defaultUser.username and auth.defaultUser.password, respectively, found in the MWS configuration file. The MWS RM contacts MWS directly using the base URL, username, and password configured.

3. Restart Moab.

   [root]# service moab restart

3.14.5 Install Remote Visualization

Remote Visualization needs to be installed on the gateway server and on all the session servers (Torque MOM Hosts).

You must complete all the tasks earlier in this topic before installing Remote Visualization.

Do the following:

1. Make sure that your DNS server is configured for reverse lookups. Without reverse DNS, Session Servers will fail to register with your Gateway Server. As a result, authentication requests to the Gateway Server will fail because the Gateway Server will not be able to connect to any Session Servers.
2. Prepare the hosts for RPM installation. If you will be installing Remote Visualization on a host that does not have another RPM installation, complete the steps to prepare the host. See 3.3 Preparing for RPM Installs for more information.
3. On the Remote Visualization Gateway Server Host and each Session Server Host, do the following:
   1. Install FastX and all its dependencies.

      [root]# yum -y install ImageMagick-perl perl-Crypt-SSLeay perl-Net-SSLeay perl-X11-Protocol StarNetFastX2

      

      If installing on RHEL, some packages may not be found in the standard RHEL distribution repositories. You will need to install the missing dependencies from EPEL or other reputable repositories.

      [root]# rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/x86_64/e/epel-release-6-8.noarch.rpm
      [root]# yum install yum-utils
      [root]# yum-config-manager --disable epel
      [root]# yum install --enablerepo=epel,rhel-6-server-eus-rpms ImageMagick-perl perl-Crypt-SSLeay perl-Net-SSLeay perl-X11-Protocol StarNetFastX2

   2. Create or use an unprivileged account to login into fastx with admin privileges. This is the <fastxadminuser>.
      

      The following example uses the ace user and password. You can use an existing user, as long as that user can ssh into this host with a username/password pair.

      [root]# useradd ace
      [root]# passwd ace

   3. Run the install.sh script on the Remote Visualization Gateway Server and on all of the Session Servers (Torque MOM Hosts).

      Answer the questions raised by the install.sh script. For example:

      [root]# /usr/lib/fastx2/install.sh
      Do you have a license server on your network? [y/N] y
      Enter the name (or IP address) of your license server: localhost
      License file /usr/lib/fastx2/rlm/localhost.lic has been created.
      Install/update the FastX web server? [Y/n] y
      Creating a self-signed certificate... done.
      A self-signed certificate has been created for this web server.
      It will allow secure connections, but is vulnerable to a
      man-in-the-middle attack. Because of this, connections will generate
      warnings from the browser. These warnings (and the vulnerability) can be
      eliminated later by installing a certificate from a certificate authority.
      Setup initial admin user? [Y/n] y
      The admin must be an existing Linux user, but not root.
      The admin will be able to see and terminate any user's session,
      add additional admins, and configure the server.
      Enter admin account: ace
      Starting FastX web service...
      Starting fastx (via systemctl): [ OK ]
      FastX Server listening on port 3000
      FastX HTTPS Server listening on port 3443
      done.

4. Viewpoint supports either password-based authentication or key-based authentication for Remote Visualization.
   • For password-based authentication, do the following on the Remote Visualization Gateway Server and on each Session Server:
     1. Set the following parameters in /etc/ssh/sshd_config:

        PasswordAuthentication yes
        ChallengeResponseAuthentication no

     2. Restart the sshd service.

        [root]# service sshd restart

   • For key-based authentication, do the following:

     1. On the Remote Visualization Gateway Server, log in as the FastX admin user and generate a ssh key. Accept the default.

        

        A passphrase is not supported by Viewpoint. Leave this field empty.

        [<fastxadminuser>@<hostname> ~]$ ssh-keygen -t rsa
        Generating public/private rsa key pair.
        Enter file in which to save the key (/home/<fastxadminuser>/.ssh/id_rsa):
        Created directory '/home/<fastxadminuser>/.ssh'.
        Enter passphrase (empty for no passphrase):
        Enter same passphrase again:
        Your identification has been saved in /home/<fastxadminuser>/.ssh/id_rsa.
        Your public key has been saved in /home/<fastxadminuser>/.ssh/id_rsa.pub.
        The key fingerprint is:
        ...

     2. Copy the generated id_rsa private key to a location where Viewpoint has access.

     3. Set the generated id_rsa public key as an authorized key for the Gateway Server.

        [root]# cat ~<fastxadminuser>/.ssh/id_rsa.pub >> ~<fastxadminuser>.ssh/authorized_keys ; chown <fastxadminuser>. ~<fastxadminuser>/.ssh/ -R

     4. Copy the id_rsa public key to all the Session Servers and set it as an authorized key.

        

        For documentation clarity, these instructions use node00 through node09 as the names of the Session Servers; with node00 designated as the initial Session Server.

        [root]# for i in {00..09} ; do scp ~<fastxadminuser>/.ssh/id_rsa.pub node$i:<fastxadminuser home>:id_rsa.pub ; done
        [root]# for i in {00..09} ; do ssh node$i "cat id_rsa.pub >> <fastxadminuser home>/.ssh/authorized_keys ; rm -f id_rsa.pub ; chownfastxadminuser>. <fastxadminuser home>/.ssh/ -R" ; done

3.14.6 Configure the Gateway Server

Do the following:

1. Using a web browser, navigate to your secure Remote Visualization Gateway Server instance. (https://<gateway_host>:3443; where <gateway_host> is the IP address or name of the Gateway Server Host).

   The Log In page displays. For example:

   Click to enlarge

2. Log in as the FastX admin user. Do one of the following:

   • If your authentication method is password-based, do the following:
   1. Enter the user name (default is "ace").
   2. Enter the password (default is "ace").
   3. Make sure the "Use Public Key Authentication" checkbox is cleared.
   4. Click Log In.
   • If your authentication method is key-based, do the following:
     1. Enter the user name (default is "ace").
     2. Select the "Use Public Key Authentication" checkbox.
     3. A prompt will display asking for you to load your private key file.
        1. Click Upload Private Key File and navigate to your stored key file.

           When your key file has uploaded it will be displayed in the prompt. For example:

           Click to enlarge

        2. Click Close. The prompt closes.
     4. Click Log In.

3. Click the icon for Admin\System Configuration. The icon is circled in the example to assist in finding its location.

   Click to enlarge

4. Select the Network tab. If it is not already selected, select the Configuration sub-tab to display the FastX Network Configuration page.

   Click to enlarge

5. Do the following:
   1. In the Secret Key field is a FastX-generated key. Record this secret key (e.g. copy to your clipboard) because you will need it when configuring the Session Servers later in this topic. This key is different from the key file used to log in as the administrative user. You can also change the generated Secret Key if needed.
   2. Enable the connection to accept data from cluster member.
   3. In the box to specify the log in method, select "Sessions - log in to the system running the fewest sessions".
   4. Disable the Gateway Server from sending data to cluster members.

   The following image is an example of the completed FastX Network Configuration page for the Gateway Server.

   Click to enlarge

6. Click Save to submit your changes.

3.14.7 Configure a Session Server

This section provides instructions on how to configure one Session Server (referred to as the initial Session Server). The configuration will then be copied to the additional Session Servers in your environment in a later procedure.

Do the following:

1. Using a web browser, navigate to your secure Remote Visualization Session Server instance. (https://<session-host>:3443; where <session_host> is the IP address or name of the initial Remote Visualization Session Server Host).

   The Log In page displays. For example:

   Click to enlarge

2. Log in as the FastX admin user. Do one of the following:

   • If your authentication method is password-based, do the following:
   1. Enter the user name (default is "ace").
   2. Enter the password (default is "ace").
   3. Make sure the "Use Public Key Authentication" checkbox is cleared.
   4. Click Log In.
   • If your authentication method is key-based, do the following:
     1. Enter the user name (default is "ace").
     2. Select the "Use Public Key Authentication" checkbox. Upload the public key used when you configured the Gateway Server earlier in this topic.
     3. Click Log In.
   

   When you first log in, you will get a message that you have no session running. That is expected.

3. Select the icon for Admin\System Configuration. The icon is circled in the example to assist in finding its location.

   Click to enlarge

4. Select the Network tab. If it is not already selected, select the Configuration sub-tab to display the FastX Network Configuration page.

   Click to enlarge

5. Do the following:
   1. In the Secret Key field, enter the name of the secret key provided when configuring the Gateway Server earlier in this topic.
      

      You will not be able to login to the portal on the Gateway Server until you have completed the configuration of at least one Session Server. If you did not save it earlier, the secret key can be found in the /usr/lib/fastx2/config/network.json on the Gateway Server.

   2. Disable the connection to accept data from cluster members.
   3. Enable the Gateway Server to send data to cluster members.
   4. In the box to specify whether to SSL certificates, select "I am using a self-signed certificate".
   5. In the Cluster member URLs box, to the following:
      1. Click the + icon.
      2. In the box that displays, enter the IP address or name and the port number of the Gateway Server you just configured (for example: "https://mgmtnode:3443").

   The following image is an example of the completed FastX Network Configuration page.

   Click to enlarge

6. Click Save to submit your changes.

3.14.8 Copy the Session Server Configuration to the Remaining Session Servers

After you configured the initial Session Server, the settings are saved in the network.json file.

For documentation clarity, these instructions use node00 through node09 as the names of the Session Servers; with node00 designated as the initial Session Server.

On the initial Session Server Host, copy the network.json file to the remaining Session Server Hosts in your environment, and restart the FastX service.

[root]# for i in {01..09} ; do scp /usr/lib/fastx2/config/network.json root@node$i:/usr/lib/fastx2/config/network.json ; done
[root]# for i in {01..09} ; do ssh node$i "chown fastx. /usr/lib/fastx2/config/. -R" ; done
[root]# for i in {01..09} ; do ssh node$i "service fastx restart" ; done

3.14.9 (Optional) Install Graphical Packages on Each Torque MOM Host

A few graphical packages are available to let you easily submit remote visualization jobs from Viewpoint (install a desktop environment).

One each Torque MOM Host, do the following:

[root]# yum -y groupinstall "Desktop" "Desktop Platform" "X Window System" "Fonts"
[root]# yum -y install xterm

3.14.10 Configure Moab for Remote Visualization

On the Moab Server Host, verify the /opt/moab/etc/moab.cfg file contains the following uncommented parameter:

JOBCFG[remote_visualization] FLAGS=usemoabjobid SELECT=TRUE

This parameter configuration specifies that Moab will reference remote visualization jobs by their internal Moab job id. However, the job's output and error files will still be generated by your resource manager (for exampe, Torque). This means that, even though your job will get assigned a Moab job id, your job's output and error file names will reference the resource manager's job id (for example, job.oX).

If you need the job's output files to match the same job id as your Moab job, append the following parameters to your moab.cfg:

RMCFG[pbs] SYNCJOBID=TRUE FLAGS=ProxyJobSubmission

RMCFG[internal] JOBIDFORMAT=integer

Be advised that these appended parameters are not recommended for all systems; especially if your configuration includes customizations. If your system is not working as expected, contact Adaptive Computing support for assistance.

If you have made changes to the moab.cfg file, make sure you restart Moab.

[root]# service moab restart

3.14.11 Configure Viewpoint for Remote Visualization

Do the following:

1. Using a web browser, navigate to your Viewpoint instance (http://<server>:8081) and then log in as the MWS administrative user (moab-admin, by default).

2. Click Configuration from the menu and then click Remote Visualization Services from the left pane.

   The following is an example of the Remote Visualization Configuration page.

   Click to enlarge

3. Enter the hostname (or IP address) and port number for the FastX gateway server in the Gateway Server field (do not use localhost if you intend to submit remote viz jobs from other hosts). For example, https://<server>:3443.
4. If your Remote Visualization configuration was set up using self-signed certificates, confirm the Trust Self Signed check box is selected.
5. Enter the FastX admin user you specified when you installed the Remote Visualization Server in the Username field. For example, ace.
6. If your configuration will authenticate using the password-based method, do the following:
   1. Select Password Based Authentication from the Authentication Method box.
   2. Enter the FastX admin user's password in the Password field.
      

      The /etc/ssh/sshd_config file on each Session server must be configured to enable password authentication. See 3.14.5 Install Remote Visualization earlier in this topic for more information.

7. If your configuration will authenticate using the key-based method, do the following:
   1. Select Key Based Authentication from the Authentication Method box.
   2. Click UPLOAD KEY and navigate to the copy of the generated .ssh/id_rsa file.
8. Click TEST to confirm your settings are correct.
9. Click SAVE to submit your settings.

3.14.12 Grant Users Remote Visualization Permissions in Viewpoint

Viewpoint comes packed with base (default) roles for Remote Visualization jobs. Any user who will be working with Remote Visualization, must have the appropriate role added to the Viewpoint user principal.

These are the Viewpoint Roles for Remote Visualization:

• RemoteVizAdmin – Administrative user, with permission to create remote visualization application templates and manage other user's remote visualization jobs.
• RemoteVizUser – Basic user, with permission to create and manage their own remote visualization jobs.

See Creating or Editing Principals in the Moab Viewpoint Reference Guide for instructions on setting up principals.

© 2016 Adaptive Computing