Log into Access Desktop and Register an HPC Cluster

Launch Access Desktop so that you can submit jobs to the Workload Manager.

Double-click the Access Desktop icon shortcut that appears on the desktop to launch Access Desktop.

Add and establish a connection to the HPC or Workgroup using SSH by registering it so that you may begin submitting and monitoring jobs.

1. Open the Windows system tray.
2. Double-click the Access Desktop icon .
3. Click .
4. Select Clusters.
   A Clusters dialog box is displayed.

   
   
   Figure 1. Add Cluster

5. Choose one of the following options:
   • Select PBS to add a PBS Server.
   • Select Workgroup to add a Workgroup computer.

     

6. For Cluster Display Name, enter a name for the cluster as it is displayed within Access Desktop.
7. For Login Node Name, enter the host name of the machine where the PBS Server is installed.
   Note: The default port number for SSH is 22. If SSH is configured to use a different port number add it along with the host name.
8. For Username, enter your user name.
9. Choose one of the following options:
   • Select Password from the drop down box and enter your password.
   • Select SSH Key from the drop down menu and import the private SSH key file.
10. Optional: If you have chosen to enter your password, you may enable Skip this next time, so that you do not have to enter your credentials again.
11. Enter the location on the PBS Server where job files are staged when a job is running.
12. Choose one of the following options:
    • If you have chosen to store your application definitions in a central repository rather than on your workstation, enter the URL for accessing the central repository in the format https://<HOSTNAME>:4443 where <HOSTNAME> is the hostname of the machine where Access Web is installed.
      Note: If the central repository is being hosted on the PBS Server, then the URL is automatically populated.
    • If you have chosen to store your application definitions locally, then remove the URL.
13. Click Add.
    Tip: Repeat the previous steps to add additional clusters.
14. Click Done.
    The cluster is added successfully and a green check mark is displayed next to the cluster name.

Add and connect to Access Web server using HTTPS to submit and monitor jobs.

1. Open the Windows system tray.
2. Double-click the Access Desktop icon .
3. Click .
4. Select Clusters.
   A Clusters dialog box is displayed.
5. Select HTTPS from the drop-down list.

   
   
   Figure 2. Adding a Cluster

6. Enter a Cluster Display Name.
   Note: You can use alphanumeric characters for a cluster display name.
7. Enter the Access Web URL in the format https://<hostname>:4443. Hostname is the machine where Access Web is installed.
   Note: If a hostname is provided during the Access Web installation enter the Access Web URL using the hostname to register the HTTPS cluster. Similarly follow the same if IP address is provided.
8. Click Add.
   A new web browser is launched and authenticates the user using the OpenID Connect (OIDC) and provides an authenticate code.

   
   
   Figure 3. OIDC Authentication

9. Click Submit.
   The Access login page is displayed.
10. Enter your credentials.

    
    
    Figure 4. Access Web Login

11. Click Log In.

    
    
    Figure 5. Successful Login

12. Close the browser. Return to the Access Desktop application; the cluster is added, and a green check mark is displayed next to the cluster name.

    
    
    Figure 6. HTTPS Cluster Register

    Tip: Repeat the steps to add an additional HTTPS cluster.

Login to Access Desktop to submit and monitor jobs.

After launching Access Desktop, a login screen is displayed if you have previously registered an HPC cluster without enabling Skip this next time option. To login to Access Desktop, you must login using your credentials for that HPC cluster. The HPC cluster that has been registered is displayed on the left.

Figure 7. Login Screen

1. For Username, enter your username credential.
2. Choose one of the following options:
   • Select Password from the drop down menu and enter your password.
   • Select SSH Key from the drop down menu and import the RSA private SSH key file.
3. Optional: If you have chosen to enter your password, you may enable Skip this next time, so that you do not have to enter your credentials again.

   An SSH key is generated and stored allowing you to login to the cluster without having to enter your credentials.