Creating a New i-Planet User

You can create a new i-Planet user using the properties of an existing i-Planet user, using the configuration files that you specify, or using system defaults as the basis:

• If you specify both -srclogin SRCID and destlogin DESTID, create creates a login ID DESTID that is based on the properties of the existing i-Planet user named SRCID.

• If you specify only -destlogin DESTID, the new i-Planet user DESTID is based on the system default settings.

• If you specify neither -srclogin nor -destlogin, the information for one or more new i-Planet users is gathered from default configuration files.

Creating a New i-Planet User Using an Existing i-Planet User As the Basis

If you provide both the -srclogin SRCID and -destlogin DESTID switches, the create action makes a new i-Planet user based on the properties of the existing i-Planet user that you specified. The new i-Planet user has the login ID of DESTID and has each property of the i-Planet user with login ID SRCID (except the IMAP password).

To Create a New i-Planet User Using an Existing i-Planet User As the Basis

1. Type the following command to create a new i-Planet user using an existing i-Planet user as a basis, for example:

   # java com.sun.stnr.useradmin.UserAdminCL +action create -srclogin olduser \ -destlogin newuser

   This command returns the confirmation that the user indicated in the command was created:

   # + created user=bc81306

Creating an i-Planet User from System Defaults

If you provide only the -destlogin DESTID switch, then you create a new i-Planet user based on system defaults. The system defaults for creating a i-Planet user in this fashion are stored in the default i-Planet user configuration file and the default profile file.

The following properties are in i-Planet's default user configuration file /etc/opt/SUNWstnr/defaultUser.conf:

• Common.UserName

• Common.FirstName

• Common.LastName

• Common.MailServer

• Common.CalendarServer

• Common.EmployeeNumber

• Common.DefaultMailServer

• SNDesktop.userTemplatePath

• SNDesktop.prefTemplatePath

• SNDesktop.feedbackTemplatePath

• SNDesktop.advancedTemplatePath

• SNDesktop.checkCalendar

• SNDesktop.checkMail

• SNDesktop.lang

• SNDesktop.serviceTimeout

The following properties are stored in i-Planet's /opt/SUNWjeev/profiles/.default file:

• role

• user.url

  ---

  Note -

  You can edit these files directly to set defaults for all new i-Planet users in the system. Each file consists of key value pairs separated by an =, with one pair on each line.

  ---

To Create a New i-Planet User Using System Defaults As a Basis

1. Type the following command to create a new i-Planet user using system defaults as a basis, for example:

   # java com.sun.stnr.useradmin.UserAdminCL +action create -destlogin bc81306

   This command returns the confirmation that the user indicated in the command was created:

   + created user=bc81306

Creating New i-Planet Users From a Text File

If you specify neither -srclogin nor -destlogin switches with the create action, then UserAdminCL reads data for the new i-Planet user from text files. You can create multiple identical i-Planet users using predefined defaults that are set up in a defaults file, or by specifying the per i-Planet user configuration in a flat file, or both. You can specify two command line switches:

• usersfile--Specifies the users file, and defaults to ./users if not specified.

• defsfile--Specifies the defaults file, and defaults to ./defaults, if not specified.

Each line in the users file contains information for a single user in the form of one or more key-value pairs. Keys and values are separated by an = (equals sign), and key-value pairs are separated by a ; (semicolon); see the example for the Procedure "To Create New Users From a Text File" below. Only the key session.uid is required--any other pairs are optional.

The defaults file format is identical to that of the i-Planet users file, except that it contains only a single line of properties. The properties specified in the defaults are applied to each i-Planet user named in the i-Planet users file for any values not explicitly specified in the i-Planet user's file.

i-Planet stores an i-Planet user's IMAP mail password as an encrypted value. It is encrypted with a proprietary algorithm. If you wish to specify a mail password for each i-Planet user in the users file, you can do so, but it must be in plain text. The password will be encrypted before it is saved.

For example, to add three i-Planet users and specify an IMAP password, a mail server, and calendar server for each, you can use the following procedure.

To Create New Users From a Text File

1. Create a ./users file, for example.

   This file should contain the following information:

   session.uid=bob;IMAP.Mail.password=gimme session.uid=bill;IMAP.Mail.password=bokbok session.uid=jan;IMAP.Mail.password=joshua

   This file is used to specify information that is different for each i-Planet user that is being created. At a minimum, each i-Planet user's login name (session.uid) and the IMAP mail password (IMAP.Mail.password) falls into this category.

2. Because the mail and calendar server are constant among all the i-Planet users, create a ./defaults file with a single line to populate the mail and calendar server values for all users, for example:

   Common.MailServer=foo.bar.com;Common.CalendarServer=farble.bar.com

3. With these files in place, type the following command to run UserAdminCL:

   # java com.sun.stnr.useradmin.UserAdminCL +action create + created login=bob + created login=bill + created login=jan

   This command returns the confirmation that the user or users indicated in the command were created:

   + created login=bob + created login=bill + created login=jan