You can use Instant Messaging to archive poll, chat, conference, news channel, and alert content and email that content to end-users and administrators. You can use any email client to search and manage the archived content. This section describes the Instant Messaging email archive in the following sections:
The Instant Messaging server caches archived records until they are emailed. If you enable email archiving, the memory requirements for the server increase. See the Sun Java Communications Suite 5 Deployment Planning Guide for information on performance tuning.
You enable or disable the email archive provider by modifying a parameter value in iim.conf.
Ensure that you have enabled archiving for Instant Messaging as described in To Enable Instant Messaging Archiving.
Open iim.conf.
See iim.conf File Syntax for more information.
Add the following line to iim.conf if it does not already exist.
iim_server.msg_archive.provider = com.iplanet.im.server.EmailIMArchive |
The iim_server.msg_archive.provider parameter contains a comma-separated list of archive providers. If you want to enable the Portal archive in addition to the email archive for example, the parameter and its value should be entered as follows:
iim_server.msg_archive.provider = com.iplanet.im.server.IMPSArchive, \ com.iplanet.im.server.EmailIMArchive |
Save and close iim.conf.
Refresh the Instant Messaging server configuration.
imadmin refresh |
Open iim.conf.
See iim.conf File Syntax for more information.
Delete the com.iplanet.im.server.EmailIMArchive value from the iim_server.msg_archive.provider parameter.
Save and close iim.conf.
Refresh the Instant Messaging server configuration.
imadmin refresh |
You can configure which administrators will receive emails containing archived instant messages. You can configure a separate list of administrators to receive polls, news, conference, alerts, or chat sessions. You can also configure Instant Messaging to use the extended RFC 822 header. Doing so allows mail clients to filter messages based on the header content.
If you run configure after modifying these parameters for the email archive, any values you input will be overwritten.
Table 18–1 describes the configuration parameters you use to define which administrators will receive email archives, as well as whether or not to use the extended RFC 822 header, and the content of that header.
Table 18–1 Email Archive Configuration Parameters
Parameter |
Default Value |
Description |
---|---|---|
iim_arch.admin.email |
Empty String |
Comma-separated list of administrator email addresses. |
iim_arch.alert.admin.email |
None |
Comma-separated list of administrator email addresses to which all archived alert messages will be sent. This parameter overrides iim_arch.admin.email for alert messages. |
iim_arch.chat.admin.email |
None |
Comma-separated list of administrator email addresses to which all archived chat messages will be sent. This parameter overrides iim_arch.admin.email for chat messages. |
iim_arch.conference.admin.email |
None |
Comma-separated list of administrator email addresses to which all archived conference messages will be sent. This parameter overrides iim_arch.admin.email for conference messages. |
iim_arch.poll.admin.email |
None |
Comma-separated list of administrator email addresses to which all archived poll messages will be sent. This parameter overrides iim_arch.admin.email for poll messages. |
iim_arch.news.admin.email |
None |
Comma-separated list of administrator email addresses to which all archived news messages will be sent. This parameter overrides iim_arch.admin.email for news messages. |
iim_arch.email.archiveheader.name |
None |
Name of the extended RFC 822 header. |
iim_arch.email.archiveheader.value |
all |
Value corresponding to the header name for iim_arch.email.archiveheader.name. |
Open iim.conf.
See iim.conf File Syntax for more information.
Add the parameters in Table 18–1 and appropriate values to iim.conf.
Refresh the server.
imadmin refresh |
The RFC 822 header content for email messages containing various types of archived Instant Messaging content is described in the following sections:
Chat session initiator.
Receiver and any administrators configured in iim.conf. See Table 18–1 for more information.
Chat session initiator.
First useful message over 50 characters in length.
Creation date of the email message by the archive provider.
Not used.
Generated by the email archive provider based on the message thread.
Chat session initiator.
Other participants and any administrators configured in iim.conf. See Table 18–1 for more information.
Chat session initiator.
If a subject is set for the conference, the conference subject is used. If no subject is set, first useful message over 50 characters in length is used.
Creation date of the email message by the archive provider.
Not used.
Generated by the email archive provider based on the conference ID.
Room owner in archive data.
Associated mailing list, users with explicit access to the conference room, and any administrators configured in iim.conf. See Table 18–1 for more information.
Not used.
[Conference name] subject.
Creation date of the email message by the archive provider.
Not used.
Generated by the email archive provider based on the conference ID.
Poll sender.
Poll sender and any administrators configured in iim.conf. See Table 18–1 for more information.
Not used.
Poll question.
Creation date of the email message by the archive provider.
Not used.
Generated by the email archive provider.
Poll sender.
Poll recipients and any administrators configured in iim.conf. See Table 18–1 for more information.
Poll sender.
Poll question.
Creation date of the email message by the archive provider.
Not used.
Generated by the email archive provider.
Alert sender.
Alert recipients and any administrators configured in iim.conf. See Table 18–1 for more information.
Not used.
Alert subject.
Creation date of the email message by the archive provider.
Not used.
Generated by the email archive provider.
News channel post sender.
Mailing list associated with the news channel and any administrators configured in iim.conf. See Table 18–1 for more information.
Not used.
News channel post subject.
Creation date of the email message by the archive provider.
Not used.
Generated by the email archive provider based on the news channel ID.