Remote Host Execution
The objective of remote host execution through the workbench is to enable a user to take advantage of remote computing resources while still taking advantage of batching/queuing and monitoring for their local machine.
In this article, we describe how to setup the ADS workbench to execute on a remote host.
The following will be described:
- How does it work
- Requirements of the remote host
- How to setup the workbench
- How to monitor case execution
How does it work
The ADS workbench can be used to access resources on the internet or on your local network. It does this by creating an SSH tunnel to the remote host and using 256 bit encrypted channels to communicate with the resource. The workbench will automate the process of uploading the execution files (.LEO, .REST, etc.), starting execution and finally downloading the case when complete.
Requirements of the remote host
- The remote host must be running a LINUX OS such as CentOS or RHEL
- The user must be able to access the remote host using SSH
- The ADS executables (LEO, WAND, utils, etc) must be installed on the remote host
- An MPICH2 ring has already been set up
- A remote directory where data will be uploaded must be created. This will be defined as the "remote workspace"
How to setup the workbench
Setting up the workbench for remote host execution is quite easy. Simply go to Window->Preferences and click on the Remote Host window. Fill in the appropriate information. If you have trouble finding the information you should contact the system admin of the remote host. Here is a description of each entry:
- Enable/Disable: Radio buttons for enabling/disabling remote host access
- Hostname: IP address or DNS hostname of the remote host
- Port: SSH port for the remote host. Typically this is 22
- Username: Your username on the remote host
- Password: Your password on the remote host
- Remote Workspace: Absolute path to the directory you created above
- Check here to use local executables (local linux executables only): Check box to for the workbench to use your local versions of the ADS software. This is not typically set
- Code exec path: Absolute path to the code executable
Once complete you should see something similar to this.
When ready, click "Apply" and then "OK"
How to monitor execution
When you run a simulation, you will be able to monitor the progress of the execution through the console window. To open the console window use Window->Show View->Console
When you start the run you will first see it added to the execution queue.
Then you see the console window open and the upload process begin.
The console will update with the current iteration completed as well as the timestamp
Once all iterations are completed, you will see the data be zipped up and downloaded back to your local machine
Once on your local machine, the data will be unzipped so that it can be viewed