Install the IBM Connections Files plug-in for Lotus Notes 




Install the IBM® Connections Files plug-in for Lotus Notes® to access IBM Connections Files from your Lotus Notes client.

There are two ways to install the IBM Connections Files plug-in for Lotus Notes. A user can install the plug-in for a Notes® client using the InstallShield wizard, or an administrator can perform a silent installation for all plug-in users.


Parent topic

IBM Connections Files plug-in for Lotus Notes

Install the Files plug-in on a Windows client


Install the plug-in so that it is integrated with the Lotus Notes client.

Procedure

  1. Download the IBM Connections Files plug-in for Lotus Notes from the IBM Connections catalog at the following web site:


  2. Unzip ICS301_Files_20110713.zip.

  3. Click Setup.exe in the output folder.

  4. Make sure your Lotus Notes client is closed before beginning the installation.

  5. Accept installation prompts for installing the plug-in.

  6. Click Finish to complete the installation.

  7. If "Forced confidential" is enabled on the Lotus Connections server (in LotusConnections-config.xml), additional configuration will need to be done on the Notes client.


    Open the plugin_customization.ini file for the Notes® client in a text editor. The file is stored in the following directory: <Notes Install>/framework/rcp/plugin_customization.ini.

    Add this line:

    com.ibm.documents.connector.service/ENABLE_SSL=true

Silently installing the IBM Connections Files plug-in (Windows)

About this task


Administrators can silently install the Connections Files plug-in from the command prompt. A silent installation uses the same installation program that the graphical user interface (GUI) version users. However, instead of displaying a wizard interface, the silent installation reads all your responses from parameters that you pass to the command line. In order for the installation to work successfully, run the silent installation from the directory where you unzipped the plug-in files.

Procedure

  1. Make sure your Lotus Notes client is closed before beginning the installation.

  2. Open a command window.

      For example, choose Run from the Microsoft® Windows® Start menu and type cmd, then click OK.

  3. Specify the path for the downloaded and unzipped installation file for the plug-in.

      For example, c:\<download_folder>.

  4. Enter setup.exe /s /v" /qn" to begin the installation.

Install the Files plug-in on a Mac client


Install the Mac version of the IBM Connections Files plug-in for Lotus Notes so that it is integrated with the Lotus Notes client.

Before you begin


Note: If you have an existing version of this plug-in installed, uninstall it before installing a new version.

Procedure

  1. Download the IBM Connections Files plug-in for Lotus Notes from the IBM Connections catalog at the following web site:


  2. Unzip ICS301_Files_20110713.zip.

  3. Open the output.mac folder, and double-click FilesPlugin.zip to unzip the package.

  4. Make sure your Lotus Notes client is closed before beginning the installation.

  5. Double-click xpd.mac-addon.pkg to launch the installation program.

  6. Accept installation prompts for installing the plug-in.

  7. Click Finish to complete the installation.

Silently installing the IBM Connections Files plug-in (Mac)

About this task


Administrators can silently install the Connections Files plug-in from the command prompt. A silent installation uses the same installation program that the graphical user interface (GUI) version users. However, instead of displaying a wizard interface, the silent installation reads all your responses from parameters that you pass to the command line. In order for the installation to work successfully, run the silent installation from the directory where you unzipped the plug-in files.

Procedure

  1. Make sure your Lotus Notes client is closed before beginning the installation.

  2. Open a terminal window.

  3. Specify the path for the downloaded and unzipped installation file for the plug-in.

      For example, /output.mac/FilesPlugin.

  4. Enter sudo Installer -pkg <package name> -target <destination volume> to begin the installation.

      Where:

      • <package name> is the name of the installer "xpd.addon.mac.pkg".
        <destination volume> is the disk where Lotus Notes was installed.

      For example: sudo Installer -pkg xpd.addon.mac.pkg -target Macintosh_HD

  5. Enter your password at the prompt to begin the installation.

      When the installation completes, a terminal message displays The install was successful.

Viewing the log files


If you encounter any errors during the installation or configuration process, review the log files for troubleshooting information.

About this task


On Windows, the logs for the plug-in are stored in the default temp directory for users. For example, on Windows XP, the directory is: C:\documents and settings\<username>\Local Settings\temp\rcp_addon_install.txt\.

To view the logs on a Mac...

Procedure

  1. If the Notes version is lower than 8.5.2.

    1. Open the Terminal windows.

    2. Enter cd /tmp to navigate to the temp folder.

    3. Enter sudo cat rcp_FilesPlugin_install.log to view the installation log for the Files plug-in.

    4. Enter sudo cat rcp_FilesPlugin_uninstall.log to view the uninstall log for the Files plug-in.

    5. Enter your password at the prompt to view the log.

        Note: The rcp_FilesPlugin_install.log and rcp_FilesPlugin_uninstall.log files are deleted automatically when the system is restarted.

  2. If the Notes version is 8.5.2 or higher.

    1. Navigate to the directory where Notes is installed.

    2. Navigate to /Contents/MacOS/rcp/deploy/instalHistory.

    3. Find the zip file. It's name will be similar to this: Notes_8.5.2FP3_ADDON_INSTALL_1311563867253.zip or Notes_8.5.2FP3_ADDON_UNINSTALL_1311572948964.zip.

    4. Unzip the file and navigate to /colutil/tmp to access the log

If you installed the IBM Connections Files plug-in for Lotus Notes 8.5.2 with either Fixpack 2 or 3 installed, there is a configuration which can prevent users from sharing files. Users will be able to view files, but, when trying to share a file will see this error message: "A problem with the server was encountered".

The reason for this problem is most likely because an ssl setting called "Forced confidential" is enabled on the Lotus Connections server and it creates a conflict on the Notes client. To correct this problem, do the following:


Open the plugin_customization.ini file for the Notes® client in a text editor. The file is stored in the following directory: <Notes Install>/framework/rcp/plugin_customization.ini.



February 23, 2012
   

 

Feb 23, 2012 4:32:30 PM 7 Aug 9, 2011 4:22:46 PM 6 Aug 9, 2011 1:10:43 PM 5 Aug 5, 2011 12:18:46 PM 4 Jul 27, 2011 7:52:26 PM 3 Jul 27, 2011 7:46:53 PM 2 Jul 27, 2011 7:33:35 PM 1

});