Batch processes can be started manually or automatically. This section will describe what configuration is required for each case.
This assumes the directory configuration to define the batch process account has been completed.
For automatic startup (via the scheduler or the server scripts), the batch process requires to be setup for automatic start, so it can be launched by the FWD server.
Auto-Start of a Batch Process.¶
Automatic start of a batch process at server launch is done via the Scheduler. An example how to schedule it:
<node class="container" name="scheduler"> <node class="job" name="start_appserver"> <node-attribute name="type" value="process"/> <node-attribute name="target" value="batch_process_name"/> <node-attribute name="enabled" value="TRUE"/> <node-attribute name="mode" value="now"/> </node> </node>
batch_process_name with the name of the FWD process account
The above example will start the batch process automatically after the FWD server has started, once. Change the
now value for the
mode attribute to
RECURRING, if you want this program to run at different times.
Launching a Batch Process via the Server Startup Script.¶
The demo Hotel applications like Hotel GUI have
server.cmd scripts, which accept a
-b batch_process_name argument, to let the FWD server start a batch program automatically.
You can simply execute
./server.sh -b batch_process_name and the FWD server will launch the FWD client for this batch process automatically.
To see the exact Java command used to to this, run
./server.sh -t -b batch_process_name, which will be something like:
java ... com.goldencode.p2j.main.ServerDriver -b batch_process_name server.xml net:connection:secure=true net:server:secure_port=3333 net:server:insecure_port=3433
Manual Launch of the Batch Process¶
To launch the batch process manually, this will require to have the private key and certificate in an external store, plus the server and root CA certificate in a different store. For example:
srv-certs.storewill hold the root CA certificate and the FWD server certificate
batch_process_name.storewill hold the certificate and private key for the
This configuration can be kept separately in a
deploy/batch/ folder, with sub-folders for each process. This subfolder, like
deploy/batch/batch_process_name, will always have:
client.xmlfile which will hold the configuration for the batch process which will be launched
The structure of the
client.xml follows the bootstrap configuration, from the
For example, the structure can be:
<?xml version="1.0"?> <node type="client"> <client> <mode batch="true" /> <driver background="true" /> <cmd-line-option startup-procedure="batch_program_to_start.p"/> </client> <security> <truststore filename="srv-certs.store" /> <truststore alias="standard" /> <keystore filename="batch_process_name.store" /> <keystore processalias="batch_process_name" /> </security> <access> <password truststore="[password-truststore]" /> <password keystore="[password-keystore]" /> <password keyentry="[password-keyentry]"/> </access> </node>
Where you will need to customize:
batch_program_to_start.p, with the converted legacy program to run
srv-certs.store, with the name of the trust store holding the root CA and server certificate
standard, with the certificate alias for the FWD server
batch_process_name.store, with the name of the store holding the certificate and private key for the batch process alias.
processalias, with the certificate alias for the batch process account.
truststore, with the password for the trust-store (
keystore, with the password for the process certificate store (
keyentry, with the password for the private key inside the keystore (
Once this are configured, the batch process can be started by copying the
client.cmd script and executing it as if you want to start a normal FWD client.
In short, the command to launch it (from within the same folder where the stores and
client.xml exists, this assumes
deploy/batch/batch_process_name), will be:
java -XX:+HeapDumpOnOutOfMemoryError -Djava.library.path=../../lib/ -classpath ../../lib/p2j.jar com.goldencode.p2j.main.ClientDriver net:server:host=localhost net:connection:secure=false net:server:secure_port=3333 net:server:insecure_port=3433 ./client.xml
No special directory configuration is required to launch the batch process in this manual mode.
© 2004-2021 Golden Code Development Corporation. ALL RIGHTS RESERVED.