Prerequisite steps to create OSLC Automation and OSLC Provisioning jobs

How to define a new OSLC Automation and OSLC Provisioning job definition by using the Dynamic Workload Console.

About this task

To create an OSLC Automation or OSLC Provisioning job definition, you must first complete the prerequisite steps listed hereafter.

For more information about creating OSLC Automation and OSLC Provisioning job definitions, see the sections about Job definition - OSLC Provisioning and OSLC Automation jobs, in the HCL Workload Automation User's Guide and Reference.

Note: Before performing the following procedure, ensure that you installed the Jazz for Service Management Registry Services from the Installation Manager.

Procedure

Obtain the Registry Services server certificate and save it in a directory that you will later use. Registry Services administrator can provide the certificate, or, with Firefox browser, for example, you can retrieve the certificate performing the following steps:
1. Log in to a Registry Services (for example, https://hostname:16311/oslc/pr)
2. Download the certificate by clicking in the browser toolbar: Tools>Options>Advanced>Encryption>View Certificates
3. Select HCL>Registry_Services_hostname:port and click Export. A file is created with the name that you specify, for example myserver:16311.
Browse to the directory where a JRE is installed, for example: C:\Program Files\HCL\TWA_<TWS_user>\TWS\JavaExt\jre\jre\bin
Create a new truststore by launching the following command: keytool -genkeypair -alias certificatekey -keyalg RSA -validity 7 -keystore trustore_directory\keystore.jks
Note: Ensure that the trustore_directory is not created in the javaExt\JRE path.
Add the HCL Registry Services certificate to the truststore by launching the following command: keytool -import -file certificate_directory\certificate_name -alias oslc -keystore trustore_directory\keystore.jks
Open the TWA_HOME\TWS\ITA\cpa\config\JobManager.ini file, and locate JavaJobLauncher section, JVMOptions row.
Add the following instructions to the row: "-Djavax.net.ssl.trustStore=DIRECTORY_TRUSTSTORE/keystore.jks -Djavax.net.ssl.trustStorePassword=TRUSTSTORE_PASSWORD". For example:
```
JVMOptions = -Djavax.net.ssl.trustStore=C:/myUtils/keystore.jks
-Djavax.net.ssl.trustStorePassword=passw0rd
```
Stop and restart the agent.
Create the OSLCAutomation.properties and OSLCProvisioning.properties files, respectively for the OSLC Automation and OSLC Provisioning jobs, and locate them in <TWA_Home>/TWS/JavaExt/cfg/.
Specify the service provider catalogs (or Registry Services) that you will later use to create the job in the following format:
```
ServiceProviderCatalogName=RegistryServicesURI
```
On the master domain manager, extract the security certificate from the keystore and add it to the Jazz for Service Management truststore. The file paths and names are as follows:
Master domain manager keystore

<TWA_Home>/WAS/TWSProfile/etc/TWSServerKeyFile.jks

Jazz for Service Management truststore

<JazzSM_Home>/profile/config/cells/JazzSMNode01Cell/nodes/JazzSMNode01Cell/trust.p12
On the workstation where you installed Jazz for Service Management, extract the security certificate from the keystore and add it to the master domain manager truststore. The file paths and names are as follows:
Jazz for Service Management keystore

<JazzSM_Home>/profile/config/cells/JazzSMNode01Cell/nodes/JazzSMNode01Cell/key.p12

Master domain manager truststore

<TWA_Home>/WAS/TWSProfile/etc/TWSServerTrustFile.jks
Close and restart the WebSphere Application Server on the master domain manager and on Jazz for Service Management.