Jump to: navigation, search

Installing the Knowledge Center CMS

You need to configure the CMS options that are stored in the "cms.general" section of the Application Cluster object.(See Configuration Options)
If you would like to use several instances of the CMS, you need to configure the CMS Cluster. (See Configuring CMS Cluster)

Install the CMS

Import the CMS Application Template


  1. Open Genesys Administrator and navigate to Provisioning > Environment > Application Templates.
  2. In the Tasks panel, click Upload Template.
  3. In the Click 'Add' and choose application template (APD) file to import window, click Add.
  4. Browse to the Knowledge_Center_CMS_852.apd file available in the templates directory of your installation CD. The New Application Template panel opens.
The Knowledge Center CMS Application Template
  1. Click Save and Close.


Create CMS Applications


  1. Open Genesys Administrator and navigate to Provisioning > Environment > Applications.
  2. In the Tasks panel, click Create New Application.
  3. In the Select Application Template panel, click Browse for Template and select the Genesys Knowledge Center Server application template that you imported earlier. Click OK.
Selecting the Knowledge Center CMS Template
  1. The template is added to the Select Application Template panel. Click Next.
  2. In the Select Metadata file panel, click Browse and select the Knowledge_Center_CMS_852.xml file. Click Open.
  3. The metadata file is added to the Select Metadata file panel. Click Next.
  4. In Specify the appropriate application parameters:
    1. Enter a name for your application. For instance, Knowledge Center CMS.
    2. Enable the State.
    3. Select the Host on which the CMS will reside.
    4. Click Create.
    5. Creating the Knowledge Center CMS Application
  1. The Results panel opens.
  2. Enable Opens the Application details form after clicking 'Finish' and click Finish. The Knowledge Center CMS application form opens and you can start configuring the CMS application.
  3. Configuring the Knowledge Center CMS


Configure the CMS Application


  1. If your Knowledge Center CMS application form is not open in Genesys Administrator, navigate to Provisioning > Environment > Applications. Select the application defined for the Knowledge Center CMS and click Edit....
  2. In the Connections section of the Configuration tab, click Add. The Browse for applications panel opens.
  3. Select the Knowledge Center Cluster application, then click OK.
  4. Expand the Server Info pane.
  5. If your Host is not defined, click the lookup icon to browse to the hostname of your application.
  6. In the Listening Ports section, create the default port by clicking Add. The Port Info dialog opens.
    1. Enter the Port. For instance, 9000.
    2. Click OK. The port with the default identifier appears in the list of Listening ports.
