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

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

## NAME

> hadbm createdomain - creates a management domain of the listed HADB hosts

## SYNOPSIS

> `hadbm createdomain` [adminpassword=password | adminpasswordfile=filename | no-adminauthentication] [agent=ma_url] host_list

## DESCRIPTION

> Use the `hadbm createdomain` command to create the HADB management domains. All the hosts that will be part of the desired domain must be included in the hostlist; including the hosts retrieved through the `hadbm listdomain`command.

> To form a domain, the hostlist must consist of valid network addresses. After the management domaiin is successfully completed, all the hosts in the domain are enabled and the management agents are ready to manage databases.

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

> - HADB management agents are running on the hosts.

> - The management agents are not members of an existing domain.

> - All the management agents are configured to use the same port.

> - All the management agents can reach each other over UDP, TCP, and with IP multicast.

## OPTIONS

> w adminpassword

>   The actual HADBM administation password. Using this option with the `hadbm createdomain` or `hadbm create` command requires that the password is entered each time any `hadbm` command is used.

>   The `adminpassword` is different from the `hadbm dbpassword` command. You must use both passwords when using the following commands: `hadbm create`, `hadbm addnodes`, `hadbm refragment`.

> W adminpasswordfile

>   The file from which the HADBM administration password is read.

> U no-adminauthentication

>   Using this option eliminates the need of password identification.

> 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 Agent.

## EXAMPLES

> Example 1. Creating an HADB management domain

> > >     hadbm createdomain host1,host2,host3
> > >     Domain host1,host2,host3 created

## EXIT STATUS

> 0

>   command executed successfully

> 1

>   error in executing the command

## ERROR CODES

> 22015

>   hosts specified in the hostlist contain duplicate host names

> 22190

>   a domain with the specified hostlist already exists or the hosts are part of a management domain

> 22196

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

## SEE ALSO

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