delete-iiop-cluster-endpoint.1


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
OPERANDS
EXAMPLES
SEE ALSO

NAME

delete-iiop-cluster-endpoint - deletes an IIOP endpoint from the IIOP cluster

SYNOPSIS

delete-iiop-cluster-endpoint [ --host admin-host ][ --port admin_port ] [ --user admin-username ][ --password admin-password ][ --passwordfile filename ] [ --secure|-s ][ -iiopserverinstance iiop-server-instance ] [ --instance instance_name ] iiop-endpoint-id

DESCRIPTION

Deletes an IIOP endpoint from the IIOP cluster. For the changes to take effect, the instance must be reconfigured and then restarted after executing this command. Specify the server instance that must be deleted from the IIOP configuration, the IIOP endpoint of the IIOP cluster configuration, and the instance to where the operation is directed.

If both the --iiopserverinstance and the --iiopendpointid are specified, the endpoint is removed if at least one endpoint remains after the deletion. If there are no remaining IIOP endpoints, the endpoints and the server is removed.

If the --iiopserverinstance alone is specified, then the instance is removed from the IIOP cluster configuration along with all its IIOP endpoint entries.

If neither the --iiopserverinstance nor the --iiopendpointid are specified, the following message is displayed:

All the iiopendpoints will be deleted. Are you sure (Y/N)?

If the response is affirmative, the entire cluster configuration is deleted.

The delete-iiop-cluster-endpoint command is available only in the Enterprise Edition of the Sun Java System Application Server.

OPTIONS

-H --host: host name of the machine hosting the administrative instance.
-p --port: administrative port number associated with the administrative host.
-u --user: administrative user associated for the instance.
-w --password: administrative password corresponding to the administrative user.
--passwordfile: file containing passwords appropriate for the command (for example, administrative instance).
-s --secure: indicates communication with the administrative instance in secured mode.
--iiopserverinstance: name of the server instance to be deleted from the IIOP cluster.
--iiopendpointid: identification of IIOP endpoint.
--instance: name of the server instance at which this operation is targeted.

OPERANDS

: None

EXAMPLES

Example 1. Removing an IIOP server instance along with all its endpoints from the IIOP cluster of server1

asadmin> delete-iiop-cluster-endpoint --user admin --password myPasswd 
--iiopserverinstance server2 --instance server1
Deleted instance server2 from the IIOP cluster of server1.

Example 2. Removing an IIOP endpoint, endpoint1 of an IIOP instance server2 from the IIOP cluster of server1

asadmin> delete-iiop-cluster-endpoint --user admin --password myPasswd 
--iiopserverinstance server2 --iiopendpointid endpoint1 --instance server1
Deleted IIOP end point endpoint1 of instance server2 from the IIOP cluster of server1.

Example 3. Removing all IIOP endpoints from the IIOP cluster of server1