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

User Commands | 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 administation password.

> W adminpasswordfile

>   The file from which the HADBM administration password is 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 | Go To Top | Last Changed 22 Dec 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.