Quick Start Guide for Cisco UC Integration for IBM Sametime
Cisco UC Integration for IBM Sametime Installation
Downloads: This chapterpdf (PDF - 463.0KB) The complete bookPDF (PDF - 1.64MB) | Feedback

Cisco UC Integration for IBM Sametime Installation

Cisco UC Integration for IBM Sametime Installation

The way that you install and upgrade Cisco UC Integration for IBM Sametime depends on how your system administrator configures the deployment. Most organizations choose to automatically install and upgrade, or “auto-push,” the Integration. In other words, when a new version of the software is available, users would automatically see an announcement of a new version and an option to install it as soon as they start IBM Sametime or IBM Lotus Notes with Sametime.

This section also includes instructions to install Cisco UC Integration for IBM Sametime manually, if your organization chooses that method or if an issue occurs with the automatic installation.

Automatically Install Cisco UC Integration for IBM Sametime

If your system administrator configured your system for auto-push installation, Sametime will alert you when a new version of the Integration is available. Follow this procedure to complete the automatic installation.

Procedure
    Step 1   Log in to IBM Sametime Connect on the host server, for example my-st-svr.cisco.com .
    Step 2   When the installation window appears, click Install this plug-in (the Do not install this plug-in option is selected by default) and click OK.
    Step 3   When Sametime displays a prompt to restart, click Restart Now to activate the plug-ins.

    Manually Install Cisco Unified Communications Integration for IBM Sametime

    The integration installation contains the following steps:
    1. Uninstall the previous version of the integration (if necessary).
    2. Modify the plugin_customization.ini file.
    3. Install the new integration.
    4. Set preferences.
    Before You Begin

    Note


    If your system administrator configured the auto-push option for your organization, Sametime will prompt you that a new version of Cisco UC Integration for IBM Sametime is available. For information on how to complete the automatic installation, see the section “Automatically Install Cisco Unified Communications Integration for IBM Sametime.”


    • The integration requires that you first install IBM Sametime Connect on your computer. Refer to IBM documentation for installation instructions.
    • Check the system requirements for the plug-in that are detailed in Release Notes for Cisco UC Integration for IBM Sametime.
    • Obtain the URL for the update site hosting the plug-in from your system administrator.

    Uninstall Previous Integration from IBM Sametime

    If you previously installed the Cisco UC Integration for IBM Sametime, you must first uninstall the previous version before installing the new integration.


    Note


    If you have not previously installed the integration on this computer, skip to Step 2.


    To uninstall the integration, follow these steps:

    Procedure
      Step 1   Log in to IBM Sametime Connect on the host server, for example ucbu-pgw-11.cisco.com.
      Step 2   Select Tools > Plug-ins > Manage Plug-ins.
      Step 3   In the left section of the Application Management window, click the arrow beside the application that ends with \Sametime\applications\eclipse to expand it.
      Step 4   Press the Shift key and click the Cisco Phone Control and Presence with Lotus Sametime plug-in and the Cisco Unified Messaging with Lotus Sametime plug-in to select both items. Then, right-click and select Uninstall from the menu.
      Step 5   When the Uninstall window appears to confirm your choice, click OK.
      Step 6   When Sametime again displays the prompt to restart, click Restart Now to restart Sametime and complete the uninstall process.
      Step 7   After Sametime restarts, restart Sametime one more time.
      Note   

      To ensure a successful installation of Cisco UC Integration for IBM Sametime, an extra restart is required before reinstallation.

      Step 8   (Optional) Confirm that the uninstallation process was successful. Depending on your operating system, ensure that only one folder, com.ibm.rcp.site.anchor.user.feature_6.1.1, exists in the following directory (or directories):
      • Windows XP:
        • C:\Documents and Settings\<userid>\Application Data\Lotus\Sametime\applications\eclipse\
      • Windows 7:
        • C:\Users\<userid>\AppData\Roaming\Lotus\Sametime\applications\eclipse\features
        • C:\Users\<userid>\AppData\Roaming\Lotus\Sametime\applications\eclipse\plugins

      Modify Customization File

      This step is optional, as some users might not have administrator privileges to allow them to modify the plugin_customization.ini file. If you do not modify this file, a security warning appears during installation and you must manually accept an unsigned certificate.

      To modify the plugin_customization.ini file, follow these steps:

      Procedure
        Step 1   In Windows Explorer, navigate to the C:\Program Files\IBM\Lotus\Sametime Connect\rcp directory.
        Step 2   Open the plugin_customization.ini file in Notepad.
        Step 3   Add the following entries to the end of the file:
        • com.ibm.rcp.security.update/EXPIRED_SIGNATURE_POLICY=ALLOW
        • com.ibm.rcp.security.update/UNSIGNED_PLUGIN_POLICY=ALLOW
        • com.ibm.rcp.security.update/UNTRUSTED_SIGNATURE_POLICY=ALLOW
        Step 4   Select File > Save and then close the file.

        Install New Integration

        Procedure
          Step 1   Obtain the update site URL from your system administrator.
          Step 2   Log in to IBM Sametime Connect on the host server, for example, my-st-server.cisco.com.
          Step 3   Select Tools > Plug-ins > Install Plug-ins.
          Step 4   In the Featured Updates window, select Search for new features to install and click Next.
          Step 5   In the Application Locations window, click Add Remote Location and navigate to the location where you unzipped the downloaded files. Then, click OK.
          Step 6   In the Application Locations window, check the check box beside the application and click Finish.
          Step 7   In the Search Results window, check the check box beside the plug-in release and click Next.
          Step 8   In the Feature License window, select I accept the terms in the license agreements and click Next.
          Step 9   In the Installation window, select the Cisco Phone Control and Presence plug-in and click Finish.
          Step 10   If a confirmation window appears, click Install this plug-in (the Do not install this plug-in option is selected by default) and click OK.
          Note   

          Appearance of the confirmation window depends on how your system administrator configured Cisco UC Integration for IBM Sametime.

          Step 11   When Sametime displays a prompt to restart, click Restart Now to activate the plug-ins.

          Set Account Preferences

          The credential you use to log in to Cisco UC Integration for IBM Sametime depend on how your system administrator configured your system.
          • If your system administrator synchronized your accounts with Sametime, then your Sametime login automatically logs you in to your phone, phone status, and voicemail accounts. You do not need to use the following procedure.
          • If your system administrator configured the servers to use your UC credentials, then you enter a single set of credentials in the Accounts Preferences window. Cisco UC Integration for IBM Sametime automatically logs you in to your phone, phone status, and voicemail accounts.
          • If your system administrator did not synchronize your accounts, you must log in to each of your servers separately.

          Follow this procedure to set your account preferences in Sametime:

          Procedure
            Step 1   Log in to IBM Sametime Connect.
            Step 2   Select File > Preferences.
            Step 3   In the Preferences window, click the arrow beside Cisco to expand it. Then, select Accounts.
            Step 4   If your system administrator synchronized your accounts across the servers, click Cisco > Accounts to enter your username and password. Cisco UC Integration for IBM Sametime automatically logs you in to your phone, phone status, and voicemail accounts.

            If your system administrator has not synchronized your accounts, click Cisco > Accounts > Phone to enter your username and password for your phone account. Then, click Cisco > Accounts > Phone Status and Cisco > Accounts > Voicemail to enter credentials for those services.

            Step 5   (Optional) Click the Use default servers drop-down menu and select Use the following servers. Then, enter the server names or IP addresses for the following servers:
            • CCMCIP server
            • TFTP server
            • CTI server

            To specify servers for the phone status and voicemail services, click Phone Status or Voicemail in the navigation section and enter the server information on those pages.

            Step 6   Click OK or Apply to save your changes.

            Manually Install Cisco UC Integration for IBM Sametime with Lotus Notes

            The integration installation contains the following steps:
            1. Uninstall the previous version of the integration (if necessary).
            2. Modify the plugin_customization.ini file.
            3. Install the new integration.
            4. Set preferences.
            Before You Begin
            • The integration requires that you first install the embedded version of IBM Sametime with Lotus Notes. See IBM for installation instructions.
            • Check the system requirements for the integration that are detailed in the Release Notes for Cisco UC Integration for IBM Sametime.
            • Obtain the URL for the update site hosting the integration from your system administrator.

            Uninstall Previous Integration from Lotus Notes

            If you previously installed the Cisco UC Integration with IBM Sametime plug-ins, you must first uninstall the previous version before installing the new integration.

            If you have not previously installed these plug-ins on this computer, skip to Step 2.

            To uninstall the integration, follow these steps:

            Procedure
              Step 1   Log in to Lotus Notes and select File > Application > Application Management.
              Step 2   In the left section of the Application Management window, click the arrow beside the application that ends with \Workspace\applications\eclipse to expand it.
              Step 3   Press the Shift key and click the Cisco Phone Control and Presence with Lotus Sametime plug-in and the Cisco Unified Messaging with Lotus Sametime plug-in to select both items. Then, right-click and select Uninstall from the menu.
              Step 4   When the Uninstall window appears, click OK to confirm your choice.
              Step 5   When Lotus Notes displays a prompt to restart, click the Restart Now to restart Lotus Notes and complete the uninstall process.
              Step 6   After Lotus Notes restarts, restart one more time.
              Note   

              To ensure a successful installation of Cisco UC Integration for IBM Sametime, an extra restart is required before reinstallation.


              Modify Customization File

              This step is optional, as some users might not have administrator privileges to allow them to modify the plugin_customization.ini file. If you do not modify this file, a security warning appears during installation and you must manually accept an unsigned certificate.

              To modify the plugin_customization.ini file, follow these steps:

              Procedure
                Step 1   In Windows Explorer, navigate to the C:\Program Files\IBM\Lotus\Notes\framework\rcp\ directory.
                Step 2   Open the plugin_customization.ini file in Notepad.
                Step 3   Add the following entries to the end of the file:
                • com.ibm.notes.branding/enable.update.ui=true
                • com.ibm.rcp.security.update/EXPIRED_SIGNATURE_POLICY=ALLOW
                • com.ibm.rcp.security.update/UNSIGNED_PLUGIN_POLICY=ALLOW
                • com.ibm.rcp.security.update/UNTRUSTED_SIGNATURE_POLICY=ALLOW
                Step 4   Select File > Save and then close the file.

                Install New Integration

                Procedure
                  Step 1   Obtain the update site URL from your system administrator.
                  Step 2   Log in to Lotus Notes and select File > Application > Install.
                  Step 3   In the Featured Updates window, select Search for new features to install and click Next.
                  Step 4   In the Application Locations window, click Add Remote Location and navigate to the location where you unzipped the downloaded installation files. Then, click OK.
                  Step 5   In the Application Locations window, check the check box beside the application and click Finish.
                  Step 6   In the Update window, check the check boxes beside the plug-in releases and click Next.

                  If you want to install only one of the plug-ins, leave the other plug-in release unchecked.

                  Step 7   In the Feature License window, select I accept the terms in the license agreements and click Next.
                  Step 8   In the Installation window, click Finish.
                  Step 9   When Lotus Notes displays a prompt to restart, click Restart Lotus Notes to activate the integration.

                  Set Account Preferences

                  Follow this procedure to set your account preferences in IBM Lotus Notes with Sametime:

                  Procedure
                    Step 1   Open Lotus Notes with Sametime, but do not log in.
                    Step 2   If your system administrator synchronized your accounts, your Sametime login automatically logs you in to your phone, phone status, and voicemail accounts.

                    If your system administrator has not synchronized your accounts, click Accounts > Phone to enter your username and password for your phone account. Then, click Accounts > Phone Status and Accounts > Voicemail to enter credentials for those services.

                    Step 3   (Optional) To enter server information, from the Use default servers drop-down menu, choose Use the following servers. Then, enter server names or IP addresses for the following servers:
                    • CCMCIP server
                    • TFTP server
                    • CTI server

                    To specify servers for the phone status and voicemail services, click Phone Status or Voicemail in the navigation section and enter the server information on those pages.

                    Step 4   Click OK to save your changes.