uCosminexus Service Platform, Basic Development Guide

[Contents][Glossary][Index][Back][Next]

2.4.2 Executing HCSC easy setup functionality

This section describes the pre-conditions for setting up and unsetting up the test environment using HCSC easy setup functionality and also the methods for setting up and unsetting up the test environment.

Organization of this subsection
(1) Setting up the test environment
(2) Unsetting up the test environment

(1) Setting up the test environment

This section describes pre-conditions and method for setting up the test environment using HCSC easy setup functionality.

(a) Pre-conditions

Following are pre-conditions for setting up the test environment.

Pre-requisite software for test environment
Following software must be installed for setting up the test environment by using HCSC easy setup functionality.
  • Component Container#1
  • XML Processor#1
  • TPBroker#1
  • Performance Tracer#1
  • Reliable Messaging#1
  • Service Coordinator#1
  • WSDL4J 1.5.1#2
Note #1
This software is configuration software of Service Architect. You need not install the above mentioned software again, in case of an environment where Service Architect is installed.
If installing above software again, install from Installer. Install the software as per instructions of Installer. The user with Administrator privileges must perform the installation.
Note #2
Install WSDL4J 1.5.1 after installing the other pre-requisite software. WSDL4J 1.5.1 is required for using SOAP1.1 mode.

Status of system when using HCSC easy setup functionality
When you setup the test environment using HCSC easy setup functionality, status of the system must be as follows:
  • Immediately after Service platform is newly installed
  • Settings related to service platform should not have been performed.
However, value of variable name "TZ" should be valid in the system environment variables. Set time zone in the environment variable "TZ". Specify "JST-9" in the time zone.
If you customize the test environment after setup, the customized information is deleted at the time of unset up. If you do not want the customized information to be deleted, register the parameter information of definition files, which you added or changed at the time of customizing.

Pre-conditions when using database and Reliable Messaging both
Following conditions must be fulfilled when you use both database and Reliable Messaging (when you select [Model with DB/RM] in HCSC easy setup screen).
  • User must have knowledge of HiRDB
  • User must not implement high load testing or performance measurement
Note
After you have unsetup the test environment, you can set up the test environment again by using HCSC easy setup functionality. For unsetting up the test environment, see "2.4.2(2) Unsetting up the test environment".
(b) Setup method

Use HCSC easy setup screen for setting up the test environment by using HCSC easy setup functionality. Following is the method to set up the test environment.

  1. From [Start] menu of Windows, select [Cosminexus]-[Test building]-[Test environment setup].
    HCSC easy setup screen is displayed.
  2. Input the required information in HCSC easy setup screen.
    For items to be input in HCSC easy setup screen, see " 2.4.2(1)(c) Input items of HCSC easy setup screen".
  3. Click [Setup] function.
    Setup of the test environment is started. Setup state is displayed in the console of HCSC easy setup screen. When "Setup of the HCSC Easy Setup functionality is complete" is displayed on console, it implies that the test environment is successfully set up.
    Note
    When error is displayed on the console, and test environment setup ends with an error, you must perform the setup again. When setup ends with an error, procedure of re-setup differs depending on enabled or disabled status of [Setup] button on HCSC easy setup screen.

    When [Setup] button is enabled
    Click [Setup] button, to perform setup again.

    When [Setup] button is disabled
    Unset up once by clicking [Un-setup] button and then perform the setup again.
(c) Input items of HCSC easy setup screen

HCSC easy setup screen is divided in [Main] tab and [Server name] tab. With [Server name] tab, you can change the information like server name or class name at the time of setup.

This section describes the input items in HCSC easy setup screen, by using the items' relation with each process in the environment to be configured with HCSC easy setup functionality.

Following figure shows HCSC easy setup screen.

Figure 2-3 HCSC easy setup screen ([Main] tab)

[Figure]

Figure 2-4 HCSC easy setup screen ([Server name] tab)

[Figure]

As the following figure shows, the items that are input in HCSC easy setup screen are set in each process of the environment to be configured. Following figure shows the relation between input items and the values that are set.

Figure 2-5 Relation of input items in HCSC easy setup screen

[Figure]

Items to be set differ depending on which of [Model with DB/without RM], [Model without DB/RM] or [Model with DB/RM] is selected. Following table describes details of setting values (input items in HCSC easy setup screen) shown in (n) of Figure 2-5.

Table 2-4 Items to be input in HCSC easy setup screen

