Install Workbench and ANSYS applications. RSM is automatically installed with Workbench. For information about the installation of RSM, refer to RSM Installation and Startup in the RSM User's Guide.
ANSYS applications (Fluent, CFX, MAPDL, and so on) should be installed on the machine(s) where you will be running jobs. They should be installed in a way that they can be accessed by the RSM machine and any other cluster machines being used.
In order to run jobs successfully in EKM, the installed version of RSM must be exactly the same version as EKM. For example, EKM 18.2 will not work with RSM 16.2.
If users will be submitting jobs to EKM from pre-18.2 versions of Workbench, the machine(s) on which jobs will run must have the matching version of ANSYS applications installed. For example, if users will be submitting Fluent jobs from Workbench 17.2 to an EKM 18.2 portal, you must have Fluent 17.2 installed on the cluster.
If jobs will be submitted to a remote cluster, whether it be an ANSYS RSM Cluster (ARC) or third-party cluster such as LSF or Microsoft HPC, RSM must be installed on the cluster submit host, and the RSM launcher service must be running on that host before job submission can begin.
After installing RSM, do not start the RSM launcher service until you have configured RSM. If you will be using the automated script to configure RSM, the script will start RSM services for you. See Configuring RSM Using an Automated Script. If you will not be using the automated script, you will need to start RSM launcher service manually. See Installing and Configuring the RSM Launcher Service in the RSM User's Guide.
If after installing and configuring RSM you wish to install another ANSYS product using the ANSYS unified installer, make sure that you stop the RSM launcher service before proceeding with the installation, and then restart it after the installation. For instructions refer to RSM Installation and Setup in the RSM User’s Guide.
Set the value of the ConfigurationDirectory
setting in the
RSM\Config\Ans.Rsm.AppSettings.config file,
which determines where RSM configuration files will be generated. This must
be a shared directory on the cluster submit host (where the RSM launcher
service is running).
You can do this in one of the following ways:
Specify the directory in EKM using an automated script. See Configuring RSM Using an Automated Script. If you use the script, the directory will be created automatically.
Specify the directory in RSM. See Specifying a Directory for Cluster Configuration Files in the RSM User's Guide.
Create cluster configurations. A cluster configuration contains information about the cluster submit host, the system used for job scheduling, desired communication protocols, and the location of job directories. When defining a cluster configuration you also define RSM queues that will appear in EKM when users submit jobs. Each RSM queue maps to a particular cluster configuration and cluster queue. See RSM Configuration in the RSM User's Guide.
You can create cluster configurations in the following ways:
(Recommended) Use the Manage Cluster Configurations feature in EKM. This option is ideal if it is difficult to display an interface on the machine where the RSM launcher service is running. It is designed specifically for EKM-RSM setups to ensure that cluster job submission is correctly configured. See Creating and Editing Cluster Configurations in EKM.
Use the RSM Cluster Configuration application. See RSM Configuration in the RSM User's Guide.
Use the RSM Utilities application to manually generate RSM configuration files. See Managing RSM Cluster Configurations and Queues (rsm.exe | rsmutils config) in the RSM User's Guide.
Use an automated script in EKM. See Configuring RSM Using an Automated Script.
Note that the first two options are preferred because they provide validation of the cluster configurations that you create.
Regardless of the method you choose, take note of the following EKM-specific requirements when defining a cluster configuration:
The Cluster Staging Directory
property or <stagingDirectory> setting
in the cluster configuration (.rsmcc) file must
always be left blank. This is because EKM stages job data in the job
data directory specified in the
jobSourceRootPath setting in the
ekm.xml file. For more information about
this setting, see Specifying Remote Process
Policies (<remoteProcess>).
When specifying client-to-cluster file management properties,
ensure that the No file transfer
needed option is selected, or that the
<fileCopyOption> in
the.rsmcc file is set to
None.
When specifying cluster-side file management properties, the use of a local scratch directory is supported for MAPDL/Mechanical solutions only. If using other solvers, you must use a shared staging directory.
Ensure that EKM and RSM job directories are correctly defined. See EKM and RSM Job Directories.
Start the RSM launcher service. If jobs will be submitted to a remote cluster, start the RSM launcher service on the cluster submit host. For more information see Installing and Configuring the RSM Launcher Service in the RSM User's Guide.
If you will be using an ANSYS RSM Cluster (ARC) as your batch queuing system, install the ARC cluster services. Refer to either Installing ARC Cluster Services on Windows (installservice) or Installing ARC Cluster Services on Linux in the RSM User's Guide. Otherwise, if you will be using a third-party cluster (SGE, LSF, and so on), you can skip this step.
If jobs will be submitted to a remote cluster, edit the following settings
in the EKM_HOME/conf/ekm.xml
file:
jobSourceRootPath: Specify the path to the
directory where EKM will stage the data files for batch jobs submitted
to RSM. You must create this directory before job submission begins. This
directory must be accessible to the cluster submit host. To avoid file
transfers you can set this path to a shared cluster staging
directory.
rsmLauncherURL: Change the value from
localhost to the host name of the cluster
submit host (where the ANSYS RSM Launcher service is running).
For more details about these settings, such as using a
jobSourceRootPath relative to users' home
directories on Linux, see Specifying Remote Process
Policies (<remoteProcess>).
In EKM, synchronize EKM job submission queues with those defined in RSM. See Synchronizing Job Submission Queues.
For each job submission queue in EKM, load or create application definitions that determine the applications to be run. See Editing Job Submission Queue Settings and Defining External Applications.
If users will be submitting Electronics jobs, you must specify an environment variable on the compute nodes where such jobs will run which contain the path to the installation directory of Electronics Desktop. You can specify different environment variables for different versions of the application. For example, specify a variable named AEDT_ROOT170 for a version 17.0 installation, and AEDT_ROOT182 for a version 18.2 installation.
Once you have installed RSM, you must configure it to work with EKM. This can be done using the RSM Cluster Configuration application and RSM utilities (see RSM Configuration in the RSM User's Guide).
As an alternative, a script is provided in the
EKM_HOME\examples\rsm folder which enables you to
configure RSM from EKM.
Running the enable-portal-setting.cmd[sh] script does
the following:
Enables the LauncherService setting in the
RSM\Config\Ans.Rsm.AppSettings.config
file:
<appSettings name="LauncherService">
<add key="LauncherXmlRpcEnabled" value="true" />Note that the LauncherService is enabled by
default, and should not be disabled.
Sets the value of the ConfigurationDirectory
setting in the
RSM\Config\Ans.Rsm.AppSettings.config file,
which determines where RSM configuration files will be generated:
<appSettings name="JobManagement">
<add key="CompressionThresholdMb" value="0" />
<add key="CleanupTimeSpan" value="00:10:00" />
<add key="FinishedJobHistoryCleanupTimeSpan" value="02:00:00" />
<add key="FailedJobHistoryCleanupTimeSpan" value="1.00:00:00" />
<add key="CancelJobHistoryCleanupTimeSpan" value="00:10:00" />
<add key="GlobalPropertiesReloadDelay" value="00:00:05" />
<add key="JobsWatcherPeriodMs" value="5000" />
<add key="LogWatcherPeriodMs" value="1000" />
<add key="AsyncResultPollingTimeoutMs" value="1000" />
<add key="CatchAllStatusExceptions" value="false" />
<add key="ConfigurationDirectory" value="\some\local\path" />If the specified directory does not exist, it will be created automatically.
Creates the RSM ClusterConfiguration (.rsmcc) and ConfiguredQueue (.rsmq) files in the specified configuration directory. Note that this is not the preferred way to create cluster configurations. Using the RSM Cluster Configuration application is recommended because the application validates cluster configurations when you create them.
Starts the RSM launcher service. In Windows,
enable-portal-setting.cmd also registers
the service as a Windows service.
Important: Prior to running the script, make sure that you have set the
AWP_ROOT182 environment
variable.
To configure RSM automatically using a script:
If the RSM launcher service is currently running, stop it.
In Windows, as an administrator, run net stop
RSMLauncherService182.
In Linux, run rsmlauncher stop.
Go to EKM_HOME\examples\rsm and open the
enable-portal-setting.cmd[sh] script in a
text editor.
(Optional) Uncomment the rsm config command
that corresponds to your cluster type, and optionally specify arguments
to configure the cluster configuration.
rem Uncomment one of the following "rsm config" commands: rem (1) Local RSM sample... "%AWP_ROOT182%\RSM\bin\rsm.exe" config create default rem (2) LSF sample... rem "%AWP_ROOT182%\RSM\bin\rsm.exe" config create LSF -name lsfcc -rsmQueue mylsfqueue -clusterQueue lsfqueue1 -p lin rem (3) Win HPC (using local scratch) sample... rem "%AWP_ROOT182%\RSM\bin\rsm.exe" config create MSHPC -name MSHpcConfiguration -localscratch c:\rsmtemphpc -scratchUnc rsmtemphpc -rsmQueue MsHpcQueue -p win
Note: It is highly recommended that you create cluster configurations using either the RSM Cluster Configuration application or the Manage Cluster Configurations feature in EKM, as they both provide validation functionality.
Running as Administrator, use a command line to go to
EKM_HOME/examples/rsm.
Use enable-portal-setting.cmd[sh] along with
a parameter that specifies the location of the configuration directory.
This is the directory where the .rsmcc and
.rsmq files will be generated. Referring to the
sample below, replace /some/path with a local path on the RSM server that is
read/write accessible to the user running the RSM launcher service
(for example, D:\RSMData).
enable-portal-setting.cmd /some/path
If the directory that you specify does not currently exist, it will be created automatically.