This chapter describes how to configure the Oracle Communications Instant Messaging Server calendar agent.
This section describes how to configure Instant Messaging Server for Java Message Service (JMS) to support Oracle Communications Calendar Server Agent alerts. You can configure Instant Messaging Server either by running the configure command or by manually configuring the necessary properties with the imconfutil command. You do not need to configure Calendar Server itself to support calendar reminders.
No special steps are needed to configure Calendar Server to work with Instant Messaging Server. However, you do need to configure the Instant Messaging Server Calendar Agent. This section describes the two ways in which you can configure Instant Messaging Server, and properties that need to be configured.
To configure Instant Messaging Server Calendar Agent with Calendar Server:
Run the configure utility, for example:
/opt/sun/comms/im/sbin/configure --nodisplay
Respond to the Calendar Agent configuration prompts as follows:
Do you want to go back to previous panel [no]:no Enable Calendar Agent [no]:y Enable local component [no]:y XMPP server hostname [hostname]: host_name XMPP server port [port number]: port_number JMQ Username: username JMQ Password: password Notification Server Hostname [localhost]: host_name Notification Server Port [port number]: port_number Topic: testTopic
After running the configure utility, use the imconfutil command to set the contenttype property.
For example:
/opt/sun/comms/im/sbin/imconfutil -c InstantMessaging_home/config/iim.conf.xml set-prop agent-calendar.serveralarms.contenttype=text/plain
If you did not configure the Calendar Agent while running the configure command, you can use the imconfutil command to manually set the properties.
The following example shows how to set the list of properties in "JMS and Calendar Agent Properties" by running the imconfutil command:
imconfutil -c InstantMessaging_homem/config/iim.conf.xml add-component id=calagent jid=calendar.domain password=secret imconfutil -c InstantMessaging_home/config/iim.conf.xml set-prop agent-calendar.broker.address=host.domain:7676 imconfutil -c InstantMessaging_home/config/iim.conf.xml set-prop agent-calendar.consumer.topic=DavNotificationTopic imconfutil -c InstantMessaging_home/config/iim.conf.xml set-prop agent-calendar.imadmin.enable=true imconfutil -c InstantMessaging_home/iim.conf.xml set-prop iim_agent.agent-calendar.enable=true imconfutil -c InstantMessaging_home/iim.conf.xml set-prop agent-calendar.iim_server.host=host.domain imconfutil -c InstantMessaging_home/iim.conf.xml set-prop agent-calendar.iim_server.port=5269 imconfutil -c InstantMessaging_home/iim.conf.xml set-prop iim_agent.enable=true imconfutil -c InstantMessaging_home/iim.conf.xml set-prop agent-calendar.jid=calendar.domain imconfutil -c InstantMessaging_home/iim.conf.xml set-prop agent-calendar.password=secret imconfutil -c InstantMessaging_home/iim.conf.xml set-prop agent-calendar.serveralarms.contenttype=text/plain
Optional: Run the following command if your imqbrokerd is configured with a user name and password. You do not have to run the following command if Java Message Queue (JMQ) is being used from GlassFish Server.
imconfutil -c /opt/sun/comms/im/config/iim.conf.xml add-jmqbroker id=jmq1 address=host_name:port user=guest password=guest
Table 23-1 list the JMS properties that you configure for Instant Messaging Server.
Table 23-1 JMS API Configuration Properties
| Property | Default Value | Description |
|---|---|---|
|
agent-calendar.broker.address |
JMQserver:port |
Specifies the host name and port on which the broker (JMQ) is running. |
|
agent-calendar.consumer.topic |
topic |
Topic on which the calendar notifications are delivered. |
|
agent-calendar.broker.user |
guest |
Specifies the broker user name. |
|
agent-calendar.broker.password |
guest |
Specifies the password of the broker user name. |
Table 23-2 list the Calendar Agent properties that you configure for Instant Messaging Server.
Table 23-2 Instant Messaging Server Calendar Agent Configuration Properties
| Property | Value | Description |
|---|---|---|
|
agent-calendar.imadmin.enable |
false |
If set to true, you can start the agent-calendar by using the imadmin command. |
|
iim_agent.agent-calendar.enable |
false |
If set to true, you can start the agent-calendar by using the imadmin command. |
|
agent-calendar.iim_server.host |
NA |
Host name of the Instant Messaging server with which the agent calendar communicates. |
|
agent-calendar.iim_server.port |
NA |
Port number of the Instant Messaging server with which the agent calendar communicates. |
|
iim_agent.enable |
true |
Enables agents for Instant Messaging Server. |
|
iim_agent.enable |
true |
Enables agents for Instant Messaging Server. |
|
agent-calendar.password |
NA |
Password used by the Calendar Agent component to authenticate the Instant Messaging Server. |
|
agent-calendar.serveralarms.contenttype |
NA |
Content type used to deliver calendar alerts. Can be text/plain or text/ical. |
Notes About Configuring Calendar Server
No additional steps are required to configure Calendar Server to work with Instant Messaging Server.
By default, Calendar Server is configured with the DavNotificationTopic configuration parameter. Use DavNotificationTopic as the value for the agent-calendar.consumer.topic property.
GlassFish Server uses Java Message Queue on port 7676 independently of Messaging Server and Calendar Server. A single host installation of Calendar Server might see problems with port 7676 being occupied if GlassFish Server is already installed on that host. To avoid this problem, edit the /etc/imq/imqbrokerd.conf file in the Oracle Solaris default path and set the ARGS=-port parameter to a free port.
imqbrokerd should be up and running for Calendar Server alerts to work when configured with Java Message Queue.