Deployment Procedure

Genesys Administrator

8.1.30x

Genesys Telecommunications Laboratories, Inc. © 2014–2017

Contents

Introduction

Release Number Date Release Type Added Support
8.1.310.03 12/18/17 General Windows Server 2016
8.1.304.03 05/15/14 General Windows Server 2012

Additional Information


Introduction

This deployment procedure applies to the releases of Genesys Administrator listed in the Release table above, and subsequent releases as appropriate. This procedure describes how to configure Microsoft IIS and its features on the operating system indicated in the table.

Top of Page


Deployment Procedure – 8.1.310.03 [12/18/2017]

This deployment procedure describes how to install Genesys Administrator 8.1.310.03 and subsequent releases on Microsoft Server 2016.

To configure IIS 10 and its features on Windows Server 2016, do the following:

  1. In Server Manager Dashboard, click Add Roles and Features and start the Wizard.

  2. Go through the Wizard steps:

    1. Choose Installation type as Role-based or feature-based installation.
    2. Select the target server from the Server Pool.
    3. Click Server Roles and do the following:

      • Expand the section Web Server (IIS)/Web Server/Application Development, and check that it contains all required .NET 3.5 and .NET 4.x roles. The following are the mandatory roles:
        • .NET Extensibility 3.5
        • .NET Extensibility 4.5
        • ASP.NET 3.5
        • ASP.NET 4.5
        • ISAPI Extensions
        • ISAPI Filters
      • Expand the section Web Server (IIS)/Management Tools and check that it contains the IIS 6 Management Compatibility role.
    4. Click Features and select the features to be installed on the selected server, if they are not already installed:

      • .NET Framework 3.5 Features [.NET Framework 3.5]
      • .NET Framework 4.5 Features [.NET Framework 4.5, ASP.NET 4.5, WCF Services [HTTP Activation, TCP Port Sharing]]
      • Background Intelligent Transfer Service (BITS)
    5. Click Install and complete the Wizard.

  3. In IIS Manager, do the following:

    1. Set the following properties of the Application Pool (by default, DefaultAppPool) to which the Genesys Administrator site belongs:

      • Set .NET CLR Version = .NET CLR Version v4.0.***.
      • Set Managed pipeline mode = Integrated.
    2. In IIS Web Server Feature Delegation, set the following:

      • Handler Mappings = ReadOnly, the default
      • Modules = ReadOnly, the default

      Warning: These settings might initially appear to be set to Read/Write. For security reasons, set them to the default value (ReadOnly).

  4. Modify the Genesys Administrator configuration files. The Genesys Administrator IP contains two configuration files: Web.Config and Web2012.Config. The second file, Web2012.Config, is dedicated to running Genesys Administrator on the Windows 2012 platform. To modify this file to run Genesys Administrator on the Windows 2016 platform, do the following:

    1. Rename the Web.Config file to a different name; for example Web_.Config.
    2. Rename the Web2012.Config file to Web.Config.
    3. In this new Web.Config file, in the section that starts with <system.webserver> and ends with <system.webServer>, remove or comment out all of the content except the first line <validation validateIntegratedModeConfiguration="false"/>.
    4. When done, the active code for that section should look like this:
      <system.webserver>
         <validation validateIntegratedModeConfiguration="false"/>
      <system.webServer>

  5. If a Language Pack is installed, repeat step 4 and then update the culture settings accordingly to the language of the Language Pack. For example, if the Language Pack for German is installed, change the culture settings as follows:

    <globalization culture="de-DE" uiCulture="de-DE"/>

  6. Restart IIS.

Top of Page


Deployment Procedure – 8.1.304.03 [05/15/2014]

This deployment procedure describes how to install Genesys Administrator 8.1.304.03 and subsequent releases on Microsoft Server 2012.

To configure IIS 8 or 8.5 and its features on Windows Server 2012, do the following:

  1. On Windows Server 2012, navigate to Start > Control Panel > Programs > Programs and Features, click Turn Windows features on or off, and start the Add Roles and Features Wizard.

  2. Go through the Wizard steps:

    1. Choose Installation type as Role-based or feature-based installation.
    2. Select the target server from the Server Pool.
    3. Choose the following Roles to be installed on the selected server, if they are not already installed:

      • Application Server [.NET Framework 4.5, Web Server (IIS) Support, Windows Process Activation Service Support (Select HTTP Activation]
      • File and storage Services [File Server]
      • Web Server (IIS) [Web Server [Common HTTP Features, Health and Diagnostics, Performance, Security, Application Development [.NET Extensibility 3.5, .NET Extensibility 4.5, ASP.NET 3.5, ASP.NET 4.5, ISAPI Extensions, ISAPI Filters]], Management Tools [IIS6 Management Compatibility]]

    4. Select the following Features to be installed on the selected server, if they are not already installed:

      • .NET Framework 3.5 Features [.NET Framework 3.5]
      • .NET Framework 4.5 Features [.NET Framework 4.5, ASP.NET 4.5, WCF Services [HTTP Activation, TCP Port Sharing]]
      • Windows Process Activation Service [Process Model, Configuration APIs]

    5. Click Install and complete the Wizard.

  3. In IIS Manager, set the following properties of the Application Pool (by default, DefaultAppPool) to which the Genesys Administrator site belongs:

  4. Modify the Genesys Administrator configuration files. The Genesys Administrator IP contains two configuration files: Web.Config and Web2012.Config. The second file, Web2012.Config, is dedicated to running Genesys Administrator on the Windows 2012 platform. To set up this file, do the following:

    1. Rename the Web.Config file to a different name; for example Web_.Config.
    2. Rename the Web2012.Config file to Web.Config.

    Note: The original Web2012.Config differs from the original Web.Config file as follows:

  5. If a Language Pack is installed, repeat step 4 and then update the culture settings accordingly to the language of the Language Pack. For example, if the Language Pack for German is installed, change the culture settings as follows:

    <globalization culture="de-DE" uiCulture="de-DE"/>

  6. Restart IIS.

Top of Page


Additional Information

Additional information on Genesys Telecommunications Laboratories, Inc. is available on our Customer Care website. The following documentation also contains information about this software. Please consult the Framework 8.5 Genesys Administrator Deployment Guide first.

If you encounter any issues with the deployment of this package, please contact Genesys Customer Care.

Top of Page