Installing and configuring Trailhead requires the following steps:
If you are installing Trailhead on the same machine as the Collaboration Server, stop the Collaboration Server.
Log in as root
Shut down the Java Web Server using these commands:
cd /usr/local/JavaWebServer1.1.3/bin
./jsadmin admin/admin -stop
Enter the following command:
cd /usr/local/
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/
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.)
Change ownership of all files in the <trailheaddir>/servlet/properties directory to nobody:
chown -R nobody /usr/local/trailhead/CiscoTH/servlet/properties
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)
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).
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/.
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.
Start JWS using this command:
<trailhead dir>/bin/trailhead -start
After you have started Trailhead for the first time, you can start it using the Trailhead Administration menu using these steps:
Open a browser and go to this URL: http://<servername>/TrailheadAdmin
The Trailhead login page appears.
Type your username and password to log in to Trailhead Administration.
The Trailhead control panel appears.
Click Startup/Shutdown.
The Startup screen appears.
Click Startup.
If you are unable to get to the Trailhead administration menu, you may need to restart JWS. Use the following procedures:
Stop JWS using this command:
<trailhead dir>bin/trailhead -stop
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.
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.
Start Media Blender. You must log in to the Media Blender Administration Control Panel, using your NT Administrator account.
Go to this URL: http://<trailhead>/TrailheadAdmin
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.