Installing and Running Star-P on the OnDemand Cluster
ATTENTION: OnDemand is in pre-production.
View or subscribe to SDSC News
for updates. To request access to this resource, contact
consult@sdsc.edu.
Star-P is a software platform to link between MATLAB®
tools and high performance parallel computing resources. The software is provided by Interactive Supercomputing Corporation.
See their Web site for more information.
Star-P software is a client-server, parallel-computing platform. The server is currently installed on the OnDemand cluster.
The client is installed on the user's desktop system with the MATLAB
installation. Users need to have a UNIX account on the
server and must have a MATLAB license for their personal workstation.
Star-P Installation
To set up the account and software environment after obtaining an allocation on the OnDemand Cluster:
- Update your MATLAB software to the most current version (Release 14 service pack 2 or higher).
- Download and install the Star-P client package from WINDOWS (starp_windows_client.exe) from /usr/local/apps/starp/cd/2.6.1/installable_package in the server system: rocks-131.sdsc.edu. (a LINUX version is also available)
- Set the environment variable USE_RELAY_HOST to rocks-131.sdsc.edu
- If you are running a bash shell, In your ".bashrc" file in your home directory, add the line: export USE_RELAY_HOST=rocks-131.sdsc.edu . In order to have this change take place immediately, run the following command: . ~/.bash_profile
- If you are running a tcsh or csh shell, in your ".cshrc" or ".tcshrc" file in your home directory, add the line: setenv USE_RELAY_HOST rocks-131.sdsc.edu . In order to have this change take place immediately, run the following command: source ~/.cshrc or source ~/.tcshrc
- Modify the starpd.properties in c:\Program Files\starp\config for the Windows system. Change the line "starpd.wgm.login=dchoi" to your ondemand login name. Also, change the line: starpd.wgm.starppath=/home/dchoi to: starpd.wgm.starppath=/usr/local/apps/starp/2.6.1 . To change the number of processors that your starp/matlab job runs on, change the line: starpd.wgm.numprocessors=8
# The path to matlab must be in your Windows Executalbe search path:
starpd.client.matlab.executable=matlab
# This sets the path to the place where Star-P will dump logs
# created by the client.
starpd.client.logroot=.starp/clientlog
# The number of days to keep log files, all older logs will be deleted.
starpd.client.logcleanup=2
# Property to disable gui dashboard. If set to 1 the gui dashboard will
# be disabled. This value need not be defined.
#starpd.dashboard.no_gui=1
#--------------------- Communication variables -----------------------
# Set this property to true to make matlab communicate with starpserverover
# an ssh tunnel. This will probably increase latency, but may be required
# if you can only connect to the HPC via ssh. Set to "true" or
# "tunnel" to use SSH tunnelling.
starpd.client.matlab.usessh=false
# This sets the SSH executable you wish to use for client/server
# communication. This can be openssh, builtin, or putty.
starpd.ssh.client=builtin
# Use this to set the path to the ssh executable when starpd.ssh.client
# is openssh or putty, if ssh or putty are *not* in your path. Remember
# to escape backslashes in the path as described at the top of this file.
#starpd.ssh.executable=
#--------------------- Server variables -----------------------
# If your matlab client is unusually slow to start, causing Star-P startup
# failures due to the server timing out before the client can connect,
# setting a value greater than 120 (seconds) for this symbol will cause the
# server to give the client more time to connect before timing out.
#starpd.client.server_connect_timeout=120
#
#-------
# The following starpd.wgm.* options specify information that the client
# needs to know about the Server.
# This sets the command to start the xmlrpc agent that starts the Server
# Manager relative to the starp installation directory
starpd.wgm.command=bin/starpagent.py
# Number of processors to request. Corresponds to --numprocs option
starpd.wgm.numprocessors=8
# HPC to connect to. Corresponds to --hpcaddress option
starpd.wgm.address=rocks-131.sdsc.edu
# login name used to ssh to the HPC. Corresponds to --hpcuser
starpd.wgm.login=u4078
# path where starp is installed on the HPC. Corresponds to --starppath
starpd.wgm.starppath=/usr/local/apps/starp/2.6.1
# path where starpserver will store data. Corresponds to --datadir
starpd.wgm.data_path=.
#-------
# The following properties can be modified to change the options
# used when running Star-P under a Workload Manger.
# Please see, the Star-P Installation Guide
# for help on acceptable values for these properties.
# Set this to override the default queue
# starpd.wlm.wlm_q_name=
# This overrides the full set of parameters passed to your WLM
# starpd.wlm.wlm_args=
# This is a single arg added to the base WLM parameters
# starpd.wlm.wlmextra=
#-------
|
| |
Running Star-P
- Run the starp executable, you will be prompted multiple times for your ondemand password.
- matlab will launch when step one is complete.
