uCosminexus Application Server, Maintenance and Migration Guide
Use the following procedure to migrate the environment:
Unset up the out-process transaction service by executing the command for setting up the out process transaction service.
The command to be used differs depending on the timing of executing the command for setting up the out-process transaction service.
Execution of setup command is not required in the in-process transaction service. Furthermore, in the in-process transaction service, the system environment definition is customized using the user property file of the J2EE server, however, in the out-process transaction service the system environment definition is customized using the tsdefvalue command. The following table describes the J2EE server property required to be set in the in-process transaction service.
Table 11-1 J2EE server property required to be set in the in-process transaction service
Key name | Value | Estimated guidelines |
---|---|---|
ejbserver.distributedtx.enableXidReuseOptimization | false | -- |
ejbserver.distributedtx.ots.status.directory1 | Directory to store the status file of the in-process transaction service. | You must operate such that the partition of the specified path does not deplete. Furthermore, in out-process transaction service, environment variable TPFS is customized and deployed on the shared disk. When operation is executed by the HA configuration, you must set the path of the shared disk. |
ejbserver.distributedtx.ots.status.directory2# |
For details on the keys, see 2.4 usrconf.properties (User property file of J2EE server) in the uCosminexus Application Server Definition Reference Guide.
In the in-process transaction service and the out-process transaction service the environment variable where the settings are required are different. Delete the unnecessary environment variable. The following table describes the setting requirements of the environment variable of the transaction service. For details on the settings of the environment variables, see the following manuals:
Table 11-2 Setting requirement of the environment variable of the transaction service
Environment variable name | Specified contents | Setting requirement | |
---|---|---|---|
In case of out-process transaction service | In case of in-process transaction service | ||
OSAGENT_PORT | Port number used by the Smart Agent | B | --#1 |
PATH | Program execution path | A | A |
LIBPATH,or LD_LIBRARY_PATH#2 | Library search path | A | A |
TPDIR | Installation destination of Cosminexus TPBroker | A | A |
TZ | Time zone | A | A |
VBROKER_ADM | Directory where the definition information of the Smart Agent is stored | A | A |
TPFS | Storage destination of the status file of Cosminexus TPBroker (any directory or character device file) |
B | -- |
TPSPOOL | Save destination of Cosminexus TPBroker operating information (any directory) |
B | -- |
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.