uCosminexus Service Platform, Setup and Operation Guide

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

7.5.4 How to recover when deploying and deleting HCSC Components

Organization of this subsection
(1) Recovery procedure
(2) Resources used by the HCSC server

(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-51 Table 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.

(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-52 Table 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 F2 N
9 IServiceKind F2 N
10 IServiceName F2 N
11 R<Number># F2 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.

Note#
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>

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.