Input items Description Initial value#2
Tab Classification Item No. Item names in HCSC easy setup screen#1
Main Model -- Model with DB/without RM Select when you want to use database and not use Reliable Messaging. Selected
-- Model without DB/RM Select when you do not want to use database and Reliable Messaging both. --
-- Model with DB/RM Select when you want to use database and Reliable Messaging both. --
Embedded database (1) Database storing destination Specify a directory for specifying RD area and a directory for specifying system file. Specify any available directory having size of 660MB or more.
If you specify a non-existing directory, specified directory is newly created.
Specify only when you select [Model with DB/without RM] or [Model with DB/RM].
Installation directory of <Service platform>\CSC\DB\area
(2) DB connection port number Specify a port number to be used for accessing an embedded database from Management Server or HCSC server. Specify with any integer in the range of 5001~65535.
Specify when you select [Model with DB/without RM] or [Model with DB/RM].
22200
Management Server (3) HCSC server operation port number Specify a port number to be used for accessing Management Server from HCSC-Manager. Specify with any integer in the range of 1~65535. 28099
(4) Logical server operation port number Specify a port number to be used for accessing Management Server from Smart Composer or management portal screen. Specify with any integer in the range of 1~65535. 28080
(5) End request receipt port number (for internal management) Specify a port number to be used by Management Server for internal management. Specify with any integer in the range of 1~65535. 28005
(6) Internal communication port number (for internal management) Specify a port number (webserver.connector.ajp13.port key of mserver.properties file) to be used by Management Server for internal management. Specify with any integer in the range of 1~65535. 28009
(7) In-process Naming Service port number (for internal management) Specify a port number (ejbserver.naming.port key of mserver.properties file) to be used by Management Server for internal management. Specify with any integer in the range of 1~65535. 28900
Administration Agent (8) Agent connection port number (for internal management) Specify a port number for internal management to be used for accessing Administration Agent from Management Server. Specify with any integer in the range of 1~65535. 20295
HCSC server -- SOAP1.1 mode Select when you want to use SOAP1.1 mode. Selected
-- SOAP1.1/1.2 combined mode Select when you want to use SOAP1.1/1.2 combined mode. --
(9) Web service /MDB (WS-R) receipt port number Specify a port number to be used for accessing standard receipt (Web service or MDB (WS-R)) or user-defined receipt from service requester. Specify with any integer in the range of 1~65535. 80
(10) SessionBean receipt port number Specify a port number to be used for accessing HSCS server from Management Server or standard reception (SessionBean) from service requester. Specify with any integer in the range of 1~65535. 900
(11) MDB (DB queue) reception port number Specify a port number to be used when accessing standard reception (MDB (DB queue)) from service requester. Specify with any integer in the range of 1024~65535.
Specify when you select [Model with DB/RM].
20351
(12) Operation check port number Specify a port number to be used by HCSC server for internal management. Specify with any integer in the range of 1~65535. 23152
(13) Simple Web server port number (for internal management) Specify a port number to be used by HCSC server for internal management. Specify with any integer in the range of 1~65535. 8080
Server name Server name selection -- V7 compatible name Select to use name same as version 7, for all types of server names of test environment to be configured by HCSC easy setup. --
-- HCSC main environment simple setup name Select to use name same as name to be setup with HCSC actual environment simple setup, for all types of server names of test environment to be configured with HCSC easy setup.
For HCSC actual environment simple setup, see "3.5 Easy Setup of production environment" in "Service Platform System Setup and Operation Guide".
Selected
-- Custom name Select to specify any name, for all types of server name of test environment to be configured with HCSC easy setup. --
Server name (14) Logical J2EE server name Specify connection destination J2EE server name. Specify single byte alphanumeric within the range of 1~128 characters, underscore and hyphen. J2EEServer
(15) Logical PRF name Specify server name of PRF to be operated by linking with HCSC server. Specify single byte alphanumeric within the range of 1~128 characters, underscore and hyphen. PRF
-- Cluster name Specify name of the cluster to which HCSC server to be set up belongs. Specify a cluster name that is unique within classes. Specify single byte alphanumeric within 1~8 characters and underscore. Cluster
(16) HCSC server name Specify name of the HCSC server to be set up. Specify single byte alphanumeric within 1~8 characters and underscore. HCSC
(17) Manager name Specify HSCS-Manager independent identification name for HCSC-Manager to identify Manager. When multiple HCSC servers are managed in a single repository, specify identification name that is unique in Manager (host) unit. Specify single byte alphanumeric within 1~16 characters and underscore. Manager

(Legend)
--: Not applicable

Note#1
When you temporarily place the mouse cursor on an item corresponding to HCSC easy setup screen, description of that item is temporarily displayed.

Note#2
Initial value is a value that is initially displayed when HCSC easy setup screen is displayed for the first time. When you execute setup by changing an initial value, previous setting value is displayed in next HCSC easy setup screen, as an initial value.

(2) Unsetting up the test environment

This section describes pre-conditions and unsetting up method for unsetting up the test environment set up by using HCSC easy setup functionality.

Note
When you unset up by using HCSC easy setup functionality, test environment returns to the status before setup. As service adapter or business process that use the test environment are automatically deleted, take a backup of required data without fail, before executing unsetup.
(a) Pre-conditions

Pre-conditions for unsetting up the test environment are as follows:

(b) Method for unsetting up

Use HCSC easy setup screen, for unsetting up the test environment. Method for unsetting up the test environment is as follows:

  1. From [Start] menu of Windows, select [Cosminexus]-[Environment configuration]-[Test environment setup].
    HCSC easy setup screen is displayed.
  2. Click [Unset up] button on HCSC easy setup screen.
    Unset up of the test environment is started. Unsetup state is displayed on the console of HCSC easy setup screen. Display of "Unset up of the HCSC Easy Setup functionality is complete" on the console implies that the test environment is successfully unset up.