You define the destinations used within your enterprise using the Trailhead.server.properties file, which resides on the Trailhead machine in \CiscoTH\servlet\properties\.
Note: Some properties require the URL of a Web page that should be served to callers for different circumstances. We provide sample HTML you can use when setting up these pages. These files reside in the directory \<CCS dir>\pub\html\Forms\blender on the Cisco Collaboration Server. Some HTML files also reside in the \CiscoTH\pub\html\Forms\ directory on the Trailhead server. Individual filenames are included in the appropriate property description. See Maintaining Trailhead HTML Pages and Forms in this guide for more information on HTML files.
Use the properties in the Trailhead.server.properties file to configure the behavior of Trailhead in a Cisco ICM environment.
Property type: String
Default value: admin
This property identifies the administration username used to access the Trailhead control panel (http://<server>/TrailheadAdmin). Note that this user name is automatically encrypted; when you edit this file, the name will appear differently.
Property type: String
Default value: None
This property identifies the administration password used to access the Trailhead control panel (http://<server>/TrailheadAdmin). Note that this user name is automatically encrypted; when you edit this file, the name will appear differently.
Property type: Boolean
Default value: False
This property indicates whether Trailhead should automatically start with the Web server. Be sure not to set this property to true until you are sure that all of your media are properly configured.
Property type: string
Default: none
Required
This property identifies the destination chooser used by the Trailhead server. In ICM Web configurations, this should be Com.WebLine.Trailhead.DcRemote.
Use these properties to set up the connections from your Trailhead servers to your Trailhead media. Note that, even though connections are numbered sequentially, you can delete a connection within the sequence without having to renumber your remaining connections.
In the properties that follow, note that "local" properties refer to the Trailhead medium. Properties that refer to "remote" values indicate the Trailhead server.
For more information on the Trailhead RMI connections, see Trailhead Components and Connections.
Property type: String
Default: trailhead
This property identifies the local name for this connection (the Trailhead server).
Property type: Numeric
Default: 1099
This property identifies the local port for this connection (the Trailhead server).
Property type: String
Default: trailheadpw
This property identifies the password for this connection. The value here must match the value indicated in the connection<n>.remotepassword property on the Trailhead medium. Note that this password is automatically encrypted; when you edit this file, the value you enter here will appear differently.
Property type: String
Default: blender
This property identifies the remote name for this connection (the Trailhead medium).The value here must match the value in the connection<n>.localservername property on the Trailhead medium.
Property type: String
Default: None
This property identifies the remote host for this connection (the Trailhead medium).
Property type: Numeric
Default: 1099
This property identifies the remote port for this connection. (the Trailhead medium.) The value here must match the value entered in the localregistryport property on the Trailhead medium.
Property type: String
Default: blenderpw
This property identifies the password for this connection. The value here must match the value indicated in the connection<n>.localpassword property on the Trailhead medium. Note that this password is automatically encrypted; when you edit this file, the value you enter here will appear differently.
Property type: Boolean
Default: true
This property specifies whether this connection should appear on the list of connections that a DcRemote destination choose tries to use when routing a session.
Property type: Boolean
Default: true
This property specifies whether this connection is usable to queue a call. This connection appears in the the destination<n>queueconn property on the Trailhead medium.
Property type: Boolean
Default: false
This property allows you to disable attempts by the Trailhead server to automatically connect to the Trailhead medium. Set this property to true if if inbound communication is not possible through your firewall. This setting ensures that the Trailhead server does not try to automatically connect to the Trailhead medium. Instead, the Trailhead medium will instead poll the Trailhead server from behind the firewall.
If the firewall will allow both inbound and outbound communication, set this property to false. This setting ensures that the Trailhead server will connect to the Trailhead medium automatically, initiating two-way communication through the connections.
On the Trailhead server, you need set up only one destination to handle system error. Use these properties to establish a system error destination on the Trailhead server.
Property type: Valid file name
Default:
This property defines the name for a destination in your configuration. When specifying destinations, number each destination sequentially, beginning with 1.
Example:
destination1.name=SysError
Property type: String
Default value:
This property lets you specify the type of response this destination will provide to web requests. Acceptable values are:
Value |
Description |
CALLONLY |
Basic Callback |
COLLAB |
Web Collaboration |
NOCALL |
Noncalling |
On the Trailhead server, you need only set up a system error destination, which should be type NOCALL.
Property type: Valid URL
Default value: none
This property maps a valid URL to a particular destination. When a request is routed to the destination, Trailhead serves the URL specified here.
We provide sample URLs for different destination types. See Maintaining Trailhead HTML Pages and Forms in this guide for more information for more information.
Note for NOCALL destinations: You can choose to server a URL here, or, instead, serve only an HTTP error code and reason to the caller. If you choose to server an error code instead, do not use this property; instead, use destination<n>errorcode and destination<n>errorreason, described below.
Property type: Integer
Default: none
This property specifies an error number to send the user, rather than a URL.You can enter 404, 500, or any HTTP error code to send these errors.
Property type: String
Default: System Error. Please try later.
This property explains the error specified in destination<n>errorcode.
The callback form is the HTML page used to gather caller information to be submitted to the ICM. Use this property to identify the callback form.
Property type: String
Default value: None
Available in the general release of the product, this property identifies the callback form used to gather information about the caller. We provide a sample, callform.html. See ICM Input: The Web request and Maintaining HTML forms and pages in this guide for more information.
The following properties let you establish a rotation of log files generated by Trailhead. Trailhead creates new log files until it reaches the number of logs specified in the logcount property.
Property type: String
Default value:none
This property identifies the pathname to which logs are written. Be sure to end the path with a forward slash.
Property type: Numeric
Default value: 20000
This property sets the maximum number of lines per log file.
Property type: Numeric
Default value: 2
This property indicates the number of log files in file rotation.
Property type: Integer
Default value: 3
This property indicates the level of verbosity of logged messages. Acceptable values are:
1 -- Urgent
2 -- Critical
3 -- Important
4 -- Informational
Property type: boolean
Default: True
This property determines whether Trailhead appends log file names with the date and time of creation. Log-1999-07-31-7-12_1.log
Property type: Integer
Default:20
This property specifies the minimum number of threads.
Property type: Integer
Default: 20
This property specifies the maximum number of threads.