Network Deployment (Distributed operating systems), v8.0 > Reference > Sets
CEA settings
Use this page to configure the Representational State Transfer (REST) interface and the computer-telephony integration (CTI) gateway to enable Communications Enabled Applications (CEA). A CTI application manages the event flow that is generated by the telephony switch, IP PBX, during the life cycle of a call.
- To view this admin console page in a single-server environment, click...
Servers > Server Types > WebSphere application servers > server_name
> Communications Enabled Applications (CEA).
- To view this admin console page in a clustered environment, click...
Servers > Clusters > WebSphere application server clusters > server_cluster > Communications Enabled Applications (CEA).
Because servers in a cluster are clones of each other, you only need to make configuration changes from the main cluster panel for the cluster, not for each individual server in the cluster.
The CEA system application uses a SIP session for state replication and therefore relies on replication domains and clustering to provide failover support, similar to any other SIP application. See the topic Replicating SIP sessions for more information.
Enable communications service
Specifies to enable or disable the communications service for this server or cluster. Disabling the field prevents the service from starting and saves system resources.
Context root
Context root of the REST interface. Use this field to assign a different context root to the REST interface.
The context root is combined with the defined servlet mapping for the REST interface to compose the full URL that users type to make a REST request. For example, if the context root is /gettingstarted and the servlet mapping is CommServlet/call, then the URL is http://host:port/gettingstarted/CommServlet/call.
Virtual host
Name of the virtual host to which the REST interface is currently mapped.
Expanding the menu list displays a list of the defined virtual hosts.
To change a mapping, select a different virtual host from the list.
Maximum hold time
Time in seconds in which a GET /event call to the REST interface waits for new or changed data or status before timing out.
Information Value Data Type Integer Default 30
Use SIP CTI (ECMA TR/87) gateway for telephony access
Select this option to use the SIP CTI gateway for telephony access.
Host name or IP address
Address or fully qualified domain name, FQDM, of the CTI gateway to be connected to by the CEA service.
Information Value Data Type string Default localhost
Port
Port of the CTI gateway to be connected to by the CEA service.
Information Value Data Type integer Default 5060
Protocol
Protocol to be used when connecting to the CTI, TR/87, gateway. The default value is TCP.
Extract user name from request
When enabled, an attempt is made to extract the user name from the HTTP request. If the name cannot be extracted, the Superuser name is used. This name is used when opening a new TR/87 session to the CTI gateway.
Attention: After you enable the Extract user name from request option, an attempt is made to extract the user name from the HTTP request. However, the user name has a null value even for authenticated users. The CEA Rest Service Servlet is an unprotected URI. Thus, you also must enable the Use available authentication data when an unprotected URI is accessed option. Use the admin console to enable the Use available authentication data when an unprotected URI is accessed option under Security > Global security > Web and SIP security > General settings. After you enable this option, the user name is available to the CEA Rest Service Servlet during the request.
Superuser name
Name used when opening a new TR/87 session to the configured CTI gateway. This requires that the CTI gateway be configured with a superuser account used to create phone calls on behalf of all end users.
Information Value Data Type string Default ceauser Attention: We can specify a Superuser name on the CEA settings panel. The superuser corresponds to a user, who is configured on the PBX, and has the ability to control any phone that is configured on the PBX. Also, the superuser has the ability to control multiple phones concurrently. This functionality, however, is not supported on every PBX. The Cisco PBX requires that you set a user name for each phone to control. The Superuser name field on the CEA settings panel can only pass a single user name; therefore, it can only control a single device.
To control multiple phones concurrently using the Cisco PBX, derive the user name from the user credentials for this PBX.
To accomplish this task, ensure that the Extract user name from request check box is selected on the CEA settings panel.
Use a third-party Web services provider for telephony access
Select this option to specify a third-party Web services provider for telephony access. Instead of using SIP CTI, this approach uses a third-party service that has implemented specific Web services to utilize a different method to connect to the telephony infrastructure.
Third-party Web services provider's WSDL
The URL path pointing to a third-party Web services provider's WSDL. If a value is specified, the SIP CTI gateway is not used.