Manually Creating and Configuring WFM Application Objects
This topic contains information and procedures that will help you to use Genesys Administrator and other tools to manually create Workforce Management (WFM) Application objects and perform other configurations manually. It contains the following sections:
- Manually Create the Application Objects
- WFM Daemon Setup
- Manually Change Configuration Server Host and Port
Manually Create the Application Objects
If you are familiar with Genesys Administrator, you might choose to create and configure the component Application objects manually, rather than using the wizards. See Creating Application Objects Manually.
WFM Daemon Setup
To successfully run WFM Daemon, you must set the correct SMTP server host and port. Depending on your configuration, you might also need to set the user name and password. For information about how to set these options, see the “SMTP Section” of WFM Daemon Options.
To support automatic report creation, perform these configurations using Genesys Administrator:
- In the WFM Web Application, set the Reports section variable ServerURL. See Installing WFM Web as Report Server.
- In the WFM Web Application, set the Reports section variable PathToAutoGeneratedReports to the network path for storing generated reports. See WFM Web Options.
- In the WFM Daemon Application, add a connection to the WFM Web Application that you installed as the report server in Installing WFM Web as Report Server.
For notifications to work successfully:
- Each agent and supervisor must have the proper e-mail set. As described in the Workforce Management Configuration Utility Help, e-mail addresses are initially defined in Genesys Administrator as part of the Person object. Once e-mail addresses exist in the Configuration Database, you have the option of importing them into the WFM Database.
- The supplied SMTP server must be configured to accept e-mails for those addresses. Before anything can be sent, you must first configure notifications in the WFM Web for Supervisors, Configuration module, as described in Workforce Management Web for Supervisor Help.
- A Supervisor’s ability to receive notifications depends on their security settings (see User Security). Supervisors must be granted rights to receive notifications for each notification type and have access to the agent teams for which they want to receive notifications, as described in Workforce Management Configuration Utility Help.
Manually Change Configuration Server Host and Port
You might need to change the Configuration Server host and port information for the WFM servers after installing WFM.
To update or change this information manually you can use one of two methods:
- Edit the startServer.bat file for each affected server.
- Unregister the servers and then reregister them, by using the updated host, port, and application name information.
The startServer.bat files for each server are located in the same directory as the executable for that server.
Backup Configuration Server Host and Port
WFM Web supports backup Configuration Server during application startup with the addition of two new values in ConfigServer.properties file: BackupHost and BackupPort. These options are specified in the same way as the Host and Port options and have the same meaning, except that they specify how to connect to the backup Configuration Server. If the primary Configuration Server is not available, WFM Web uses this information to connect to the backup Configuration Server.
To configure these options manually, edit the ConfigServer.properties file in the Tomcat directory webapps\wfm\WEB-INF (assuming that WFM Web was deployed as wfm.war, otherwise wfm should be replaced with the specified name). In addition, the application name must be the same on both primary and backup Configuration Server.
For more information about configuring connections to backup Configuration Server, see Connect to Backup Configuration Server.
Click the red arrow to display a list of procedure related to the topics on this page.
Creating Application objects manually
Purpose: To create WFM Application objects manually (not using the Configuration Wizards).
Start of Procedure
- In Genesys Administrator, open the Environment > Applications folder.
- Right-click in the folder and select New Application from the shortcut menu that appears.
- Browse to and select the appropriate application template from those you previously imported. If necessary, see Import the WFM Templates for instructions.
- Enter the appropriate information in each tab of the Application object. The information on most of these tabs is familiar to regular users of Genesys Administrator. Ensure the settings are correct on the Connections tab of each Application object. For the complete set of required connections, see Table: WFM Component Connections.
End of Procedure
- Manually configure the Options tab settings. For a list of options with default settings and descriptions, see WFM Configuration Options.
Editing the startServer.bat files
Purpose: To edit the WFM startServer. bat files.
Start of Procedure
- To edit the WFM startServer. bat file, stop the WFM server.
- Open the startServer.bat file in a text editor, such as WordPad.
- Change the host and port information.
- Save the edited file.
- Restart the server.
End of Procedure|-|
Using Server Registration to change Host and Port
Purpose: To change the host and port for a server.
Summary: You can also change the host and port information for the servers by unregistering them as services and then re-registering them using the new host and port.
Start of Procedure
- Execute the following command from the command line to unregister the installed service:
<server .exe filename> -remove
For example, WFMServer.exe -remove
- Register the service with new host and port information:
<server .exe filename> -install -host “<hostname>” -port “<portnumber>” -app <applicationname>
For example, WFMServer.exe -install -host “Siamese” -port 4000 -app WFMServer_76