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 3.3


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

  1. Follow the Build Instructions for NSS 3.6.1 Release, except check out coreconf with the CVS tag JSS_3_3_RTM instead of NSS_3_6_1_RTM. That is, step 3 of the NSS 3.6.1 build instructions should proceed as follows when you are building JSS 3.3:
      cvs co -r NSPR_4_2_2_RELEASE mozilla/nsprpub 
      cvs co -r JSS_3_3_RTM mozilla/security/coreconf
      cvs co -r DBM_1_61_RTM mozilla/dbm mozilla/security/dbm
      cvs co -r NSS_3_6_1_RTM mozilla/security/nss
  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.

  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_3_3_RTM mozilla/security/jss
  2. Setup environment variables needed for compiling Java source.


      setenv JAVA_HOME /usr/local/jdk1.2.2 (or wherever you installed the JDK)
      setenv JCE_JAR " " (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 you installed the JDK)
      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 you installed the JDK)
      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.