You are currently viewing a snapshot of taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to, please file a bug.

Build Instructions for JSS 4.2


Before building JSS, you need to set up your system as follows:

  1. Follow the Build Instructions for NSS 3.11.4 Release,
  2. To check that NSS built correctly, run (in mozilla/security/nss/tests) and examine the results (in mozilla/test_results/security/computername.#/results.html.

  3. Install a Java compiler and runtime. JSS supports Java version 1.2 or later. We suggest you use the latest.

  4. In order to build JSS, you must have the Java Cryptography Extension (JCE) classes. These classes have been incorporated into JDK 1.4 and later, so if you are using one of these versions of the JDK, you don't have to do anything for this step.

    If you are using an earlier version of the JDK, download and install the JCE from Sun's page. When building, set the JCE_JAR environment variable to the path of the JAR file (such as jce1_2_1.jar) contained in the JCE distribution.

  5. You must have Perl version 5.005 or later.
Now you are ready to build JSS. Follow these steps:
  1. Switch to the appropriate directory and check out JSS from the root of your source tree.
    cvs co -r JSS_4_2_RTM mozilla/security/jss
  2. Setup environment variables needed for compiling Java source. The JAVA_HOME variable indicates the directory containing your Java SDK installation. The JCE_JAR variable indicates the location of the JAR file containing the JCE; this is only necessary if you are using an SDK version earlier than 1.4. The JDK_VERSION variable is currently only needed on Linux; it should be set to "1.4" if the SDK is version 1.4 or later.


      setenv JAVA_HOME /usr/local/jdk1.2.2 (or wherever your JDK is installed)
      setenv JCE_JAR " "; setenv JDK_VERSION "1.4"(if you are using JDK version >= 1.4)
      setenv JCE_JAR /usr/local/jce1.2.1/lib/jce1_2_1.jar (if you are using
      JDK version < 1.4)
    Windows NT
      set JAVA_HOME=c:\programs\jdk1.2.2 (or wherever your JDK is installed)
      set JCE_JAR=" " (if you are using JDK version >= 1.4)
      set JCE_JAR=c:\programs\jce1.2.1\lib\jce1_2_1.jar (if you are
      using JDK version < 1.4)
    Windows NT (Cygnus)
      JAVA_HOME=/cygdrive/c/programs/jdk1.2.2 (or wherever your JDK is installed)
      export JAVA_HOME
      JCE_JAR=" " ; export JCE_JAR
      (if you are using JDK version >= 1.4)
      JCE_JAR=/cygdrive/c/programs/jce1.2.1/lib/jce1_2_1.jar ; export JCE_JAR
      (if you are using JDK version < 1.4)
  3. Build JSS.

    cd mozilla/security/jss

Next, you should read the instructions on using JSS.