To be able to run a multi-node Ansys RSM Cluster (ARC), such that jobs can be dispatched to one or more nodes, you must install the ARC Master service on the node that you are designating as the cluster submit host, and install the ARC Node service on every node that will be used for job execution (including the submit host if it will be used for running jobs).
When installing an ARC cluster service on Linux, you must determine if you want to install the service as a daemon that will start the service automatically when the machine is booted, or if you want to start the service manually via a startup script. Use only one of these methods.
When an ARC cluster service is started manually, it runs as a process for the user who initiated the service. A manually started ARC cluster service is stopped each time the machine is rebooted. After a reboot you must restart the ARC cluster service by running the startup script.
In a multi-node ARC on Linux, it is recommended that you install cluster services as daemons.
Before installing ARC cluster services on Linux, you can edit the arc_env_profile file in the $AWP_ROOT242/RSM/ARC/tools/linx64 directory. In this file, you can add any common environment variables to be used by the cluster. Once defined, ARC services should inherit these environments when any job is run on the ARC. It is useful to be able to set common environment variables in a single place instead of having to set them up on each job user's .cshrc or .profile file from the user’s $HOME directory.
The following shows the content of arc_env_profile file:
#!/bin/sh # The following examples show loading environment settings specific to ARC Advanced mode. # When defined, ARC services will inherit the environment created here # . /home/batch/environmentVariables/conf/settings.sh
Note:
This profile only works on Linux. Windows users should modify their environment via the environment interface in Windows.
This profile will work for all Ansys RSM Cluster (ARC) jobs, but the shell is dependent on what is chosen.
For a basic ARC configuration in which no special setup has been performed, this file must be written in
/bin/sh. This applies, for example, when a user submits a job to a single-node ARC, and RSM auto-starts ARC services on the node if they are not running.For an ARC configuration where ARC services have been configured as daemon services, arc_env_profile should be written in whatever shell is chosen in the
LinuxShellToUsesetting in the Ans.Rsm.AppSettings.config file.
Ensure that you set this profile carefully. Setting it incorrectly could prevent RSM and ARC from working properly.
You can run ARC cluster service scripts to manually start, stop, and check the status of ARC cluster services.
Manually Running the ARC Master Service Script
Use the arcmaster service script and appropriate option to manually start, stop, and check the status of the ARC Master service on a Linux cluster head node.
To start the ARC Master service, run
$AWP_ROOT242/RSM/ARC/tools/linx64/arcmaster
start.
To stop the ARC Master service, run
$AWP_ROOT242/RSM/ARC/tools/linx64/arcmaster
stop.
To check the status of the ARC Master service, run
$AWP_ROOT242/RSM/ARC/tools/linx64/arcmaster
status.
Manually Running the ARC Node Service Script
Use the arcnode service script and appropriate option to manually start, stop, and check the status of the ARC Node service on Linux execution nodes.
To start the ARC Node service, run
$AWP_ROOT242/RSM/ARC/tools/linx64/arcnode
start.
To stop the ARC Node service, run
$AWP_ROOT242/RSM/ARC/tools/linx64/arcnode
stop.
To check the status of the ARC Node service, run
$AWP_ROOT242/RSM/ARC/tools/linx64/arcnode
status.
You can configure an ARC cluster service to start automatically when the machine is booted by configuring it as a “daemon” service (if the service is not configured to start automatically, then it must be started manually, as described in Starting ARC Cluster Services Manually on Linux (arcmaster | arcnode)). Daemon services are scripts or programs that run persistently in the background of the machine, and which are usually executed at startup by the defined runlevel.
Once the daemon service is installed, the cluster service will be started automatically without rebooting. The next time the machine is rebooted, the installed cluster service will be started automatically.
Installing the ARC Master Service as a Daemon
To install the ARC Master service as a daemon on a Linux cluster head node, run the following command:
$AWP_ROOT242/RSM/ARC/tools/linx64/install_daemon
-arcmaster
Installing the ARC Node Service as a Daemon
To install the ARC Node service as a daemon on a Linux execution node, run the following command:
$AWP_ROOT242/RSM/ARC/tools/linx64/install_daemon
-arcnode