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

## hadbm-definedomain(1)

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

#### NAME

definedomain– connects to the Management Agent and defines the domain

#### SYNOPSIS

`definedomain` [`––remove=host_list`] [`––adminpassword=password` | `––adminpasswordfile=filename` | `––no-adminauthentication`] [`––`javahome=JAVA_HOME] [`––agent=HADBM_agent`] host_list

#### DESCRIPTION

Before you can define a domain, ensure that the Management Agents are running on the hosts constituting the domain. Refer to the `ma` command to run the Management Agent. All agents must be listening for client connections on the same port. The Management Agent maintains a domain of hosts to communicate with. When you first define a domain, the listed hosts form a domain by initializing the internal communication channels and the internal persistent configuration store. On later redefinitions of the domain, adding or deleting hosts from the domain, the whole desired domain must be included in the host list. You can identify the current hosts on a domain by using the `listdomain` command. When adding new hosts to the domain, the new hosts must be included in the host list along with the hosts in the current domain. When removing hosts from the domain, the hosts to be dropped should be listed in the list for the `––remove` option, not in the desired domain list. A host which is in use by a database instance, or has a software package which is in use by a database instance, cannot be removed from the domain.

Use the `definedomain` command to plan large deployments. It allows you to add any number of hosts to the management domain without actually creating a database instance.

#### OPTIONS

`––remove`

  A comma-separated list of each host you wish to remove from the previously defined domain.

`–w` `––adminpassword`

  The actual HADBM administation password as defined in the environment variables of the Management Agent.

`–W` `––adminpasswordfile`

  The file containing the HADBM administration password and defined in your environment variables of the Management Agent. The adminstration password should be defined in the following form: HADBM_ADMINPASSWORD=password. Where password is the actual administrator password.

`–U` `––no-adminauthentication`

  Using this option eliminates the need of password identification.

`––javahome`

  The full path to the Java runtime installation. The default value is the value of the `JAVA_HOME` variable.

`––agent`

  Use this option in place of the `HADBM_AGENT` variable set in your environment or to override the existing set variable. The value for this option must be in the form of host_list:port_number. Where the host_list is a comma separated list of hosts.

#### OPERANDS

host_list

  A comma-separated list of each host defined in your domain which is running the Management Agent. By default, it connects to the first listed host, if unavailable it will continue until an active agent is found.

#### EXAMPLES

##### Example 1 Using the hadbm-definedomain to create a new domain

The following command defines a new domain including HostA and HostB.

    hadbm definedomain HostA,HostB

##### Example 2 Using the hadbm-definedomain to add hosts to an existing domain

The following command adds HostC and HostD to an already existing domain.

    hadbm> definedomain HostA,HostB,HostC,HostD

When adding hosts to a domain, all hosts in the current domain and the new hosts must be listed.

##### Example 3 Using the hadbm-definedomain to remove hosts from an existing domain

The following command removes HostD from the existing domain.

    hadbm> definedomain --remove=HostD HostA,HostB,HostC

A host which is in use by a database instance, or has a software package which is in use by a database instance, cannot be removed from the domain.

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### SEE ALSO

hadbm-create(1), hadbm-listdomain(1)

J2EE SDK 1.4 Last Revised 22 Dec 2004

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

- © 2010, Oracle Corporation and/or its affiliates