3.3.1 Deleting a service adapter

This subsection describes the preconditions for deleting a service adapter deployed in the execution environment, and explains how to delete the service adapter.

Note that the series of processing to stop and delete the HCSC components from the HCSC server can also be executed in the development environment in a batch. However, batch execution is performed during system development or from unit testing to integration testing. For details, see "7.6 Batch execution of processes for stopping HCSC components and deleting them from the HCSC server" in "Service Platform Basic Development Guide".

Organization of this subsection

(1) Preconditions
(2) How to delete a service adapter

(1) Preconditions

To delete a service adapter, the following conditions must be satisfied:

The HCSC server is running

For details on how to check the status of the HCSC server, see "5.3.15 Checking the HCSC server information".
The service adapter is in a stopped state

For details on how to check the status of the service adapter, see "5.3.17 Checking the service adapter information".

To Page Top

(2) How to delete a service adapter

To delete a service adapter, execute the csccompoundeploy command in the operating environment.

For details on the csccompoundeploy command, see "csccompoundeploy (Deleting the deployed HCSC components) " in "Service Platform Reference Guide".

The execution format of the command differs depending on whether all the service adapters are deleted in a batch, or whether only the specified service adapter is deleted.

Important note: If the service adapter cannot be deleted, eliminate the cause of the error, and then delete again.

(a) To delete all the service adapters in a batch

Delete all the service adapters on the HCSC server or cluster in a batch.

The execution format of the command differs depending on whether the service adapter is deleted from a single HCSC server, or all the HCSC servers configuring the cluster.

To delete all the service adapters from a single HCSC server

Execute the command by specifying the name of the HCSC server and the -all option.

All the service adapters deployed on the HCSC server specified in the -csc option are deleted (all the undeleted business processes and user-defined receptions are also deleted at the same time).

csccompoundeploy -user <login user ID> -pass <login password> -csc <HCSC server name> -all

To delete all the service adapters from all the HCSC servers configuring the cluster

Execute the command by specifying the cluster name and the -all option.

All the service adapters deployed on all the HCSC servers in the cluster specified in the -cluster option are deleted (all the undeleted business processes and user-defined receptions are also deleted at the same time).

csccompoundeploy -user <login user ID> -pass <login password> -cluster <cluster name> -all

(b) To delete the specified service adapter only

Among the service adapters deployed on the HCSC server or cluster, only the specified service adapter is deleted.

The execution format of the command differs depending on whether the service adapter is deleted from a single HCSC server, or all the HCSC servers configuring the cluster.

To delete only the specified service adapter from a single HCSC server

Execute the command by specifying the name of the HCSC server and the service ID of the service adapter.

The service adapter specified in the -name option is deleted, from among the service adapters deployed on the HCSC server specified in the -csc option.

csccompoundeploy -user <login user ID> -pass <login password> -csc <HCSC server name> -name <Service ID of the service adapter>

To delete only the specified service adapter from all the HCSC servers configuring the cluster

Execute the command by specifying the cluster name and the service ID of the service adapter.

Only the specified service adapter is deleted, from among the service adapters deployed on all the HCSC servers in the cluster specified in the -cluster option.

csccompoundeploy -user <login user ID> -pass <login password> -cluster <cluster name> -name <Service ID of the service adapter>

Important note

If in-process requests exist, the service adapter is not deleted.

To destroy the in-process requests, and to delete the service adapter forcefully, execute the csccompoundeploy command by specifying the -force option.

The following are the examples of forced deletion:

To delete all the service adapters of the HCSC server "HCSC" forcefully
```
csccompoundeploy -user admin -pass admin -csc HCSC -all -force
```
To delete the service adapter "Adapter1" of the HCSC server "HCSC" forcefully
```
csccompoundeploy -user admin -pass admin -csc HCSC -name Adapter1 -force
```

To Page Top