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

NAME

 create-domain - creates a domain with the given name

SYNOPSIS

 create-domain --user admin_user [--passwordfile filename] [--host host_name] [--port port_number] [--secure|-s] [--terse=false] [--echo=false] [--interactive=true] [--help] [--domaindir install_dir/domains] [--adminport port_number] [--instanceport port_number] [--domainproperties (name=value)[:name=value]*] [--masterpassword master_password] [--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, you should omit the --passwordfile and --masterpassword 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.

--adminport

The administrative instance port number.

--adminuser

The username associated with the administrative instance.

-W --passwordfile

The file containing the domain application server password associated with the administrative instance. The password is defined in the following form: AS_ADMIN_PASSWORD=password. Where password is the actual administrator password for the domain.

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

--masterpassword

The master password used to protect all sensitive data.

--savemasterpassword

Setting this option to true allows the masterpassword to be written to the file system. This is necessary so that the start-domain command can start the server without having to prompt the user. However, for security purposes, the default setting is false because saving the master password on the disk is an insecure practice.

OPERANDS

domain_name

The name of the domain you wish to create.

EXAMPLES

Example 1. Using the create-domain command

asadmin> create-domain --domaindir /export/domains 
--adminport 7070 --adminuser admin --masterpassword adminadmin 
--instanceport 7071 sampleDomain
created domain sampleDomain successfully

Where: the sampleDomain domain is created in the /export/domains directory.

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)