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-reducedomain(1)

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

## NAME

> hadbm reducedomain - removes hosts from the HADB management domain

## SYNOPSIS

> `hadbm reducedomain` [adminpassword=password | adminpasswordfile=filename] [agent=ma_url] host_list

## DESCRIPTION

> The following prerequisites must be met before using the `hadbm reducedomain` command:

> - An HADB management domain must already exist.

> - The hosts to be removed are registered in the domain. No database nodes are configured to be used on the hosts to be removed.

> - The HADB management repository is writable.

> - Software packages that are in use are not registered on the hosts which are to be removed.

> - The hostlist must not contain all agents in the domain. To remove all agents, use the `hadbm deletedomain` command.

> After successfully executing the `hadbm reducedomain` command, the management agents of the removed hosts are stopped and the repository of the deleted hosts is cleaned up.

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

> host_list

>   A comma-separated list of all the hosts that are part of the management domain.

## EXAMPLES

> Example 1. Removing hosts from a management domain

> > >     hadbm reducedomain host4,host5
> > >     Hosts removed, domain is now host1,host2,host3

## EXIT STATUS

> 0

>   command executed successfully

> 1

>   error in executing the command

## ERROR CODES

> 22015

>   the hostlist contains duplicate host names

> 22192

>   the management domain does not exist

> 22193

>   the specified hosts are not part of the domain and cannot be removed

> 22194

>   hosts cannot be removed because they contain databases

> 22195

>   cannot remove all hosts from the domain

> 22196

>   the URL used to connect to management agents spans hosts which are not in the management domain

## SEE ALSO

> `hadbm`(1m), `hadbm-create`(1), `hadbm-createdomain`(1), `hadbm-deletedomain`(1), `hadbm-extenddomain`(1), `hadbm-listdomain`(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.