Configure the Application Server

Use the Server Manager to configure the 3-tier Cherwell Application Server connection so that connections can be maintained between the CSM Applications and the Database.

TCP connections are a legacy configuration and are only available for systems upgraded from a version earlier than CSM 9.5.0. For new installations of CSM 9.5.0 and later, only HTTP connections are supported.

To configure the 3-tier Application Server connection:

  1. Select Start > All Programs > Cherwell Service Management > Tools > Server Manager.
  2. Select Application Server from the Server field drop-down.
  3. Select the Configure button.
  4. Select the Ellipses button to select the connection the server should use to connect to the CSM database.
  5. Select a connection or select Add to configure a new connection.
  6. Select OK.
  7. Select a Server communication method:
    1. Communicate via HTTP: The Communicate via HTTP radio button is selected by default and uses HyperText Transfer Protocol (HTTP) to communicate with the Application Server. It is recommended to use HTTP as the Server communication method.
    2. Communicate via TCP: Select this radio button to use Transmission Control Protocol (TCP) to communicate with the Application Server.
  8. Set a Use Port value based on the selected communication method:
    1. Communicate via HTTP: Select the default Use Port value of 80.
    2. Communicate via TCP: Select the default Use Port value of 8001.

      Use Port values are configurable based on unassigned ports as well as selected Encryption settings. Provide a custom Use Port value if desired.

  9. (Optional): Edit the Server Name. The Server Name field is disabled by default on newer CSM instances.
  10. (Optional): Select Encrypted from the Security Mode drop-down to sign and encrypt communications using the specified server certificate. The encryption is at the transport level using SSL/TLS. By default, the communications between the Client applications and the Application Server are not encrypted or signed.
  11. (Optional): Select the Encryption Server Certificate.
  12. (Optional): Select a Certificate Authentication option to determine how the Server Certificate should be authenticated.
  13. Select the Advanced tab to view default settings.

    Do not change the Advanced Server Configuration settings without consulting Cherwell Support.

  14. Select OK.

Application Server Reference

Application Server Advanced Settings Tab Reference:

Item Description
Maximum TCP Connections Maximum number of client connections the server keeps pooled.

A client might maintain a connection that is not actively being used for a service request.

Maximum Concurrent Calls Maximum number of service requests the server handles concurrently. Service requests above this amount fail.
Maximum Concurrent Instances Maximum number of concurrent service instances. This value is used for testing purposes.
Maximum Concurrent Sessions Maximum number of concurrent sessions allowed to the server.

A client may have more than one session at a time. Trying to create sessions above this amount result in an error.

Allowed Connection Backlog Number of connections above the maximum that can be backlogged before the server returns an error.
Maximum Buffer Pool Size Maximum memory, in bytes, the server uses for buffering messages. Decreasing this amount can reduce the memory usage of the server but could cause a performance degradation on each service call.
Maximum Message Size Maximum size of a message, in bytes, the server or client consumes. Messages over this size are not be processed and result in an error.

The message header is included in this size.

Maximum Message Depth Maximum depth the client or server accepts when parsing an XML message. Depth refers to the nesting of XML elements in a message.
Maximum Message Table Count The message table contains the unique names of all elements and attributes in a message as it is consumed on the client or server. If this value is exceeded, an error message is generated. Reports with large datasets could require this setting to be increased.
Maximum Content Length Maximum number of characters allowed in XML element content.
Maximum Array Length Maximum allowed size of a message being received by the client or server.
Enable Message Compression When selected, compresses message traffic between the client and application server.
Enable Service Performance Counters When selected, allows the entire service behavior to be measured, which can then be used to diagnose performance. These can be found under the performance object when viewing with Performance Monitor (Perfmon.exe).
Enable Rest for HTTP When selected, the Application Server communicates with REST and gzip rather than SOAP and Cherwell compression. Select this option to use less bandwidth, ensure that communication is more discoverable by standard security tools, and enhance debugging capabilities with external tools, such as Fiddler.
Restore Default Value When selected, restores all limits and options to their default values.