STEP 9. Configuring IBM ADDI Batch Server

About this task

Before running IBM® ADDI Batch Server, some preliminary configurations must be performed. You need to specify on which projects you want IBM ADDI Batch Server to run the reports, which reports to generate, where to store the generated reports, and so on. Also, you need to specify the parameters for IBM ADDI Web Service.

The configuration parameters are stored in server.properties and project.properties files, which can be found in the configuration folder.

Below are the instructions on how to perform a minimal configuration in order to have source code analysis in IBM ADDI Analyze Client. For detailed instructions on how to configure IBM ADDI Batch Server, see Step 9.1 Advanced Configurations for IBM ADDI Batch Server.

Procedure

Access Start Menu > IBM Application Discovery and Delivery Intelligence > Launch IBM Application Discovery Configuration Service Admin, and go to Configure > Environments > "Your environment" > Servers > Graph Database Server. The Graph Database Server settings page is displayed.
1. During the installation process through IBM ADDI Configuration Wizard, the password for GraphDB Server's root user was set. If necessary, set a new password and confirm it.
2. Click Save.
In the context of Graph Database, OrientDB SSL can be configured as follows:

Note: For more information about OrientDB SSL configuration, see Using SSL with OrientDB.
1. Before you begin, make sure to complete the instructions on the following page: Prepare files for enabling secure communication
2. Copy the path to the keystore file that was uploaded to the ADDI Configuration Service Admin, for example, <IBM ADDI Installation Folder>\security\<environment-id>\server_keystore.p12.
3. Go to <IBM ADDI Installation Folder>\IBM Application Discovery Batch Server\orientdb\orientdb-community\config, open the orientdb-server-config.xml, set OrientDB SSL to true and update the password for both keystore and truststore as follows:
```
<parameter name="network.ssl.clientAuth" value="true"/> 
<parameter name="network.ssl.keyStore" value="<IBM ADDI Installation Folder>\security\<environment-id>\server_keystore.p12"/>
<parameter name="network.ssl.keyStorePassword" value="password"/>
<parameter name="network.ssl.trustStore" value="<IBM ADDI Installation Folder>\security\<environment-id>\server_keystore.p12"/>
<parameter name="network.ssl.trustStorePassword" value="password"/>
```
  Note: You can enter an encrypted Keystore Password. For more information, see Obtaining an encrypted keystore password.
4. In the listeners section of the orientdb-server-config.xml file, update the first line that includes the socket and the default port range for OrientDB SSL as follows:
```
<listener protocol="binary" socket="ssl" port-range="2424" ip-address="0.0.0.0"/>
```
5. Open the <IBM ADDI Installation Folder>\IBM Application Discovery Batch Server\orientdb\orientdb-community\config\jvmargs.txt file, paste the following parameters in one single line and fill in the location and password of your keystore file:
```
-Dclient.ssl.enabled=true -Djavax.net.ssl.keyStore="<IBM ADDI Installation Folder>\security\<environment-id>\server_keystore.p12" -Djavax.net.ssl.keyStorePassword="password OR encrypted password" -Djavax.net.ssl.trustStore="<IBM ADDI Installation Folder>\security\<environment-id>\server_keystore.p12" -Djavax.net.ssl.trustStorePassword="password OR encrypted password"
```
6. Open the <IBM ADDI Installation Folder>\IBM Application Discovery Batch Server\conf\jvmargs.txt file, paste the following parameters in one single line and fill in the location and password of your keystore file:
```
-DgdbImport.client.ssl.enabled=true -DgdbImport.javax.net.ssl.trustStore="<IBM ADDI Installation Folder>\security\<environment-id>\server_keystore.p12" -DgdbImport.javax.net.ssl.trustStorePassword="password OR encrypted password" -DgdbImport.javax.net.ssl.keyStore="<IBM ADDI Installation Folder>\security\<environment-id>\server_keystore.p12" -DgdbImport.javax.net.ssl.keyStorePassword="password OR encrypted password"
```
Note: At this point, OrientDB SSL is configured to run with the root username and the password that is configured above.

The project.properties file contains a set of global settings, followed by the specific settings for each type of component. The global settings specify the projects on which the IBM ADDI Batch Server will operate and which components will run on the specified projects.

Detailed information on the additional components that can be considered for this service.

Table 1. Optional Components
Component	Description
ruleBased	The Rule Based component generates reports for the resources specified in the configuration files according to the rules and parameters defined in the corresponding configuration files. Note: If the Rule Based component is used, make sure that the ruleBased.properties file is configured. For more information, go to ruleBased.properties File.
reports	The Reports component is used to generate the complexity reports. For more information, go to Complexity Reports.
cobolPP	The cobolPP, jclPP, and pl1PP components generate the expanded sources for COBOL, JCL, and PL/I. For more information, go to View Expanded Source.
jclPP
pl1PP

What to do next

Restart Graph Database Server.
- Under Windows: Once the configuration is done, go to the Dashboard tab, in IBM ADDI Configuration Server, click the menu button of Graph Database Server, and select Restart Service.
  Note: Wait until the service is restarted, this can take a few minutes to complete.
Restart Batch Server Service.
- Under Windows: Once the configuration is done, go to the Dashboard tab, in IBM ADDI Configuration Server, click the menu button of Batch Server Service, and select Restart Service.
  Note: Wait until the service is restarted, this can take a few minutes to complete.

Note: Make sure to restart IBM ADDI Batch Server after modifying the configuration files.

Important: For monitoring the IBM ADDI Batch Server tasks, see Checking the log files of components.