Lotus Notes Gateway


This section contains information that concerns the Lotus Notes Gateway.


Requirements

This section contains requirements of the Lotus Notes Gateway.

A Notes client (Windows only) or Domino Server:

 

on the same host as the Notes gateway and on the same host as the StyleSet Editor


Notes and Tips

Zoning a Collection (VDK) Field vs. Zoning in the Lotus Notes Gateway

 

The following describes the differences between zoning a collection field and zoning in the Lotus Notes Gateway configuration.

Zoning a Collection Field

Is field mapping required?

Yes, you must map to a collection field and then select Zoning for that field so that entries are written to style.dft . For information on style.dft , see the Verity Collection Reference Guide.

Are attachments zoned like the parents?

Yes, since collection fields are inherited automatically and the zones are based on the fields, the zones are also applied to any separate attachment documents.

Do you have control over inclusion in the VDK summary?

Yes, the style.dft file allows special tags like NOEXTRACT and hidden that control its inclusion in summary and viewing. The default is to hide and not extract any fields marked to zone. For information on style.dft , see the Verity Collection Reference Guide.

Zoning in the Lotus Notes Gateway

Is field mapping required?

No, you can zone content like body fields or attachments that you cannot map to a collection field.

Are attachments zoned like the parents?

No, the Lotus Notes Gateway only sets the zone on the base documents.

Do you have control over inclusion in the VDK summary?

No, any zoned content is also available for the summary and for viewing.

Notes ID Requires Read Access to Databases

 

The Notes user ID used for the connection context on the system on which Notes gateway is installed needs to have read access on all Notes databases that are to be indexed.

Notes Password versus Internet Password

 

The Notes gateway by default relies upon the Internet password to authenticate users.

When users need to authenticate while searching or viewing, they must use their Internet password.

 

 
Note   You can set up an LDAP K2 Ticket server and use the Collection Settings Lookup Type of Use LDAP Credentials when Available to create a single sign-on environment.
 

 


Known Problems

This section contains known problems concerning Notes Server/Client Configuration

View Alias Names with Double-byte Characters are Not Supported

 

If a view alias name contains double-byte characters with spaces between them, the view should not be selected when specifying starting points in the StyleSet Editor. This is due to a Notes limitation regarding double-byte characters in a view alias name. (68625)

Changes to Access for Supplemental Filtering User Name are not Recognized

 

If you make changes that affect the supplemental filter user name’s access to documents/databases that have already been indexed by changing the database ACL or group membership for the user, those changes are not recognized and so those unmodified documents are not added or removed, as the case may be. You must purge the collection and re-index as described in the Verity K2 Lotus Notes Gateway Guide. (68884)

This section contains known problems concerning indexing with the Notes Gateway

Consistent Security Lookup Information for Notes Domain

 

For all collections indexed from the same Notes domain, you must be consistent in the values you specify for Server for security checks for this domain and Lookup Type on the Collection Settings dialog.

Problem with User ID Switching

 

While running a Verity process (such as K2 Server or an indexer) that uses the Lotus Notes Gateway and you switch IDs in the Notes client during the indexing task, the Verity process may hang and lock the ID file.

Cannot Index RTF OLE Objects

 

OLE objects that are RTF (Rich Text Format) documents are not supported and are therefore not indexed. Only Microsoft Office document formats are supported as OLE objects. (68503)

Verity Spider and K2 Spider Errors May Be Due to Incorrect PATH

 

If you consistently receive errors from Verity Spider, verify that your Lotus application directories are properly represented in your system PATH environment variable.

 

 
Note   If you have more than one Lotus application installed, the Notes gateway searches the first application directory in your PATH to find the notes.ini file. During installation, you have the opportunity to select a Lotus application and specify the Lotus application directories.
 

 

Incremental Refresh May Be Incomplete with Different Settings

 

If the time setting on the Domino server is different than that on the system on which the Verity Spider or K2 Spider is running, incremental refreshes may not pick up all of the documents you would expect. Both systems should have their time settings synchronized. (69348)

Knowledge tree ordering for multi GW collections

 

If HTTP collections and Notes collection are used in a collection map file, the Notes collections should be listed first.

Partial Index Refreshes May Take a Long Time

 

The refreshing of a large collection of many databases may take up to an hour depending on numbers and document counts of databases and network performance between the system running Verity Spider and the Domino server to be indexed.

If multiple refreshes are needed during a single day but only for a select set of databases, then you should use the -start option for Verity Spider. This will limit the refresh to only the selected databases. The format of the start_point argument in -start start_point must be of the form:

-start “notes://servername!!databasepath_name

For example:

-start “notes://Monterey/Verity Inc!!mail/rbarber.nsf”

You may supply multiple -start start_point arguments to Verity Spider. For more information, see the Verity Command-Line Indexing Reference. (69356)

Search Results Do Not Display Content From Newly Configured Databases

 

When refreshing collections that are on-line with one or more K2 Servers, some restrictions apply. New content added to configured Notes databases becomes available for search users immediately upen refreshing the collection.

However, if you add new Notes databases or views to the configuration, the collection must be re-opened by a K2 Server to make available documents from the new databases or views. To do this, take the collection off-line and then bring it back on-line.

If you do not re-open the collection, allowing searches to attempt to return the newly configured content will result in the following error message appearing in vgwnotes.log :

VlnView::OpenByKey VlnDbInfo::Find@vlnview.cpp:1327 Err=0x03d1 (Document Not Found)

On Windows, the vgwnotes.log file is stored in the temp directory defined by the TMP environment variable. On UNIX, vgwnotes.log is stored in /var/tmp .

Workaround:

Utilize one of the All databases... indexing scope options on the Database Properties dialog to dynamically select the databases for indexing. This applies only to databases that are enabled for Multi-database indexing on the Domino server.

All databases within this directory

All databases within this directory recursively

All databases on this server

This section contains known problems concerning using StyleSet Editor with the Notes Gateway

Document Filtering Formula containing Different Languages May Cause Problems

 

When you include languages other than English in a document filtering formula, you may not see all available forms and instead see only the [Verity_Default] form.

Workaround:

Before you type a Document filtering Formula on the Database Properties dialog, finish field mapping by going through the Mapping Selection and Field Mapping dialogs. When you are finished, click OK until you are back on the Database Selection dialog and then click the DB Properties button. Type the Document filtering Formula you need, including multiple languages as desired. (69182)