Configuring Address Book
The Mobile Access Pack address book provider allows you to set up an address book channel that displays summary address book entries with links that launch the iPlanet Messaging Server’s Messenger Express client, allowing the user to control the address book.
This chapter discusses how to use the Administration Console to configure the address book channel for your mobile device user. It explains the following tasks:
• Enabling Access to Address Book
• Configuring Channel Display
• Configuring Channel Layout
Enabling Access to Address Book
You must set up the address book channel before the user can use the address book channel.
To enable access to the address book, complete the following steps:
1. As root, log in to the Administration Console and select Manage Domains from the left frame.
2. Select the link for your server’s domain.
3. Select the icon next to the Applications heading to display the Applications list.
NOTE If you previously installed and uninstalled the Mobile Access Pack software, address book settings from your previous installation were not removed. Be sure that you review all of your settings when you set up the address book for your mobile device users.
Enabling Access to Address Book
4. Select the Desktop link to display the profile for the desktop.
5. From the Available Channels list, select iwtAddressBookProvider.
6. Select Edit Channel to display address book provider attributes.
7. In the Client URL text field, specify the base URL of the address book client.
8. Select Add.
9. In the IMAP Server Name To Authenticate Against text field, specify the name of the IMAP server to authenticate against.
10. In the Address Book LDAP Server text field, specify the LDAP server name where the address book is stored.
11. In the Address Book LDAP Server Port text field, specify the port number where the address book LDAP server is running. Its default value is set to 389.
12. In the Address Book Admin User DN field, specify the address book administrator’s name.
This user name is used to bind to the server.
TIP This field is optional. If you do not specify a client URL, Mobile Access Pack creates one from the IMAP Server Name To Authenticate Against that you specify and from the mail channel’s Client Port attribute.
To specify the URL, use this format:
genericHTML|server_name:port
Replaceserver_namewith the complete URL of your address book server andport with the port number of your address book server.
For example:
genericHTML|http://siroe.iplanet.com:80 Include all of the parameters in the URL.
NOTE Authentication of the user against the IMAP server specified here is used to validate the user’s credentials.
Enabling Access to Address Book
Chapter 4 Configuring Address Book 37
13. In the Address Book Admin User Password text field, specify the address book administrator’s password.
This password is used to bind to the server.
14. In the Directory Searchbase text field, specify the address book search origin.
TIP To obtain the address book admin DN, perform the following steps:
1. As root, log in to the iPlanet Messaging Server 5.1 server machine.
2. Issue a command of the form:
/install_directory/server5/msg-hostname/configutil | grep local.service.pab.ldapbinddn
Replaceinstall_directory with Messaging Server’s installation directory andhostname with the name of Messaging Server.
This returns the address book admin DN.
TIP To obtain the address book password, perform the following steps:
1. As root, log in to the iPlanet Messaging Server 5.1 server machine.
2. Issue a command of the form:
/install_directory/server5/msg-hostname/configutil | grep local.service.pab.ldappasswd
Replaceinstall_directory with Messaging Server’s installation directory andhostname with the name of Messaging Server.
This returns the address book admin password.
TIP To obtain the directory search base, perform the following steps:
1. As root, log in to the iPlanet Messaging Server 5.1 server machine.
2. Issue a command of the form:
/install_directory/server5/msg-hostname/configutil | grep local.ugldapbasedn
Replaceinstall_directory with the Messaging Server installation directory andhostname with the name of Messaging Server.
This returns the directory search base.
Configuring Channel Display
15. Select Submit and then select Continue.
Configuring Channel Display
You can control the appearance of entries in the address book channel by
specifying number of entries and default sorting criteria, in addition to specifying whether to turn display on or off.
To configure the display of the entries in the address book channel, complete the following steps:
1. As root, log in to the Administration Console and select Manage Domains.
2. Select the link for your server’s domain.
3. Select the icon next to the Applications heading to display the Applications list.
4. Select the Desktop link to display the profile for the desktop.
5. From the list of available channels, select iwtAddressBookProvider.
6. Select Edit Channel to display the address book provider attributes.
7. In the Display Entries text field, specify whether to display the entries.
8. In the Number Of Entries text field, specify the number of entries to display in the address book channel.
9. In the Maximum Number Of Entries text field, specify the maximum number of entries that the user can set in the Number of Entries text field.
10. In the Sort Order text field, specify what order to sort the entries.
TIP The values are:
• true, to display entries in the channel
• false, to prevent display
Configuring Channel Layout
Chapter 4 Configuring Address Book 39
11. In the Sort On Given Field text field, specify what field to use for sorting address book entries.
12. Select Submit and then select Continue.
Configuring Channel Layout
You can control the layout of entries in the address book channel by specifying name, background color, width and refresh time, in addition to specifying other channel layout attributes.
To configure the layout of the address book channel, complete the following steps:
1. As root, log in to the Administration Console and select Manage Domains.
2. Select the link to your server’s domain name.
3. Select the icon next to the Applications heading to display the Applications list.
4. Select the Desktop link to display the profile for the desktop.
5. From the list of available channels, select iwtAddressBookProvider.
6. Select Edit Channel to display the address book provider attributes.
7. Select Show Advanced Options to display additional attributes.
TIP The values are:
• up, to sort in ascending order
• down, to sort in descending order
• none, to leave entries unsorted
By default, entries are sorted in ascending order.
TIP The values are:
• ln, to sort by last name
• fn, to sort by first name
• none, to leave entries unsorted By default, entries are sorted by last name.
Configuring Channel Layout
8. In the Title text field, specify a name for the channel.
The specified address book channel content is displayed with this name.
9. In the Background Color text field, specify a background color for the channel.
10. From the Width list, select the channel width.
11. Select the Detached check box to detach the channel from the desktop, if desired.
12. Select the Minimized check box to minimize the channel in the desktop, if desired.
13. In the Refresh Time text field, specify the frequency for updating or refreshing content in the channel.
14. Select the Framed check box to frame the channel in the desktop, if desired.
15. In the Column text field, specify the number of columns in the channel.
16. In the Row text field, specify the number of rows in the channel.
17. From the Number of AB Lines to Display Via JSP list, select the mobile device that you want to configure.
18. In the Number of AB Lines to Display Via JSP text box, specify the number of lines to display in this mobile device’s address book.
19. Select Submit and then Continue.
TIP The channel can be thin, thick, full top, or full bottom.
TIP Use this format to specify the line count:
clientType|number For example:
pana_p503i|8
41