Sun Java System Calendar Server 6 2005Q4 Administration Guide

Configuring Pop-up Reminders

This section includes the following configuration instructions:

ProcedureTo Configure Instant Messaging Server

The high level list of tasks necessary to configure Instant Messaging for Pop-ups that follows is for your convenience. To configure Instant Messaging, refer to the Instant Messaging documentation available at:

http://docs.sun.com/coll/1309.2

  1. Install the new package SUNWiimag.

    Before you can use Instant Messaging for Pop-ups, the Instant Messaging package must be installed using the Java Enterprise System installer.

  2. On the machine where Instant Messaging is installed, change to the following directory:

    cd /etc/opt/SUNWiim/default/config

  3. Edit one or more of the parameters in the iim.conf file as shown in the following table.

    The parameter values shown assume you want pop-up reminders for both events and tasks. If these parameters do not already exist in your iim.conf file, add them.

    Parameter 

    Description and Appropriate Value to Use 

    JMS Consumers Section 

     

    jms.consumers

    Name of alarm. Set the value to cal_reminder.

    jms.consumer.cal_reminder.destination

    Destination of the alarm. Set the value to enp:///ics/customalarm 

    jms.consumer.cal_reminder.provider

    The name of the provider. Set to ens. This must be the same as the name in jms.providers in the JMS Providers section.

    jms.consumer.cal_reminder.type

    The type of alarm to set. Set the value to topic.

    jms.consumer.cal_reminder.param

    The alarm parameter. Set the value to "eventtype=calendar.alarm" (including the quotes)

    jms.consumer.cal_reminder.factory

    C++ factory name. Set the value to:  

    com.iplanet.im.server.
    JMSCalendarMessageListener

    JMS Providers Section 

     

    jms.providers

    The name of the provider. Set value to ens. This must be the same as the value listed in the JMS Consumers Section for jms.consumer.cal_reminder.provider.

    jms.provider.ens.broker=cal.example.com

    Port number that ENS listens on. Set to the port specified in the ics.conf file parameter service.ens.port. The default is 57997.

    jms.provider.ens.factory

    C++ factory to use. Set to com.iplanet.ens.jms.EnsTopicConnFactory

    Calendar Server General Parameters 

     

    iim_agent.enable

    Enables the Calendar agent. Set the value as follows including the quotes: 

    iim_agent.enable="true"

    iim_agent.agent-calendar.enable

    Loads a component that enables the Calendar agent. Set the value as follows including the quotes: 

    iim_agent.agent-calendar.enable="true"

    agent-calendar.jid

    The JID of the Calendar agent. Set this value as follows: 

    agent-calendar.jid=calimbot.server.domain

    agent-calendar.password

    The Calendar agent password. Set this value as follows: 

    agent-calendar.password=password

    iim_server.components

    Set this value as follows: 

    iim_server.components=agent-calendar

  4. Change to the directory where the imadmin command-line utility is located:

    cd /opt/SUNWiim/sbin

  5. Start the Calendar agent using imadmin:

    imadmin start agent-calendar

    The Calendar agent is an Instant Messaging component that provides pop-up functionality to Calendar Server users. Using tools provided with Instant Messaging, you can start, stop, restart, or check the status of the Calendar agent as well as monitor its activity through log files.


    Note –

    If you have scripts that include the stop, start and refresh commands, add the calendar agent to them.


    For more information about imadmin and the Calendar agent, see the Sun Java System Instant Messaging 7 2005Q1 Administration Guide.

ProcedureTo Configure Calendar Server

Before You Begin

Confirm that the ics.conf parameters shown in the following table have the values shown. If they do not, or you wish to customize them, perform the following steps:

  1. Log in as an administrator with permission to change the configuration.

  2. Change to the /etc/opt/SUNWics5/cal/config directory.

  3. Save your old ics.conf file by copying and renaming it.

  4. Edit the ics.conf parameters as shown in the following table:

    Parameter  

    Description and Default Value  

    caldb.serveralarms 

    Enables calendar alarms to be queued. The default is “yes” (enabled).

    caldb.serveralarms.contenttype 

    Output format for alarm content. The default is "text/xml".

    caldb.serveralarms.dispatch 

    Enables calendar alarms to be dispatched. The default is “yes”.

    caldb.serveralarms.dispatchtype 

    The type of server alarm to dispatch. The default is "ens".

    caldb.serveralarms.url 

    This is the URL for alarm retrieving alarm contents. The default is "enp:///ics/customalarm".

  5. Save the file as ics.conf.

  6. Restart Calendar Server.

    cal_svr_base/SUNWics5/cal/sbin/start-cal

ProcedureTo Configure Instant Messenger

To receive pop-up reminders for Calendar Server events and tasks, end users must configure their Instant Messenger as follows:

  1. On the Main window, from the Tools menu, select Settings.

  2. On the Settings window, click the Alerts tab.

  3. Check the Show Calendar Reminders option.

  4. Click OK.