mozilla

• Roadmap
• Projects
• Coding
  • Module Owners
  • Hacking
  • Get the Source
  • Build It
• Testing
  • Releases
  • Nightly Builds
  • Report A Problem
• Tools
  • Bugzilla
  • Tinderbox
  • Hg
  • MXR
• FAQ

Build Instructions for JSS 4.2.5

Newsgroup: mozilla.dev.tech.crypto

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

1. Build NSPR/NSS by following the build Instructions for NSS 3.11.4 Release,
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.5 or later. We suggest you use the latest.

4. 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_5_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.

   Unix

   setenv JAVA_HOME /usr/local/jdk1.5.0 (or wherever your JDK is installed)
   

   Windows NT

   set JAVA_HOME=c:\programs\jdk1.5.0 (or wherever your JDK is installed)
   

   Windows NT (Cygnus)

   JAVA_HOME=/cygdrive/c/programs/jdk1.5.0 (or wherever your JDK is installed)
   export JAVA_HOME
   

   Windows build Configurations WINNT vs WIN95

   NSPR/NSS/JSS build generates a "WINNT" configuration by default on Windows for historical reasons. 
   We recommend most applications use the "WIN95" configuration. If you want JSS to be used 
   with your applet and the Firefox browser than you must build WIN95. (See JSS FAQ) 
   The "WIN95" configuration supports all versions of Windows. The "WIN95" name is historical; 
   it should have been named "WIN32".
   To generate a "WIN95" configuration, set OS_TARGET=WIN95 and build NSPR/NSS/JSS WIN95. 
   

3. Build JSS.

   cd mozilla/security/jss
   gmake
   
   

4. Sign the JSS jar.

   If you're intention is to modify and build the JSS source you 
   need to Apply for your own  JCE code-signing certificate  
   
   If you made no changes and your goal is to build JSS WIN95 you can use the 
   signed binary release of the jss4.jar from ftp.mozilla.org.
   with your WIN95 jss4.dll. 
   

Next, you should read the instructions on using JSS.