Once EnginFrame has been installed and started, you must execute the steps below to configure EKM to connect with EnginFrame.
Stop the EKM server.
During the EnginFrame installation we created ekmServer.domainname.com.client.keystore and ekmServer.domainname.com.client.truststore certificate files for each EKM cluster node (for example, in the /opt/nice/enginframe/tools folder). Copy the ekmServer.domainname.com.client.keystore and ekmServer.domainname.com.client.truststore files of each EKM server to the EKM_HOME/conf folder of that server.
Configure JBoss to use the certificate files by modifying the bin/ekm_start.(cmd|sh) control script. These instructions are already present but commented out in the script. You will need to uncomment these instructions and change the certificate file names and password. The password is the one that was used for creating certificate files.
If you are running EKM as a service on Windows, these instructions are present in the wrapper.conf file as shown below:
#wrapper.app.parameter.27=-Djavax.net.ssl.keyStore=${EKM_HOME}/conf/
ekmServer.domainname.com.client.keystore
#wrapper.app.parameter.28=-Djavax.net.ssl.keyStorePassword=ekmansys
#wrapper.app.parameter.29=-Djavax.net.ssl.trustStore=${EKM_HOME}/conf/
ekmServer.domainname.com.client.truststore
#wrapper.app.parameter.30=-Djavax.net.ssl.trustStorePassword=ekmansysIf you are running EKM in console mode on Windows, these instructions are present in the ekm_start.cmd control script as shown below:
rem set JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.keyStore="%EKM_HOME%\conf\ ekmServer.domainname.com.client.keystore" rem set JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.keyStorePassword=ekmansys rem set JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.trustStore="%EKM_HOME%\conf\ ekmServer.domainname.com.client.truststore" rem set JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.trustStorePassword=ekmansys
If you are running EKM on Linux, these instructions are present in the ekm_start.sh control script as shown below:
#JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.keyStore=$EKM_HOME/conf/ ekmServer.domainname.com.client.keystore" #JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.keyStorePassword=ekmansys" #JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.trustStore=$EKM_HOME/conf/ ekmServer.domainname.com.client.trustStore" #JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.trustStorePassword=ekmansys"
Edit the ekm.xml file and define
the <enginframe> settings in the <remoteProcess> section. A template that is commented
out is provided for your convenience. You can uncomment this template
and modify it as needed. The supplied template definition is shown
below:
<enginframe>
<serviceDefinitionFile>https://<enginframe-server-name>:8443/enginframe/demo/showcase/showcase.xml
</serviceDefinitionFile>
<adminUser>efadmin</adminUser>
<queue>
<name>Windows Remote Viz Queue</name>
<os>windows</os>
<scheduler>neutro</scheduler>
<schedulerQueue></schedulerQueue>
<remoteType>dcv</remoteType>
</queue>
<queue>
<name>Linux Remote Viz Queue</name>
<os>linux</os>
<scheduler>lsf</scheduler>
<schedulerQueue></schedulerQueue>
<remoteType>dcv</remoteType>
</queue>
</enginframe>Below is a description of the settings that you need to specify:
serviceDefinitionFile: Replace the
<enginframe-server-name> with the Fully Qualified Domain
Name (FQDN) of the EnginFrame server.
adminUser: The name of the
EnginFrame admin user. The default name is efadmin.
queue: There can be any number
of interactive queues defined. When the EKM server starts, these
queues will be automatically created in the /Administration/Servers/Master folder. You can specify the following settings for each queue:
name: The name of the queue
as it appears in EKM.
os: The operating system
of the visualization server. The value can be either windows or linux.
scheduler: The job scheduling
system used for creating the session. The value can be lsf, neutro, pbs, moab, or torque. The value lsf is used for the openlava
scheduler.
schedulerQueue: This is an
optional setting that can be used to specify the name of a queue on
the scheduler for creating the session.
remoteType. The remote visualization
technology used. The value can be vnc, dcv, rgs or virtualgl.
If you want to add logging for EnginFrame integration for troubleshooting purposes, you will need to edit the ekm.log4j.properties file in the JBoss configuration directory (see JBoss Domain Mode and Configuration). You will need to add the following line:
log4j.logger.com.enginframe=DEBUG, ekmStdout
Start the EKM server.
Edit the settings of each newly created interactive queue by navigating to the
/Administration/Servers/Master folder in EKM and then
right-clicking the queue and selecting > . For more information, see Editing Job Submission Queue Settings in the EKM Administration
Guide.
When an interactive queue is created, it will automatically
include a predefined application called remoteDesktop.app.xml that can be used to start a remote desktop session. You can also
create additional applications in a queue if you want a particular
application (for example, ANSYS Workbench) to launch automatically
when the remote session starts. For details on how to do this, see Defining External Applications Directly in EKM in the EKM Administration
Guide.