On the Trailhead Server:
Trailhead.server.properties

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.

General Trailhead Properties

Use the properties in the Trailhead.server.properties file to configure the behavior of Trailhead in a Cisco ICM environment.

adminname=

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.

adminpw=

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.

autostart=

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.

destchooser=

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.

Specifying Trailhead Connections

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.

connection<n>.localservername=

Property type: String

Default: trailhead

This property identifies the local name for this connection (the Trailhead server).

connection<n>.localregistryport=

Property type: Numeric

Default: 1099

This property identifies the local port for this connection (the Trailhead server).

connection<n>.localpassword=

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.

connection<n>.remoteservername=

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.

connection<n>.remotehost=

Property type: String

Default: None

This property identifies the remote host for this connection (the Trailhead medium).

connection<n>.remoteregistryport=

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.

connection<n>.remotepassword=

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.

connection<n>.canroute=

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.

connection<n>.canqueue=

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.

connection<n>disableautoconnect=

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.

Specifying a System Error Destination

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.

destination<n>.name=

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

destination<n>.type=

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.

destination<n>.URL=

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.

destination<n>errorcode=

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.

destination<n>errorreason

Property type: String

Default: System Error. Please try later.

This property explains the error specified in destination<n>errorcode.

Identifying the Callback Form

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.

formurl=

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.

Setting up the Log

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.

logpath=

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.

loglines=

Property type: Numeric

Default value: 20000

This property sets the maximum number of lines per log file.

logcount=

Property type: Numeric

Default value: 2

This property indicates the number of log files in file rotation.

verbose=

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

timestampfiles=

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

threadfloor=

Property type: Integer

Default:20

This property specifies the minimum number of threads.

threadceiling=

Property type: Integer

Default: 20

This property specifies the maximum number of threads.