Sun Java System Delegated Administrator 6.4 Administration Guide

Adding a New Calendar Time Zone

You can customize Delegated Administrator by adding a new Calendar Server time zone. Delegated Administrator can then provision organizations, users, groups, and resources with the new time zone.

To add a new time zone, perform the following tasks. To administer the new time zone with the Delegated Administrator utility, you must perform only the first task. To administer the new time zone through Delegated Administrator console, you must perform both tasks.

Once the time zone has been added, you can set it as the default time zone for newly created users by performing the following task:

To change the default time zone in Delegated Administrator

To add a new time zone in Delegated Administrator

You must perform this task before you can use either the commadmin utility or the Delegated Administrator console to provision users with the new time zone. This task updates Access Manager with the new time zone value. After this task is completed, you can use commadmin to assign the new time zone to users.

Add the time zone in Calendar Server.

To accomplish this step, you must edit the timezones.ics file and other Calendar Server files. For instructions, see “Adding a New Time Zone” in the chapter, “Managing Calendar Server Time Zones” in the Sun Java System Calendar Server Administration Guide.

Back up the UserCalendarService.xml and DomainCalendarService.xml files.

The xml files are located by default in the following directory:

da-base/lib/services

Edit the UserCalendarService.xml and DomainCalendarService.xml files to add the new time zone in Delegated Administrator.

In both the UserCalendarService.xml and DomainCalendarService.xml files, find the following entry heading:

<AttributeSchema name="icstimezone"
                            type="single choice"
                            syntax="string"
                            any="optional|adminDisplay">
                            <ChoiceValues>

Add the new time zone value to the list of <ChoiceValues>.

Run the Access Manager amadmin utility to delete the current service and add the updated service.

For both the UserCalendarService.xml and DomainCalendarService.xml files, run the following amadmin commands:
./amadmin -u <admin> -w <password> -r CalendarService
./amadmin -u <admin> -w <password> -s da_base/lib/services/CalendarService.xml
where CalendarService is either UserCalendarService or DomainCalendarService.

Note –
If you also intend to make the new time zone your default, you can run these amadmin commands after you have performed both tasks. For details, see To change the default time zone in Delegated Administrator.

Restart your Web container to enable the changes to take effect.

To enable the Delegated Administrator console to show the new time zone, see To display and administer the new time zone in the Delegated Administrator console.

To display and administer the new time zone in the Delegated Administrator console

This task adds the new time zone to the list of time zones displayed in the console. Next, the task enables the new time zone value to be saved in the directory.

To display the time zone in the console, you must add the new value to the Resources.properties file.

To allow the console to store the time zone in the directory, you must add the new value to two lists in the daconfig.properties file. The first list specifies the actual value stored in the LDAP directory. The second list enables the console to map the (possibly localized) display value of the time zone to the stored value.

Edit the Resources.properties file, located under your Delegated Administrator data directory.

The Resources.properties file is located by default in the following directory:
da-base/data/da/WEB-INF/classes/com/sun/ \ comm/da/resources
To edit Resources.properties, search for the rsrc.Timezone property and add the new time zone to the appropriate list. You can localize this display value of the new time zone.

Locate the list of time zone values in the daconfig.properties file, located under your Delegated Administrator data directory.

The daconfig.properties file is located by default in the following directory:
da-base/data/da/WEB-INF/classes/com/sun/ \ comm/da/resources
To find the list of time zone values, search for the following line:
```
#Timezone values - only English
```
These are the values stored in the LDAP directory. The new time zone must be in English; this is the required format for the values stored in the directory.

Add the new time zone to the list.

For example, to add America/Miami to the list, assuming Timezone1 currently has 24 values, you would add
```
rsrc.Timezone1-25=America/Miami
```
This value would be the 25th time zone displayed in the Americas drop-down list in the console. Note that the time zone may be displayed in another language, depending on what you specified in the Resources.properties file in the preceding task.

Locate the reverse-time zone mappings list in the daconfig.properties file.

This list keys the localized time zone value (displayed in the console) to the actual value, which you specified in Step 2, above.

To find the list of reverse mappings, search for the following line:
```
#reverse timezone mappings - used by DA in getting localized tz value
```

Add the new value to the reverse-mapping list.

For example, to add America/Miami to the list, you would add
```
rsrcKey-America-Miami=rsrc.Timezone1-25
```

Redeploy the edited daconfig.properties and Resources.properties files to the Web container used by the Delegated Administrator console.

Before the change can take effect, you must run the script that deploys the customized daconfig.properties file to your Web container.

For instructions on how to deploy a customized properties file to a particular Web container, see To Deploy a Customized Configuration File.

After you edit and redeploy the daconfig.properties and Resources.properties files, the new time zone will appear in the appropriate list boxes in the Delegated Administrator console. It will be saved in the directory whenever you select the time zone in the Delegated Administrator console and click Save.

To change the default time zone in Delegated Administrator

In the UserCalendarService.xml and DomainCalendarService.xml files, edit the following value:
<DefaultValues> <Value>America/Denver</Value> </DefaultValues>
You can find <DefaultValues> under the following entry in the xml files:
<AttributeSchema name="icstimezone"

Run the Access Manager amadmin utility to delete the current service and add the updated service.

For both the UserCalendarService.xml and DomainCalendarService.xml files, run the following amadmincommands:
./amadmin -u <admin> -w <password> -r DomainCalendarService
./amadmin -u <admin> -w <password> -s da_base/lib/services/DomainCalendarService.xml

Restart your Web container to enable the changes to take effect.