Preparing to Install WFM

To prepare Workforce Management (WFM) for installation, read through the topics on this page and complete the procedures as required.

WFM 8.1 works in conjunction with a number of software components. Before installing WFM, set up Genesys Framework. The installation should include at least the following components:

• Configuration Manager
• Configuration Server
• DB Server
• T-Server
• Stat Server

Important

WFM 8.1 is compatible with Genesys Framework 7.x and 6.5. However, for full interoperability with WFM 8.1, the Genesys components must be release 7.0 or later. Using WFM 8.1 with earlier releases of these components limits use of the Configuration Wizards, Management Layer support, and Reason Code support. For example, the WFM Daemon wizard will work only with Genesys Framework 7.6 or greater, because it uses new the WFM Daemon application type, which was introduced in Configuration Manager 7.6.

Software Requirements

For complete and up-to-date information on software requirements, review the Genesys Supported Operating Environment Reference Guide, which is located on the Technical Support web site. You will need a Genesys-supplied login and password to access certain documents there.

Back to Top

Management Layer System Requirements

The Management Layer of Genesys Framework enables administrators to start, stop, and monitor the status of entire solutions from a centralized location. To use Management Layer, you must also have the following Genesys Framework components installed:

• DB Server
• Configuration Server
• Message Server
• Log Database
• Solution Control Server (SCS)
• Solution Control Interface (SCI)
• Local Control Agents (LCA)

For more information on installing any of these components, see the documentation for Genesys Framework.

To use Management Layer, you must install LCA on the servers running WFM Builder, WFM Server, WFM Data Aggregator, and WFM Daemon.

Register the Server Host Computers

You must register each host computer that runs one or more of the servers. See the Procedure: Registering a host computer.

Create Your WFM Database

If you are updating from WFM 7.x to WFM 8.1, you do not need to create a new database. Simply update your current database as described in Managing WFM Database Utility.

If you are installing WFM for the first time or migrating from version 6.x, you must create a new database.

Important

If you are migrating from WFM 6.x, see the “Workforce Management Migration Procedures” chapter in the Genesys Migration Guide to find information about how to transfer your data from your current database to the new one.

Ensure your database meets the following criteria:

• Is of an appropriate size.
• Allows room for expansion.
• Is configured to be case insensitive.

Back to Top

Database Access Privileges

The user who accesses the database must have the specific privileges, depending on the platform being used.

If the platform is MS SQL:

• database-owner (DBO)

If the platform is Oracle:

• GRANT CREATE SESSION TO <user name>
• GRANT CREATE TABLE TO <user name>
• RANT CREATE VIEW TO <user name>
• GRANT CREATE PROCEDURE TO <user name>
• GRANT CREATE SEQUENCE TO <user name>
• GRANT CREATE TRIGGER TO <user name>
• GRANT CREATE TYPE TO <user name>
• GRANT UNLIMITED TABLESPACE TO <user name>

Important

The privileges listed above must be assigned to Oracle database owners to ensure WFM Applications are fully functional when the WFM database runs on an Oracle platform.

If the platform is DB2:

• Connect to database
• Create tables
• Create packages
• Register routines to execute in database manager's process
• Database administrator authority
• Create schemas implicitly
• Access to the load utility
• Create external routines
• Connect to quiesced database

Important

A DB2 database requires specific configuration, which is described in the section New Database Configuration.

For an Oracle database, the database server name that the client application uses to access the database is actually an alias. If you use different database aliases on the various client computers, you cannot use the same Database Access Point (DAP) for data from each client.

The procedure required to create your WFM Database varies, depending upon which database type you are using. A qualified database administrator should perform this procedure.

In order for the Configuration Utility to work properly, you must set Microsoft SQL and Oracle database management systems to be case-insensitive.

Back to Top

Create a Database Access Point

Many of the WFM Application objects require a connection to a Database Access Point (DAP), which specifies the name and location of the WFM Database. To create a DAP, see Procedure: Creating a Database Access Point.

Requirements for 8.1x Installations Using an Oracle Database

Before you install an Oracle Database, ensure you are using:

• The latest Oracle Client 11 with Oracle NET and Oracle Provider for OLE DB.
• The 64-bit Oracle Client with 64-bit WFM servers.
• The 32-bit Oracle Client on the WFM Database Utility and/or WFM Configuration Utility host computers (which are 32-bit

applications).

Important

• Do not install 64-bit WFM Data Aggregator and WFM Server on the same machine as 32-bit WFM Database Utility, because they require different Oracle Clients.
• Regardless of the version of Oracle Database Server used, Genesys recommends that you use Oracle Client version 11.2 or later on all WFM hosts.
• To install all required components, use the Oracle Client or Oracle ODAC installation packages.

Import the WFM Templates

Import the Application and Solution templates. The WFM component applications use the Application template and the WFM Configuration Wizards use the Solution template. See Procedure: Importing the Application Templates and Procedure: Importing the Solution Template.

Back to Top

Procedures

Purpose: To enable the computer to run one or more servers required by WFM.

