CTI OS System Manager Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted Release 9.0(1)
CTI Toolkit Desktop Client installation
Downloads: This chapterpdf (PDF - 1.09MB) The complete bookPDF (PDF - 4.72MB) | Feedback

CTI Toolkit Desktop Client installation

CTI Toolkit Desktop Client installation

Important:

The new CTI OS functionality that is part of Release 9.0(1) is installed by the procedure discussed in CTI OS silent monitor installation and configuration. Release 9.0(1) upgrades Release 8.5(2) or later. When you apply Release 9.0(1) to a Release 8.5(2) system, it performs an upgrade. However, when you apply Release 9.0(1) to a Release 8.5(2) or later, it first rolls back the system to Release 8.0 and then performs the upgrade to Release 9.0(1).

This chapter provides procedures for installing the following CTI Toolkit Desktop Client components:

  • CTI Toolkit Desktop applications:
    • Agent desktop (including silent monitor)
    • IPCC Supervisor Desktop (including silent monitor)
    • Tools
  • Documentation
  • CTI Toolkit SDK (previously the CTI OS Developer's Toolkit, including necessary files, controls, documentation, and samples needed to write custom applications):
    • Win32
    • Java
    • .NET

It also provides procedures for enabling the Emergency Call and Supervisory Call buttons, which enable an agent to make a call to a supervisor.


Note


Before you begin installation, verify that your system meets the hardware and software requirements for the components you plan to install, as listed in Hardware & System Software Specification (Bill of Materials) for Cisco Unified ICM/Contact Center Enterprise & Hosted, Release 9.0(1). This document is available at: http://www.cisco.com/en/US/products/sw/custcosw/ps1844/prod_technical_reference_list.html.


Upgrade from previous version

If you are upgrading from a previous CTI OS release, you need not uninstall the CTI Toolkit Desktop Client software before you install CTI Toolkit Desktop Client Release 9.0(1).

Install Cisco CTI Toolkit Desktop Client component

To install the CTI Toolkit Desktop Client components, perform the following steps.

Procedure
    Step 1   From the Installs\CTIOSClient directory on the CD, run Setup.exe.
    Step 2   Click the Next button on the Welcome screen. The Software License Agreement screen appears.
    Figure 1. CTI Toolkit Desktop Client component installation license agreement



    Step 3   Click the Yes button.

    The Choose Destination Location screen appears.

    Figure 2. Destination drive selection



    Step 4   Accept the default drive or click the Browse button and specify another drive.
    Step 5   Click Next to open the Select Components screen and select the CTI Toolkit Desktop Client components that you want to install.
    Note   

    If you plan to use the Release 9.0(1) Silent Monitor Service, you must select at least one of the CTI Toolkit Desktop Software components or the CTI Desktop SDK Win32 component.

    Step 6   Click Next.

    If you select CTI Toolkit Agent Desktop or CTI Toolkit IPCC Supervisor Desktop, the CTIOS Server Information screen appears.

    Note   

    Phones that are configured to use SRTP cannot be silently monitored. Customers who wish to silently monitor agents must not configure the agent phones to use SRTP.

    Figure 3. CTI OS Server information



    Enter the Name or IP Address and the Port Number for your CTI OS systems.

    Note   

    If you enable the QoS checkbox during the CTI OS Server Installation, you must select the checkbox at this stage.

    Step 7   Click the Next button.

    The Start Copying Files screen appears.

    Step 8   Click the Next button to begin installation.
    Step 9   After the installation is complete, the following window appears, prompting you to install the Security feature. For more information about CTI OS Security, see CTI OS security.
    Figure 4. CTI OS Client security



    For more information about what Security Certificate option you must select, see CTI OS security

    Step 10   Click OK.

    The following window appears:

    Figure 5. CTI OS security InstallShield wizard



    While Security is being configured, several status messages appear.

    Step 11   Lastly, the CTIOS Setup Completed dialog box appears.
    Figure 6. CTI OS Server setup completion dialog box



    Step 12   Specify whether or not you want to restart your computer. Click the Finish button to exit Setup.

    Installed files

    When you install the CTI Toolkit Agent Desktop or the CTI Toolkit IPCC Supervisor Desktop, the CTI Toolkit installation process installs a number of dynamic link libraries (DLLs). The installation process registers many of these DLLs automatically, but you must manually register some of these DLLs to work correctly.

    The following table lists the Windows DLLs that are installed with the CTI Toolkit Agent Desktop or the CTI Toolkit IPCC Supervisor Desktop, along with the command line entry for manually registering the DLL (if needed).

    Table 1 Windows DLLs

    DLL

    Command Line Entry For Manually Registering

    msvcrt.dll

    Registration not needed.

    msvcrtd.dll

    Registration not needed.

    msvcp60.dll

    Registration not needed.

    msvcp60d.dll

    Registration not needed.

    mfc42.dll

    Registration not needed.

    mfc42d.dll

    Registration not needed.

    atl.dll

    regsvr32 atl.dll

    msvbvm60.dll

    regsvr32 msvbvm60.dll

    The following Softphone Controls DLLs are installed with the CTI Toolkit Agent Desktop or the CTI Toolkit IPCC Supervisor Desktop:

    • CtiosStatusbar.dll
    • EmergencyAssistCtl.dll
    • AgentSelectCtl.dll
    • GridControl.dll
    • AgentStateCtl.dll
    • HoldCtl.dll
    • AlternateCtl.dll
    • IntlResourceLoader.dll
    • AnswerCtl.dll
    • Arguments.dll
    • BadLineCtl.dll
    • ButtonControl.dll
    • ChatCtl.dll
    • ConferenceCtl.dll
    • CtiCommonDlgs.dll
    • MakeCallCtl.dll
    • ReconnectCtl.dll
    • CTIOSAgentStatistics.dll
    • RecordCtl.dll
    • CTIOSCallAppearance.dll
    • SubclassForm.dll
    • CTIOSClient.dll
    • SupervisorOnlyCtl.dll
    • CTIOSSessionResolver.dll
    • TransferCtl.dll
    • CTIOSSkillGroupStatistics.dll

    If the CTI Toolkit Agent Desktop or the CTI Toolkit IPCC Supervisor Desktop indicate that a given DLL is not registered, you can manually register the DLL by using the following command:

    regsvr32 <DLL filename>

    For example, you can register CtiosStatusbar.dll by using the following command:

    regsvr32 CtiosStatusbar.dll

    With interoperability, the Win32 COM controls work under the .NET framework. The installation lays down the following files and installs them into the Global Access Cache (GAC):

    AxInterop.AgentSelectCtl.dll

    Cisco.CTICOMMONDLGSLib.dll

    Interop.AgentSelectCtl.dll

    AxInterop.AgentStateCtl.dll

    Cisco.CTIOSARGUMENTSLib.dll

    Interop.AgentStateCtl.dll

    AxInterop.AlternateCtl.dll

    Cisco.CTIOSCLIENTLib.dll

    Interop.AlternateCtl.dll

    AxInterop.AnswerCtl.dll

    Cisco.CTIOSSESSIONRESOLVERLib.dll

    Interop.AnswerCtl.dll

    AxInterop.BadLineCtl.dll

    Cisco.INTLRESOURCELOADERLib.dll

    Interop.BadLineCtl.dll

    AxInterop.ButtonControl.dll

    Interop.ButtonControl.dll

    AxInterop.ChatCtl.dll

    Interop.ChatCtl.dll

    AxInterop.ConferenceCtl.dll

    Interop.ConferenceCtl.dll

    AxInterop.CTIOSAgentStatistics.dll

    Interop.CTIOSAgentStatistics.dll

    AxInterop.CTIOSCallAppearance.dll

    Interop.CTIOSCallAppearance.dll

    AxInterop.CTIOSSkill
    GroupStatistics.dll

    Interop.CTIOSSkill
    GroupStatistics.dll

    AxInterop.CTIOSStatusBar.dll

    Interop.CTIOSStatusBar.dll

    AxInterop.EmergencyAssistCtl.dll

    Interop.EmergencyAssistCtl.dll

    AxInterop.GridControl.dll

    Interop.GridControl.dll

    AxInterop.HoldCtl.dll

    Interop.HoldCtl.dll

    AxInterop.MakeCallCtl.dll

    Interop.MakeCallCtl.dll

    AxInterop.ReconnectCtl.dll

    Interop.ReconnectCtl.dll

    AxInterop.RecordCtl.dll

    Interop.RecordCtl.dll

    AxInterop.SilentMonitorCtl.dll

    Interop.SilentMonitorCtl.dll

    AxInterop.SubclassForm.dll

    Interop.SubclassForm.dll

    AxInterop.SupervisorOnlyCtl.dll

    Interop.SupervisorOnlyCtl.dll

    AxInterop.TransferCtl.dll

    Interop.TransferCtl.dll

    Uninstall CTI Toolkit

    To uninstall the CTI Toolkit, run Add/Remove programs from the Windows Control Panel and select Cisco CTI Toolkit Uninstall.

    Determine version number of installed CTI Toolkit files

    If the CTI Toolkit Agent Desktop or the CTI Toolkit Supervisor Desktop for IPCC are currently running, the title bars of the desktop windows display the CTI Toolkit version number.

    If these desktops are not currently running, you can determine the version number of an installed CTI Toolkit file by performing the following steps.

    Procedure
      Step 1   Go to the directory: Program Files\Cisco Systems\CTIOS Client\CTIOS Toolkit\Win32 CIL\COM Servers and Activex Controls
      Step 2   Highlight, and then right-click the ctiosclient.dll file.
      Figure 7. CTI OS COM directory



      Step 3   Select Properties from the drop-down menu.

      The Properties dialog box appears.

      Step 4   Select the Version tab.

      This tab contains version information (release number and build number) for the file.

      Figure 8. CTI OS Client properties




      Unified CM Intercept configuration requirement

      You must set the Cisco Unified CM service parameter named Drop Ad Hoc Conference to "never" (the default value), otherwise during the Intercept function, all the parties in the call get dropped.

      Configure supervisory assistance features

      The CTI Toolkit Agent Desktop includes buttons that enable an agent to make an emergency call to a supervisor or to place a call to request assistance from a supervisor. To enable the functionality for these buttons, a Unified ICM system administrator must perform the following steps.

      Procedure
        Step 1   Perform the following tasks from the Unified ICM Configuration Manager (for more information, see Configuration Guide for Cisco Unified ICM/Contact Center Enterprise and Hosted).
        1. On the Dialed Number List screen, create a Dialed Number for the supervisor, as shown in the following screens.
          Figure 9. Dialed Number List





        2. On the Agent Team List screen, enter the Dialed Number in the Supervisor script dialed number field, as shown.
          Figure 10. Agent Team List



        Step 2   Perform the following task from the Script Editor (for more information, see Scripting and Media Routing Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted).
        1. On the Call Type Manager screen, associate the Dialed Number with your script, as shown.
          Figure 11. Call Type Manager




        Video configuration

        For more information about configuring video on CTI OS or CAD desktops, see Configuring Video on the Cisco CTI OS or CAD Desktops topic in the Configuration and Administration Guide for Cisco Unified Customer Voice Portal, Release 9.0(1) located at:

        http://www.cisco.com/en/US/products/sw/custcosw/ps1006/products_installation_and_configuration_guides_list.html.