Installation Instructions

System Requirements

The V2.0 Custom Course Builder is a Java-based application. It requires a minimum Java version of 1.3.1 and is supported on Microsoft Windows NT 4.0, 2000, and XP and on HP-UX and Sun Solaris UNIX operating systems.

Installation Instructions
Run the Custom Course Builder Application
Troubleshooting and Known Issues

Installation Instructions

The Custom Course Builder is available for download as a self-extracting executable on Windows and a self-extracting shell script on UNIX. You will run the self-extracting program to unpack and install the Custom Course Builder.

Note -- Trying to install the Custom Course Builder on a machine with an unsupported version of Java will cause the installer to generate a warning about the Java version available being incompatible with the Custom Course Builder. Installation of the product will not be halted, but you will need to update your Java version before execution of the Custom Course Builder.

If you have any difficulties during installation, see the Troubleshooting section at the end of this document.

Check the download file size
When saving the self-installing executable to disk, notice that its byte size is provided next to the download link below. Once the download is completed, check that you have downloaded the full, uncorrupted software file.

Platform Type	Download File	Size in Bytes
Windows NT, 2000, XP	ccb102802.exe	Size: 6,527,224 bytes Size on disk: 6,529,024 bytes
UNIX (HP-UX, Sun Solaris)	ccb102802.bin	1,911,596 bytes

Run the Custom Course Builder installer

Note -- you may need administrative permissions to install the Custom Course Builder on Microsoft Windows 2000 and XP, the installer uses the Microsoft Installer service technology and this may need to be configured using an administrative account during the installation if you have not previously installed an application which uses this technology. See Troubleshooting for more information.

Windows Platforms
If using Internet Explorer, you have both of the following options. If using Netscape Navigator^TM, you have only the "Save As" option.
- Open - This enables you to install the Custom Course Builder without leaving a compressed file on your hard disk.
- Save As - This saves the downloaded file without installing it. Check that you have downloaded the entire file by comparing the size of the file you downloaded with the expected size shown above:
After downloading this file, you can double-click on its icon to run the installer. Follow the instructions the installer provides. When done with the installation, to recover more disk space, delete the self-extracting program you downloaded.

HP-UX and Sun Soalris

Save [Target] As - This saves the downloaded file without installing it. Check that you have downloaded the entire file by comparing the size of the file you downloaded with the expected size shown above.

chmod 755 [download_location]/[downloaded file]

Where [download location] is the full path to the download file and [downloaded file] is the name of the file saved to disk.

Move to the directory location you want to install the Custom_Course_Builder into and execute the downloaded file.

[download_location]/[downloaded file]

Where [download location] is the full path to the download file and [downloaded file] is the name of the file saved to disk.

The only prompt used during installation is to determine the location of your Java 1.3.1 or higher installation. After providing that information, the Custom Course Builder will be installed into the current working directory. When done with the installation, to recover more disk space, delete the self-extracting program you downloaded.

Delete the downloaded file (Optional)
If you want to recover disk space, delete the file you originally downloaded.

Run the Custom Course Builder application

Windows Platforms

From the Start menu select any of these three options:

Start->Programs->Custom Course Builder->Start CCB

Start->Programs->Custom Course Builder->Start CCB with CAST

Start->Programs->Custom Course Builder->Help

HP-UX and Sun Solaris

The Custom Course Builder can be started in two modes, with CAST (it wil be started with its working directory pointing at the CAST environment), or stand-alone (with the working directory pointing to the course development directory in the Custom Course Builder installation location).

To start the Custom Course Builder with CAST you will need to have CAST NX installed and the UGII_BASE_DIR variable must be set on your system. Start the Custom Course Builder with CAST using the command:

$CCB_HOME/bin/startccb -cast

To start the Custom Course Builder in stand-alone mode, run the command:

$CCB_HOME/bin/startccb

UNIX Only

If you are running the Custom Course Builder with CAST there are several files that you need to update in the UGII_BASE_DIR/ugcast/html environment. (On Windows these files are updated by the installation program).

To update your CAST environment copy the following files from the ccb_work/html environment to the CAST environment:

Copy: .../Custom_Course_Builder/ccb_work/html/js/navtool.js

To: $UGII_BASE_DIR/ugcast/html/js/navtool.js

Copy: .../Custom_Course_Builder/ccb_work/html/cast.jar

To: $UGII_BASE_DIR/ugcast/html/cast.jar

Troubleshooting and Known Issues

Windows installation may require administrative privileges

During the installation on Windows platforms, if you receive an error stating that you must run with administrative privileges, this means that you have not previously installed any Microsoft Installer installed applications and the machine needs to configure the msiexec service in order to install the Custom Course Builder. You should log in as a administrative user on your machine to install Custom Course Builder if this happens.

Java version incompatible with Custom Course Builder

If the installation program warns you that your Java version is incompatible with the Custom Course Builder, you can proceed to install the Custom Course Builder application. After installing the application you must install an appropriate version of Java (1.3.1 minimum) on your machine and then edit the ccbenv.bat (ccbenv.ksh - UNIX) script in the [installation location]/Custom_Course_Builder/bin directory. You should change the JAVA_HOME variable defintion to the location of your updated Java installation.

Internet Explorer performance problems viewing custom course files

If you have performance problems in Internet Explorer while paging through your custom course, you may want to disable your Java Plugin. This can be done from the Tools -> Internet Options -> Advanced dialog.

Editing the ccbenv.bat/ccbenv.ksh file

After you install the Custom Course Builder, the environment to which you installed should work properly, however, if you want to modify the working environment for the Custom Course Builder you can do so be editing the ccbenv.bat/ccbenv.ksh file.

If you want to move the ccb_work directory used by the Custom Course Builder, you should edit the setting for the CCB_WORK_DIR variable.
If you want to define a different web browser to view the HTML course files, you should edit the setting for the CCB_BROWSER variable.
If you need to redefine the location of your Java installation to run the Custom Course Builder, you should edit the setting for the JAVA_HOME variable.
On UNIX, if you move the location of the Custom Course Builder, edit the CCB_HOME directory in the ccbenv.ksh. On Windows it is recommended that you uninstall and reinstall to change the application location, if you do this manually, the uninstallation of the Custom Course Builder in the future will not work properly.