Hitachi

uCosminexus Service Platform Setup and Operation Guide


5.3.23 Changing the configuration of HCSC components

When the definition of the HCSC components is changed in the development environment, the changed definition is passed to the operating environment by using the repository. In the operating environment, change the configuration of HCSC components according to the definition information changed in the development environment.

This subsection describes the prerequisites and method for changing the configuration of the HCSC components:

Organization of this subsection

(1) Prerequisites

To change the configuration of HCSC components, the following conditions must be fulfilled:

(2) Changing method

The procedure for changing the configuration of HCSC components is as follows:

Note: For how to update the repository, see also 4.7 Updating the repository.

  1. Check the differences in the repository information.

    For details on how to check the differences in the repository information, see "4.5 Referencing difference information of repositories".

  2. Stop HCSC components.

    Specify the -cluster option in the csccompostop command, to stop HCSC components deployed on all HCSC servers within the cluster, in a batch.

    For details on how to stop HCSC components, see "5.3.34 Stopping the user -defined reception", "5.3.35 Terminating the Service Adapter", and "5.3.36 Terminating the Business Process".

  3. Delete HCSC components.

    Specify the -cluster option in the csccompoundeploy command, to delete HCSC components deployed on all HCSC servers within the cluster, in a batch.

    For details on how to delete HCSC components, see "3.3.1 Deleting a service adapter", "3.3.2 Deleting a business process", and "3.3.3 Deleting a user-defined reception".

  4. Import the repository.

  5. For details on how to import the repository, see "4.3 Importing a repository".

  6. Deploy HCSC components.

    Specify the -cluster option in the csccompodeploy command, to deploy the undeployed HCSC components on all HCSC servers within the cluster, in a batch.

    For details on how to deploy HCSC components, see "3.1.8 Deploying a service adapter", "3.1.13 Deploying a business process", and "3.1.14 Deploying a user-defined reception".

  7. Start HCSC components.

    Specify the -cluster option in the csccompostart command, to start HCSC components deployed on all HCSC servers within the cluster, in a batch.

    For details on how to start HCSC components, see "5.3.6 Starting Service Adapters","5.3.7 Starting Business Processes", and "5.3.8 Starting user-defined receptions".

(3) Method for adding, updating, and deleting multiple HCSC components

The procedure for adding, updating, and deleting multiple HCSC components is as follows:

First, create a list of the target HCSC components with the following procedure:

  1. Upgrade the version of new repository.

    cscrepupdate -inputfile <zip file name> -outputfile <zip file name of the output destination>
  2. Acquire the change information of the current repository and the new repository.

    Create a list of the target HCSC components with any one of the following methods:

    • Output the HCSC component-specification file by specifying the -compo option in the cscrepdiff command.

      cscrepdiff -repfile <repository zip file name> -compo -listfile <HCSC component-specification file name of the output destination>
    • Create HCSC component-specification file manually.

The procedure for adding, updating, and deleting multiple HCSC components by specifying the created HCSC component-specification file in the -namelist option is as follows:

(a) Adding multiple HCSC components

The following is the procedure for adding multiple HCSC components. Use this procedure to add HCSC components of the distributed development.

  1. Import repositories.

    cscrepctl -import <repository zip file name> -compo -namelist <HCSC component-specification file name>
  2. Deploy HCSC components.

    csccompodeploy -namelist <HCSC component-specification file name>
  3. Start HCSC components.

    csccompostart -namelist <HCSC component-specification file>

(b) Updating multiple HCSC components

The procedure for updating multiple HCSC components is as follows. Use this procedure to update HCSC components of the distributed development.

  1. Stop HCSC components.

    csccompostop -namelist <HCSC component-specification file name>
  2. Undeploy HCSC components.

    csccompoundeploy -namelist <HCSC component-specification file name>
  3. Import repositories.

    cscrepctl -import <repository zip file name> -compo -namelist <HCSC component-specification file name>
  4. Update the service information. Execution of this step is optional.

    cscsvcctl -setfile < service-information change definition file>
  5. Deploy HCSC components.

    csccompodeploy -namelist <HCSC component-specification file name>
  6. Start HCSC components.

    csccompostart -namelist <HCSC component-specification file name>

(c) Deleting multiple HCSC components

The procedure for deleting multiple HCSC components is as follows:

  1. Stop HCSC components.

    csccompostop -namelist < component-specification file name >
  2. Undeploy HCSC components.

    csccompoundeploy -namelist <HCSC component-specification file name >
  3. Delete the component information from respositories.execution of this step is optional.

    cscrepctl -delete -namelist <HCSC component-specification file name >

(d) Adding, updating, and deleting multiple HCSC components

The procedure for concurrently adding, updating, and deleting multiple components is as follows. Use this procedure to switch HCSC components.

  1. Stop HCSC components. (updating and deleting HCSC components).

    csccompostop -namelist <HCSC component-specification file name>
  2. Undeploy HCSC components.(updating and deleting HCSC components).

    csccompoundeploy -namelist <HCSC component-specification file name>
  3. Perform normal import of repositories.

    cscrepctl -import <repository zip file name>
  4. Update the service information. Execution of this step is optional.

    cscsvcctl -setfile <service-information change definition file >
  5. Deploy HCSC components. (updating and deleting HCSC components).

    csccompodeploy -namelist <HCSC component-specification file name>
  6. Star HCSC components. (updating and deleting HCSC components).

    csccompostart -namelist <HCSC component-specification file name>