|
|
Windows-Ia64 Build Instructions
JavaTM 2 SDK, Standard Edition, v1.4.1 fcs
|
Build Overview |
This README file contains build instructions for the JavaTM 2 SDK, Standard Edition, v1.4.1 (J2SDK 1.4.1) 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 64-bit Windows J2SDK 1.4.1 is Windows 2000.The minimum recommended hardware for building the Windows-Ia64 version is a Pentium class processor or better, at least 256 megabytes of RAM, and approximately 600 MB of free disk space.
You will need to install the following additional tools and libraries for building a 64-bit version of the windows J2SDK.
The Microsoft Visual C++ 6.0 Professional Edition compiler, with Visual C++ 6.0 Service Pack 3 installed (not Service Pack 4), is required for building the J2SDK. The compiler and other tools are expected to reside in the locations defined by the variables MSVCDir and MSDEVDir, which are set by the setup utility VCVARS32.BAT (usually found in C:\Program Files\Microsoft Visual Studio\VC98\Bin\). It is required that you run VCVARS32.BAT to set MSVCDir, MSDEVDir, INCLUDE, LIB, and the PATH prior to building the J2SDK. If your compiler resides in a place other than the default, you can set ALT_COMPILER_PATH to point to the location of the cl compiler binary, and ALT_MSDEVTOOLS_PATH to point to the location of the development tools. The compiler and tools binaries must be in the PATH.This compiler is used in conjunction with the Microsoft Platform Software Development Kit (SDK) ccompiler as described in the next section.
The Microsoft Platform Software Development Kit (SDK), November 2001 Edition compiler, is required for building the J2SDK. You will need to minimally install the Core SDK and the MDAC SDK features of this compiler. The compiler and other tools are expected to reside in the locations defined by the variables MSSdk and MSTools, which are set by the setup utility SETENV.BAT /XP64 (usually found in C:\Program Files\Microsoft SDK\). It is required that you run SETENV.BAT /XP64 after running VCVARS32.BAT to set MSSdk, MSTools, MSVCDir, MSDEVDir, INCLUDE, LIB, and the PATH correctly prior to building the 64-bit windows J2SDK.If your compiler resides in a place other than the default, you can set ALT_COMPILER_PATH to point to the location of the cl compiler binary, and ALT_MSDEVTOOLS_PATH to point to the location of the development tools.
Because GNU Make has problems with spaces in command PATHS, it may be required that you set ALT_COMPILER_PATH and ALT_MSDEVTOOLS_PATH to point to the locations of the SDK using the Microsoft Mangled Path name convention. For example, if the Microsoft SDK is installed in C:\Progam Files\Microsoft SDK then the settings using mangled path names on the system may be: SET ALT_COMPILER_PATH=C:\Progra~1\Micros~3\bin\win64 and SET ALT_MSDEVTOOLS_PATH=C:\Progra~1\Micros~3\bin, depending on the unique situation of your build machine.
The compiler and tools binaries must be in the PATH.
The J2SDK build requires access to Unix command binaries supplied by MKS Toolkit version 8.0 or later. Information about the MKS Toolkit can be obtained from the MKS website at http://www.mks.com. If the binaries are not installed in C:\mksnt\, set the ALT_UNIXCOMMAND_PATH environment variable to their location.If MKS is installed into a Path that contains spaces, it will be necessary to set ALT_UNIXCOMMAND_PATH to identify that location using Microsoft Mangled Path Name conventions. For example, if the MKS command are located in C:\Program Files\MKS Toolkit\mksnt, then ALT_UNIXCOMMAND_PATH should be set to C:\Progra~1\MKSToo~1\mksnt (or whatever mangled name setting is appropriate for your installation). You can use the DOS command
DIR /xas an aide in determining the mangled path and file names.
You will need access to a J2SDK 1.4.0 RC1 or later for a windows-ia64 build. The 1.4.0 RC1 binaries can be downloaded from Sun's J2SDK 1.4.0 download site. Set ALT_BOOTDIR to point to the location of the bootstrap J2SDK installation, and place its bin directory in the PATH.
GNU make version 3.78.1 or later, built for the MKS shell per the instructions in its documentation, is required to build the J2SDK. Information on GNU make, and access to ftp download sites, are available on the GNU make web site. Place the location of the GNU make binary in the PATH.
ZIP.EXE and UNZIP.EXE should be installed in C:\UTILS. If you have them installed elsewhere set the environment variable ALT_DEVTOOLS_PATH to their location.
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.
It is strongly recommended that the Microsoft VC 6 and SDK setup scripts
VCVARS32.BAT and SETENV.BAT /XP64 be used
to set the PATH.
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).
Windows-Ia64 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.
The following environment variables should not be set:
ARCH_DATA_MODEL to 64 to tell the build
to perform a 64-bit build. By default, ARCH_DATA_MODEL is set to 32
and will build a 32-bit release.
PATH to contain:
Windows-Ia64 Build
gnumake all ARCH_DATA_MODEL=64 [DEV_ONLY=true] [ALT_OUTPUTDIR=directory-name-for-output] [MILESTONE=milestone_name] [BUILD_NUMBER=build_number] [other "ALT_" overrides]
|
Copyright 2002 Sun Microsystems, Inc., 901 San Antonio Road,
Palo Alto, California 94303, U.S.A. All rights reserved. |
|
