Download this book in PDF (1865 KB)

create-domain(1)

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

NAME

create-domain– creates a domain with the specified name

SYNOPSIS

create-domain [––domaindir install_dir/domains] [––template domain_template] ––adminport port_number ––adminuser admin_user [––passwordfile passwordfile] [––terse=false] [––echo=false] [––interactive=true] [––instanceport port_number] [––domainproperties (name=value)[:name=value]*] [––savemasterpassword=false] domain_name

DESCRIPTION

Use the create-domain command to create a domain containing an instance that can administer itself. By creating a domain, an administration server is created in a directory named as the domain name. If you create a domain in a non-default directory, the domain will not be automatically shutdown during uninstallation.

The ––adminpassword option has been deprecated, use the ––passwordfile option instead. To maintain high security, omit the ––passwordfile from the command line and allow the system to prompt you for these options.

This command is supported in local mode only.

OPTIONS

––domaindir

The directory where the domain is to be created. If specified, the path must be accessible in the filesystem. If not specified, the domain is created in the default install_dir/domains directory.

––template

Specifies the filename of a domain.xml template used to create the domain. Allows domains of different types to be created and allows users to define their templates. This option is available only in the Sun Java System Application Server Enterprise Edition.

––adminport

The administrative instance port number.

––adminuser

The username associated with the administrative instance.

––passwordfile

The file containing the domain application server password associated with the administrative instance. The password is defined in the following form: AS_ADMIN_ADMIN_PASSWORD=password. Where password is the actual administrator password for the domain. This file can also contain the AS_ADMINPASSWORD and the AS_MASTERPASSWORD. The syntax for each is the same as the syntax for AS_ADMIN_PASSWORD. Using this option on the command line can be insecure, since the password is stored in clear text. This file, however, can be protected by file system permissions.

–t ––terse

Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.

–e ––echo

Setting to true will echo the command line statement on to the standard output. Default is false.

–I ––interactive

If set to true (default), only the required options are prompted.

––instanceport

The port number listening to the HTTP request. The port number cannot be currently in use. If not specified, the default value is 8080.

––domainproperties

Setting the optional name/value pairs overrides the default values for the properties of the domain to be created. The list must be separated by the “:” character. The following properties are available:

Property	Definition
jms.port	This property specifies the port number for JMS. Valid value are 7676
orb.listener.port	This property specifies which ORB listener port for IIOP connections orb-listener-1 listens on.
http.ssl.port	This property specifies the port number for http-listener-2. Valid values are 1–65535. On UNIX, creating sockets that listen on ports 1–1024 requires superuser privileges.
orb.ssl.port	This property specifies which ORB listener port for IIOP connections the IIOP listener called SSL listens on.
orb.mutualauth.port	This property specifies which ORB listener port for IIOP connections the IIOP listener called SSL_MUTUALAUTH listens on.
domain.jmxPort	Specifies the port on which the jmx connector is initialized. The valid values are 1-65535.

––savemasterpassword

Setting this option to true allows the masterpassword to be written to the file system. It is best to create a masterpassword when creating a domain, because masterpassword is used by the start-domain command. For security purposes, the default setting should be false, because saving the masterpassword on the disk is an insecure practice, unless file system permissions are properly set. If masterpassword is saved, then start-domain will not prompt for it. Masterpassword gives an extra level of security to the environment.

OPERANDS

domain_name

The name of the domain to be created.

EXAMPLES

---

Example 1 Using the create-domain command




The following command creates the myDomain domain and saves the admin username and password.

asadmin> create-domain --adminport 8282 --adminuser admin myDomain Please enter the admin password> Please enter the admin password again> Please enter the master password> Please enter the master password again> Default port 8080 for HTTP Instance is in use. Using 40718 Default port 7676 for JMS is in use. Using 40719 Default port 3700 for IIOP is in use. Using 40720 Default port 8181 for HTTP_SSL is in use. Using 40721 Default port 3820 for IIOP_SSL is in use. Using 40722 Default port 3920 for IIOP_MUTUALAUTH is in use. Using 40723 Default port 8686 for JMX_ADMIN is in use. Using 40724 Domain myDomain created.

---

EXIT STATUS

0

command executed successfully

1

error in executing the command

SEE ALSO

delete-domain(1), start-domain(1), stop-domain(1), list-domains(1)

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