3.5.3 Executing the Easy Setup functionality for the HCSC production environment

(a) Preconditions

The preconditions for setting up the production environment are as follows:

Status of the system when the Easy Setup functionality for the HCSC production environment is used

When you set up the production environment by using the Easy Setup functionality for the HCSC production environment, the system must be in one of the following states:

• Service Platform has just been installed

• If the production environment was set up once by using the Easy Setup functionality for the HCSC production environment, the environment was unset up by using the Easy Setup functionality for the HCSC production environment

• If the test environment was set up once by using the Easy Setup functionality for the test environment, the environment was unset up by using the Easy Setup functionality for the test environment

Setting up the environment variables

To set up the production environment by using the Easy Setup functionality for the HCSC production environment, the environment variable must be specified. For details on the environment variables, see "4.1.13 Check points on setting environment variables of the logical server" in "Application Server System Setup and Operation Guide".

(b) Setup procedure

To set up the production environment by using the Easy Setup functionality for the HCSC production environment, you must use the template file to create the definition file. The following shows the setup procedure in the production environment:

1. Copy the template file to any directory (preparation environment).

   For details on the template file to be copied and the storage location of the template file, see "3.5.5 Definition files used with the Easy Setup functionality for the HCSC production environment".

2. Edit the template file and create the definition file.

   For details on the template file to be edited, see "3.5.5 Definition files used with the Easy Setup functionality for the HCSC production environment".

3. Copy the definition file created in 2 from the preparation environment to any directory in the production environment.

4. Execute the cscsetup command to set up the production environment.

   Specify the storage destination directory for the definition file in the -setup option and then execute the command.

   cscsetup -setup <storage destination directory for the definition file>

   For details on the cscsetup command, see "cscsetup (Easy setup of the production environment) " in "Service Platform Reference Guide".

5. Change the HTTP Server definition file.

   For details on the definition file to be changed, see "3.5.5 Definition files used with the Easy Setup functionality for the HCSC production environment".

(a) Preconditions

The preconditions for changing the information that was set up by using the Easy Setup functionality for the HCSC production environment are as follows:

• The production environment was set up by using the Easy Setup functionality for the HCSC production environment.

• All the logical servers are in a stopped state.

Furthermore, if the information to be changed is the service information or definition information for user-defined receptions, the following conditions must be satisfied:

When changing the service information

• The repository is imported from the development environment.

• The HCSC components are in an un-deployed state.

When changing the definition information for user-defined receptions

• The HCSC components are in a deployed state.

(b) Change procedure

To change the information that was set up by using the Easy Setup functionality for the HCSC production environment:

1. Apply the information to be changed in the definition files created in the preparation environment at setup, and change the definition files.

   The definition files to be changed differ as follows depending on the information to be changed:

   • Service information: service-information change definition file (cscadpconfig.properties)

   • Definition information for user-defined receptions: User-defined reception runtime definition file (cscurcptnconfig_id.properties)

   • Definition information for servers: Easy Setup definition file (SOA.xml)

   For details on the definition files to be changed, see "3.5.5 Definition files used with the Easy Setup functionality for the HCSC production environment".

2. Copy the definition file changed in 1 from the preparation environment to the production environment.

   Copy the directory where the definition file is stored.

3. Execute the cscsetup command to change the information set up in the production environment.

   Specify the storage destination directory for the definition file in the -change option and then execute the command.

   cscsetup -change <storage destination directory for the definition file>

   For details on the cscsetup command, see "cscsetup (Easy setup of the production environment) " in "Service Platform Reference Guide".

(a) Preconditions

The preconditions for unsetting up the production environment that was set up by using the Easy Setup functionality for the HCSC production environment are as follows:

• The production environment is in the state as the one immediately after setup was executed by using the Easy Setup functionality for the HCSC production environment (the HCSC components are in an un-deployed state).

• Management Server and Administration Agent are running.

(b) How to perform unsetup

To unset up the production environment that was set up by using the Easy Setup functionality for the HCSC production environment, execute the cscsetup command by specifying the -unsetup option.

cscsetup -unsetup

For details on the cscsetup command, see "cscsetup (Easy setup of the production environment) " in "Service Platform Reference Guide".

(a) Points to be considered when performing setup by using the Easy Setup functionality for the HCSC production environment

When an error occurs or when a sudden problem must be handled, the production environment that was set up by using the Easy Setup functionality for the HCSC production environment is sometimes changed or unset up with a normal method. The following paragraphs describe the relationship with the normal method for changing and unsetting up the information that was set up by using the Easy Setup functionality for the HCSC production environment:

Changing the information that was set up by using the Easy Setup functionality for the HCSC production environment

The following figure shows the changing of the information that was set up by using the Easy Setup functionality for the HCSC production environment.

Figure 3‒18:  Changing of the information that was set up by using the Easy Setup functionality for the HCSC production environment

If the information that was set up by using the Easy Setup functionality for the HCSC production environment is changed with the normal method, you must apply the changed contents to the definition file created during setup, and then change the definition information of the production environment. However, the information of the following Service Platform-related definition files need not be changed:

• HCSC-Manager definition file (cscmng.properties)

• HCSC-Manager command definition file (csccmd.properties)

• HCSC server configuration definition file (cscsvsetup.xml)

• HCSC server setup definition file (cscsvsetup.properties)

• HCSC server runtime definition file (cscsvconfig.properties)

• User-defined reception runtime definition file (cscurcptnconfig_id.properties)

• Service-information change definition file (cscadpconfig.properties)

For details on how to change the definition information, see "(2) Changing the setup information".

Unsetting up production environment that was set up by using the Easy Setup functionality for the HCSC production environment

The following figure shows the unset up of production environment that was set up by using the Easy Setup functionality for the HCSC production environment.

Figure 3‒19:  Unsetting up production environment that was set up by using the Easy Setup functionality for the HCSC production environment

If a production environment that was set up by using the Easy Setup functionality for the HCSC production environment is unset up with the normal method, the unsetup operation must be performed again by using the Easy Setup functionality for the HCSC production environment as follows:

1. After performing unsetup with the normal method, re-execute setup with the normal method, and return the production environment to the state when the environment was set up by using the Easy Setup functionality for the HCSC production environment.

2. Perform unsetup by using the Easy Setup functionality for the HCSC production environment.

(b) Points to be considered when performing setup without using the Easy Setup functionality for the HCSC production environment

A production environment that was set up without using the Easy Setup functionality for the HCSC production environment cannot be changed and unset up by using the Easy Setup functionality for the HCSC production environment.