Jump to: navigation, search

Installing the Workspace SIP Endpoint

[Modified: 8.5.109.16, 8.5.114.08]

The Workspace SIP Endpoint is an optional plug-in or standalone application for Workspace. It is available as a separate IP that you install from a separate CD/DVD. You can install it in one of two modes, as a plugin that runs with Workspace Desktop Edition on the agent workstation, or as a standalone application that connects to Workspace running in a virtualized environment.

Tip
Workspace also supports the Genesys Softphone in place of Workspace SIP Endpoint. To learn about the installation of Genesys Softphone, see Deploying Genesys Softphone in the Genesys Softphone Deployment Guide.

If you intend to create a ClickOnce package to install Workspace SIP Endpoint, install the Workspace SIP Endpoint after you install the Workspace application on your server, but before you run the Workspace Deployment Manager.

If you deploy Workspace SIP Endpoint as part of a ClickOnce deployment, the behavior of the ClickOnce download depends on the privileges that are assigned to the agent who is logging in. If the agent is granted the privilege to execute a local Workspace SIP Endpoint, the following files are downloaded to the agent workstation:

  • The SIP Endpoint Communication plug-in (part of Workspace runtime)
  • The Workspace SIP Endpoint executable and associated assemblies.

Installing Workspace SIP Endpoint as a Workspace Desktop Edition plugin

Use the following procedure to install Workspace SIP Endpoint in environments where the Workspace application and Workspace SIP Endpoint run on the same workstation. Use the Installing the Standalone Workspace SIP Endpoint when you are running Workspace in a virtualized environment.

Procedure

Installing the Workspace SIP Endpoint as a Workspace Desktop Edition plugin

Purpose: To install the Workspace SIP Endpoint on your web server, an agent workstation, or a development workstation as a plugin.

Prerequisites

Start

  1. On your desktop, open the Workspace SIP Endpoint disc or the Workspace SIP Endpoint IP and double-click the Setup.exe file.

    You might be asked to reboot your system to delete or rename certain system files before the Installation Wizard runs.

    The Genesys Installation Wizard launches and the Welcome panel is displayed.

  2. On the Welcome panel, do one of the following:
    • Click Next to begin the installation procedure.
    • Click Cancel to exit the Genesys Installation Wizard.
    • Click About to open the Workspace SIP Endpoint ReadMe in your default browser.

      If you clicked Next, the Select Installed Application panel is displayed (see the Figure - Select Installed Application Panel of the Genesys Installation Wizard).

      Select Installed Application Panel of the Genesys Installation Wizard
  3. The Select Installed Application panel enables you to select the Workspace application instance to which you want to add Workspace SIP Endpoint as a plug-in.

    The Genesys Installation Wizard searches the target computer for an installed version of Workspace. Select the version of Workspace in the location in which you want Workspace SIP Endpoint to be installed.

    The Application Properties pane displays the name, version, and location of the selected Workspace application (see the Figure - Select Installed Application Panel of the Genesys Installation Wizard).

  4. After you have selected the version of Workspace that you want to use with Workspace SIP Endpoint, do one of the following:
    • Click Next to proceed to the next panel.
    • Click Cancel to exit the Genesys Installation Wizard.
    • Click Back to return to the previous panel.

      If you clicked Next, the Ready to Install panel is displayed.

  5. On the Ready to Install panel do one of the following:
    • Click Install to install Workspace SIP Endpoint on your web server, development workstation, or agent workstation.
    • Click Back to return to the Select Installed Application panel.
    • Click Cancel to exit the Genesys Installation Wizard.
    If you clicked Next, Workspace SIP Endpoint is installed in the location that you specified. When installation is complete, the Installation Complete panel is displayed.
  6. Click Finish to exit the Genesys Installation Wizard.

    A folder that is named InteractionWorkspaceSIPEndpoint is created in the Workspace folder. The InteractionWorkspaceSIPEndpoint folder contains the Workspace SIP Endpoint application and associated files.

    After the Workspace SIP Endpoint application is installed on the agent or developer workstation, or after it is downloaded by the ClickOnce application (see Deploying The ClickOnce Application On Your Web Server), and after the agent is granted permission to use the application, agents must login Workspace on a Place that is associated with a SIP DN to start the Workspace SIP Endpoint. The Workspace SIP Endpoint process is started automatically when Workspace application is being initialized.

  7. To ensure that the supporting programs were installed correctly, check if the following programs are available in the "uninstall programs" view of the Control Panel on your Windows workstation:
    • Genesys Workspace SIP Endpoint <version>
    • Microsoft Visual C++ 2005 Redistributable (8.5.113.xx and lower)
    • Microsoft Visual C++ 2012 Redistributable (x86) - 11.0.60.610

