Installing Ondemand Batch Instance

Install $BXM_HOME/batch/batchServiceEndpoint on the WAS by selecting one of the two methods below.

Create a symbolic link

This guide proceeds under the assumption that the configuration is done with a symbolic link.
```
ln -s $BXM_HOME/batch/batchServiceEndpoint $BXM_HOME/../tomcat9_batch/webapps/batchServiceEndpoint
```
Or copy $BXM_HOME/batch/batchServiceEndpoint

If you copied it, you must modify the configuration paths defined in the guide to the copied paths.
```
cp -R $BXM_HOME/batch/batchServiceEndpoint $BXM_HOME/../tomcat9_batch/webapps/batchServiceEndpoint
```

Ondemand batch instance environment file list
File name	File location	Remarks
web.xml	batchServiceEndpoint/WEB-INF/	Web context configuration file
bxm-ondemand-batch.xml	batchServiceEndpoint/WEB-INF/classes	BXM ondemand batch instance configuration file
logback.xml		Logback configuration file (used by BXM)
commons-logging.properties		Commons Logging configuration file (used by Spring)
JobConfig.xml		Batch Job common configuration file
datasource.properties		Batch DB connection configuration
logLayer.properties		File for configuring system, DB, and job log level

Ondemand batch instance configuration
1. Open $BXM_HOME/batch/batchServiceEndpoint/WEB-INF/classes/logback.xml.
2. Find the property item below and change BXM_HOME to the BXM installation directory. For log levels, it is recommended to use debug in development and info in production.
  ... <property name="LOGS_ABSOLUTE_PATH" value="<<BXM HOME>>/bxm/logs" /> ...
3. Open $BXM_HOME/batch/batchServiceEndpoint/WEB-INF/classes/bxm-ondemand-batch/xml.
4. Find the environment item and change jdbc-datasource and application-home. At this time, set BXM HOME to the path where BXM is installed.
  ... <environment> <datasource> <jdbc-datasource driver-classname="oracle.jdbc.OracleDriver" uri="<<DB JDBC URL>>" username="bxmv5" password="<<encrypted DB PASSWORD>>" validationQuery="select 1 from dual" validationQueryTimeout="30" maxTotal="50"/> </datasource> <loader mode="cold" autodeploy="false" lazy-init="true" nouse-snapshot="false" registry="off"> <application-home><<BXM HOME>>/apps/batch</application-home> </loader> </environment> ...
5. Find the on-demand-batch item and modify BXM_HOME to the path where BXM is installed.
  ... <on-demand-batch init-workers="10" max-workers="50" worker-wait-timeout="2000" logging-home="<<BXM HOME>>/logs/batch"/> ...
6. Open $BXM_HOME/batch/batchServiceEndpoint/WEB-INF/classes/datasource.properties. (The configuration method is the same as for normal batch.)
7. Configure the datasource to be used by the application when executing batch. Configure datasource.properties based on the assumption that jdbc dataSource is configured in bxm-application.xml as shown below.
  
  bxm-application.xml jdbc datasource configuration
  image::batch-jdbc-datasource-conf.png[]
  
  At this time, modify the parts enclosed with <<…>> such as url, password, etc. to match the user environment.
  driver-classname=oracle.jdbc.OracleDriver uri=<<DB JDBC URL>> username=bxmv5 password=<<encrypted bxm account password>>