uCosminexus Service Platform, Basic Development Guide
7.6.2 How to stop HCSC components and delete them from the HCSC server
(1) Prerequisites
To stop HCSC components and delete them from the HCSC server, the following conditions must be fulfilled:
- Perform the operation only during the system development or from the time of performing unit testing to integration testing.
- Build the development environment, operating environment, and execution environment on the same machine. If these environments are set up in 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) Stopping the selected HCSC components and deleting them from the HCSC server
- From the service definition list in the tree view, stop HCSC components and select the HCSC components to be deleted from the HCSC server.
- Right-click the selected HCSC components, and choose Stop and Delete from the Server.
When the 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 the batch execution is performed for the second time and thereafter, the processing will start immediately.
- When a dialog box reporting the completion of processing appears, click the OK button.
- Check the following as needed:
- Check if the deployment definition has been deleted
- In the system configuration definition list of the tree view, make sure that the selected HCSC components have been deleted.
- In the above example, you can confirm that the selected business process (BP1) has been deleted.
- Check that the HCSC components are stopped and deleted from the HCSC server
- Log into the HCSC-Manager, and select the HCSC-Manager view. Make sure that the selected HCSC components are stopped, and then deleted from the HCSC server. 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 that the selected business process (BP1) and the user-defined reception (Reception1) defined in the selected business process have been stopped, and then deleted.
(b) Stopping all the HCSC components and deleting them from the HCSC server
- Right-click the service definition list in the tree view, and choose Stop All Services and Delete from the Server.
When the 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 the batch execution is performed for the second time and thereafter, the processing will start immediately.
- When a dialog box reporting the completion of processing appears, click the OK button.
- Check the following as needed:
- Check that the deployment definition has been deleted
- In the system configuration definition list of the tree view, make sure that all the HCSC components have been deleted.
- In the above example, you can confirm that all the HCSC components (BP1, WebService1, and WebService2) have been deleted.
- Check that the HCSC components are stopped and deleted from the HCSC server
- Log into the HCSC-Manager, and select the HCSC-Manager view. Make sure that all the HCSC components are stopped, and then deleted from the HCSC server. 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 that all the HCSC components (BP1, WebService1, WebService2, and Reception1) have been stopped and deleted.
(3) Precautions
The precautions to be taken when stopping HCSC components and deleting from the HCSC server are as follows:
- When stopping the selected HCSC components and deleting from the HCSC server, 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, stop all the HCSC components, and delete them from the HCSC server.
- 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, stop all the HCSC components and delete them from the HCSC server.
- 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 then re-execute the processing.
- If a batch execution of the process for stopping and deleting the HCSC components from 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, delete the HCSC components 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.