Deployment example: Adding Sametime 8.5.0 client to the Notes 8.5.1 client install kit

Technote (FAQ)


Question

How can you add the Sametime 8.5.0 client as the embedded client for the Lotus Notes 8.5.1 client? Notes 8.5.1 ships with Sametime 8.0.2 client embedded, and you would like Sametime 8.5.0 features to be installed instead.

Answer

Note: For later versions of Sametime, refer to "Upgrading the IBM Lotus Sametime client embedded in IBM Lotus Notes to Lotus Sametime 8.5.1 or 8.5.2."



You can use one of the following methods to add the Sametime 8.5.0 client as the embedded client for Notes 8.5.1 client:
  • installing the Sametime 8.5 client on an existing Notes 8.5.1 client platform (already installed)
  • adding the Sametime 8.5 embedded client to the Notes 8.5.1 installation package

Use the method applicable to your configuration by following the steps below.

NOTE: Lotus Notes 8.5.1 fix pack 2 (FP2) should be applied after adding Sametime 8.5 to the Notes 8.5.1 client. This fix pack allows for additional Sametime patches to be installed at a later time.

    Method 1: Steps to add the Sametime 8.5 client to an existing Notes 8.5.1 client platform
    1. Obtain the Sametime 8.5 client installation package, namely the following image:

      IBM Lotus Sametime Standard V8.5 Connect Clients Standalone, Notes, Network Installer, Mobile Windows Multilingual (CZA6MML)

    2. Extract the archive, and locate the Sametime 8.5 embedded updatesite:

      ..\CZA6MML\SametimeStandardClient\sametimeclient.for.notes\sametime.embedded.add-on.win.20091204-1650.zip

    3. Within the extracted files, locate the setup.exe file. Make sure Notes is shut down, then run the setup.exe file.

    4. Verify the installation dialog completes and reports a successful install.

    Now your Notes 8.5.1 client contains Sametime 8.5.0 embedded.


    Method 2: Steps to add the Sametime 8.5 embedded client to the Lotus Notes 8.5.1 install package

    1. Obtain the Notes 8.5.1 install package and extract the contents:
      1. Obtain the Notes 8.5.1 install package for your platform. For example, the following part number is for Windows:

        IBM Lotus Notes 8.5.1 for Windows English (CZ5S3EN)

      2. Launch the executable, and choose to "Unpack the files used to perform the installation to a location specified below...."

      3. Choose a path and click next to extract the contents of the install package. Once it completes, cancel out of the installer and make note of the path you specified.

    2. Obtain the Sametime 8.5 client installation package
      1. Obtain the following image:

        IBM Lotus Sametime Standard V8.5 Connect Clients Standalone, Notes, Network Installer, Mobile Windows Multilingual (CZA6MML)

      2. Extract the archive and locate the Sametime 8.5 embedded updatesite:

        ..\CZA6MML\SametimeStandardClient\sametimeclient.for.notes\sametime.embedded.add-on.win.20091204-1650.zip

      3. Extract Sametime 8.5 embedded update site.

        Extract the sametime.embedded.add-on.win.20091204-1650.zip file.

        Copy the embedded updatesite (sametime.embedded.update.site.20091204-1650.zip) into the Notes install kit (the same directory containing the Notes "updateSite.zip").

    3. Replace the old Sametime features with the new versions in the Notes install.xml
      1. Backup the Notes .\deploy\install.xml file.

      2. Locate the installfeatures whose ID is "Sametime", and replace the following nine features with the correlating install features from the Sametime 8.5 embedded updatesite's .\deploy\install.addon.xml. For example you will find something like this in the .\deploy\install.addon.xml:

        <feature id="com.ibm.collaboration.realtime.browser.feature" version="<timestamp>" match="compatible" download-size="68" size="68" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.<timestamp>.zip!/"/>
        <feature id="com.ibm.collaboration.realtime.chat.logging.feature" version="20091204-1650" match="compatible" download-size="121" size="121" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>
        <feature id="com.ibm.collaboration.realtime.core.feature" version="20091204-1650" match="compatible" download-size="148" size="148" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>
        <feature id="com.ibm.collaboration.realtime.im.community.feature" version="20091204-1650" match="compatible" download-size="300" size="300" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>
        <feature id="com.ibm.collaboration.realtime.messages.feature" version="20091204-1650" match="compatible" download-size="322" size="322" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>
        <feature id="com.ibm.collaboration.realtime.people.feature" version="20091204-1650" match="compatible" download-size="121" size="121" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>
        <feature id="com.ibm.collaboration.realtime.rtc.core.feature" version="20091204-1650" match="compatible" download-size="165" size="165" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>
        <feature id="com.ibm.collaboration.realtime.ui.feature" version="20091204-1650" match="compatible" download-size="1061" size="1061" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>
        <feature id="com.ibm.rcp.realtime.livenames.feature" version="20091204-1650" match="compatible" download-size="17" size="17" action="install" shared="true" mergeaction="add" url="jar:${installer.root}/sametime.embedded.update.site.20091204-1650.zip!/"/>

        Leave the other features alone whose install action is "uninstall".

      3. Locate the installfeature whose ID is "SametimeUI". Again replace the entire SametimeUI installfeature from the Notes install kit with the SametimeUI installfeature from the Sametime embedded kit's install.addon.xml.

        Attached is an install.xml file from the notes install kit that has been modified using this procedure.

        NOTE: The attached install.xml file should not be used if you, the administrator, have used trimupdatesite or other applications to adjust the install manifest because it will remove your changes.

        install.xml
        modified install.xml file

    4. Install Notes 8.5.1
      1. Before installing, make sure you have copied the Sametime 8.5 embedded updatesite to the root of the Notes installer directory (Step 2c above). Also make sure the ./deploy/install.xml is saved and correct.

      2. Launch the installer from the directory you have been working with. The installer should complete normally with no provisioning errors, which can be verified by checking the logs in the user workspace.


    Rate this page:

    (0 users)Average rating

    Document information


    More support for:

    IBM Sametime
    Notes integration

    Software version:

    8.5

    Operating system(s):

    Linux, Mac OS X, Windows

    Software edition:

    Standard

    Reference #:

    1420476

    Modified date:

    2011-10-19

    Translate my page

    Machine Translation

    Content navigation