Prerequisites: The computer that is being registered is on the same network as the computer you are using to register it.

Start of Procedure

1. Identify the host computer’s assigned name on the network.
2. Open Configuration Manager and select Environment > Hosts.
3. Right-click Hosts and from the shortcut menu, select New > Host.
4. In the dialog box that opens, enter the host name of a computer on which you are installing a WFM server.
   Important

   Host names must be lowercase. They are case sensitive.
5. Enter the host computer’s operating system, version, and its IP address.
6. Accept the default port number, and ensure the State Enabled check box is selected.
7. Click Apply.
   Repeat the process for all computers that are to run a WFM server.

End of Procedure

Purpose: To enable the Configuration Utility, the Database Utility, and WFM Server to specify the DAP on their Application object Connections tab.

Prerequisites: You know the name of your new WFM Database, its location, its type, and the login name and password for a user with DBO privileges.

Start of Procedure

1. In Configuration Manager, open Environment and then right-click Applications.
2. From the shortcut menu that appears, select New Application.
3. From the Templates list, choose your DAP Application template and then click OK.
4. On the General tab, enter a unique DAP name.
   Important

   You do not need to select a DB Server. WFM does not use DB Server to access its database.
5. On the Server Info tab, enter any valid host name and port number.
   WFM does not use them, but you cannot save the DAP Application object unless these fields are filled in.
6. Enter the appropriate information on the remaining Application object tabs.
   If you need help with this step, see “Configuring Database Access Points” in the Framework DB Server User's Guide.
7. To save the new Application object, click OK.

End of Procedure

Purpose: To install the Oracle Client with Oracle NET.

Start of Procedure

1. Uninstall all Oracle Client software that is currently installed. Use the Oracle Deinstall Tool and steps described in the Oracle® Database Client Quick Installation Guide. See the topic, "Removing Oracle Database Client Software".
2. Download latest Oracle Client 11g complete installation package with appropriate bit version: Oracle ODAC 11g 32-bit or Oracle ODAC 11g 64-bit.
3. During Oracle Client installation, use any type of installation.
   Important

   Recommended types are Administrator or Runtime installation types which will install all required components. The installation type Instant Client will need an additional Oracle Provider for OLE DB installation, found in Oracle ODAC. The installation type Custom will require you to manually select the Oracle NET and Oracle Provider for OLE DB.
4. Connect Oracle Database Client to an Oracle Database, as described in the Oracle® Database Client Quick Installation Guide. See the topic, "Oracle Database Client Post installation Tasks".

End of Procedure

Purpose: To install Oracle ODAC with Oracle Provider.

Start of Procedure

1. Uninstall all Oracle Client software that is currently installed. Use the Oracle Deinstall Tool and steps described in: Oracle® Database Client Quick Installation Guide. See the topic, "Removing Oracle Database Client Software".
2. Download latest Oracle Client 11g complete installation package with appropriate bit version: Oracle ODAC 11g 32-bit or Oracle ODAC 11g 64-bit.
3. During the Oracle ODAC installation, select Oracle Provider for OLE DB and Oracle Instant Client components.
4. Connect Oracle Database Client to an Oracle Database, as described in the Oracle® Database Client Quick Installation Guide. See the topic, "Oracle Database Client Post installation Tasks".

End of Procedure

Purpose: To enable WFM installation, which requires the current Application templates.

Start of Procedure

1. In Configuration Manager, select Environment > Application Templates.
2. Right-click Application Templates and from the shortcut menu, select Import Application Template.
   A dialog box opens that enables you to browse to the Application templates on your Workforce Management installation disk.
3. Select a one of the following templates and then, click Open:
   • WFM_Builder.apd
   • WFM_Client.apd (used for both Database and Configuration Utilities)
   • WFM_Data_Aggregator.apd
   • WFM_Daemon_Genesys_Server.apd
   • WFM_Server.apd
   • WFM_Web.apd
   Important

   Beginning with release 7.6, these template names no longer contain a version number.
4. If you want to, enter a name for the template in the Name text box on the General tab.
   Important

   Do not make any other changes to the template. When you create Application objects using the imported templates, you configure them as explained in the following sections.
5. To save the template, click OK.
6. Repeat Steps 1–5 to import all of the Application templates.

End of Procedure

Next Steps: Configure the new Application objects, based on the imported Application templates, as described in the various sections in Installing Workforce Management.

Purpose: To enable the WFM Configuration Wizards, which requires the current Solution template.

Start of Procedure

1. In Configuration Manager, select Environment > Solutions.
2. Right-click Solutions and from the shortcut menu, select Import Solution Template.
   A dialog box opens that enables you to browse to the Solution template on your Workforce Management installation disk.
3. Select the WFM_Solution_3rd_Party.sd template and then, click Open.
   
4. Enter a name for the template in the Name text box on the General tab, if desired.
   Important

   Do not make any other changes to the template. When you run the WFM Configuration Wizard, it configures the solution for you.
5. To save the template, click OK.

End of Procedure

Next Steps: Procedure: Installing WFM Configuration Wizards Optional for Phase 1.

Back to Top