End

Next Steps

Installing the standalone Workspace SIP Endpoint

[Added: 8.5.109.16]

Use the following procedure to install Workspace SIP Endpoint in environments where the Workspace application is running in a virtualized environment and Workspace SIP Endpoint runs as a standalone application on the agent workstation.

Procedure

Installing the standalone Workspace SIP Endpoint as a ClickOnce package

Purpose: To install the Workspace SIP Endpoint on your web server so that it can be deployed on an agent workstation or a development workstation.

Prerequisites

Start

  1. Open the Workspace SIP Endpoint disc or the Workspace SIP Endpoint IP and double-click the Setup.exe file. You might be asked to reboot your system to delete or rename certain system files before the Installation Wizard runs. The Genesys Installation Wizard launches and the Welcome panel is displayed.
  2. On the Welcome panel, do one of the following:
    • Click Next to begin the installation procedure.
    • Click Cancel to exit the Genesys Installation Wizard.

    If you clicked Next, the Select Installed Application panel is displayed (see the Figure - Select Installed Application Panel of the Genesys Installation Wizard).

    Select Installed Application Panel of the Genesys Installation Wizard
  3. Ensure that Workspace Desktop Edition is selected, then click Next to proceed to the Ready to Install panel.
  4. On the Ready to Install panel, click Install to install Workspace SIP Endpoint on your web server.

    Workspace SIP Endpoint is installed in the location that you specified. When installation is complete, the Installation Complete panel is displayed.

  5. Click Finish to exit the Genesys Installation Wizard.

    A folder that is named InteractionWorkspaceSIPEndpoint is created in the Workspace Desktop Edition folder. The InteractionWorkspaceSIPEndpoint folder contains the Workspace SIP Endpoint application and associated files.

  6. From the Start menu of your web server host, use the application shortcut to launch the Workspace Desktop Edition Deployment Manager. The Deployment Manager can also be launched from the location where you installed it. The Welcome panel is displayed on the desktop of your web server.
  7. On the Welcome panel, click Next to begin the installation procedure. The Select Package panel is displayed.
    Select Package Panel of the Workspace Desktop Edition Deployment Manager
  8. Click the Workspace Desktop Sip Endpoint standalone option, then click Next. The Destination Folder panel is displayed.
  9. Specify the path to the destination folder for the ClickOnce package, then click Next. The Package Information panel is displayed.
  10. Specify the following information:
    • Application Name—The default name is Workspace Desktop SIP Endpoint
    • Publisher—The default name is Genesys Telecommunications Laboratories
    • Base URL—Specify the host URL that will be provided to agents to download the ClickOnce package

    Click Next. The Signing panel is displayed. For more information about how to create or obtain a signing certificate, refer to the "ClickOnce Deployment and Authenticode" page on the Microsoft Developer Network web site:

    http://msdn.microsoft.com/en-us/library/ms172240.aspx
  11. Choose the type of signing certificate that you are using:
    • Click Do not Sign if you do not provide a certificate, a security warning is displayed whenever the client downloads the package.
    • Click Sign with a provided certificate to enable the Selects a certificate field.
      1. Click the browse button to navigate to the certificate.
      2. Enter the password for the certificate in the Password field.
  12. Click Next to proceed with the installation. The Ready to Build pane is displayed. This pane contains a summary of the files that will be deployed on your web server and a confirmation of the deployment URL.
  13. Click Next to complete the deployment. The Deployment Manager deploys the Workspace Standalone SIP Endpoint ClickOnce application in the path that you specified at the beginning of the wizard execution. When the deployment is complete, the Deployment Finished pane is displayed. This pane contains messages that relate to the success of the deployment.
  14. Click Finish to close the Workspace Deployment Manager.

    Deployment proceeds. When deployment is complete, the publish.htm web page is opened in your default browser automatically for testing purposes.

    The Workspace Standalone SIP Endpoint publish.htm page
  15. Provide the URL for the publish.htm page to your agents to enable them to install the Workspace Standalone SIP Endpoint on their workstations and receive automatic updates when the application is updated on the web server.
  16. When an agent navigates to the publish.htm page, the ClickOnce package deployment automatically starts, or she or he should click the Launch hyperlink to start the deployment on his or her workstation.
  17. Instruct your agent to click Install. When the installation is complete, the Workspace Standalone SIP Endpoint launches automatically. The application icon is displayed in the system tray (IW 851 Workspace Standalone SEP Sys Tray Icon.png). The icon is grey when the SIP Endpoint is not connected to a Workspace application running in a virtualized environment, and red when it has an active connection.

    Agents can exit the SIP Endpoint by right clicking on the icon and selecting Exit. If Agents have to relaunch the application, they can do so by using the shortcut in the Start menu.

    Note: When Workspace SIP Endpoint is started for the first time on a workstation with an active Windows Firewall, the Windows Operating System displays a security message requesting the user to approve the selection of a private or enterprise network.

    Agents running Workspace SIP Endpoint on Workstations using Windows Firewall might have to grant access to run the application for the first time

