HP Email Archiving software for IBM Lotus Domino Version 2.
Legal and notice information © Copyright 2007-2009 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . Intended audience . . . . . . . Related documentation . . . . . Document conventions and symbols HP technical support . . . . . . Subscription service . . . . . . Other Web sites . . . . . . . . 1 System overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Execution Settings . . . . . . . . . . . . . DWA Settings . . . . . . . . . . . . . . . Debug Options . . . . . . . . . . . . . . Preprocessing messages . . . . . . . . . . . . Preprocessing and reference databases . . . . Configuring the Preprocessing Control documents Databases Location tab . . . . . . . . . Encapsulation Settings . . . . . . . . . Agent Log Settings . . . . . . . . . . . Execution Settings . . . . . . . . . . . Debug Settings . . . . . . . . . . . . Viewing references . . . . . . . . . .
6 Configuring compliance (journal) archiving . . . . . . . . . . . . . Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Encrypted messages . . . . . . . . . . . . . . . . . . . . . . . Calendar notices . . . . . . . . . . . . . . . . . . . . . . . . Mail-To-Me messages . . . . . . . . . . . . . . . . . . . . . . . Journaling recommendations . . . . . . . . . . . . . . . . . . . . . Advanced Filtering (HP EAs Domino journaling) . . . . . . . . . . . Domino native journaling . . . . . . .
Configuring the plug-in installer . . . . . . . . . . . . . . . . . . Installing the plug-in . . . . . . . . . . . . . . . . . . . . . . . Using the Windows Notes Client Plug-In with Local Cache . . . . . . . . . Adding the tombstone icon (optional) . . . . . . . . . . . . . . . . . . Retrieving and viewing encapsulated messages . . . . . . . . . . . . . . Retrieving and opening encapsulated messages in Lotus Notes and DWA Opening encapsulated messages in the IAP Web Interface . . . . . . .
Tables 1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 2 IAP and EAs applications for users . . . . . . . . . . . . . . . . . . . . . . . . 13 3 IAP and EAs applications for administrators . . . . . . . . . . . . . . . . . . . . . 14 4 Supported platforms and operating systems . . . . . . . . . . . . . . . . . . . . . 15 5 HP EAs Domino character support . . . . . . . . . . . . . . . . . . . . . . . . . 17 6 Common administration tasks . . . . . . . . . . . .
About this guide HP Email Archiving software for IBM Lotus Domino (HP EAs Domino) is mail administration software that mines messages from Lotus Notes mail databases and/or journal databases and places the messages in the HP Integrated Archive Platform (IAP) architecture. This guide explains how to configure and administer HP EAs Domino to enable mining of Notes databases. NOTE: The Integrated Archive Platform was formerly known as the Reference Information Storage System, or RISS.
Document conventions and symbols Table 1 Document conventions Convention Element Medium blue text: Related documentation Cross-reference links and email addresses Medium blue, underlined text (http://www.hp.
HP technical support Telephone numbers for worldwide technical support are listed on the HP support Web site: http://www.hp.com/support/. Collect the following information before calling: • • • • • • Technical support registration number (if applicable) Product serial numbers Product model names and numbers Applicable error messages Operating system type and revision level Detailed, specific questions For continuous quality improvement, calls may be recorded or monitored.
About this guide
1 System overview This chapter provides an overview of the IAP system and HP EAs Domino software. It contains the following topics: • • • • IAP and EAs, page 13 System requirements and prerequisites, page 14 Character support, page 16 Architecture, page 18 IAP and EAs IAP is a fault-tolerant, secure system of hardware and software that archives email messages and attachments for your organization, and lets users search for archived documents.
System administrators can use the following troubleshooting and administrative tools: Table 3 IAP and EAs applications for administrators Application Description HP EAs Domino server software System administrators can use the software to create selective archiving and journaling rules and configure agents for archiving email messages. IAP Platform Control Center (PCC) Administrators can monitor and troubleshoot system status and performance, and manage IAP user accounts using their Web browser.
Table 4 Supported platforms and operating systems Platform OS EAs–D advanced filtering Support via local mining or Active Gateway (remote mining) Support only via Active Gateway (remote mining) Lotus Domino release Windows server 2003 6.5.6, 7.x, 8.0.x, 8.5.x 6.5.6, 7.x, 8.0.x, 8.5.x Windows server 2000 6.5.6, 7.x 6.5.6, 7.x Red Hat Enterprise Linux 5 8.0.x 8.0.x Red Hat Enterprise Linux 4 7.x 7.x SUSE Linux Enterprise Server 10 7.x 7.x, 8.0.x SUSE Linux Enterprise Server 9 7.x 7.
Supported Lotus Notes clients • • • • Windows 2000: Lotus Notes 7.0.x and 8.0.x (Standard and Basic) Windows XP: Lotus Notes 6.5.x, 7.0.x, 8.0.x, 8.5.x (Standard and Basic) Windows Vista: Lotus Notes 7.0.x, 8.0.x, 8.5.x (Standard and Basic) Red Hat Linux and Macintosh OS: 8.0.x (Standard) by request to HP IAP Web Interface The Web Interface can be accessed with the following browsers: • Microsoft Internet Explorer (Windows) 6.x and 7.x • Mozilla Firefox 2.x and 3.
Table 5 HP EAs Domino character support Supported character set Description ISO-8859-1 Western European, extended ASCII ISO-8859-15 Western European, variant of ISO-8859-1 WINDOWS-1252 Western European (Windows variant of ISO-8859-1) US-ASCII 7-bit American Standard Code for Information Interchange UTF-8 Unicode/Universal Character Set (all modern languages) ISO-8859-2 Eastern European KOI8-R Cyrillic (Russian and Bulgarian) ISO-8859-5 Cyrillic (Bulgarian, Belarusian, Russian) WINDOWS-1251
Architecture The HP EAs Domino software can be installed on a mail server or it can be installed on a separate processing server such as the HP gateway.
2 Preparing to run HP EAs Domino This chapter contains information about preparing your environment to install and run HP EAs Domino.
How HP EAs Domino works with your current system and configuration • • • • Clustering does not affect EAs Domino. Partitioning has no affect on EAs Domino. Shared mail has no effect on EAs Domino. A replica of your Domino Directory(ies) is installed on the HP gateway server(s) and is modified during the DAS process (synchronization of user information with the IAP). EAs Domino does not update the Domino Directory itself. • Any mail template that is supplied by Lotus is functional with EAs Domino.
Installing HP EAs Domino EAs Domino can be loaded on and signed by the HP gateway server(s) for remote mining, installed directly on the mail servers for local mining, or installed on Domino journal or application servers for local or remote mining. Your HP service representative performs the installation of the EAs server software on the servers. The Agent Manager, Router, and Replicator server tasks must be running while the EAs Domino software is installed.
6. Change the Daytime Parameter values as shown in the table below. (In some circumstances, your HP representative or HP support might recommend increasing these values.) Field Description Start time Enter 08:00 AM. End time Enter 08:00 PM. Max concurrent agents Enter 5. Max LotusScript/Java execution time Enter 240 minutes. Max % busy before delay Enter 50. 7. Change the Nighttime Parameter values as shown in the table below.
3 HP EAs Domino configuration basics • • • • • • HP EAs–D API, page 23 Editing the Global Configuration document, page 24 Configuring the Server Definition document, page 27 Preprocessing messages, page 35 Viewing references, page 40 Working with log files, page 41 HP EAs-D API The EAs databases are installed in the hprim folder of the Domino data directory or notesdata directory. All EAs Domino modules are registered into the main configuration database, HP EAs-D API (hp_rissapi.nsf).
Editing the Global Configuration document The Global Configuration document registers the HP EAs-D API database and configures the EAs Domino binaries on servers where the EAs software is installed. To configure the Global Configuration document: 1. Open the HP EAs-D API database. 2. Double-click Global Configuration EAs Domino in the EAs-D API main view. The Global Configuration document appears.
General Settings tab View the standard databases that were created during installation of the software. User’s Mail file details database Database containing the EAs user mail records on the mail server (hprim/hp_rissuser.nsf). Journaling filtering rules database Filtering rules for EAs journaling (hprim/ hp_rissapi.nsf). Module’s log database The mining log database (hprim/hp_risslog.nsf). Additional Modules tab View the additional databases that were created during installation of the software.
DWA Index Settings EAs Domino’s DWA Extension feature allows users to access tombstoned messages in Domino Web Access. If you plan to use DWA Extension, edit the Retention field in this tab and configure DWA support. See “Configuring DWA Extension” on page 47. Field Description DWA Index database Leave the default: hprim\hp_dwaindex.nsf. This database contains the software to accept and process requests to retrieve archived messages from the IAP and return them to the request user’s browser.
Administration Alert tab Edit the settings for email alerts to be sent to the administrator if an EAs Domino task is not running properly. Field Description From Enter a value such as Global Config or IAP system. SendTo You can change the default value (LotusNotesAdministrator) by: • Clicking the arrow. • Removing the default value. • Adding a name from the address list. • Clicking OK. Subject You can change the subject from the default.
Server Settings tab Field Description Domino Server(s) Click the arrow and select the message processing server(s) or the DWA Proxy Gateway server(s) to be included in the server definition. Only DWA proxy servers or servers that run the EAs Domino code should be listed in this field. In a remote mining configuration, add the HP gateway(s) or the journal or application servers. Do not add the mail servers or the servers on which the journal mail-in databases reside.
Archiving Options tab Field Description Ensure Owner Receipt When a message is sent to a user’s mailbox via a distribution list, the user is not specifically included in the recipient list. Clicking Yes allows the email to be archived in the user’s mailbox repository. Note that when Duplicate Manager is enabled on the IAP, this does not result in a duplicate copy of the message. This option is used only for selective archiving. It does not apply to compliance archiving and, if enabled, is ignored.
Address Conversion Settings The address conversion settings: • Resolve SMTP aliases. • Allow for resolution of groups from multiple Domino domains. • Allow configuration of a single additional Domino Directory for resolution of group names. Field Description Use Global Config Override — use Server Definition Config • If the address conversion settings apply to all Domino servers in the domain, select Use Global Config and configure address conversion in the Global Configuration document.
Multiple Domino Domain tab Field Description Resolve addresses for additional Domino domains Select the check box to resolve addresses. Secondary directory for name lookups Enter the filename of an additional Domino Directory for name resolution. A Directory Catalog can be used if the configuration includes more than two Domino mail domains. Alias lookup view in second directory Leave $Users (the default).
Profile Agent Settings Field Description Use ’Address Conversion Settings’ Leave the default (with the check box selected) unless you plan to use an alternate Domino Directory to identify users for selective archiving. (For example, if you have set up a Directory Assistance database.) If you plan to use an alternate Domino Directory to identify users, deselect the check box and complete the remaining fields in this tab.
Execution Settings Field Description Error Notifications Select the user or group from the list who should be notified when there are errors executing the Archive or Tombstone mining agents. For example, LocalDomainAdmins. Maximum Session Size for Archive For local mining, leave the default (300M). For remote mining, increase to 500M on an Active Gateway or journal server. Maximum Documents to Archive For local mining, leave the default (3000).
DWA Settings During archive processing, a signed or encrypted message is encapsulated, or encased in its own database, to keep message data intact. The database with the encapsulated message is then attached to the original message and sent to the IAP. When the message is retrieved in DWA, it needs to be unencapsulated for the user to view it.
Debug Options Debug options are used by HP support to help diagnose problems that might occur during message archiving. • • • • The The The The Archive tab enables debugging for the Archive agent. Tombstone tab enables debugging for the Tombstone agent. Field Remapper tab enables debugging for message headers. Body Parser tab enables debugging for the unique message ID (hash).
Function Preprocessing database name Reference database name Selective archiving hprim\hp_preproc_miner.nsf hprim/hp_riss_minerreferenc.nsf Compliance archiving hprim\hp_preproc_journal.nsf hprim/hp_riss_journalreferenc.nsf Bulk upload hprim\hp_preproc_blk.nsf hprim/hp_riss_blkupdreferenc.nsf NOTE: The preprocessing and reference databases should not be replicated.
Databases Location tab Field Description Domino Server(s) Enter the name of the server running the Encapsulate agent. For local mining, this would be the local mail server(s). For remote mining, this would be the HP gateway server(s) or application/journal server(s). PreProcess Database The path and filename are pre-set in the default documents: • hprim\hp_preproc_miner.nsf for selective archiving • hprim\hp_preproc_journal.nsf for journaling • hprim\hp_preproc_blk.
Field Description Encapsulation Database Do not edit this field. A copy of the message is encased in the encapsulation database. The database is then renamed (for example, encap001.nsf, encap002.nsf) and added as an attachment to the message. Temporary Work Area This field lists the directory on the message processing server that temporarily stores the encapsulation databases while the messages are being encapsulated.
Agent Log Settings Field Description Log Path and Filename Leave the default. Encapsulate Log ID Leave the default. CleanUp Log ID Leave the default. Execution Settings Field Description Maximum Session Size The size of the total number of messages that can be processed by the Encapsulate agent in a session. The default is 300M; this size can be increased to 500M for remote mining.
Debug Settings The debug option is used by HP support to help diagnose problems that might occur during message preprocessing. Under normal operation this option should be disabled. Ensure that the Debug Level is set to None, unless you are asked by HP support to enable debugging. Viewing references Reference databases contain pointers to messages that are eligible for archiving. The EAs agents create and remove these pointers as needed.
3. Double-click the message entry for more information about a reference. Each message has a universal ID (UNID). Messages can be in one of the following states: • Preprocess: An encapsulated message is being processed. • Pending: A message has not been sent to the IAP. It is pending on a mail server or on the HP gateway server. • Sent: A message has been sent to the IAP from the gateway server. • Error: An error occurred and the message was not processed.
• Output generated from the API database’s Actions >- Tools > 2. Export configuration (used by HP support to examine the HP EAs-D API database configuration) The Domino server log (log.nsf) also records the execution of rissminer and the agents, and any debugging output. However, items are much easier to locate in the EAs-D log than the server log, and the EAs-D log contains more information about the mining activity. Viewing archiving log files To view mining logs: 1.
2. Double-click a log entry for more information about the particular entry.
When you select Actions >- Tools > 2. Export configuration in the EAs-D API database, information about the database configuration settings is displayed in the log entry: Purging log entries The Purge_Document agent is used by the HP EAs-D Log to remove log records that are older than a certain number of days. The default removes records that are more than 30 days old. You can change the number of days that log records are kept by editing the Agent Parameters document. 1.
5. Double-click the value in Argt1: Purge record older than (n) Days and change the number of days. Do not change the Form Name value in Argt2. 6. Click File > Save, and then close the document. 7. In the Designer client, schedule and enable the Purge_Document agent. a. Open the HP EAs-D Log database in the hprim folder on any mail server with a copy of the database. b. In the Design pane, select Shared Code > Agents. c. Double-click Purge_Document. The Properties for Agent dialog box appears. d.
HP EAs Domino configuration basics
4 Configuring DWA Extension Tombstones, or links in mail files to messages archived on the IAP, can be retrieved in Lotus Notes and Domino Web Access (DWA), or iNotes. This chapter explains the steps required to retrieve messages in DWA. For information on retrieving messages in Notes clients, see “Working with HP EAs Domino client applications” on page 105.
To configure DWA Extension, follow these steps: 1. Verify the file installation. On each Domino server where messages are retrieved from the IAP (including the proxy, if used): • A replica of the API database should be installed using the following file path: hprim\hp_rissapi.nsf. This database is used to support the lookup operations that are performed when a user clicks a tombstone URL in DWA.
9. (Optional) If there are user groups that only access messages via DWA, create a DWA mining rule. Use Email Miner DWA Sample in the HP EAs-D API Mining Rules as the basis for the rule. 10. Configure the Tombstone Settings tab in the mining rule(s). This tab must be configured whether you use a DWA mining rule or a mining rule for mail files accessed by both DWA and Notes user communities. See “Editing the Tombstone Settings tab” on page 53. 11.
To configure the Proxy Gateway document: 1. Open the HP EAs-D API database file. 2. Under Mining Rules in the main view, open Proxy Gateway Default, the default Proxy Gateway document. 3. Complete the following settings. Field Description Is default Select Yes if there is one Proxy Gateway or if this Proxy Gateway acts as the default for all mail servers listed in the Mail Server field below.
Configuring the Tombstone Prototype document A Tombstone Prototype document must be configured for tombstoned messages to be retrieved in DWA. It must also be configured if users access messages in both DWA and the Notes client. The prototype document includes a Rich Text field with a Computed Text element. The element contains a Formula Language function that is used to generate the link used during DWA tombstone retrieval.
NOTE: If users access messages only in the Notes client, do not configure a Tombstone Prototype document. See “Tombstone Settings tab” on page 65 for the settings to use. Follow this procedure to configure the document: 1. Open the HP EAs-D API database. 2. Under Tombstone Prototype in the main view, select one of the sample documents: • TSKey1, for use with a Proxy Gateway, generates tombstones that are approximately 3 KB.
8. Edit the formula values: • (Proxy Gateway keys only) Edit the CurrentServer values if the mail server has spaces in its name. Change the spaces to either %20 or + so the URL can launch correctly. Otherwise, it stops at the first space. • Edit the MsgNotes value if you want to change the sample, “This message has been archived.” This is the static message that appears in Lotus Notes. • Edit the MsgDWA value if you want to change the sample, “Click here to retrieve the full message.
To configure the tombstone settings: 1. Open the HP EAs-D API database file. 2. Under Mining Rules in the main view, open Email Miner DWA Sample. 3. Double-click inside the document to edit the rule. 4. Click the Tombstone Settings tab, and configure the settings according to the steps in “Tombstone Settings tab” on page 65. Purging cached messages The HP EAs-D DWA Index database (hp_dwaindex.
5 Configuring selective archiving • • • • • • • • • • • Overview, page 55 Configuring mining rules, page 56 Scheduling the mining job, page 69 Editing a rule or schedule, page 71 Enabling the mining agents, page 71 Enabling the preprocessing agent, page 72 HP EAs–D Users database, page 73 Scheduling and enabling the Profile Agent, page 73 Viewing Mail Detail records, page 74 Enabling other HP EAs-D Users agents, page 75 Running the mining job, page 77 Overview Selective archiving, also known as email mini
Configuring mining rules A mining rule must be configured in order to selectively archive messages in mail files or journals. To configure the mining rule: 1. Double-click the HP EAs-D API database file. 2. In the HP EAs-D API main view, double-click one of the default rules under Mining Rules: • Use Email Miner Selective for archiving mail databases of current employees. • Use Email Miner Journaling for archiving messages in journals. • Use Email Miner Bulk for archiving older mail databases.
3. Complete the following fields at the top of the document: Field Description Policy Status Select Enable when you are ready to activate the rule and begin archiving. Profile The name of the rules profile. For example, Selective or Journaling. Archiving Strategy Select Oldest first or Biggest first from the drop-down menu. Do not archive document older than Enter a date by clicking the calendar icon.
Time Conditions tab Time Conditions establishes the age of email to be archived. To configure Time Conditions, complete the Memo, Reply settings using the instructions in the table below. Field Description Memo, Reply type of document Click the arrow and select the way to define an email’s date: Creation Date, Last Modified Date, or Posted Date. Specify Form(s) to not archive List any forms your organization uses that should not be archived.
Folders Settings tab These settings define specific archiving treatment for user folders. Field Description No Time Condition — “on demand” When you list a folder in this field, all messages stored in the folder are archived no matter what value is set in the Time Conditions tab. (The upper limit set at the top of the mining rules document still applies.) The folder can include nested folders. You can list more than one folder. Folder names can be separated by commas, semicolons, or newlines.
Exceptions Settings Use the Exceptions Settings to define exceptions to the overall mining rules, or to limit the amount of archive traffic per session. Special Fields Field Description Document fields If one of the fields listed is found in a message, the message is not archived. A default list of special fields is shown. Delete those that do not apply. Do not delete the HPTombstoned field. You can add other fields. Field names can be separated by commas, semicolons, or newlines.
Attachments & Doc size tab To complete the Attachments & Doc size settings, use the instructions in this table. Field Description Attachment control Click Enable to enable these settings. Not authorized attachment extensions To exclude documents with certain types of extensions, list the extensions. You can prevent the system from mining attachments containing calendar-related notices by entering .ics. Extensions can be separated by commas, semicolons, or newlines.
User Membership tab Complete this tab to associate users with the mining rule. Users can be added from standard Domino Directory mail databases and mail-in databases. When users are added in this tab and the Profile Agent is run, a Mail Detail record is created for each user in the HP EAs-D Users database (hp_rissuser.nsf) and the user is associated with the mining rule. For more information, see “Scheduling and enabling the Profile Agent” on page 73 and “Viewing Mail Detail records” on page 74.
Field Description Membership conditions Define the user mailboxes or journals to be mined with this rule. Select any or all of the following: • String pattern matching (Meta): Use a wildcard to define members of an organization or organizational unit. For information on the syntax to use, see “Defining wildcard patterns” on page 63. • Groups: A group within the organization. Important! EAs does not support group types that are set to Access Control List. • Person entry: Individual mailboxes.
Reference Database tab The reference database is a temporary repository that contains pointers to messages in mail boxes while the messages are being processed and sent to the IAP. Use this tab to enter the name and location of the reference database. Field Description Reference document Select Regular unless HP support asks you to select Extended for troubleshooting purposes.
Tombstone Settings tab Use this tab to specify the action the Tombstone agent takes when a mail file is mined. There are several actions available: the full message can be retained in the mail file, the message can be deleted from the mail file, or the message can be replaced with a link, or tombstone, to the archived message on the IAP.
Style 66 If you selected one of the tombstoning actions, a tombstone replaces the message. Use the Style field to format the tombstone. • Text: Select this option if users access tombstoned messages only in Lotus Notes. When this setting is chosen, a field to customize the standard tombstone message is displayed. Change the content if you do not want to use the default, “This message has been archived.
Session Settings tab Session settings control the impact of mining sessions on server resources. Field Description Allow Remote Mining of databases Click No to archive only databases on the local mail server. Click Yes if you are archiving databases located on remote mail servers. Do not start the program if ’Reference’ database When you enable this option, mining does not start if the reference database: • Is bigger than n MB, or • Has more than n messages.
Set the maximum size of archive traffic per session in the three traffic size fields. You can set values for any or all of the fields. If there are no size restrictions for a field, enter 0. Maximum archive traffic size [nb of sent] /user To set a value using the number of messages per user, enter the number of messages. Maximum archive traffic size/user To set a value using mailbox size, enter the user mailbox size in MB.
Scheduling the mining job After configuring the mining rule, schedule the mining job. 1. In the EAs-D API main view, open the rule for editing by double-clicking inside the rule document. 2. Click Schedule Job in the upper left corner of the mining rules document created for the profile. The rissminer program document appears. 3. Complete the fields in the Basics tab. HP Email Archiving software for IBM Lotus Domino Version 2.
Field Description Basics Program name Leave the default value: rissminer Command line Leave the default value. Note that the -k command line switch and the name of the mining rule is picked up in the command. Server to run on The default is the current mail server. If you need to change the server, click the arrow and select another server. This is the only field in the Basics column that you should edit. Comments Leave the default value.
5. Click Save & Close to save the program document. 6. Click Save to save the mining rule. A rissminer program document must be created in the Domino Directory of each mail server on which the mining rule is enabled. 1. In the Domino Administrator client, click the Configuration tab. 2. Expand Server and select All Server Documents. 3. Select the server, and then select Create > Server > Program. 4. Complete the program document fields according to steps 2–4 above.
5. Set the schedule: a. Click the arrow in the box next to the Schedule button to select a parameter. For journaling, the schedule should be set to more than once a day. b. Click the Schedule button and set the run time. The schedule should be set in conjunction with the schedule in the rissminer program document. For journaling, the agents should run frequently, all day. The times should be at least 20 minutes apart. c. Ensure that the server name appears in the Where agent runs box. d. Click OK. 6.
5. Set the schedule: a. Click the arrow in the box next to the Schedule button to select a parameter. For journaling, the schedule should be set to more than once a day. b. Click Schedule and set the run time to meet your requirements. For journaling, the agent should run frequently, all day. The times should be at least 20 minutes apart. c. Ensure that the correct server appears in the Where agent runs box. d. Click OK. 6. Close the Agent Properties dialog box and the agent, and then click Enable. 7.
NOTE: After the EAs software is configured, you can force the agent to populate the EAs-D Users database by opening the server console and entering: tel amgr run “hprim\hp_rissuser.nsf” ’profileAgent’ If Domino 7.0.3 is installed on the server, do not run the agent manually. See “JVM panic gc0 error” on page 130.
• The Activity Log provides a brief summary of the archiving activity in the user database, showing the date and time of archiving, the number of messages archived, and their total size. • The Notes Archive Settings tab shows any native Notes archive databases that have been sent to the IAP. Information includes the name of the archive file, the server it resides on, the mail template it is based on, the date the file was created, and the current size of the file in MB.
Scheduling the agent To schedule and enable the agent using the Designer client: 1. Open the HP EAs-D Users database in the hprim folder on any server with a copy of the database. 2. In the Design pane, select Shared Code > Agents. 3. Double-click Stats\User Activity Alert – Agent, and then click OK to bypass the warning. The Properties for Agent dialog box appears. 4. Make sure the Trigger is set to On schedule and the Target is set to All documents in database. 5.
4. In Argt1: Number of lines max, edit the Value field to reduce the number of lines. Legal values are 0–20. If the value is set to 0, the agent purges all log entries when it is run. 5. Select File > Save from the top menu, and then close the document. 6. Schedule and enable the agent. Follow the procedure in “Statistics User Activity Alert agent” on page 75.
Configuring selective archiving
6 Configuring compliance (journal) archiving • • • • • Overview, page 79 Journaling recommendations, page 80 The journaling process, page 82 Creating HP EAs Domino journaling rules, page 85 Mail.box issue, page 89 Overview HP EAs Domino can archive journaled messages using one of two methods: • Advanced Filtering, also known as EAs Domino journaling • Domino native journaling For both methods, message copies are captured and put in a mail-in journal database that is mined by the rissminer program.
Mail-To-Me messages If you use Domino native journaling, HP EAs-D Tools must be configured and the cleanup agent enabled. Domino native journaling cannot filter out messages that users send to themselves from the IAP Web Interface. Since these messages are already archived, the mining agents skip them and leave them in the journal. EAs-D Tools provides an automated process for removing Mail-to-Me messages from the journal mail-in database. HP EAs-D Tools and the mail-in database must be on the same server.
Domino native journaling • Only the mail-in style of Domino native journaling is supported with EAs Domino archiving. • HP recommends that you use HP EAs-D Mail Journal (6) (hp_mailjrn65.ntf) as the template for the mail-in database. This template is located in the Templates folder on the EAs installation CD. HP has removed the $Inbox folder and several other folders that are found in the standard Domino journal template.
Configuring HP EAs Domino journaling and native journaling on the same server Running both EAs Domino journaling and Domino native journaling on the same server is not common. However, there are situations where it might be used. For example, an organization might require that all messages are journaled for an existing business process, but only a subset of users’ messages are archived to the IAP.
d. Make sure the following options are set in the mining rules document: Field Description Time Conditions/Memo Reply Do not edit. Folders Settings • No Time Condition – “on demand”: Do not list folders in this field. • Configure the remaining fields according to your company’s legal policies. Exceptions Settings Do not edit. User Membership • Ensure that the Active for servers setting is accurate, especially if the journal mail-in database is on a remote server.
6. Add a journal “user” to the HP EAs-D Users database by creating a Mail Detail mail-in record. a. In the Domino Administrator client, open the HP EAs-D Users database in the hprim folder. b. In the Create menu, select Mail Details > Database Details. A new Mail Detail record appears. c. On the Database Details tab, set the following values: Field Description FullName Enter the mail-in database name; for example EASJournalDB.
Creating HP EAs Domino journaling rules Messages are captured using one or more journaling rules that determine which messages are copied to the journal. The method for creating EAs Domino journaling rules is described in this section. If you are using native Domino journaling, follow the instructions in the Domino documentation and the recommendations in “Domino native journaling” on page 81.
6. (Optional) If there are two or more journaling rules, prioritize execution of the rules: a. In the main view, select the rule with the top priority. b. Select Actions > Filter rules > 1. Set ’Priority’. c. Enter 1 in the dialog box that appears, and then click OK. d. Click OK to confirm the priority. e. Repeat steps a–d, creating a priority for each journaling rule. Traffic Definition tab Complete the traffic definitions settings, which describe who is sending or receiving the journaled messages.
Sender/Receiver Exceptions tab Define any exceptions to the traffic definition. Be sure to define the Except to field so that messages sent to the IAP are not journaled again. Field Description Except From Messages from this user or group should not be journaled. 1. Click the arrow and select a user or group from the list, or enter a wildcard to define a group. 2. Click the radio button to define the sender. The Meta and Meta group categories use wildcards.
Journal Database tab Complete this tab to select the mail-in database used for journaling. Field Description Journal this email in mail-in Click the arrow and select the mail-in account name. You are responsible for creating the Mail-In Database document. See the Domino Administrator help for instructions on creating the document. The Mail-In Database document must specify the following settings: • Encrypt incoming mail: No For more information, see “Encrypted messages” on page 79.
Editing journal rules IMPORTANT: Before editing journaling rules, stop the mwadvt task on the server. To make changes to a journal rule: 1. From the Domino Administrator or server console, stop the mwadvt task by issuing the command tell mwadvt quit. If more than one Domino server shares the HP EAs-D API database, stop the mwadvt task on all relevant servers. 2. Open the HP EAs-D API database, and double-click the Journaling Rules document in the main view. 3.
Configuring compliance (journal) archiving
7 Using bulk upload Bulk upload is a utility that can be used for one-off archiving. For example, it can be used to discover the mail files of former employees or inactive users and archive the messages in their mail files. It can also be used to locate and archive messages in the old mail files of existing users. When EAs Domino is first installed, you might use bulk upload quite a lot.
Editing the Preprocessing Control document To edit the document: 1. In the Domino Administrator client, open the HP EAs-D API database. 2. In the PreProcessing Controls area of the EAs-D API main view, double-click PreProcessing Controls Default for Bulk Upload. 3. In the Databases Location tab, select the server(s) running the Encapsulate agent. 4. In the Encapsulation Settings tab, edit the temporary work directory if necessary.
Forcing a database owner Every mail database should have an owner that can be associated with a user in the IAP. To force a particular database owner, you can use the argument –o{x@xx.xx], where {x@xx.xx] is the Internet address of the owner. For example, if you want to force Joe Smith as owner of a database, you might enter: load hpblkupd –d –ojoesmith@company.com If you do not specify a value for the owner, bulk upload tries to find the owner using the following steps.
5. Run the Archive and Tombstone agents: tel amgr run “hprim\hp_riss_blkupdreferenc.nsf” ‘archive’ tel amgr run “hprim\hp_riss_blkupdreferenc.nsf” ‘tombstone’ NOTE: If Domino version 7.0.3 is installed on the server, do not complete step 5. The Archive and Tombstone agents must be scheduled. Do not run these agents from the command line.
8 Configuring IAP single sign-on With IAP single sign-on (SSO), users are automatically authenticated for access to the IAP Web Interface when they log into their Lotus Notes account. Authentication with the IAP is performed using Domino credentials. To use IAP SSO, follow the procedures in this chapter. SSO involves configuration on the mail servers, changes to the mail template, and configuration on the IAP. NOTE: SSO can only be used with IAP version 1.6.1 or later. If you are using IAP version 1.6.
NOTE: The rimsso.nsf file name is hard-coded in the Search the IAP Archive agent used in IAP SSO. If you change the file name, be sure to change the file name in the agent. See “Configuring The Search the IAP Archive agent” on page 99. 4. Specify the template for the HP EAs-D SSO database: a. In the Server box, leave Local. b. In the Template box, select HP EAs-D SSO, and then click OK. 5. Close the database.
6. In the Notes client, open HP EAs-D SSO. The EAs-D SSO database opens to the following window. 7. In the Notes File menu, select Database > Access Control. 8. Perform the following steps in the ACL window: a. Check that the ID has Manager access and the RIM SSO Admin role. b. Set the Default access level to Reader. c. If all members of the LocalDomainAdmins group are trusted with SSO information, enter that group into the ACL and give it Manager rights with the RIM SSO Admin role.
10. Export the SSO Shared Secret: a. In the HP EAs-D SSO database window, click Export the Shared Secret. b. Select a location to save the secret in an XML file, and then click Save. You will use the XML file as a reference when performing the IAP configuration for SSO (see step 2 in “Configuring SSO on the IAP” on page 102. IMPORTANT: The XML file is not encrypted. It should not be left exposed, where unauthorized users might be able to find and read it. 11.
14. In the properties dialog box: a. Select On schedule for the trigger, and then select Daily in the drop-down list. b. Click the Schedule button and verify that the correct server name appears in the Run on drop-down list. c. Set the execution time close to 12:00 AM (for example, 12:15 AM). d. Click OK, and then close the dialog box. 15. Enable the agent. To force an initial run of the agent, go to the Domino server console and issue the command: tell amgr run “hprim\rimsso.
The template also contains a sample modification of the action bar in the $Inbox folder, adding a Search the IAP button. This sample shows an easy way for users to log into the IAP. Instructions for using the template’s design elements to modify a production template are given below. IMPORTANT: The HP EAs-D Mail (R6) with SSO template can be used as-is to create mail files for test and demonstration purposes.
Copying design elements from the template 1. In the Designer client, open the following files: • HP EAs-D Mail (R6) with SSO (mail6RIM16–SSOx.ntf) • A user mail file 2. In the Shared Code section of mail6RIM16–SSOx.ntf, open the Agents list and copy the Search The IAP Archive agent to the clipboard. 3. In the Shared Code section of the user mail file, open the Agents list and paste the Search The IAP Archive agent into the list. NOTE: If you changed the rimsso.
Modifying the Search The IAP Archive agent If you selected Internet Address in step 11 of Configuring the HP EAs–D SSO database and the Generate SSO Tokens agent, perform the following steps in the user’s mail file: 1. In the Shared Code section of the user’s mail file, open the Agents list and select the Search The IAP Archive agent. 2. Open the agent. 3. In the Initialize section of the agent: a. Remove the “’” character from ’gConfigLoginItem = ITEM_INET_ADDR. b.
Modifying the UID Perform the following steps on the IAP if you selected Internet Address as the IAP Login in the SSO Token Agent Configuration (step 11 in Configuring the HP EAs–D SSO database and the Generate SSO Tokens agent). Stop the current DAS job: 1. Log into the IAP PCC and navigate to Account Synchronization. 2. On the DAS Available Jobs page, select the job, and click Stop. Make the following modification: 1.
Configuring IAP single sign-on
9 Working with HP EAs Domino client applications Copies of archived messages can be viewed and retrieved from the IAP in several ways, depending on the EAs applications that are installed. • IAP Web Interface: The IAP Web Interface is available for all online clients. Users can view and open archived messages using their Web browser, and send message copies to their mailboxes. These functions do not require software to be installed on client systems.
• Content Type for search: email • Send (All Items or Checked Items) sends email copies to the user’s Inbox. Export (All Items or Checked Items) is a function that requires software to be installed on the client system. For information on exporting email, see “Using Export Search” on page 107. Creating an IAP Web Interface link in Lotus Notes A link can be created in Lotus Notes that takes users directly to the IAP Web Interface when the link is clicked.
Using Export Search Export Search is a tool that you will typically use to retrieve messages that have been requested by compliance officers for litigation-related review. With Export Search, message links are exported from the IAP Web Interface to a DLD file. The linked messages are then downloaded into a standard Notes NSF file, usually one created for this purpose. The original messages remain on the IAP. The email search itself is performed in the IAP Web Interface.
4. Click More Options to open the options menu. 5. To export all results, click Export All Items. To export the selected items, click Export Checked Items. The file download dialog box appears. 6. Click Open to open the DLD file. The DLD file extension must be associated with ExportSearch.exe to open the file. 7. Enter the Notes password in the dialog box that appears, and then click OK. The Export Search wizard appears. 8. In the Output area, select a Notes database to contain the downloaded messages.
10. Click the Start arrow next to the progress bar to start the download. A log appears displaying the download results. 11. Review the log for any errors that might have occurred during the download process. 12. If the log shows a successful download, click Exit to close the Export Search wizard. 13. Use Notes to open the destination database and view the downloaded messages. Using the server to extract messages Follow these instructions when there are a large number of messages to export.
6. Restart the Domino server. Exporting the messages To export email copies from the IAP Web Interface: 1. Search for the relevant email. If the search is a complicated one, use the Advanced Search instructions in the HP Integrated Archive Platform User Guide. NOTE: If IAP 2.x is installed, you cannot use the Folder Name field in Advanced Search. HP EAs Domino 2.0 does not capture folder names when messages are archived. 2.
Field Description IAP host name or IP Click the arrow, select the IAP Host IP, and then click OK. DLD file(s) Drag and drop the DLD file from the client into this field. 6. Click the Request Target tab and complete the fields as shown below. All fields must be completed. Field Description Use an existing database Click the arrow and choose whether to add the messages to an existing database or create a new database, and then click OK.
Field Description From Enter a name. Recipients Click the arrow, select the recipients, and then click OK. Subject You can change the subject line from the default. Hot Spot text You can change the text from the default. Body Add any comments for the body of the message. For example, if the messages are downloaded into a new folder in the database, you can mention that the link will open the database to the Inbox and users must open another folder. 8. Select File > Save to save the request.
Using Local Cache Local Cache is a client application that gives Windows-based Notes users offline access to their archived messages. It is most useful for employees traveling with a laptop or notebook computer. When client machines are online, users can pull copies of archived messages from the IAP into the cache, as long as the messages fall within the parameters that are configured for the cache. When client machines are offline, users can access any archived messages that are in the cache.
4. In the Installation folder box, enter a name for the Local Cache folder. 5. Click Next. 6. In the 4. Shortcuts window, select a location (desktop or Start menu) if you want to create shortcuts to the Local Cache and Export Search applications.
7. In the 5. Save installation window, select whether to save the installation on the client. • If you choose to save the installation, select the Save this installation check box, and browse for a location in which to save the installation. • If you do not save the installation base, click Next. 8. Confirm the installation parameters in the install preview screen. If you need to make adjustments, use the Previous button or the sequence menu on the left side of the screen. 9. Click Install.
6. Select the mail folder(s) where cached messages are stored, and then click Apply.
7. Click the Settings tab and configure the cache. a. In the Updates area, select the age of the messages to be retrieved. The Local Cache retrieves and caches any archived message where the received date is more recent than the number of days specified. To ensure a continuous flow of messages, select the Always retrieve up to last date check box. b. In the Purge area, limit the scope and size of the cache.
8. Click OK. The source and the destination databases appear on the Download tab. 9. To use Local Cache: a. Click Start to import the archived message copies into the cache. A log of the download results appears on the Logging tab. The log is stored in the Localcache directory that was created during installation. Log entries can be cleared or copied by using the icons at the top of the tab: Clear specific types of log entries (summary, warning, error, etc.). Clear a specific entry or entries.
Deleting messages from the cache When the cache size or time limit is exceeded, messages are automatically deleted from the cache in reverse chronological order. Messages can be manually deleted from the cache by following these steps: 1. Double-click the Local Cache icon on the desktop or in the Start menu. 2. In the Local Cache window, click Options and then select Manual Purge. The Manual Purge wizard appears with the list of messages in the cache. 3.
Using the Windows Notes Client Plug-In A plug-in can be installed on Windows clients to automatically retrieve tombstoned messages. The plug-in can be installed on its own or, for users traveling with a laptop, installed with Local Cache. Users have instant access to their archived messages when the computer is online. When they select a message, its content appears automatically. The process works in a somewhat different way when the plug-in is installed together with Local Cache.
Variable Value RISS_HOST_ADDRESS= Change the sample IP address to the IP address of your IAP HTTP portal, or the DNS name that resolves to that IP address. Be sure to keep =0 after the address so this variable is added to notes.ini. HPCLIENT_FROM_DOMAINTOREMOVE= This variable removes the extraneous FromDomain added to a message during archiving, so it does not appear when users create a reply to the message. Change the sample name to one or more Domino domain name(s).
Variable Value EXTMGR_ADDINS This variable registers the plug-in with the Notes Extension Manager. Do not change this entry. NOTES_PATH Do not change this entry. HPCLIENTEXCLUDE=localcache, taskldr=0 Do not change this entry. It appears when Local Cache is installed in addition to the plug-in. A completed variableInstallation.ini file would look like this sample: RISS_HOST_ADDRESS=15.1.1.1=0 HPCLIENT_FROM_DOMAINTOREMOVE=EASCPE@usa.hp.
Using the Windows Notes Client Plug-In with Local Cache Windows clients can use the plug-in together with Local Cache for no-click access to archived messages. The plug-in interacts with the cache in three ways: • Message is in the cache: When users open a tombstoned message, the plug-in looks for a pointer to the message in the cache. If it is found, the plug-in it retrieves the message from the cache and automatically displays it for the user. This improves performance and reduces the load on the IAP.
Retrieving and viewing encapsulated messages Retrieving and opening encapsulated messages in Lotus Notes and DWA Encrypted messages can be decrypted when users retrieve them in DWA or Notes. Signatures in signed messages can be validated if the original sender’s certified public key is available in the Domino Directory or the recipient’s Personal Address Book.
5. If the message is encrypted, switch to the user ID of the message recipient. If the message is signed, make sure the Domino Directory or the recipient’s Personal Address Book contains a Person document with the certified public key of the sender. 6. Open the message from the folder. Adding MS Office 2007 MIME type support to HP EAs Domino Microsoft Office 2007 supports several new file extensions that its applications use on its data files.
Table 7 New MS Office 2007 MIME types MIME type MIME subtype File extension Application vnd.ms-word.document.macroEnabled.12 .docm Application vnd.openxmlformats-officedocument.wordprocessingml.document .docx Application vnd.ms-word.template.macroEnabled.12 .dotm Application vnd.openxmlformats-officedocument.wordprocessingml.template .dotx Application vnd.ms-powerpoint.template.macroEnabled.12 .potm Application vnd.openxmlformats-officedocument.presentationml.template .
10 Collecting held messages for HP technical support The Get Held Messages Notes application recovers mail.box messages that are in the Hold or Dead state, so they can be used for IAP and EAs diagnostics. After the application recovers a held message from mail.box, it resubmits the message to the router several times, giving it another chance to be delivered. The number of retries can be configured. After the maximum number of retries, the message is saved in Get Held Messages and is not returned to mail.
Collecting held messages for HP technical support
11 Troubleshooting and performance improvement This chapter explains how to troubleshoot HP EAs Domino and improve system performance.
3. For each server running rissminer: a. Select the server in the right pane. b. Select Create > Server > Program. c. On the Basics tab, complete these fields: Field Description Program name Enter cmd Command line Enter /c erase c:\lotus\domino\rissminer_*.lock (where c:\lotus\domino is the Domino program directory) Server to run on The default is the current mail server. To change the server, click the arrow and select another server.
Large Mail Detail log records An error occurs when Lotus Notes records store more than 64 KB of text, and the following message is displayed on screen: Notes error: too large. Field is too large or View’s column selection formulas are This error can occur if the Purge Selective Archive Log agent is not scheduled and enabled or if the value for number of lines is set too high in the agent’s Parameter document. To avoid this error, see “Purge Selective Archive Log agent” on page 76.
Editing server configuration The following settings improve server performance. Add these settings to the notes.ini settings. 1. In the Administrator Client, click the Configuration tab. 2. Click the Server expansion arrow. 3. Click Configurations. 4. Double-click the existing server configuration document. 5. Click the NOTES.INI Settings tab. 6. Click Edit Server Configuration, click Set Modify Parameters, and add the following settings one at a time by selecting the drop-down box from Item.
Limiting the server log file size It is possible to limit the server’s log file size based on the age of log entries. This prevents the log file from growing too large. 1. In the Notes client, open the workspace. 2. Click File > Database > Open. 3. Select the gateway server and open the file log.nsf. 4. Close the new tab and return to the workspace. 5. Right-click the log icon, then click Replication > Settings. 6. Click Space Savers. 7.
Troubleshooting and performance improvement
A Indexed document and content types • Indexed document types, page 135 • Message MIME types, page 135 • Additional indexing detail/limitations for Microsoft Office, page 137 Indexed document types Users can search the contents of a message and attachment only if the contents have been indexed. Indexing catalogs the words in a message and attachment to prepare them for later searching. The following types of messages and attachments are indexed: • • • • Plain text files Rich text files (.
File extension File type MIME type .rtf Rich text format rtf/text, application/rtf .mht, .mhtml, .nws, .eml Email message message/RFC 822 .doc, .dot Microsoft Word 97-2003 document application/msword .xla, .xlc, .xlm, .xls, .xlt, .xlw Microsoft Excel 97-2003 document application/vnd.ms-excel, application/ms-excel .pot, .pps, .ppt Microsoft PowerPoint 97-2003 document application/vnd.ms-powerpoint, application/vnd.msppt .pdf Adobe Portable Document format application/pdf .
File extension File type MIME type .potx Microsoft PowerPoint 2007 template application/vnd.openxmlformats-officedocument. presentationml.template .potm Microsoft PowerPoint 2007 macro-enabled presentation template application/vnd.ms-powerpoint.template. macroEnabled.
Type Microsoft Excel Feature Office 97–2003 Office 2007 Contents Yes Yes Table Yes Yes Textbox No Yes Header/Footer No No Comment No No Signature No No Chart No No Object (Microsoft Office, WordPad) No No OLE Yes Yes WordArt No No Sheet’s name No No Table 10 Microsoft Office supported properties Type Document Properties Advanced Properties: General 138 Property Microsoft Word, PowerPoint, and Excel Author Yes Title Yes Subject Yes Keywords Yes Category Ye
Type Advanced Properties: Summary Advanced Properties: Statistics Advanced Properties: Contents Advanced Properties: Custom Property Microsoft Word, PowerPoint, and Excel Title Yes Subject Yes Author Yes Manager No Company No Category Yes Keywords Yes Comments Yes Hyperlink base No Template No Created No Modified No Accessed No Printed No Last saved by Yes Revision number Yes Total Editing Time No Statistics Word, PowerPoint: No Excel: N/A Document Contents No Ch
Type Advanced Properties: Custom (continued) 140 Property Microsoft Word, PowerPoint, and Excel Group Yes Language Yes Mailstop Yes Office Yes Owner Yes Project Yes Publisher Yes Purpose Yes Received from Yes Recorded by Yes Recorded date Yes Reference Yes Source Yes Status Yes Telephone number Yes Typist Yes Indexed document and content types
B Configuring the HP EAs-D Tools database Domino native journaling cannot filter out messages that users send to themselves from the IAP Web Interface. Since these messages are already archived, the EAs agents skip them and leave them in the journal. EAs-D Tools provides an automated process for removing these Mail-to-Me messages from the journal mail-in database. This appendix explains how to configure the HP EAs-D Tools database.
e. In the Template for New Database area of the window, select the server in the Server box, and then select the HP EAs-D Tools template in the scroll box. f. Click OK and close the database’s About page. g. Select File > Database > Access Control and adjust the access control settings to make sure that: • • • • Default has no access to the database. LocalDomainAdmins have Manager access, with delete rights and all roles. LocalDomainServers have Designer access, with delete rights and all roles.
7. Close the Agent Properties dialog box and the agent, and click Enable to enable the agent. You can run the agent immediately from the server console by issuing the following command: tell amgr run “rim_tools.nsf” ‘Email Miner MTM Cleanup’ To enable verbose logging, enter: Set config HPRIM_DebugJournalCleanup=1 To disable verbose logging issue, enter: Set config HPRIM_DebugJournalCleanup=0 HP Email Archiving software for IBM Lotus Domino Version 2.
Configuring the HP EAs-D Tools database
C Creating reference and preprocessing databases The reference and preprocessing databases should not be replicated during the software installation. For each message processing server, create a new preprocessing database and corresponding reference database. Function Preprocessing database name Reference database name Selective archiving hp_preproc_miner.nsf hprim/hp_riss_minerreferenc.nsf Compliance archiving hp_preproc_journal.nsf hprim/hp_riss_journalreferenc.nsf Bulk upload hp_preproc_blk.
8. Configure the database from the Notes client: a. Select File > Database > New. The New Database window appears. b. In the Server box, specify the relevant mail server. Enter the name of the server if it does not appear in the list. c. In the Title box, enter a name for the database. For example, HP EAs-D PreProcess (miner). d. In the Filename box, browse to and select the hprim folder, then enter the database filename. For example, hp_preproc_miner.nsf. e.
8. Configure the database from the Notes client: a. Select File > Database > New. The New Database window appears. b. In the Server box, specify the relevant mail server. Enter the name of the server if it does not appear in the list. c. In the Title box, enter a name for the database. For example, HP EAs-D Reference (mnr). d. In the Filename box, browse to and select the hprim folder, then enter the database filename. For example, hp_riss_minerreferenc.nsf. e.
Creating reference and preprocessing databases
D Account Synchronization Account Synchronization in the IAP PCC is used to configure dynamic Account Synchronization (DAS), which automatically creates and updates email user accounts on the IAP. You can define multiple configurations that track sets of users from one or more LDAP servers for specific IAP domains.
2. Complete the form to create an LDAP service connection by entering the following information: Field Description Connection Name Name used to identify the LDAP connection. Hostname IP address of the LDAP server. Binder user User in the LDAP directory tree that you want to bind to. At a minimum, the user must have read access to all users objects. For example: cn=Administrator,cn=Users,dc=hostname,dc=com. Binder pswd Password of the Binder user.
5. Complete the form by entering the following information: Field Description LDAP Domain name Domain to which the users belong. For example: ldaptest.com. LDAP Starting Point Root node where the user accounts are stored. For Domino, leave this text box empty to mine all aggregated Domino domains. IAP DomainID The IAP domain ID (not the domain name) where users are synchronized with users on the LDAP server. This is the same as the domainID set in Domain.jcml.
4. To assign this job to an HTTP portal, click Assign Job. See “Assigning HTTP portals” on page 152 for further instructions. Assigning HTTP portals Before running a DAS job, assign an HTTP portal on which to run the job. Only one job can be assigned to an HTTP portal. If all HTTP portals are being used, reassign the HTTP portal from another job. To assign an HTTP portal to a job: 1. Click Assign Job. 2.
To stop a DAS job: 1. In the DAS Available Jobs view, select the job and click Start/Stop. A notice appears stating that the job has stopped. 2. Click Back to Main Page to return to the DAS view. Viewing DAS history logs The DAS jobs history log provides a list of job runs for each configured active job. The log includes the job name; the number of IAP users that were added, deleted, and updated; the time between job runs; the job status; and the date and time the job was completed.
Account Synchronization
Index Symbols D .
EnsureOwnerReceipt, 29 exception settings, 60 Export Search, 105, 107, 107, 109, 109 using the client to extract messages, 107 using the server to extract messages, 109, 109 extracting exported messages from DLD file, 110 F File Identification mapping, 125 filtered compliance, 63 Find Parent tool, 41 folder settings, 59 G gateway server compacting databases, 131 configuring, 20 Get Held Messages, 127 monitoring, 132 Global Configuration document, 24 H held or dead messages, 127, 132 help, obtaining, 1
mailboxes, user, 73, 74 memory problems, avoiding, 22, 109 message processing servers, defined, 19 messages, maximum size, 55, 61, 79 MIME Content-Type indexing, 135 mining agents, 71, 83 mining job, 69, 83 running, 77 mining log, 25, 41 mining rules, editing, 71 MS Office 2007 MIME type support, 125 MTM Cleanup agent, 142 mwadvt task, 89 N Notes 64 KB error, 76, 131 O on demand archiving, 59 operating systems supported, 14 P partitioning, 20 PCC Account Synchronization view, 149 description, 14 pendi
system requirements, 14 T technical support HP, 11 text symbols, 10 Tombstone agent, 71 tombstone icon, 123 tombstone settings, 65 traffic, archive, 67 troubleshooting, 129 troubleshooting tools, 35, 41 U User Activity Alert agent, 75 user database agents, 75 158 user guide, 9 users PCC management, 149 Users database, 73 W Web sites HP documentation, 11 HP storage, 11 HP Subscriber’s choice, 11 wildcards, 63, 63, 86, 87 Windows Notes Client Plug-in, 105, 120 configuring, 120 phone message form, 120
