Installation Instructions

System Requirements

The V2.1 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.

  1. Run the Custom Course Builder installer

    2. For the Windows Platforms:

    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.

    If you are using Internet Explorer, you will have both of the following options. If you are using Netscape NavigatorTM, you will only have 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 file you downloaded.

    For the HP-UX and Sun Solaris Platform:

    • 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.

    After downloading this file, set its execute permissions so that it can be run:

    • 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 d

    Move to the directory location where you want to install the Custom Course Builder 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.

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

Run the Custom Course Builder application

    For the Windows Platforms:

    From the Start menu select any of these options:

      Start->Programs->Custom Course Builder 2.1->Start CCB
        Runs the Custom Course Builder. After the CCB is opened select File->New to create a new environment or File->Open to open an existing environment.

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

        Displays the Custom Course Builder documentation in your default system web browser. This information is also available inside the CCB by using Help->Course Builder Help.

    For the HP-UX and Sun Solaris Platform:

    The Custom Course Builder can be started by executing the following script:

      [installation directory]/Custom_Course_Builder21/bin/startccb

    If you are running the Custom Course Builder with CAST NX 2, there are several files that you will need to update in the CAST environment. (On Windows these files are updated by the installation program).

    To update your CAST NX 2 environment, copy the files listed below from the .../Custom_Course_Builder21/templates/ui directory to the directory containing the CAST environment ($UGII_BASE_DIR/ugcast/html). The files that need to be updated are:

    • start.html
    • contents.html
    • navapp.html
    • map_lms.html
    • cast.jar
    • js/navtool.js

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 an administrative user on your machine to install the 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 will need to install an appropriate version of Java. The Custom Course builder requires Java 1.3.1 or higher (Java 1.4.x is recomended). On Windows you will need to edit the JAVA_HOME variable in the startccb.cmd script (located in .../Custom_Course_Builder21/bin). On Unix you will need to make sure that you JAVA_HOME environment variable is set.