Hitachi

uCosminexus Service Platform Setup and Operation Guide

3.1.3 Setting up an HCSC server

To deploy the service adapters, business processes, and user-defined receptions to the HCSC server and set up the execution environment, you must first set up the HCSC server. When you set up the HCSC server, you can also set up the cluster.

This subsection describes the preconditions for setting up the HCSC server and explains how to perform the setup.

Reference note

It is recommended that you specify the HCSC server definition information after you set up the HCSC server and before you start the HCSC server. For details on how to define the HCSC server, see "3.1.4 Setting up the HCSC server definition information".

Organization of this subsection

(1) Preconditions

The following conditions must be satisfied to set up the HCSC server:

To Page Top

(2) How to perform the setup

To set up the HCSC server, execute the cscsvsetup command in the operating environment.

For details on the cscsvsetup command, see "cscsvsetup (Setting up an HCSC server)" in "Service Platform Reference Guide".

The contents to be set up differ depending on whether a single HCSC server is set up, or whether the server is set up to configure a cluster with an already set up HCSC server.

Important note

  • If a communication failure or timeout occurs during the execution of the command, the processing might be concluded in the execution environment. Therefore, obtain the HCSC server setup information and re-execute the cscsvsetup command according to the obtained information. For details on how to obtain the HCSC server setup information, see "5.3.14 Checking the HCSC server setup information". Note that when obtaining the HCSC server setup information, you must use the -host option in the cscutil command. For details on the cscutil command, see "cscutil (Various operations) " in "Service Platform Reference Guide".

  • The cluster name and HCSC server name are not case sensitive, so specify a unique name. However, you can omit the cluster name when you set up the HCSC server.

  • When using a database for setup, do not execute cscsvsetup command (setting up the HCSC server) or cscsvunsetup command (unsetting up the HCSC server) on multiple machines at the same time even if the operating environment repositories are different.

  • After you have completed setup, you can no longer check the information in the HCSC server configuration definition file that was used for setup. If necessary, create a backup of the file before completing setup.

(a) When setting up an independent HCSC server

Specify the cluster name in the -cluster option. However, this server is an independent HCSC server, so a configuration of clusters is not formed at this stage. When you set up other HCSC servers, you can configure a cluster by specifying and setting up the cluster names specified here. 

cscsvsetup -user <login user ID> -pass <login password> -csc <HCSC server name> -cluster <cluster name> -propfile <Name of HCSC server configuration definition file>

Note that if you omit the cluster name, the HCSC server name specified in the -csc option is set up as the cluster name.

cscsvsetup -user <login user ID> -pass <login password> -csc <HCSC server name> -propfile <Name of HCSC server configuration definition file>

(b) To configure a cluster with an already set up HCSC server

In the -cluster option, specify the cluster name for adding the HCSC server.

cscsvsetup -user <login user ID> -pass <login password> -csc <HCSC server name> -cluster <Cluster name for adding the HSCS server> -propfile <Name of HCSC server configuration definition file>

To Page Top

(3) Adding and changing the setup information

If you re-execute the setup described in "(2) How to perform the setup" for the HCSC server that is already set up, you can add or change the set up information.

To add or change the HCSC server setup information, the HCSC server, service adapters, business processes, and user-defined receptions must be stopped already.

For details on how to check the status of the HCSC server, service adapters, business processes, and user-defined receptions, see "5.3.15 Checking the HCSC server information", "5.3.17 Checking the service adapter information", "5.3.18 Checking the business process information", and "5.3.19 Checking the information of user-defined reception" respectively.

The information that you can add or change is as follows:

Information that can be added

  • Types of standard reception

    You can add and set up the synchronous (Web service/ SessionBean), and asynchronous (MDB (WS-R)/ MDB and (DB queue)) standard receptions. To change or delete the information of the already set up standard reception types, execute unsetup and then reset up.

Information that can be changed

  • Location information for the synchronous standard reception (Web service)

    This is the Web server location information used for the synchronous standard reception (Web service). You can change the Web server IP address, port number, and protocol.

  • Location information for the asynchronous (MDB (WS-R)) standard reception

    This is the Web server location information used for the asynchronous (MDB (WS-R)) standard reception. You can change the Web server IP address, port number, and protocol.

  • Location information for the synchronous (SessionBean) standard reception

    This is the NameServer location information used for the synchronous (SessionBean) standard reception. You can change the NameServer IP address and port number.

  • Managerlocation information

    You can change the IP address and port number for accessing Manager.

    Important note

    To add or change information other than that mentioned above, you must execute unsetup and resetup of the HCSC server. If you add or change other information without executing HCSC server unsetup, and then implement setup, the additions and changes are ignored.

To Page Top

Trademarks

All Rights Reserved. Copyright (C) 2022, Hitachi, Ltd.