You are currently viewing a snapshot of www.mozilla.org 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 www.mozilla.org, please file a bug.



Build Instructions for JSS 3.2

Newsgroup: mozilla.dev.tech.crypto

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

  1. Follow the Build Instructions for NSS 3.4.2 Release, except check out coreconf with the CVS tag JSS_3_2_RTM instead of NSS_3_4_2_RTM. That is, step 3 of the NSS 3.4.2 build instructions should proceed as follows when you are building JSS 3.2:
      cvs co -r NSPRPUB_RELEASE_4_1_2 mozilla/nsprpub 
      cvs co -r JSS_3_2_RTM mozilla/security/coreconf
      cvs co -r DBM_1_61_RTM mozilla/dbm mozilla/security/dbm
      cvs co -r NSS_3_4_2_RTM mozilla/security/nss
      
  2. To check that NSS built correctly, run all.sh (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_2_RTM mozilla/security/jss
    
  2. Setup environment variables needed for compiling Java source.

    Unix

      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
    gmake
    

Next, you should read the instructions on using JSS.