Sun Java System Delegated Administrator 6.4 Administration Guide

commadmin domain modify

The commadmin domain modify command modifies attributes of a single domain’s directory entry. To modify multiple domains, use the -i option.

Syntax

commadmin domain modify -D login -d domain -n domain -w password
   [-A [+|-]attributename:value] [-h] [?] [-i inputfile] [-p AM port] [-s] [-v] [-V]
   [-X AM host]
   [-S mail -H preferred mailhost]
   [-S cal [-g access string] [-C cross domain search domains] [-B backend calendar data server]
   [-P [action]propertyname[:value]] [-R propertyname[:value]] [-T calendar time zone string]]

Options

The following options are mandatory:

Option  

Description  

-D login

The user ID of the Top-Level Administrator. 

-d domain

The DNS domain name to be modified. If -d is not specified, the domain specified by -n is used.

-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 value 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. A “-” indicates removing the value.

If the “-” is used, it must be preceded by two backslashes if the command is specified on the command line. If the option is provided within an input file, one backslash must precede the “-” sign. 

If the action value (+ or -), is not specified, the default action is to replace the existing value.

-h, -?

Prints command usage syntax. 

-i inputfile

Reads the command information from a file instead of the command line. 

-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

Adds the specified service or services to the domain during modification. 

The valid service values are mail and cal. These values are case-insensitive.

The services listed with the -S option are separated by a comma.

If -S mail is specified, then the -H option must be specified.

When adding a service, the following option is only allowed if the -S mail option is specified:

 

-H preferred mailhost

The preferred mailhost for the domain. 

This option is mandatory if the -S mail option is specified.

When adding a service, the following options are only allowed if the -S cal option is specified:

 

-B backend calendar data server

The default backend host assigned to a user or resource in a domain. 

-C cross domain search domains

Specifies the domains to be searched when looking for calendars or users. 

-g access string

Specifies the Access Control List (ACL) for newly created user calendar. 

-P [action]propertyname[:value]

Sets the values for multi-valued and bit oriented attributes. Refer to table Attribute Values for the descriptions and values of propertyname.

-T calendar time zone string

Time zone ID used when importing files. 

See Calendar Time Zone Strings for a list of the valid time zone strings.

-R propertyname[:value]

Sets calendar domain attribute icsAllowRights. The attribute holds a bitmap value. See Attribute Values for a list property names, their value, and description.

Example

To modify an existing domain:


commadmin domain modify -D chris -w bolton -n sesta.com -d varrius.com \
-A preferredmailhost:test.siroe.com