Configuring Liberty for the batch REST API

WebSphere® Application Server Liberty includes a RESTful management interface to manage your Java batch jobs. Managed batch enables a secure HTTPS REST interface so that you can externally manage your Java batch jobs.

1. Add the batchManagement-1.0 feature to your server.xml file.

   <featureManager>
   	<feature>batchManagement-1.0</feature>
   </featureManager>

2. Configure batch persistence by configuring the databaseStore used by the Java batch feature. Reference the databaseStore in the server.xml file by using the jobStoreRef element.
   The following example illustrates what your server.xml file should look like.

   <batchPersistence jobStoreRef="BatchDatabaseStore" />
   
   <databaseStore id="BatchDatabaseStore" dataSourceRef="batchDB" />

   For more information on database persistence, including auto-creation versus manual creation of tables, see Java batch persistence configuration.

3. Create an SSL certificate and user registry in your server.xml file, so that batchManagement-1.0 automatically enables the SSL feature.

   <keyStore id="defaultKeyStore" password="Liberty"/>
   			
   <basicRegistry id="basic" realm="ibm/api">
   	<user name="bob" password="bobpwd" />
   	<user name="jane" password="janepwd" />
   </basicRegistry>
   

   Important: The default self-signed SSL certificate in this example is intended only for development use and not for production.

   For information on configuring role-based management of the batch environment and assigning users to roles, see Securing the Liberty batch environment.