Previous     Contents     Index     Next     
iPlanet Portal Server: Mobile Access Pack Administration Guide



Chapter 4   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

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.

  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.


    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

    Replace server_name with the complete URL of your address book server and port 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.


  8. Select Add.

  9. In the IMAP Server Name To Authenticate Against text field, specify the name of the IMAP server to authenticate against.


    Note

    Authentication of the user against the IMAP server specified here is used to validate the user's credentials.


  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

    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

    Replace install_directory with Messaging Server's installation directory and hostname with the name of Messaging Server.

    This returns the address book admin DN.


  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.


    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

    Replace install_directory with Messaging Server's installation directory and hostname with the name of Messaging Server.

    This returns the address book admin password.


  14. In the Directory Searchbase text field, specify the address book search origin.


    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

    Replace install_directory with the Messaging Server installation directory and hostname with the name of Messaging Server.

    This returns the directory search base.


  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.


    Tip

    The values are:

    • true, to display entries in the channel

    • false, to prevent display


  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:

    • 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.


  11. In the Sort On Given Field text field, specify what field to use for sorting address book entries.


    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.


  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.

  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.


    Tip

    The channel can be thin, thick, full top, or full bottom.


  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.


    Tip

    Use this format to specify the line count:

    clientType|number

    For example:

    pana_p503i|8


  19. Select Submit and then Continue.


Previous     Contents     Index     Next     
Copyright © 2001 Sun Microsystems, Inc. All rights reserved.

Last Updated November 20, 2001