HOW TO: Install the PGP Lotus Notes Plug-In on the Lotus Notes Domino Server

book

Article ID: 180117

calendar_today

Updated On:

Products

Symantec Products

Issue/Introduction

 

Resolution


This article describes how to install the PGP Lotus Notes Plug-In on the Lotus Notes Domino Server. This article applies to PGP 8.x (Desktop and Enterprise), and Lotus Notes Domino Server version 4.5.x, 4.6.x, 5.x, and 6.x.

 

  • PGP 8.0.2 through 8.1 is needed in order to support Lotus Notes 6.x.
  • The Notes PGP Plug-in supports only Notes client-based Notes Mail. Web browser-based Notes Mail is not supported. PGP's "Current Window" feature may be used to encrypt/decrypt mail in Web-based mail applications.



The PGP Lotus Notes Plug-In uses the PGP Plug-In Template database to allow PGP-enabled and non-PGP-enabled Notes Mail users to coexist peacefully within your Lotus Domino environment.

This article assumes that Lotus Notes 4.5.x, 4.6.x, 5.x, or 6.x is installed and functioning on your users' computers and that your network is running Lotus Domino server software 4.6.x, 5.x, or 6.x. We also assume you are the Lotus Notes administrator for your company or are at least familiar with Notes administration and have commensurate access rights into your Lotus Notes infrastructure. Without the proper access rights you cannot install the PGP Lotus Notes Plug-in.

 

Prior to installing the Lotus Notes Plug-in

  • PGP Desktop 8.1 is already installed on your users' computers.
  • Your Domino servers are correctly configured for sending and receiving mail.

Using the PGP Lotus Domino Server wizard there are two options:

  • Create/refresh your PGP email template--you need to do this when you are installing the PGP Lotus Notes plug-in in your organization's Domino environment for the first time, or when you want to update the plug-in template already on the target Domino server. Selecting this option copies the PGP plug-in templates to the Domino server,which from then on can be replicated to any other Domino mail servers in your network. By use of the standard Domino Design add-in task, any updates made to the PGP template will be propagated to all end user mail databases previously PGP-enabled.
  • PGP enable specific Notes Mail databases--this feature enables the selected mail databases to use the PGP Notes mail extension. This is accomplished by enhancing the design of the selected databases with the PGP-enabled email forms that reside in the PGP Plug-in template, resident on the server.
  • The PGP Lotus Domino Server wizard also lets you remove the PGP Lotus Notes plug-in support from selected mail databases, or completely from your Domino server. To do this, simply select Un-configure PGP Lotus Notes Plug-in on your Domino server from the PGP Lotus Notes Plug-in Options menu and follow the on-screen instructions.

 

Configuring your Domino servers: 

  1. If you are not running the wizard directly on the server machine,make sure you are logged on as a Lotus Notes administrator so that you have the appropriate permissions.
  2. Locate the file called PGPLotusNotesDominoPlugin.exe (found with PGP Desktop and PGP Enterprise Download).
  3. Double click PGPLotusNotesDominoPlugin.exe to start the installer. The Lotus Notes Install Directory screen appears.
  4. Verify the path to the Notes install directory (C:\Lotus\Domino), then click Next. The Lotus Notes Data Directory screen appears.
  5. Verify the path to the Notes data directory(C:\Lotus\Domino\Data), then click Next. The PGP Lotus Notes Plug-in Options menu screen appears.
  6. Select Configure PGP Lotus Notes Plug-In on your Domino server, then click Next. The Domino Server screen appears.
  7. Enter the name of the Domino server that you are configuring (e.g. Server1/Acme -- omitting the quotes),then click Next. (If you are running the PGP Lotus Domino Server wizard on the Domino server itself, leave this field empty.) The Select Task(s) screen appears.
  8. Select either Create-Refresh PGP Plug-In Template and/or PGPEnable specific Notes Mail database(s), then click Next.

    Note: Select Create or refresh PGP Plug-In template if you are installing the PGP Lotus Notes plug-in in your organization's Domino environment for the first time, or when you want to update the template already on the target Domino server. Select PGP enable specific Notes mail database(s) so that you can enable selected mail databases to use the PGP Plug-in template. If you selected PGP enable specific Notes mail database(s), the Lotus Notes Template Filename screen appears.

     
  9. Enter the path to the mail template used on your Domino servers (mail50.ntf, for example), then click Next.
  10. If you selected Create or refresh PGP Plug-In Template, the Method for inputing Notes Mail databases screen appears.
  11. Select Manually type database names, then click Next.
  12. The Lotus Notes Mail Database(s) screen appears.
  13. Do one of the following:

    Enter the file name of a database on the server to PGP enable it.

    Enter list of databases to PGP enable. Use the pipe (|) character to separate each database in the list. mail\helpdesk.nsf for one user or mail\helpdesk.nsf|mail\bob.nsf|mail\ceo.nsf for many users.

    Or...

    Enter the keyword users.txt to batch process a list of databases from a file (you can also browse to this file using the Browse option.

    Method for inputing Notes Mail databases screen - If you choose this option, the installer will look for a file named users.txt in the Lotus Notes program directory. The format of users.txt should resemble the following: database1.nsf database2.nsf database3.nsf

    Or...

    If the mail databases reside in a subdirectory of the server root directory, include the relative path. For example: mail\database1.nsf mail\database2.nsf mail\database3.nsf.

     
  14. When you've made your selection, click Next. The Verify your selections screen appears.
  15. Verify that the settings are correct, then click Next. You are prompted for the password for the user ID file. (If you are installing the Plug-in on the Notes Server and not from and Admin console, then you will not be prompted for the user ID file. (This is because you already have access to the directory on the server where the Plug-in will be making changes).
  16. Enter the appropriate password, then click OK. The configuration of the Domino server begins at this point. This process can take quite awhile depending on your hardware and the number of databases to be configured. In the event that any databases failed to be PGP-enabled,a log file is generated (PGPlog.txt) in your current workstation's Lotus Notes Program directory. When the Domino server is configured,the PGP Install Wizard Complete screen appears.

Notify existing PGP Desktop 8.x users that they may now use PGP from within Lotus Notes. Also tell them that they may need to trust a security warning in their Lotus Notes Client application in order for the PGP Lotus Notes Plug-in to show up the first time.