Configuring the Batch Activity Dashboard runtime environment

Before you can begin using the Batch Activity Dashboard application, you must first configure the runtime environment variables.

1. Open a browser and navigate to http://<host>:<port>/ProcessAdmin.
   Replace <host> and <port> with the specific host and port used by your installation of the Process Admin Console.
2. At the login page, provide your administration user name and password, then click Login.
3. From the main Process Admin Console menu, click Installed Apps, then click All to show all process applications.
4. Click on the snapshot for the imported Batch Activity Dashboard application, then click Environment Vars.
   The Batch Activity Dashboard environment variables appear.
5. Type the appropriate values for each environment variable:
   1. For batch_home, type the home path of the batch processor, such as /usr/IBM/MDM/BatchProcessor.
   2. For batch_instance, type the name of the batch processor instance, such as batch02.
      Note: The batch_home and batch_instance variables enable the Batch Activity Dashboard to start the MDM batch processor directly. This batch instance must reside at the same location where the BPM server is installed.
      Note: The batch_instance variable must match the value of the instance_name property in the Batch.properties file of the batch instance specified by batch_home. Otherwise, the Batch Activity Dashboard may incorrectly disable the Process Now button.
   3. For mdm_server_password, type the password used to access InfoSphere® MDM.
      Tip: To prevent the password from being shown in clear text, you can use WebSphere® Application Server to encode the password in a file:

      1. Create a text file called batchuser.txt.
      2. Edit batchuser.txt to add the line mdm_server_password=<user-password>.
      3. Run the following command to encode the password value:
         • For Windows systems:

           $NODE_HOME\bin\PropFilePasswordEncoder.bat <path>\batchuser.txt mdm_server_password

         • For UNIX or Linux® systems:

           $NODE_HOME/bin/PropFilePasswordEncoder.sh <path>/batchuser.txt mdm_server_password

           $NODE_HOME represents the home folder of the WebSphere Application Server node. <path> represents the directory location of the batchuser.txt file.
      4. Open the batchuser.txt and copy the encoded password value to the Batch Activity Dashboard environment variable mdm_server_password.
   4. For mdm_server_url, type the URL of the InfoSphere MDM instance, following the format https:/<mdm-server-host>:<mdm-WC_defaulthost_secure>/MDMWSProvider/MDMService.
      Attention: For security reasons, use HTTPS protocol instead of HTTP protocol when specifying the URL. When HTTPS is used, the BPM server must be configured to trust the back end InfoSphere MDM operational server. For more information, see Securing communication between the Batch Activity Dashboard and the server.
   5. For mdm_server_user, type the user name used to access InfoSphere MDM.
   6. For pme_match_engine, type true if InfoSphere MDM uses the Probabilistic Matching Engine (PME); otherwise, type false.
6. To apply your configuration changes, you must deactivate and then reactivate the Batch Activity Dashboard application.
   Note: For more information, see Activating and deactivating the Batch Activity Dashboard application.