Install and Configure Trailhead

Installing and configuring Trailhead requires the following steps:

  1. Stop the Collaboration Server or shut down the JWS

  2. Install the Trailhead software

  3. Change the JWS Port (optional)

  4. Configure Trailhead

  5. Start Trailhead

  6. Configure the Trailhead medium on Media Blender

  7. Verify communication between Trailhead and Media Blender

Step 1: Stop the Collaboration Server OR Shut down the JWS

If you are installing Trailhead on the same machine as the Collaboration Server, stop the Collaboration Server.

  1. Log in as root

  2. Shut down the Java Web Server using these commands:

    cd /usr/local/JavaWebServer1.1.3/bin

    ./jsadmin admin/admin -stop

Step 2: Install the Trailhead software

  1. Enter the following command:

    cd /usr/local/

  2. Copy the file trailh.tar.Z from the CD to the directory in which you want to install the Trailhead directory.

    Example:

    cp /cdrom/ciscoth/trailh/trailh.tar.Z /usr/local/

  3. Unpack the file using the following commands:

    bin/zcat trailh.tar.Z| tar xf -

    This unpacks the software into the trailhead directory. (If the trailhead directory doesn't yet exist, this command creates it.)

  4. Change ownership of all files in the <trailheaddir>/servlet/properties directory to nobody:

    chown -R nobody /usr/local/trailhead/CiscoTH/servlet/properties

  5. Run the installation script:

    a. Log in as root (using the su command)

    b. Type this command:

      chmod a+x /usr/local/trailhead/CiscoTH/bin/installTrailhead

    c. Type this command:

      /usr/local/trailhead/CiscoTH/bin/installTrailhead

    d. When prompted, enter these values:

      --the Java WebServer installation directory of the (/usr/local/JavaWebServer1.1.3)

      --the Trailhead installation directory (/usr/local/trailhead/CiscoTH)

Step 3: Change the Java Web Server Port (optional)

If you have another Web server running on the same machine as Trailhead, that Web server and the Java Web Server (JWS) may both attempt to use port 80. You can either choose to run the other Web server on another port or change the port used by the JWS.

Note: This step is necessary ONLY if you are running another web server on the same machine as JWS.

To change the JWS Port, edit the following file:

<JWSdir>/properties/server/javawebserver/webpageservice/endpoint.properties

by setting the endpoint.main.port property to a port other than 80 (e.g. 8080).

Step 4: Configure Trailhead

You configure the behavior of Trailhead in the Trailhead.server.properties property file that resides in the /usr/local/trailhead/CiscoTH/servlet/properties/trailhead directory. (You may need to change ownership of the /usr/local/trailhead/servlet/properties/trailhead directory).

Be sure the change the logpath to reflect the path in which the logs will be created. Using the LogPath property, change the logpath to /usr/local/trailhead/Logs/.

For complete information on the Trailhead property file, see the Cisco ICM Web Option: Trailhead Configuration and Administration Guide. You can access this guide on the Media Blender server using this URL: <blenderserver>/help/.

Trailhead Autostart

You can configure Trailhead to automatically start whenever the JWS is started using the autostart property in the Trailhead servlet properties file.

If you choose to do so, you must also ensure that the checkurls property is set to false until you have created all of the HTML pages used by Trailhead. See Post-Installation Tasks for more information.

Step 5: Start Trailhead

Start JWS using this command:

<trailhead dir>/bin/trailhead -start

Starting Trailhead from the Trailhead Administration menu

After you have started Trailhead for the first time, you can start it using the Trailhead Administration menu using these steps:

  1. Open a browser and go to this URL: http://<servername>/TrailheadAdmin

    The Trailhead login page appears.

  2. Type your username and password to log in to Trailhead Administration.

    The Trailhead control panel appears.

  3. Click Startup/Shutdown.

    The Startup screen appears.

  4. Click Startup.

If you are unable to get to the Trailhead administration menu, you may need to restart JWS. Use the following procedures:

  1. Stop JWS using this command:

    <trailhead dir>bin/trailhead -stop

  2. Then use this command to start Trailhead:

    <trailhead dir>/bin/trailhead -start

Once you have installed and configured your Trailhead server and it runs as expected, you can also remove the file trailh.tar.Z.

The following steps are required only if you are using Trailhead to provide callback-only in at least some instances.

Step 6: Configure the Trailhead medium

A Trailhead medium is installed automatically with Media Blender on the Media Blender server. You must configure this medium if you intend to use Trailhead in any kind of callback-only situation. You configure the Trailhead medium using the /usr/local/trailhead/CiscoTH/servlet/properties/Trailhead.properties file. For complete information on configuring the Trailhead medium, see the Cisco ICM Web Option: Trailhead Configuration and Administration Guide.

You must also identify Trailhead as a participating medium in the blender.properties file. Use the medium(n) property to define this medium.

Step 7: Verify communication between Trailhead and Media Blender

  1. Start Media Blender. You must log in to the Media Blender Administration Control Panel, using your NT Administrator account.

  2. Go to this URL: http://<trailhead>/TrailheadAdmin

  3. Click Summary.

    Ensure that the destination that communicates with Media Blender has received a poll from the Media Blender. You set the time interval between Media Blender polls to the Trailhead server using the properties file for the Trailhead medium. See the Cisco ICM Web Option: Trailhead Configuration and Administration Guide for more information.