uCosminexus Service Platform, Basic Development Guide
7.5.2 How to deploy HCSC components in the HCSC server and start them
(1) Prerequisites
To deploy the HCSC components in the HCSC server and then start them, you must fulfill the following conditions:
- Perform the operation only during the system development or from the time of performing unit testing to the integration testing.
- Build the development environment, operating environment, and execution environment on the same machine. If these environments are set up on multiple machines, the operation cannot be guaranteed.
- The setup of the HCSC server must be complete. Set up only a single HCSC server. Even when you use the HCSC Easy Setup functionality, set up only a single HCSC server.
- The HCSC server and database must be running.
(2) Operation procedure
(a) Deploying the selected HCSC components on the HCSC server and starting them
- From the service definition list in the tree view, select the HCSC components to be deployed on the HCSC server.
- Right-click the selected HCSC components, and choose Deploy on the server and start.
The displayed dialog box and the procedure thereafter will differ depending on whether the HCSC components to be operated are being edited.
- When the HCSC components to be operated are being edited
- A dialog box confirming whether to save the HCSC components being edited (private) will be displayed. If multiple services and user-defined receptions are being edited, multiple dialog boxes will be displayed. Click the Yes button to save. Click the Yes to all button to save thereafter without displaying the confirmation dialog box. If you do not want to save HCSC components, click the Cancel button and end the process.
- Proceed to step 3.
- When HCSC components to be operated are not being edited
- When batch execution is first performed after starting Eclipse, the Account Authentication dialog box is displayed. When the user ID and password are entered, and then the OK button is clicked, the processing will start. When batch execution is performed for the second time and thereafter after starting Eclipse, the processing will start immediately.
- Proceed to step 4.
- Click the Yes button or click the Yes to all button.
When batch execution is first performed after starting Eclipse, the Account Authentication dialog box is displayed. When the user ID and password are entered and then the OK button is clicked, the processing will start. When batch execution is performed for the second time and thereafter after starting Eclipse, the processing will start immediately.
The processing will differ as follows depending on whether deployment is defined (public) for the HCSC components being edited or deployment is not defined (private):
- When deployment is defined for the HCSC components
- Set HCSC components for which deployment is defined to a state in which deployment is not defined. After that, save the edited HCSC components and start the processing.
- When deployment is not defined for HCSC components
- Save the HCSC components being edited and start the processing.
- When a dialog box notifying the completion of processing appears, click the OK button.
- Check the following as needed:
- Check if deployment is defined
- In the system configuration definition list of the tree view, make sure that the selected HCSC components are added.
- In the above example, you can confirm if the selected business process (BP1) and the service adapter (WebService1) defined in the selected business process are added.
- Check if the HCSC components are deployed on the HCSC server and started
- Log into the HCSC-Manager, and select the HCSC-Manager view. Make sure that the selected HCSC components are deployed on the HCSC server and started. For details about how to log in to the HCSC-Manager, see the manual Cosminexus Service Platform System Setup and Operation Guide.
- In the above example, you can confirm if the selected business process (BP1) and the service adapter (WebService1) and user-defined reception (Reception1) defined in the selected business process are added.
(b) Deploying all HCSC components on the HCSC server and starting them
- Right-click the service definition list in the tree view, and choose Deploy all the services on the server and start.
- When the HCSC components to be operated are being edited
- A dialog box, confirming whether to save the HCSC components being edited (private), will be displayed. If multiple services and user-defined receptions are being edited, multiple dialog boxes will be displayed. Click the Yes button to save. Click the Yes to all button to save thereafter without displaying the confirmation dialog box. If you do not want to save HCSC components, click the Cancel button and end the process.
- Proceed to step 3.
- When the HCSC components to be operated are not being edited
- When batch execution is first performed after starting Eclipse, the Account Authentication dialog box is displayed. When the user ID and password are entered and then the OK button is clicked, the processing will start. After starting Eclipse, when batch execution is performed for the second time and thereafter, the processing will start immediately.
- Proceed to step 4.
- Click the Yes button or click the Yes to all button.
When batch execution is first performed after starting Eclipse, the Account Authentication dialog box is displayed. When the user ID and password are entered and then the OK button is clicked, the processing will start. After starting Eclipse, when batch execution is performed for the second time and thereafter, the processing will start immediately.
The processing will differ as follows depending on whether deployment is defined (public) for the HCSC components being edited or deployment is not defined (private):
- When deployment is defined for the HCSC components
- Set the HCSC components for which deployment is defined to a state in which deployment is not defined. After that, save the edited HCSC components and start the processing.
- When deployment is not defined for the HCSC components
- Save the HCSC components being edited and start the processing.
- When a dialog box notifying the completion of processing appears, click the OK button.
- Check the following as needed:
- Check if deployment is defined
- In the system configuration definition list of the tree view, make sure that all the HCSC components defined in the development environment are added.
- In the above example, you can confirm that all the HCSC components (BP1, WebService1, and WebService2) defined in the development environment are added.
- Check if the HCSC components are deployed on the HCSC server and started
- Log into the HCSC-Manager, and select the HCSC-Manager view. Make sure that all the HCSC components defined in the development environment are deployed on the HCSC server and started. For details about how to log in to the HCSC-Manager, see the manual Cosminexus Service Platform System Setup and Operation Guide.
- In the above example, you can confirm if all the HCSC components (BP1, WebService1, WebService2, and Reception1) defined in the development environment are added.
(3) Precautions
The following are the precautions to be taken when deploying the HCSC components on the HCSC server and then starting them:
- When deploying the selected HCSC components on the HCSC server and then starting them, if the configuration information of the HCSC server specified in the repository information of the operating environment and the development environment is wrong, this will result in an error in the following cases. In such case, deploy all the defined HCSC components on the HCSC server and then start them.
A configuration format of the repository (combination of database and Cosminexus RM) do not match in the development and operating environment.
The service deployed in the repository of the operating environment is updated or deleted in the development environment.
A SOAP mode in the repository of the development and operating environment do not match.
If an error occurs, deploy all the defined HCSC components on the HCSC server and start them.
- If an error occurs during the processing, interrupt the processing and terminate the batch execution. However, the processes, for which the batch execution had finished before the occurrence of the error, will not return to the status prior to the execution. In such a case, remove the cause of the error, and re-execute the processing.
- When batch execution is to be performed for multiple HCSC components after revising them, deploy all the HCSC components on the HCSC server and start them. However, if the revised HCSC components are included in the reference range of 7.5.1(2) HCSC components to be operated, the selected HCSC components can be deployed on the HCSC server and started.
- If a batch execution of the process for deploying and starting the HCSC components on the HCSC server fails, you might not be able to start the service and re-execute until the HCSC component stops. If the process fails, stop the HCSC components by executing in the order of the csccompostop -all and csccompoundeploy -all command and undeploy them. After this, redeploy and restart the HCSC components on the HCSC server. Note that you cannot stop HCSC components by the method described in 7.6 Batch execution of processes for stopping HCSC components and deleting them from the HCSC server.
For details about the csccompostop and csccompoundeploy command, see the manual Cosminexus Service Platform Reference.
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.