Jump to: navigation, search

Install Genesys Co-browse Server

Important
  • Starting in 8.5.0, Embedded Cassandra mode is deprecated in Genesys Co-browse; support for this mode will be discontinued in a later release of 9.0.x.
  • Genesys strongly recommends no more than one Cassandra instance on the same machine due to performance. If you intend to use a Cassandra instance embedded into Co-browse Server, you should not have a CASSANDRA_HOME environment variable to avoid conflict between embedded and external CASSANDRA_HOME variables.

Creating the Co-browse Server Application Object in Genesys Administrator

Overview

Co-browse 8.5.001+ introduced a new cluster configuration, which includes cluster and node Application objects. In the steps below, you create multiple Co-browse Server Application nodes, each with unique configuration, and unite them under a common configuration in the Cluster Application object:


Importing the Application Templates

To support this new configuration, you must first import two application templates, one for the node and one for the cluster.

Start

  1. Open Genesys Administrator and navigate to PROVISIONING > Environment > Application Templates.
  2. In the Create menu of the Tasks panel, click the Upload Template link.
    Upload Template link in the Tasks panel
  3. When the dialog box appears, Click Add to choose the application template (APD) file to import.
  4. Choose the Co-browse_Cluster_900.apd file in the templates directory of your installation CD. The New Application Template panel opens.
  5. Click Save & Close.
  6. Complete the same import steps for the Node Application Template by importing the Co-browse_Node_900.apd file in the templates directory of your installation CD.

End

Creating the Co-browse Cluster Application

Prerequisites

Start

  1. Open Genesys Administrator and navigate to PROVISIONING > Environment > Applications.
  2. In the Create menu of the Tasks panel, click the Create New Application link.
    Create New Application link.

  3. In the Select Application Template panel, click Browse for Template and select the Co-browse Cluster template you previously imported. Click OK.
  4. The template appears in the Select Application Template panel. Click Next.
  5. In the Select Metadata File panel, click Browse and select the Co-browse_Cluster_900.xml file. Click Open.
  6. The metadata file appears in the Select Metadata File panel. Click Next.
  7. In Specify Application parameters:
    • Enter a name for your application—for example, Co-browse_Cluster.
    • Enable the State.
    • Select the host of the Co-browse Server. Co-browse does not actually use this value for the Cluster Application, so you can specify any host.
    • Click Create.
  8. The Results panel opens. Enable Open the Application details form after clicking Finish and click Finish. The Co-browse Cluster Application form opens to the Configuration tab.
  9. If you use an external Cassandra cluster, add connections to the external Cassandra Resource Access Points (RAPs). For each RAP connection, set the ID to default.
  10. Create any necessary connections to other Genesys servers. For example:
    • Primary Configuration Server
    • Primary Message Server
    • Chat Server(s) or Chat Application Cluster
  11. Important
    The connection to Chat Server needs to be done through the webapi port.
  12. In the Server Info section, add the Default Listening Port. Co-browse does not use this value for the Cluster Application, so you can specify any port.
  13. Make sure the Working Directory and Command Line fields are set to . (period).
  14. In the Options tab, set the following configuration options:
    Important
    Application Node configuration has priority over Application Cluster Configuration. If you configure an option in both the Application Node and Application Cluster objects with different values, Co-browse uses the Application Node value.
    • In the cassandraEmbedded section: If you use an external Cassandra cluster, set enabled to false. Genesys recommends using an external Cassandra cluster. Support for embedded Cassandra will be discontinued in a later release of 9.0.x.
    • In the cassandraKeyspace section: Set replicationStrategyParams using the following format:
      '<Data Center name>':<Co-browse Nodes amount>
      

      For example: 'OperationalDC':3

    • In the cluster section: Set the url option to the HTTP(S) Co-browse load balancer. For example:
      https://<LB_host>:<LB_port>/cobrowse
      
      Important
      The url option is mandatory and you must configure this option to properly set up a Co-browse Server cluster. Be careful not to confuse the url option with the serverUrl option which is not mandatory.
  15. Set additional options according to your needs. See Configuration Options for details.
  16. Click Save & Close. The Confirm dialog displays the following message:

    The host and/or port(s) of the application will be changed. Do you want to continue?

    Click Yes.

End

Creating the Co-browse Node Application

Prerequisites


Complete the following steps for each Co-browse Node Application in your cluster.

Important
If your Cassandra cluster is built from Cassandra nodes that are embedded in your Co-browse nodes, the minimum number of Co-browse nodes is three. If you use an external Cassandra cluster, the minimum number of Co-browse nodes is two.

