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.

Skip to main content

Build Instructions for JSS 3.3

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