Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Reference Manual

## hadbm-disablehost(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ERROR CODES | SEE ALSO

#### NAME

hadbm disablehost– selectively disables a host in the management domain

#### SYNOPSIS

`hadbm disablehost` [`––adminpassword=password` | `––adminpasswordfile=filename`] [`––agent=ma_url`] hostname

#### DESCRIPTION

Use the `disablehost` command to remove an unresponsive host from the management domain. Since the majority of management agents in a management domain must be enabled and running to execute HADB management commands, unresponsive hosts reduce the number of active agents and therefore prevent operation of `hadbm` commands.

A disabled host is automatically re-enabled when its management agent is restarted.

Before using the `disablehost` command, ensure the host to be disabled is:

- registered in the management domain

- enabled

- the management agent for the host is not running

- all database nodes configured to run on the host are stopped

#### OPTIONS

`–w` `––adminpassword`

  The actual HADBM administration password.

`–W` `––adminpasswordfile`

  The file from which the passwords are read.

`–m` `––agent`

  Identifies the URL to the Management Agent. The default is localhost:1862.

#### OPERANDS

hostname

  The hostname for the host to be disabled.

#### EXAMPLES

##### Example 1 Disabling a host named host1

    hadbm disablehost host1
    Host successfully disabled

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### ERROR CODES

22176

  the host is not registered in the HADB management domain

22180

  the host is already disabled

22181

  database nodes are running on the host. Use hadbm stopnode to stop the nodes before using disablehost

22182

  the management agent is running on the specified host. Stop the management agent before disabling the host

#### SEE ALSO

hadbm(1), hadbm-create(1), hadbm-listpackages(1), hadbm-unregisterpackage(1)

J2EE SDK 1.4 Last Revised 31 Jan 2005

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ERROR CODES | SEE ALSO

- © 2010, Oracle Corporation and/or its affiliates