h1. {anchor:ACFEL} commadmin domain create
The {{commadmin domain create}} command creates a single domain in the LDAP directory. To create multiple domains, use the {{-i}} option.
h2. {anchor:ACFEM} Syntax
{panel}
{{commadmin domain create –D _login_ –d _domain name_ –n _domain_ –w _password_}}
{{ [–A [+] _attributename_:_value_] [–h] [–?] [–i _inputfile_] [–o _organization RDN_]}}
{{ [–p _AM port_] [–s] [–v] [–V] [–X _AM host_]}}
{{ [–S mail –H _preferred mailhost_]}}
{{ [–S cal [–B _backend calendar data server_] [–C _searchable domains_] [–g _access control string_]}}
{{ [–P _propertyname_[:_value_]] [–R _right_[:_value_]] [–T _calendar time zone string_] ]}}
{{ [–S im]}}
{panel}
h2. {anchor:ACFEN} Options
The following options are mandatory:
||Option ||Description ||
|{{-D}} _login_|The user ID of the Top-Level Administrator.|
|{{-d}} _domain name_|DNS domain name of the domain that is being created.|
|{{-n}} _domain_|The domain of the Top-Level Administrator.|
|{{-w}} _password_|The password of the Top-Level Administrator.|
The following options are non-mandatory:
||Option ||Description ||
|{{-A}} [+] _attributename_:_value_ |An attribute to modify. The _attributename_ is defined in the LDAP schema and the _value_ specified replaces any and all current values for this attribute in the directory. Repeat this option to modify multiple attributes at the same time, or to specify multiple values for the same attribute.\\
\\A “+” before the _attributename_ indicates adding the value to the current list of attributes.\\
\\If the action value (+), is not specified, the default action is to add the existing value.|
|{{-h, -?}}|Prints command usage syntax.|
|{{-i}} _inputfile_|Reads the command information from a file instead of the command line.\\
\\An option value specified in the input file overrides any value for the same option set in the command line.|
|{{-o}} _organization RDN_|Specifies the organization RDN for the domain. For example, {{o=varrius.florizel.com.}}\\
\\If this option is not specified, the organization is created under the {{osi}} {{suffix,}} with {{o=}} the name of the domain, {{o=osiSuffix.}}|
|{{-p}} _AM port_|Specifies an alternate TCP port where the Access Manager is listening. If not specified, the default _AM port_ is used, or Port 80 is used if no default was configured at install time.|
|{{-s}}|Use SSL (Secure Socket Layer) to connect to the Access Manager.|
|{{-v}}|Enable debugging output.|
|{{-V}}|Prints information about the utility and its version.|
|{{-X}} _AM host_|Specifies the host on which the Access Manager is running. If not specified, the default _AM host_ is used, or the localhost if no default was configured at install time.|
|{{-S}} _service_|Specifies the service or services to be added to the domain.\\
\\ _service_ can have the value of a single service or multiple services. The valid _service_ values are {{mail}}, and {{cal}}, and {{im}}_._ These values are case-insensitive.\\
\\If the {{-S mail}} option is specified, then the {{-H}} option must be specified.\\
\\Can be listed as a comma-separated list.\\
\\For Example:\\
\\ {{-S mail,cal,im}}\\
{panel:|borderColor=#ccc|bgColor=#FFFFCE}
*Delegated Administrator 7:* {{-S im}}
{panel}\\
\\ AM provisioning mode: A domain is created with the services mentioned depending on the value of the particular service definition present in the configuration file of Access Manager.|
|The following option is only allowed if the {{-S}} {{mail}} option is specified:| |
|{{-H}} _preferred_ _mailhost_|The preferred mail host for the domain. The host must be a fully qualified host name, for example, {{mailhost.sesta.com}}.\\
\\This option is mandatory if the {{-S mail}} option is specified.|
|The following options are only allowed if the {{-S}} {{cal}} option is specified:| |
|{{-B}} _backend calendar data server_|Specifies the default backend host assigned to a user or resource in a domain.|
|{{-C}} _searchable domains_|Specifies the domains to be searched when looking for calendars or users.|
|{{-g}} _access control string_|Specifies the Access Control List (ACL) for newly created user calendar.|
|{{-P}} _propertyname_[:_value_]|Sets values for multi-valued and bit oriented attributes. Refer to table [Attribute Values|Attribute Values and Calendar Time Zones#ACFIA] for attributes, their descriptions and values.|
|{{-R}} _right_[:_value_]|Sets calendar domain attribute {{icsAllowRights}}. The attribute holds a bitmap value. See [Attribute Values|Attribute Values and Calendar Time Zones#ACFIA] for a list of attributes, their value, and description.|
|{{-T}} _calendar time zone string_|Specifies the time zone ID used when importing files.\\
\\See [Calendar Time Zone Strings|Attribute Values and Calendar Time Zones#ACFIB] for a list of the valid time zone strings.|
h2. {anchor:ACFEO} Example
To create a new domain with mail, calendar, and instant messaging services, enter:
{panel}
{{commadmin domain create –D chris –d florizel.com –n sesta.com –w bolton \}}
{{–S mail,cal,im –H mailhost.sesta.com}}
{panel}
{panel:title=Product Version Information|borderColor=#ccc|titleBGColor=#F7D6C1| bgColor=#FFFFCE}
* *Current Features*
Features documented on this page were introduced in the following product release versions:
** Delegated Administrator 7:
*** Direct LDAP domain creation (no dependence on AM)
*** Support for IM service
{panel}
The {{commadmin domain create}} command creates a single domain in the LDAP directory. To create multiple domains, use the {{-i}} option.
h2. {anchor:ACFEM} Syntax
{panel}
{{commadmin domain create –D _login_ –d _domain name_ –n _domain_ –w _password_}}
{{ [–A [+] _attributename_:_value_] [–h] [–?] [–i _inputfile_] [–o _organization RDN_]}}
{{ [–p _AM port_] [–s] [–v] [–V] [–X _AM host_]}}
{{ [–S mail –H _preferred mailhost_]}}
{{ [–S cal [–B _backend calendar data server_] [–C _searchable domains_] [–g _access control string_]}}
{{ [–P _propertyname_[:_value_]] [–R _right_[:_value_]] [–T _calendar time zone string_] ]}}
{{ [–S im]}}
{panel}
h2. {anchor:ACFEN} Options
The following options are mandatory:
||Option ||Description ||
|{{-D}} _login_|The user ID of the Top-Level Administrator.|
|{{-d}} _domain name_|DNS domain name of the domain that is being created.|
|{{-n}} _domain_|The domain of the Top-Level Administrator.|
|{{-w}} _password_|The password of the Top-Level Administrator.|
The following options are non-mandatory:
||Option ||Description ||
|{{-A}} [+] _attributename_:_value_ |An attribute to modify. The _attributename_ is defined in the LDAP schema and the _value_ specified replaces any and all current values for this attribute in the directory. Repeat this option to modify multiple attributes at the same time, or to specify multiple values for the same attribute.\\
\\A “+” before the _attributename_ indicates adding the value to the current list of attributes.\\
\\If the action value (+), is not specified, the default action is to add the existing value.|
|{{-h, -?}}|Prints command usage syntax.|
|{{-i}} _inputfile_|Reads the command information from a file instead of the command line.\\
\\An option value specified in the input file overrides any value for the same option set in the command line.|
|{{-o}} _organization RDN_|Specifies the organization RDN for the domain. For example, {{o=varrius.florizel.com.}}\\
\\If this option is not specified, the organization is created under the {{osi}} {{suffix,}} with {{o=}} the name of the domain, {{o=osiSuffix.}}|
|{{-p}} _AM port_|Specifies an alternate TCP port where the Access Manager is listening. If not specified, the default _AM port_ is used, or Port 80 is used if no default was configured at install time.|
|{{-s}}|Use SSL (Secure Socket Layer) to connect to the Access Manager.|
|{{-v}}|Enable debugging output.|
|{{-V}}|Prints information about the utility and its version.|
|{{-X}} _AM host_|Specifies the host on which the Access Manager is running. If not specified, the default _AM host_ is used, or the localhost if no default was configured at install time.|
|{{-S}} _service_|Specifies the service or services to be added to the domain.\\
\\ _service_ can have the value of a single service or multiple services. The valid _service_ values are {{mail}}, and {{cal}}, and {{im}}_._ These values are case-insensitive.\\
\\If the {{-S mail}} option is specified, then the {{-H}} option must be specified.\\
\\Can be listed as a comma-separated list.\\
\\For Example:\\
\\ {{-S mail,cal,im}}\\
{panel:|borderColor=#ccc|bgColor=#FFFFCE}
*Delegated Administrator 7:* {{-S im}}
{panel}\\
\\ AM provisioning mode: A domain is created with the services mentioned depending on the value of the particular service definition present in the configuration file of Access Manager.|
|The following option is only allowed if the {{-S}} {{mail}} option is specified:| |
|{{-H}} _preferred_ _mailhost_|The preferred mail host for the domain. The host must be a fully qualified host name, for example, {{mailhost.sesta.com}}.\\
\\This option is mandatory if the {{-S mail}} option is specified.|
|The following options are only allowed if the {{-S}} {{cal}} option is specified:| |
|{{-B}} _backend calendar data server_|Specifies the default backend host assigned to a user or resource in a domain.|
|{{-C}} _searchable domains_|Specifies the domains to be searched when looking for calendars or users.|
|{{-g}} _access control string_|Specifies the Access Control List (ACL) for newly created user calendar.|
|{{-P}} _propertyname_[:_value_]|Sets values for multi-valued and bit oriented attributes. Refer to table [Attribute Values|Attribute Values and Calendar Time Zones#ACFIA] for attributes, their descriptions and values.|
|{{-R}} _right_[:_value_]|Sets calendar domain attribute {{icsAllowRights}}. The attribute holds a bitmap value. See [Attribute Values|Attribute Values and Calendar Time Zones#ACFIA] for a list of attributes, their value, and description.|
|{{-T}} _calendar time zone string_|Specifies the time zone ID used when importing files.\\
\\See [Calendar Time Zone Strings|Attribute Values and Calendar Time Zones#ACFIB] for a list of the valid time zone strings.|
h2. {anchor:ACFEO} Example
To create a new domain with mail, calendar, and instant messaging services, enter:
{panel}
{{commadmin domain create –D chris –d florizel.com –n sesta.com –w bolton \}}
{{–S mail,cal,im –H mailhost.sesta.com}}
{panel}
{panel:title=Product Version Information|borderColor=#ccc|titleBGColor=#F7D6C1| bgColor=#FFFFCE}
* *Current Features*
Features documented on this page were introduced in the following product release versions:
** Delegated Administrator 7:
*** Direct LDAP domain creation (no dependence on AM)
*** Support for IM service
{panel}