Hitachi

uCosminexus Service Platform Setup and Operation Guide

7.5.4 How to recover when deploying and deleting HCSC Components

Organization of this subsection

(1) Recovery procedure

If deployment of a service adapter, business process, or user-defined reception fails and the item cannot be re-deployed, or if a service adapter, business process or user-defined reception cannot be deleted even after repeated deletion attempts, perform the following procedure.

  1. Execute the csccompoundeploy command by specifying the -ignore option, and delete the repository information.

    csccompoundeploy -user <login user ID> -pass <login password> -csc <HCSC server name> -name <Service ID or Reception ID> -ignore

    The next steps you perform differ depending on whether deletion of applications is necessary:

    • If deletion of applications is necessary, perform steps 2 to 5.

    • If deletion of applications is unnecessary, perform step 5.

  2. Execute the following command to confirm the name of the HCSC application that you want to delete:

    cscapputil -user <login user ID> -pass <login password> -mng <Manager name> -j2ee <J2EE server name> -operation list

    The following table lists and describes the HCSC applications to be deleted. There are no shared resources between these applications within the cluster. Therefore, delete all applications.

    Table 7‒65:  HCSC applications to be deleted (when there is a failure in deploying and deleting HCSC components)

    Item

    Application name

    HCSC component (service adapter and business processes) applications

    <Service ID>

    HCSC component (user-defined reception) applications

    <Reception ID>

  3. Execute the following command to stop HCSC components to be deleted:

    cscapputil -user <login user ID> -pass <login password> -mng <Manager name> -j2ee <J2EE server name> -app <Application name> -operation stop

  4. Execute the following command to delete HCSC components:

    cscapputil -user <login user ID> -pass <login password> -mng <Manager name> -j2ee <J2EE server name> -app <Application name> -operation delete

  5. If there are resources (queue) that cannot be deleted, delete those resources in reference to "(2) Resources used by the HCSC server".

    However, for resources that are shared in the cluster, delete these resources when you are cancelling the setup of the last service adapter or business process in the cluster.

  6. If there are resources (database table information) that cannot be deleted, delete in reference to the following procedure:

    Execute the following SQL statement and delete the remaining resources (database table information) that are not required.

    DELETE FROM CSCMSG_C<class name>_HA_ASYNC_ADP 
       WHERE CSC_SERVER_NAME='<HCSC server name>' 
         AND ADAPTER_ID='<Service ID of asynchronous service adapter with failed deployment or deletion>';
 
COMMIT;

    Do not delete resources (database table information), if all the following conditions are not met:

    • HCSC server is set up by specifying "HA" in cluster type.

    • Asynchronous service adapter with same service ID is not deployed within the cluster.

  7. Restart the HCSC server.

To Page Top

(2) Resources used by the HCSC server

The following table lists and describes the resources used by the HCSC server (service adapters, business processes):

Table 7‒66:  List of resources used by the HCSC server (service adapters and business processes)

No.

Item

Resource

Type

Shared

1

Database table

Row where any of the following is stored in SERVICE_NAME column of CSCMSG_S<HCSC server name>_LC_DIRECTORY table:

  • Service names of service adapters to be deleted

  • Business process names to be deleted

  • The format of user-defined reception to be deleted is as follows:

    :Reception_<Reception ID of user-defined reception to be deleted>:<Reception name of user defined reception to be deleted>

T

N

2

Service adapter queue

CSC_<class name><Service ID>

Q

Y

3

Queue destination of MDB (WS-R) adapter

CSC<Service ID>

U

Y

4

HCSC server temporary file

UserReceptionProperties_<HCSC server name>_<Reception ID>

F

N

5

UserReceptionProperties_<HCSC server name>_<Reception ID>.old

F

N

6

UserReceptionPropertiesAct_<HCSC server name>_<Reception ID>.old

F

N

7

_cscmsg_cnfrq_<HCSC server name>_<Reception ID>.xml

F

N

8

IAdapterName#1

F2

N

9

IServiceKind#1

F2

N

10

IServiceName#1

F2

N

11

R<Number>#2

F2

N

12

IServiceName#1

F3

N

13

R<Number>#2

F3

N
Legend:

Y: Indicates that the resource is shared in the cluster.

N: Indicates that the resource is not shared in the cluster.

"TYPE" column: Indicates respective content as follows:

  • T: Indicates a database table.

    Execute the DELETE SQL command and delete one line each of database tables.

  • Q: Indicates a Reliable Messaging queue.

    To delete Reliable Messaging queue, execute the hrmstop command to migrate to the management status, and then execute the hrmdelque command. For details on the command, see "8.3.26 hrmstop (Migrating to management status) " in "Reliable Messaging".

  • U: Indicates address specified in the Reliable Messaging transfer queue.

    To delete the address specified in the Reliable Messaging transfer queue, execute the hrmstop command to migrate to the management status, and then execute the hrmdeladdr command. For details on the command, see"8.3.6 hrmdeladdr (Deleting address) " in "Reliable Messaging".

  • F: Indicates HCSC server temporary file.

    When you want to delete file, delete the files in "<Installation directory of Service Platform>CSC\system\msg".

  • F2: Indicates HCSC server temporary file.

    When you want to delete a file, delete resources (files) in the "directory-specified-in-hcscserver-data-filepath\inf\LC_DIRECTORY" directory specified in hcscserver-data-filepath property of the HCSC server setup definition file. When a directory is not specified in the hcscserver-data-filepath property, delete the resources (files) that in the "default-directory-of-hcscserver-data-filepath\inf\LC_DIRECTORY" directory.

  • F3: Indicates HCSC server temporary file.

    If you want to delete this file, delete the resource (file) in the \inf\LC_BPFORMAT directory located in the directory specified for the hcscserver-data-filepath property in the HCSC server setup definition file. If no directory is specified for this property, delete the resource (file) in the \inf\LC_BPFORMAT directory located in the default directory for the property.

Note#1

Delete only the content of the file instead of deleting the file itself.

Note#2

The file in which any of the following items are stored in the SERVICE_NAME line within the file:

  • Service name of the service adapter to be deleted

  • Business process name to be deleted

  • The format of the user-defined reception to be deleted is as follows:

    :Reception_<Reception ID of the user-defined reception to be deleted>:<Reception name of the user-defined reception to be deleted>

Important note

  • When deleting HCSC components on the J2EE server, use the cscapputil command. You cannot delete HCSC components with J2EE server commands.

  • Use the cscapputil command only when recovering from a failure. Do not use the command during normal operations and setup.

  • The Service Platform system might collapse if you delete an application with the cscapputil command. Therefore, perform operations with utmost care.

To Page Top

Trademarks

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