4.9.3 Considering the system re-setup procedures
This subsection gives examples of the system re-setup procedures to be written in the System Setup Procedure document. When preparing a System Setup Procedure document, refer to these sample procedures.
To perform a re-setup of a secure system, Smart Composer functionality commands and server management commands are used. In addition, commands that create an audit log entry should be used for all operations. When adding an operation other than those described here to the work procedure document, use commands that create audit log entries. For details about commands that create audit log entries, see Chapter 6 in the uCosminexus Application Server Operation, Monitoring, and Linkage Guide.
Note that all procedures described in this subsection are to be performed by the System administrator.
- Organization of this subsection
(1) Replacing a J2EE application
If maintenance of a J2EE application becomes necessary, the System administrator should replace the application. The procedure for replacing a J2EE application is as follows:
-
Use the cmx_stop_target command to set the service unit within the Web system to a ready state.
-
Use the cjstopapp command to stop the J2EE application to be replaced.
-
Use the cjdeleteapp command to delete the J2EE application to be replaced.
-
Use the cjimportapp command to import the replacement J2EE application.
-
Use the cjgetappprop command to obtain the integrated property file for the replacement J2EE application.
-
Edit the integrated property file obtained in step 5 and configure the settings necessary for the J2EE application. Customize the J2EE application if necessary.
-
Use the cjsetappprop command to incorporate the integrated property file edited in step 6 into the replaced J2EE application.
-
Use the cjstartapp command to start the replacement J2EE application.
-
Use the cmx_start_target command to set the service unit within the Web system to a running state.
In addition to this method, a J2EE application can also be replaced by using the cjreplaceapp command or the Redeploy function, or by using the cjreloadapp command or the Reload function.
(2) Tuning the system
The System administrator should tune the system if necessary. The procedure for tuning the system is as follows:
-
Edit the Easy Setup definition file.
-
Use the cmx_stop_target command to stop the service unit within the Web system.
-
Use the cmx_build_system command to reconfigure the Web system settings.
-
Use the cmx_start_target command to start the service unit within the Web system.
(3) Reconfiguring the system (by adding a service unit)
If necessary, the System administrator should reconfigure the system by adding a service unit. The procedure for reconfiguring the system by adding a service unit is as follows:
-
Create and edit a reconfiguration definition file.
-
Use the cmx_change_model command to change the information model of the Web system on Management Server.
-
Use the cmx_build_system command to apply the changed information model of the Web system.
-
Use the cmx_start_target command to set the added service unit within the Web system to a ready state.
-
Use the cjstartrar command to start the resource adapter.
-
Use the cjstartapp command to start the J2EE application.
-
Use the cmx_start_target command to set the added service unit within the Web system to a running state.
(4) Reconfiguring the system (by removing a service unit)
If necessary, the System administrator should reconfigure the system by deleting a service unit. The procedure for reconfiguring the system by removing a service unit is as follows:
-
Use the cmx_stop_target command to stop the service unit within the Web system to be removed.
-
Use the cmx_delete_system command to remove the service unit within the Web system specified in step 1.