End

Next Steps

Procedure

Installing the Standalone Workspace SIP Endpoint on a workstation

Purpose: To install the Workspace SIP Endpoint on an agent workstation or a development workstation.

Prerequisites

Start

  1. On your workstation, open the Workspace SIP Endpoint disc or the Workspace SIP Endpoint IP and double-click the Setup.exe file. You might be asked to reboot your system to delete or rename certain system files before the Installation Wizard runs. The Genesys Installation Wizard launches and the Welcome panel is displayed.
  2. On the Welcome panel, do one of the following:
    • Click Next to begin the installation procedure.
    • Click Cancel to exit the Genesys Installation Wizard.
    If you clicked Next, the Choose Destination Location panel is displayed.
  3. Specify the Destination Folder for the Workspace SIP Endpoint application, then click Next to proceed to the Ready to Install panel.
  4. On the Ready to Install panel, click Install to install Workspace SIP Endpoint on your workstation.

    Workspace SIP Endpoint is installed in the location that you specified. When installation is complete, the Installation Complete panel is displayed.

  5. Click Finish to exit the Genesys Installation Wizard.
  6. When the installation is complete, the Workspace Standalone SIP Endpoint can be launched for the first time by using the shortcut in the Start menu (or it will start automatically when any Windows user session is started). The application icon is displayed in the system tray (IW 851 Workspace Standalone SEP Sys Tray Icon.png).

    The icon is grey when the SIP Endpoint is not connected to a Workspace application running in a virtualized environment, and red when it has an active connection.

    Agents can exit the SIP Endpoint by right clicking on the icon and selecting Exit. If Agents have to relaunch the application, they can do so by using the shortcut in the Start menu.

End

Next Steps

Deployment Manager in Console mode

You can build a Workspace Standalone SIP Endpoint ClickOnce package using Workspace Desktop Edition Deployment Manager in Console mode. This can be done by setting the ApplicationToDeploy attribute in the silent.xml file:

<ApplicationToDeploy>WorkspaceSipEndpoint</ApplicationToDeploy>

For more information, refer to 3b. Console: Deploy the Workspace downloadable ClickOnce package on your web server.

The following is an example of a silent.xml file with supported options for Workspace SIP Endpoint: 

<?xml version="1.0" encoding="windows-1250"?>
<configuration>
<ApplicationToDeploy>WorkspaceSipEndpoint</ApplicationToDeploy>
<InformationApplicationName>Workspace SIP Endpoint</InformationApplicationName>
<InformationURL>http://WebServerHost/WorkspaceSipEndpoint</InformationURL>
<InformationPublisher>Genesys Telecommunications Laboratories</InformationPublisher>
<DeploymentDestinationFolder>c:\inetpub\wwwroot\WorkspaceSipEndpoint</DeploymentDestinationFolder>
<SigningSignsWithProvidedCertificate>false</SigningSignsWithProvidedCertificate>
<SigningCertificateFileName></SigningCertificateFileName>
<SigningPassword></SigningPassword>
</configuration>
This page was last edited on February 28, 2019, at 19:34.
Comments or questions about this documentation? Contact us for support!