Workflow Post Installation
Contents
Post-installation configuration tasks include:
Tomcat
This step is necessary for both voice and routing applications. For Tomcat settings:
- Select Window > Preferences, then expand Composer and select Tomcat.
- Provide the same port number that you specified during installation. The default user name and password for the bundled Tomcat is admin.
- To start Tomcat, click the button on the main menu. If necessary, see Tomcat Service Failed to Start.
If you already have Java Composer Projects in the workspace and did not perform the Tomcat configuration earlier, perform the following steps to deploy the project on Tomcat:
- From the Project Explorer, right-click on the Java Composer Project and select Properties.
- Select Tomcat Deployment and click the Deploy button.
Note: This also needs to be done if a Java Composer Project is imported or renamed as well.
Configuration_Server
Routing applications may be developed either:
- With a connection to Configuration Server
- Or in an "offline" mode, without connecting to Configuration Server
Whether or not to connect depends on what you wish to do. For example, you would need to connect to Configuration Server in order to access configuration objects through the Target block. You can connect to Configuration Server now or wait until strategy design time. To bring up the Connect Configuration Server dialog box:
- From the main menu, select Configuration Server > Connect. Or use the keyboard shortcut: Alt+I+C. (To disconnect, keyboardshortcut is: Alt+I+D).
- Enter Username, Password, Application, Host, and Port information for the Configuration Server used in your environment.
- Select Use Secure connection for Transport Layer Security (TLS) when connecting to Configuration Server.
- Click Next:
- If authentication with the supplied User Name and Password is unsuccessful, Composer displays informational text in a Configuration Server Connection Error dialog box.
- If a secure connection cannot be made, or if Transport Layer Security is not configured, a Configuration Server Connection Error dialog box appears.
In both of the above scenarios, click the Details button for more information.
- Select the Tenant. For a single-tenant environment, select Resources.
- Click Finish. Composer can now access Configuration Server data during validation (if configured to do so) and other operations.
Notes:
- You can configure an inactivity timeout for the connection to Configuration Server as well as the time for the timeout warning dialog. For information on these features, see the Genesys 8.1 Security Deployment Guide.
- For making live calls, you must manually configure the Routing Point in the Configuration Database as described in the chapter on creating SCXML-based strategies in the Universal Routing 8.1 Deployment Guide. You must also configure other Universal Routing Server options as described in that guide.
- Routing applications are not stored in Configuration Server as in 7.x and earlier. They are stored in the Workspace that you specify.
MIME_Types
MIME (Multipurpose Internet Mail Extensions) refers to a common method for transmitting non-text files via Internet e-mail. By default the SCXML MIME type is already configured in the Tomcat server bundled with Composer. If you are using the Internet Information Services (IIS) Application Server to deploy SCXML strategies, add the following MIME type extensions through the IIS Manager of your webserver:
.json | text/json |
.scxml | text/plain |
.xml | text/xml |
Predefined_Statistics
There is an option to control whether or not to create Universal Routing Server predefined statistics. You will want to do this if you plan to route based on the value of a statistic (for example, statistic StatTimeInReadyState).
- Select Window > Preferences.
- Expand Composer > Configuration Server.
- Check the box: Create router predefined statistics when connecting to Configuration Server.
Orchestration
In addition to specifying the HTTP request parameters, both Universal Routing Server (URS) and Orchestration Server (ORS) must be properly configured outside of Composer using Configuration Manager or Genesys Administrator. In addition to specifying HTTP request parameters, the URS configuration option strategy must be set to ORS. This ensures that URS is prepared to process interactions according to requests received from ORS. For more information, including information on additional options that must be set, consult the following: Composer 8.1 Deployment Guide, Post-Installation Configuration chapter. Universal Routing 8.1 Deployment Guide, Orchestration Support chapter. Orchestration Server 8.1 Deployment Guide, SCXML Strategy Support and Configuring Orchestration Server chapters. Important! if you have both Composer and IRD set up in the same environment, check in Interaction Routing Designer's Loading View that you have not loaded an IRD 7.x routing strategy on the same Route Point DN where the built-in strategy is loaded. This will create a conflict and cause your SCXML application not to launch.
Stream_Manager
Perform these steps in Configuration Manager or Genesys Administrator if using Stream Manager to play treatments via the Composer treatment blocks (such as PlaySound). After installing Stream Manager as described in the Framework 7.6 Stream Manager Deployment Guide:
- Set up a SIP Switching Office and a SIP Switch.
- Set up a SIP T-Server with an association to the SIP Switch.
- For your SIP T-Server, ensure that the sip-port option under the TServer section is unique in your environment.
- Make sure there is a connection between your SIP T-Server and Stream Manager.
- For Stream Manager options, in the contact section, make sure the SIP port is unique in your environment.
- On your SIP Switch, create a DN of type Voice over IP Service to enable Stream Manager to properly play the treatments. For information on Stream Manager and the Voice over IP Server type DN, refer to the Voice Platform Solution 8.1 Integration Guide.
- In the Annex tab of this DN, add a section called TServer with the following options:
- Name: contact, Value: :<IP Address of Stream Manager>:<SIP Port of Stream Manager>
- Name: service-type, Value: treatment
Optional
- You may also need a DN of type Trunk for your SIP softphone. In the Annex tab, add a section called TServer.
- Name: contact, Value:<IP address of where SIP softphone is running>
Defining Preferences
You can configure Preferences for SCXML-based routing applications now or later.
ORS_Debugger
You can configure Preferences for the ORS Debugger now or later. To set ORS Debugger preferences:
- Select Window > Preferences, then expand Composer and select Debugging.
- Specify the following settings:
- Network Interface. Composer debugging uses this setting to make the socket connection for the Debugger control channel. Select the interface that is applicable to your scenario. The debugging server (GVP or ORS) must be able to access the Tomcat server, bundled as part of Composer, for fetching the Voice or Routing application pages. If you have multiple NIC cards of multiple networks (such as Wireless and LAN) select the interface on which GVP or ORS will communicate to your desktop. In case you are connected over VPN, select the VPN interface (such as PPP if connected via a Windows VPN connection).
- Client Port Range. Enter a port range to be used for connection to ORS for SCXML debugging sessions.
- Expand Debugging, select ORS Debugger, and specify the fields below. You can change this information when creating a launch configuration.
- ORS Server Host Name. Enter the IP address for the ORS Server.
- ORS Server Port. Enter the debugger port for the ORS Server.This is defined in the ORS configuration as [scxml]:debug-port, and defaults to 7999. ORS must have debug-enabled set to true.
Note: New launch configurations are pre-populated with the above host name and port information, which can be changed.
- Use Secure Connections. Check to enable secure communications (SSL/TLS) between the Composer client and ORS, for SCXML debugging sessions. The connection between Composer and ORS is mutually-authenticated TLS if implemented on the ORS side. Note: As of the Composer 8.1.1 release date, this feature is not yet implemented on the ORS side.