RSM cluster configurations and queue definitions (.rsmcc and .rsmq files) are the key to successful cluster job submission, as they contain vital information about the cluster and how files will be handled.
In order for users to be able to submit jobs to a cluster, they must have access to the cluster configurations that you have defined. To accomplish this, there are two approaches that you can take:
If you are an administrator who has defined cluster configurations for multiple people to use, you can make the cluster configurations accessible to users by making the cluster configuration directory a shared directory. This method ensures that all users have the most accurate and up-to-date cluster configuration information, as files are centrally stored and managed.
If you changed the cluster configuration directory to a share-friendly folder before creating cluster configurations (as described in Setting the Cluster Configuration Directory), you can go ahead and share that folder. Make sure that the folder has read-only permission to prevent others from modifying your cluster configurations.
If you did not change the cluster configuration directory before creating cluster configurations, your cluster configurations are located in the default cluster configuration directory, which is a user-specific directory that is not suitable for sharing.
In this case, follow these steps:
Copy the .rsmcc and .rsmq files from the default cluster configuration directory to a new folder
that is not associated with a user account (for example,
C:\some\folder).
Use the RSM Utilities application to set the JobManagement
ConfigurationDirectory setting to the new folder. See Changing the Cluster Configuration Directory.
Set read-only permission on the new folder to prevent others from modifying the configurations.
Share the folder.
To identify the location of your cluster configuration directory, see Querying the Location of the Cluster Configuration Directory.
Once the cluster configuration directory has been shared, Workbench client users should set
the cluster configuration directory on their local machines to the path of the shared cluster
configuration directory. For example, the share path might be something like
\\machineName\Share\RSM for Windows users, or
/clusternodemount/share/RSM for Linux users. For details, see Changing the Cluster Configuration Directory.
Note: One potential drawback of this method is that users may not be able to access to the shared
cluster configurations if the host goes offline or cannot be accessed for some reason (for
example, if a user is working off-site and does not have access to the network). In this case
RSM will automatically switch the cluster configuration directory back to the default cluster configuration directory on their local
machines. This means that users will, at a minimum, be able to submit jobs to ARC clusters
already installed on their local machines using the localhost cluster
configuration that is generated in the default cluster configuration directory when RSM is
installed.
If you are a user looking to access cluster configurations that have been defined by your RSM or cluster administrator, you can do so by setting your cluster configuration directory to the shared cluster configuration directory that was set by the administrator (see Method 1 above). Alternatively you can copy the cluster configuration database to the appropriate directory on your machine.
As a user, you will need to:
Obtain the cluster configuration files (.rsmcc and .rsmq files) from the RSM or cluster administrator. If the administrator has put the files in a shared directory that you can access, you can retrieve them directly from there.
On your local machine, copy the files into your cluster configuration directory. For information about the location of this directory, see Setting the Cluster Configuration Directory.
Note: If any of the shared files that you are copying have the same name as files in your local cluster configuration directory, you will need to rename your local files if you do not want them to be overwritten. For example, you may want to rename your localhost.rsmcc file to mylocalhost.rsmcc to distinguish it from the remote cluster's localhost.rsmcc file, as its settings may be different.
Alternatively, to avoid this issue altogether:
Create a new folder on your local machine (for example,
C:\SharedRSMConfig).
Copy the cluster configurations from the network share to that folder.
Use the RSM Utilities application to set the JobManagement
ConfigurationDirectory setting to the new folder. See Changing the Cluster Configuration Directory.