Knowledge Center CMS Port Information
  1. Optionally, you can add a secure listening port for authenticated users, secured connections. Click Add. The Port Info dialog opens.
    1. Enter https for the ID field.
    2. Enter the port . For instance, 9553.
    3. Enter https for the Connection Protocol.
    4. Choose Secured for the Listening Mode.
    5. Click OK.
    GKS CMS https port

    1. Ensure the Working Directory and Command Line fields contain "." (period).
    2. Knowledge Center CMS Information
    3. In the Tenants section, add a working tenant by clicking Add. Browse and choose the appropriate tenant in the pop-up dialog. Click OK.
      • Cluster can only work under a single tenant and Application Cluster and GKC server/CMS should be in the Tenant
    4. Uncheck Log On As SYSTEM.
    5. In Log On Account specify the user account that:
  • has the ability to view access groups (this is required if you use access groups to set privileges for your agents)
  • has Knowledge.ADMINISTER privileges and has "Change" permissions for Cluster Application (for example belongs to a Administrators access group, required for exporting configuration definitions)
  • has Knowledge.AUTHOR privilege (required for scheduled synchronization)
  • User should be from the same tenant in which the CMS is configured
  • User should belong to Administrator access group in Environment tenant or be granted "Read and Execute (RX)" and "Read Permissions (E)" permissions for Environment tenant, if the application configured not in the Environment tenant (required for scheduled sycnhronization)
  • On Options tab in section cms.general set valid URL to CMS or CMS cluster load balancer in externalURL option.
  • Click Save.
  • The Confirmation dialog for changing the application's port opens. Click Yes.
  • End

    Installing the CMS

    Windows Installation Procedure


    1. In your installation package, locate and double-click the setup.exe file. The Install Shield opens the welcome screen.
    Knowledge Center CMS installation Window
    1. Click Next. The Connection Parameters to the Configuration Server screen appears.
    2. Knowledge Center CMS Connection Parameters
    3. Under Host, specify the host name and port number where Configuration Server is running. (This is the main listening port entered in the Server Info tab for Configuration Server.)
    4. Under User, enter the user name and password for logging in to Configuration Server.
    5. Click Next. The Select Application screen appears.
    6. Select the Knowledge Center CMS that 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. Selecting the Knowledge Center CMS Application
    8. Click Next. The Choose Destination Location screen appears.
    9. Under Destination Folder, keep the default value or browse for the desired installation location.
    10. Choosing the Knowledge Center CMS Installation Destination
    11. Click Next. Choose the appropriate version of the Java JDK.
    12. Selecting the Knowledge Center CMS Java Version
    13. Click Next. The Ready to Install screen appears.
    14. Knowledge Center Knowledge Center is Ready to Install
    15. Click Install. The Genesys Installation Wizard indicates it is performing the requested operation for the Genesys Knowledge Center CMS. When through, the Installation Complete screen appears.
    16. Click Finish to complete your installation.
    17. Inspect the directory tree of your system to make sure that the files have been installed in the location that you intended.
    18. Important
      The Windows service will not be automatically configured during installation of the CMS. To configure the Windows service, start server.bat with the following parameters: server.bat install. To run the server as service, comment out the (REM) APP_TYPE property in senenv.bat before installing the service.


      Linux Installation Procedure


      1. Open a terminal in the CMS installation package, and run the install.sh file. The Genesys installation starts.
      2. Enter the hostname of the host on which you are going to install.
      3. Enter the connection information required to log in to the Configuration Server:
        1. Hostname—For instance, demosrv.genesyslab.com
        2. Listening port—For instance, 2020
        3. User name—For instance, demo
        4. Password
      4. If you have a backup Configuration Server, enter the Host name and Port.
      5. If the connection settings are successful, a list of keys and Knowledge Center CMS applications is displayed.
      6. Enter the key for the Knowledge Center CMS application that you created previously in Configuration Server.
      7. Enter the full path to your installation directory and confirm that it is correct.
      8. If the installation is successful, the console displays the following message:
        Installation of Genesys Knowledge CMS, version 8.5.x has completed successfully.


      Configuring the CMS

      The Knowledge Center Server includes an embedded Jetty server. After installation, you can carry out your initial configuration by creating a work directory for temporary Jetty files inside the ./server folder.

      Configure Required CMS Access Options

      Genesys Knowledge Center supports the following privileges to restrict agent access:

    • Knowledge.CMS.Document.Author—create, edit, or delete documents
    • Knowledge.CMS.Category.Author—create, edit, or delete categories
    • Knowledge.CMS.Approver—approve documents and categories, and export data
    • Knowledge.CMS.Administrator—create, edit, or delete knowledge bases
    Only agents who have both Knowledge.CMS.Document.Author and Knowledge.CMS.Category.Author privileges can successfully import data from XML files.

    To configure the appropriate privileges for an agent:


    1. Go to Provisioning > Accounts > Roles.
    2. In the taskbar, click New to create a new object.
    3. Set the name of the role in the General section.
    Knowledge Center CMS Access Roles
    1. Go to the Role Privileges tab and select the set of roles for Genesys Knowledge Center.
    2. Open the Genesys Knowledge Center CMS privileges list.
    3. Set the appropriate privileges to Allowed.
    4. Setting Knowledge Center CMS Access Privileges
    5. Go back to the Configuration tab.
    6. In the Members Section, add the appropriate Agent by clicking the Add button.
    7. Knowledge Center CMS Members Section
    8. Save and Close.


    This page was last edited on March 11, 2016, at 23:04.


    Comment on this article:

    blog comments powered by Disqus