![]() |
Solaris Build Instructions
JavaTM 2 SDK, Standard Edition, v1.4.2 fcs
|
Build Overview |
This README file contains build instructions for the JavaTM 2 SDK, Standard Edition, v1.4.2 (J2SDK 1.4.2) Community Source Release. Building the source code for the Java 2 SDK requires a high level of technical expertise. Sun provides the source code primarily for technical experts who want to conduct research, port the platform to new operating systems and hardware, or add enhancements that require access to platform internals. If you are not a technical professional in one of these categories, this release is probably not for you.
The official build platform for the 32-bit version of J2SDK 1.4.2 is Solaris 7.The minimum recommended hardware for building the Solaris-SPARC version is an UltraSPARC with 128 megabytes of RAM. For building the Solaris-x86 version, a Pentium class processor or better and at least 128 megabytes of RAM are recommended. Approximately 1.4 GB of free disk space is needed for a 32-bit build.
64-BIT-ONLY: The official build platform for the 64-bit version of J2SDK 1.4.2 is a 64-bit installation of Solaris 7 on SPARC. You may run the command "isainfo -v" to verify that you have a 64-bit installation. An additional .7 GB of free disk space is needed for a 64-bit build.
The build uses the tools contained in /usr/ccs/bin and /usr/bin of a standard developer or full installation of the Solaris operating environment.
Minimum patch revisions are given in the tables below, though later patch revisions are expected to work also. Patches may be downloaded from the J2SE download page. You should ensure that the latest patch cluster for your version of the Solaris operating environment has been installed prior to installing these patches. The J2SE patch clusters are available for download on the SunSolve web site.
The term "required" means the patch is required for non-international build.
SPARC patch x86 patch Req/Opt Description 107834-04 none Required dkio.h & commands.h patch 107544-03 107545-03 Required Kernel update 106541-24 106542-24 Required Kernel update, requires reboot 106980-22 106981-23 Required Threads patch 106950-22 106951-22 Required Linker patch 106327-17 106328-17 Required C++ library patch 106300-18 none Required C++ library patch 108376-42 108377-37 Required OpenWindows patch 107656-11 107657-09 Required OpenWindows libXt patch 107702-12 107703-12 Required CDE 1.3 dtsession patch 108374-07 108375-07 Required CDE libDtWidget patch 107226-19 107227-19 Required CDE window manager patch
Patches for Building on Solaris 5.8
SPARC patch x86 patch Req/Opt Description 108652-66 108653-55 Required Xserver patch 108714-08 108715-08 Required CDE 1.4 libDtWidget patch 108940-52 108941-52 Required Motif 2.1 patch 108989-02 108990-02 Required Accounting patch 111293-04 111294-03 Required libdevinfo.so.l patch none 111307-04 Required boot.bin, bootconf.exe, bootenv.rc and nbp patch 111310-01 111311-01 Required libhcpagent.so.l patch 112396-02 112397-02 Required fgrep patch 108987-13 108988-13 Required patchadd, patchrm patch 111111-03 111112-03 Required nawk patch 108528-20 108529-20 Required Kernel update 108993-18 none Required LDAP2 Patch none 110400-01 Required RBAC Feature patch none 111024-02 Required /kernel/fs/mntfs patch none 108994-18 Required LDAP2 patch 109147-23 109148-23 Required linker patch 111308-03 111309-03 Required Performance for apps using memory alloc
Once the Solaris OS is set up, you will need to install additional tools and libraries for building the J2SDK.
Forte Developer 6 Update 1 (containing version 5.2 of the C and C++ compilers) is required, with patches as defined below. You may download these compilers with a free 30-day "Try and Buy" license. A permanent license may be obtained from the Forte Developer Tools web site: an Update 2 license will work with the Update 1 products.Set ALT_COMPILER_PATH to point to the location of the compiler binaries, and place this location in the PATH. These patches are available for download on the SunSolve web site.
SPARC patch x86 patch Req/Opt Description 109505-06 109502-03 Required For C 5.0, C++ 5.0 109513-05 109514-03 Required For Forte Development 6 C compiler 109508-03 109509-03 Required For Forte Development 6 update 1 C++ compiler 109510-03 109511-03 Required For Forte 6.1 Debugger 109516-02 109517-02 Required For Forte 6.1 Performance Analyzer 110480-01 110481-01 Required For Forte TeamWare
You will need access to a J2SDK 1.4.1 for Solaris installation. The 1.4.1 binaries can be downloaded from Sun's J2SDK 1.4.1 download site. Set ALT_BOOTDIR to point to the location of the bootstrap J2SDK installation. The installation instructions for the bootstrap J2SDK include a list of required and recommend patches that are needed at runtime. The subset of these patches that are required for building J2SDK are listed in the System Setup section above. However, all the runtime patches should be installed to ensure proper behavior of all J2SDK functionality after the build is completed.
GNU make version 3.78.1 or later is required to build the J2SDK. Information on GNU make, including download sites, is available on the GNU Make web site. For convenience, place the GNU make binary in the PATH.
Motif version 2.1 headers and libraries are required for building the J2SDK.Create a Motif library and header area that contains header files and libraries for Motif 2.1. Use the ALT_MOTIF_DIR environment variable to point to absolute path of the Motif directory. The top level of the directory must contain directory named motif21, which must have subdirectories include and lib with contents as shown here:
+- motif_area/ (set ALT_MOTIF_DIR to this level) +- motif21/ +- include/ | +- Xm/ (from /usr/include/Xm) | +- <many files> | +- lib/ (from /usr/dt/lib/) +- libXm.so (symbolic link to libXm.so.4) +- libXm.so.4 +- sparcv9/ (64-bit Motif library) +- libXm.so (symbolic link to libXm.so.4) +- libXm.so.4In the example above, the name of the top-level directory is not significant; it is not required to be named motif_area.
Set up the following directory structure for the ODBC
driver, and set the ALT_ODBCDIR environment variable to
point to it.
An alternative to using a DataDirect driver is to build a dummy
driver of your own. Create and then "cd" to the directory
$ALT_ODBCDIR/ISLIodbc/2.11/lib, copy over the source file
j2se/make/sun/jdbc/dummyodbc.c,
and then compile as follows using the Forte C compiler:
The source bundles contain a cacerts file without CA root certificates.
J2SDK builders will need to secure permission from each public CA and
include the certficates into their own custom cacerts file. Failure to
provide a populated cacerts file will result in verification of a
certificat chain during runtime.
The ALT_CACERTS_FILE should be set to point to the location of
the populated cacerts file.
Environment variables may be set in the shell environment
or on the GNU make command line.
JDBC-ODBC Bridge
The DataDirect Connect ODBC 2.11 driver is needed for building the
JDBC-ODBC Bridge.
A copy of the driver is on the Desktop 1.1.1 Solaris
CD-ROM, which is part of older Solaris distributions.
+- odbc/ (set ALT_ODBCDIR to this level)
+- ISLIodbc/
+- 2.11/
+- odbc files and directories (lib/, include/, etc.)
On SPARC systems you may use the DataDirect ODBC 3.7 driver in
place of the 2.11 driver:
use the directory structure above (including the 2.11
directory) if doing so.
cc -G -h libodbc.so -o libodbc.so dummyodbc.c
cc -G -h libodbcinst.so -o libodbcinst.so dummyodbc.c
zip
The build requires
zip
version 2.2 (November 3rd 1997) or later.
Set ALT_DEVTOOLS_PATH to point to the location of this binary.
Information on zip, including download sites,
is available on the info-zip web site.
cacerts
A certificates file named "cacerts" represents a system-wide keystore
with CA certificates. In J2SDK and JRE binary bundles, the "cacerts"
file contains root CA certificates from several public CAs (e.g., VeriSign,
Thawte, and Baltimore).
GNU C Compiler (32-bit build only)
GNU gcc version 2.95.2 is required for building the Plug-in.
The source code for gcc is available from
http://www.gnu.org/software/gcc/,
and some pre-built binaries are available from
sunfreeware.com.
Set ALT_GCC_COMPILER_PATH to point to the location of the gcc binary.
Mozilla Headers (32-bit build only)
Mozilla headers are required for building Java Plug-in. Download
and unpack the headers into a directory similar to the one
shown below, and set the ALT_MOZILLA_PATH
environment variable to the absolute path of the top-level
directory.
+- devtools/ (set ALT_MOZILLA_PATH to this level)
+- share/
+- plugin/
+- mozilla_headers_ns610/
The name of the top-level directory is
not significant; it is not required to be named devtools.
Solaris Build Environment Variables
This section describes environment variables that you can set to
influence various aspects of the build. Some of these variables
are mentioned specifically in the setup and build instructions
above. Others you may set at your discretion.
PATH
to contain:
ALT_COMPILER_PATH
)/usr/bin
Solaris Build
gnumake scsl [ARCH_DATA_MODEL=32 or 64] [ALT_OUTPUTDIR=directory-name-for-output] [MILESTONE=milestone_name] [BUILD_NUMBER=build_number] [other "ALT_" overrides]
64-BIT-ONLY: Before 64-bit binaries can be used,
they must be merged with the binaries from a separate 32-bit build.
The merged binaries may then be used in either 32-bit or 64-bit mode,
with the selection occurring at runtime.
Copyright 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. |
|