Start

  1. Open Genesys Administrator and navigate to PROVISIONING > Environment > Hosts.
  2. Click New... and create the Host object where the Co-browse Node will run.
  3. Navigate to PROVISIONING > Environment > Applications.

    In the Create menu of the Tasks panel, click Create New Application.
    Create New Application link.

  4. In the Select Application Template panel, click Browse for Template and select the Co-browse Node template you previously imported. Click OK.
  5. The template appears in the Select Application Template panel. Click Next.
  6. In the Select Metadata file panel, click Browse and select the Co-browse_Node_900.xml file. Click Open.
  7. The metadata file appears in the Select Metadata File panel. Click Next.
  8. In Specify Application Parameters:
    • Enter a name for your application—for instance, Co-browse_Node.
    • Enable the State.
    • Select the Host you created in Step 2. This is the host where the Co-browse Server will reside.
    • Click Create.
  9. The Results panel opens
    Enable Open the Application details form after clicking 'Finish' and click Finish. The Co-browse Node Application form opens to the Configuration tab.
  10. Create a connection to the Co-browse Cluster Application you previously created and set the ID to default.
  11. In the Server Info section, add the Default Listening Port. Set Connection Protocol to http and Listening Mode to unsecured.
  12. If you intend to use https, add the https port. Set Connection Protocol to https and Listening Mode to secured.
  13. Make sure the Working Directory and Command Line fields are set to . (period). Co-browse automatically populates these fields during installation.
  14. In the Options tab, set the following configuration options:
    Important
    Application Node configuration has priority over Application Cluster Configuration. If you configure an option in both the Application Node and Application Cluster objects with different values, Co-browse uses the Application Node value.
    • In the cassandraEmbedded section: If you use an external Cassandra cluster, leave all values at their defaults. Otherwise, specify the necessary values for your configuration.
  15. Set any other options according to your needs. See Configuration Options for details.
  16. Click Save & Close. The Confirm dialog displays the following message:
    The host and/or port(s) of the application will be changed. Do you want to continue?
    Click Yes.

End

Next Steps

Installing the Co-browse Server

With basic Configuration Server details in place, you can now complete the installation process.

Important
Genesys does not recommend installation of its components using a Microsoft Remote Desktop connection. You should perform the installation locally.

Prerequisites: You completed Creating the Co-browse Server Application Object in Genesys Administrator.

Start

  1. In your installation package, locate and run the setup application for your platform as specified below:
    • Linux: install.sh
    • Windows: setup.exe
    The Install Shield opens to a welcome screen.
  2. Click Next. The Connection Parameters to the Configuration Server screen appears.
  3. Under Host, specify the host name and port number of your Configuration Server. This value should be the same as the main listening port in the Server Info tab of your Configuration Server.
  4. Under User, enter the user name and password to log in to Configuration Server.
  5. Click Next. The Select Application screen appears.
  6. Select the Co-browse Server Application you are installing. The Application Properties area shows the Type, Host, Working Directory, Command Line executable, and Command Line Arguments information previously entered in the Server Info and Start Info tabs of the selected Application object.
  7. Click Next. The Choose Destination Location screen appears.
  8. Under Destination Folder, keep the default value or click browse to set the installation location.
  1. Click Next. The Backup Configuration Server Parameters screen appears.
  2. Under Host, specify the host name and the port number where the Backup Configuration Server is running.
  3. Click Next. The Ready to Install screen appears.
  4. Click Install. When The Genesys Installation Wizard finishes installing Co-browse Server, the Installation Complete screen appears.
  5. Click Finish to complete your installation of Co-browse Server.

End

Next Steps

Configuring the Co-browse Server

Complete the steps below to configure the Co-browse Server application in Genesys Administrator. This procedure only covers a few of the mandatory options. Most options can be left at their default values.

Prerequisites: Creating the Co-browse Server Application Object in Genesys Administrator.

Start

  1. Open Genesys Administrator and navigate to PROVISIONING > Environment > Applications.
  2. Select the Co-browse Cluster Application you previously created.
  3. In the Options tab, locate the session section and update the following options:
    • domRetrictionsURL—a URL that points to the XML file that contains DOM restrictions. By default, all Submit buttons are disabled for the agent. For information about customizing this XML file, see DOM Restrictions
  4. Configure the options allowedOrigins in the cross-origin section, and allowedExternalDomains in the http-proxy section. You must configure these options in order to control which websites can access your Co-browse server and which external resources Co-browse server may proxy.
  5. If you deploy Co-browse Server to an environment where the Internet is accessed using a forward proxy (for example, DMZ or local intranet), configure the options in the forward-proxy section.
  6. Save & Close</b> your Co-browse Cluster Application and open the Co-browse Node Application that you previously created.
  7. Configure the options in the log section. These options are standard Genesys log options. For details, refer to the Management Framework 8.5 Configuration Options Reference Manual
  8. If you use Genesys Workspace Web Edition, configure the serverUrl option in the cluster secion.
  9. Click Save & Close.

End

Next Steps

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on 2 March 2018, at 10:55.