[52d29f7] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[ff769b8c] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
---|
[52d29f7] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[da18e2f] | 7 | <!ENTITY jdk-download-source "https://tiger.dev.java.net/jdk_5_0_08.html">
|
---|
[5f0bab7] | 8 | <!ENTITY jdk-download-binary "http://java.sun.com/j2se/1.5.0/download.jsp">
|
---|
[60a31248] | 9 | <!ENTITY jdk-source-md5sum "&sources-anduin-http;/j/jdk-&jdk-src-version;.md5sums">
|
---|
[da18e2f] | 10 | <!ENTITY jdk-bin-md5sum "4fb7972a819e9d5a5ecc902e017e8646">
|
---|
| 11 | <!ENTITY jdk-bin-size "47.2 MB">
|
---|
| 12 | <!ENTITY jdk-src-size "64.1 MB (three .jar files)">
|
---|
| 13 | <!ENTITY jdk-src-buildsize "1700 MB">
|
---|
| 14 | <!ENTITY jdk-time "36 SBU">
|
---|
[52d29f7] | 15 | ]>
|
---|
| 16 |
|
---|
[5f0bab7] | 17 | <sect1 id="jdk" xreflabel="JDK-&jdk-src-version;">
|
---|
[4378f935] | 18 | <?dbhtml filename="jdk.html" ?>
|
---|
| 19 |
|
---|
| 20 | <sect1info>
|
---|
| 21 | <othername>$LastChangedBy$</othername>
|
---|
| 22 | <date>$Date$</date>
|
---|
| 23 | </sect1info>
|
---|
| 24 |
|
---|
[5eaa687] | 25 | <title>JDK-&jdk-src-version;</title>
|
---|
[4378f935] | 26 |
|
---|
| 27 | <indexterm zone="jdk">
|
---|
| 28 | <primary sortas="a-JDK">JDK</primary>
|
---|
| 29 | </indexterm>
|
---|
| 30 |
|
---|
| 31 | <sect2 role="package">
|
---|
| 32 | <title>Introduction to JDK</title>
|
---|
| 33 |
|
---|
[dae2ba0b] | 34 | <para>The <application>JDK</application> package contains
|
---|
[bccbdaea] | 35 | Sun's <application>Java</application> development environment. This is
|
---|
| 36 | useful for developing <application>Java</application> programs and provides
|
---|
| 37 | the runtime environment necessary to run <application>Java</application>
|
---|
[cb61e3a8] | 38 | programs. It also includes a plug-in for browsers so that they can be
|
---|
[4378f935] | 39 | <application>Java</application> aware.</para>
|
---|
| 40 |
|
---|
[bccbdaea] | 41 | <para>The <application>JDK</application> comes in two flavors, a
|
---|
| 42 | precompiled binary and a source package. Previously, the plugin included
|
---|
[cb61e3a8] | 43 | in the <application>JDK</application> binary package was unusable on LFS
|
---|
[bccbdaea] | 44 | owing to incompatibilities with <application>GCC</application>-3 compiled
|
---|
[cb61e3a8] | 45 | browsers. This is not the case anymore.</para>
|
---|
[4378f935] | 46 |
|
---|
| 47 | <para>In order to use the source code and patches, you must read and agree
|
---|
[473131d] | 48 | to the Sun <ulink url="http://www.java.net/jrl.csp"> Java Research
|
---|
| 49 | License</ulink> or optionally, the Sun <ulink
|
---|
| 50 | url="http://java.net/jiul.csp">Java Internal Use License</ulink>. In
|
---|
| 51 | addition, the source code is not allowed to be downloaded to some
|
---|
| 52 | countries, so for users in those countries, the binary is the only
|
---|
| 53 | option.</para>
|
---|
[cb61e3a8] | 54 |
|
---|
[6473e74] | 55 | <para>You will first need to download and install the binary version of the
|
---|
[b26eca2] | 56 | <application>JDK</application>.</para>
|
---|
[6473e74] | 57 |
|
---|
[b26eca2] | 58 | <para>To build from the source, you will also need to download the
|
---|
| 59 | additional files and patches to complete the source build as detailed
|
---|
| 60 | below.</para>
|
---|
[4378f935] | 61 |
|
---|
| 62 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 63 | <itemizedlist spacing="compact">
|
---|
| 64 | <listitem>
|
---|
[6473e74] | 65 | <para>Binary download: <ulink url="&jdk-download-binary;"/>
|
---|
[b26eca2] | 66 | (to download jdk-&jdk-bin-string;-linux-i586.bin)</para>
|
---|
[4378f935] | 67 | </listitem>
|
---|
| 68 | <listitem>
|
---|
| 69 | <para>Download MD5 sum (binary): &jdk-bin-md5sum;</para>
|
---|
| 70 | </listitem>
|
---|
| 71 | <listitem>
|
---|
[b26eca2] | 72 | <para>Source download: <ulink url="&jdk-download-source;"/>
|
---|
[bc2b746] | 73 | (to download jdk-&jdk-src-string;-fcs-src-b03-jrl-03_may_2006.jar (or
|
---|
[b26eca2] | 74 | optionally the JIUL version),
|
---|
[bc2b746] | 75 | jdk-&jdk-src-string;-fcs-bin-b03-03_may_2006.jar, and
|
---|
| 76 | jdk-&jdk-src-string;-mozilla_headers-b03-unix-03_may_2006.jar)</para>
|
---|
[4378f935] | 77 | </listitem>
|
---|
[428434e7] | 78 |
|
---|
[4378f935] | 79 | <listitem>
|
---|
[6473e74] | 80 | <para>Download MD5 sums (source):
|
---|
[b26eca2] | 81 | <simplelist>
|
---|
[da18e2f] | 82 | <member>267653f0e425b4c8f37b918b73e47027
|
---|
| 83 | jdk-&jdk-src-string;-fcs-bin-b03-08_aug_2006.jar
|
---|
[b26eca2] | 84 | </member>
|
---|
[da18e2f] | 85 | <member>f83f8efe9dc82b4e16c382828d490031
|
---|
| 86 | jdk-&jdk-src-string;-fcs-src-b03-jrl-08_aug_2006.jar
|
---|
[b26eca2] | 87 | </member>
|
---|
[da18e2f] | 88 | <member>d75c8dbf3383def458d107f557f95d98
|
---|
| 89 | jdk-&jdk-src-string;-mozilla_headers-b03-unix-08_aug_2006.jar
|
---|
[b26eca2] | 90 | </member>
|
---|
| 91 | </simplelist>
|
---|
| 92 | </para>
|
---|
[4378f935] | 93 | </listitem>
|
---|
[428434e7] | 94 |
|
---|
[4378f935] | 95 | <listitem>
|
---|
| 96 | <para>Download size (binary): &jdk-bin-size;</para>
|
---|
| 97 | </listitem>
|
---|
| 98 | <listitem>
|
---|
| 99 | <para>Download size (source): &jdk-src-size;</para>
|
---|
| 100 | </listitem>
|
---|
| 101 | <listitem>
|
---|
| 102 | <para>Estimated disk space required: &jdk-src-buildsize;</para>
|
---|
| 103 | </listitem>
|
---|
| 104 | <listitem>
|
---|
| 105 | <para>Estimated build time: &jdk-time;</para>
|
---|
| 106 | </listitem>
|
---|
| 107 | </itemizedlist>
|
---|
| 108 |
|
---|
| 109 | <bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
---|
| 110 |
|
---|
| 111 | <bridgehead renderas="sect4">Required Patches</bridgehead>
|
---|
| 112 | <itemizedlist spacing='compact'>
|
---|
| 113 | <listitem>
|
---|
| 114 | <para><ulink
|
---|
[d71866ba] | 115 | url="&patch-root;/jdk-&jdk-src-version;-gcc4-1.patch"/></para>
|
---|
[4378f935] | 116 | </listitem>
|
---|
| 117 | <listitem>
|
---|
[dae2ba0b] | 118 | <para><ulink
|
---|
[985c02e] | 119 | url="&patch-root;/jdk-&jdk-src-version;-motif_fixes-1.patch"/></para>
|
---|
[4378f935] | 120 | </listitem>
|
---|
| 121 | <listitem>
|
---|
| 122 | <para><ulink
|
---|
| 123 | url="&patch-root;/jdk-&jdk-src-version;-nptl-1.patch"/></para></listitem>
|
---|
| 124 | <listitem>
|
---|
[dae2ba0b] | 125 | <para><ulink
|
---|
[4378f935] | 126 | url="&patch-root;/jdk-&jdk-src-version;-remove_broken_demo-1.patch"/></para>
|
---|
| 127 | </listitem>
|
---|
| 128 | <listitem>
|
---|
| 129 | <para><ulink
|
---|
[d71866ba] | 130 | url="&patch-root;/jdk-&jdk-src-version;-remove_fixed_paths-1.patch"/></para>
|
---|
[4378f935] | 131 | </listitem>
|
---|
| 132 | </itemizedlist>
|
---|
| 133 |
|
---|
| 134 | <bridgehead renderas="sect4">Recommended Patches</bridgehead>
|
---|
| 135 | <itemizedlist spacing='compact'>
|
---|
| 136 | <listitem>
|
---|
[dae2ba0b] | 137 | <para><ulink
|
---|
[4378f935] | 138 | url="&patch-root;/jdk-&jdk-src-version;-remove_debug_image-1.patch"/>
|
---|
[bdf7e1b] | 139 | (skips compiling of the <application>JDK</application> debug image)</para>
|
---|
[4378f935] | 140 | </listitem>
|
---|
| 141 | <listitem>
|
---|
[dae2ba0b] | 142 | <para><ulink
|
---|
[4378f935] | 143 | url="&patch-root;/jdk-&jdk-src-version;-static_cxx-1.patch"/>
|
---|
[bdf7e1b] | 144 | (forces dynamic linking to <application>GCC</application> libs)</para></listitem>
|
---|
[1d61428d] | 145 | </itemizedlist>
|
---|
| 146 |
|
---|
[42a04581] | 147 | <bridgehead renderas="sect3">JDK Dependencies</bridgehead>
|
---|
[4378f935] | 148 |
|
---|
[5eaa687] | 149 | <bridgehead renderas="sect4">Required (to Build JDK from Source)</bridgehead>
|
---|
[e77976f] | 150 | <para role="required"><xref linkend="x-window-system"/>,
|
---|
[dae2ba0b] | 151 | <xref linkend="zip"/>,
|
---|
| 152 | <xref linkend="unzip"/>,
|
---|
| 153 | <xref linkend="cpio"/>,
|
---|
[12b5ece] | 154 | <xref linkend="alsa-lib"/>, and
|
---|
[4378f935] | 155 | <xref linkend="tcsh"/></para>
|
---|
| 156 |
|
---|
[1039de3] | 157 | <para condition="html" role="usernotes">User Notes:
|
---|
| 158 | <ulink url="&blfs-wiki;/jdk"/></para>
|
---|
| 159 |
|
---|
[4378f935] | 160 | </sect2>
|
---|
| 161 |
|
---|
| 162 | <sect2 role="installation">
|
---|
| 163 | <title>Installation of JDK</title>
|
---|
| 164 |
|
---|
[b26eca2] | 165 | <para>Both the binary and source built versions will be installed. You may
|
---|
| 166 | choose to keep either or both.</para>
|
---|
[4378f935] | 167 |
|
---|
[d4277d4] | 168 | <tip>
|
---|
[bc2b746] | 169 | <para>The <command>./jdk-mod.bin</command>
|
---|
[d4277d4] | 170 | command below unpacks the distribution into a
|
---|
| 171 | <filename class='directory'>jdk&jdk-bin-version;</filename> directory.
|
---|
| 172 | You will be required to view, and then accept (by entering a
|
---|
| 173 | <keycap>y</keycap> keypress), a license agreement before any files are
|
---|
| 174 | unpacked. If you are scripting (automating) the build, you'll need to
|
---|
| 175 | account for this. There is information about automating build commands
|
---|
| 176 | in the <xref linkend="automating-builds"/> section of Chapter 2. Towards
|
---|
| 177 | the end of this section, specific information for automating this type of
|
---|
| 178 | installation is discussed.</para>
|
---|
| 179 | </tip>
|
---|
| 180 |
|
---|
[b26eca2] | 181 | <para>Normally in BLFS, the files are unpacked into a subdirectory
|
---|
[6473e74] | 182 | and the starting point for the installation procedures is that
|
---|
[b26eca2] | 183 | location. For this application only, start in the directory where all
|
---|
| 184 | the downloaded files are located.</para>
|
---|
| 185 |
|
---|
[4378f935] | 186 | <para>Install the precompiled <application>JDK</application> with the
|
---|
| 187 | following commands:</para>
|
---|
| 188 |
|
---|
[b26eca2] | 189 | <screen><userinput>cp jdk-&jdk-bin-string;-linux-i?86.bin jdk-mod.bin &&
|
---|
| 190 | sed -i "s:^PATH=.*::" jdk-mod.bin &&
|
---|
| 191 | chmod -v +x jdk-mod.bin &&
|
---|
| 192 | ./jdk-mod.bin</userinput></screen>
|
---|
[2a7340c2] | 193 |
|
---|
[4378f935] | 194 | <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
|
---|
[2a7340c2] | 195 |
|
---|
[b26eca2] | 196 | <screen role="root"><userinput>cd jdk&jdk-bin-version; &&
|
---|
| 197 | install -v -d /opt/jdk/jdk-precompiled-&jdk-bin-version; &&
|
---|
[cb61e3a8] | 198 | mv -v * /opt/jdk/jdk-precompiled-&jdk-bin-version; &&
|
---|
[f86db562] | 199 | chown -v -R root:root /opt/jdk/jdk-precompiled-&jdk-bin-version; &&
|
---|
[256f9439] | 200 | ln -v -sf motif21/libmawt.so \
|
---|
[b26eca2] | 201 | /opt/jdk/jdk-precompiled-&jdk-bin-version;/jre/lib/i386/ &&
|
---|
| 202 | cd ..</userinput></screen>
|
---|
[014d11ad] | 203 |
|
---|
[4378f935] | 204 | <para>The binary version is now installed.</para>
|
---|
[014d11ad] | 205 |
|
---|
[dae2ba0b] | 206 | <para>If you don't want to compile the source or are not in a position to
|
---|
| 207 | download the source owing to license restrictions, skip ahead to the
|
---|
[4378f935] | 208 | configuration section.</para>
|
---|
[014d11ad] | 209 |
|
---|
[bccbdaea] | 210 | <para>Save the existing path, and append the recently installed
|
---|
[cb61e3a8] | 211 | <application>JDK</application>.</para>
|
---|
[014d11ad] | 212 |
|
---|
[cb61e3a8] | 213 | <screen><userinput>export JAVA_HOME=/opt/jdk/jdk-precompiled-&jdk-bin-version; &&
|
---|
| 214 | export PATH_HOLD=${PATH} &&
|
---|
| 215 | export PATH=${PATH}:${JAVA_HOME}/bin</userinput></screen>
|
---|
[014d11ad] | 216 |
|
---|
[aeaebda9] | 217 | <para>The source code is contained in self-extracting
|
---|
| 218 | <filename class='extension'>jar</filename> files. You
|
---|
[bccbdaea] | 219 | will need to be in a windowed environment to extract the sources.
|
---|
[cb61e3a8] | 220 | Create a directory to store the extracted sources. Choose the newly
|
---|
| 221 | created <filename class="directory">jdk-build</filename> directory
|
---|
| 222 | when prompted for the target directory.</para>
|
---|
[014d11ad] | 223 |
|
---|
[4378f935] | 224 | <screen><userinput>mkdir jdk-build &&
|
---|
[5f0bab7] | 225 | cd jdk-build &&
|
---|
[cb61e3a8] | 226 | for JAR in ../jdk-&jdk-src-string;*.jar
|
---|
| 227 | do java -jar ${JAR}
|
---|
| 228 | done</userinput></screen>
|
---|
[014d11ad] | 229 |
|
---|
[b89c7ca] | 230 | <para>Apply all the patches downloaded above:</para>
|
---|
[014d11ad] | 231 |
|
---|
[4378f935] | 232 | <screen><userinput>for PATCH in ../jdk-&jdk-src-version;*.patch
|
---|
[5f0bab7] | 233 | do patch -Np1 -i ${PATCH}
|
---|
[4378f935] | 234 | done</userinput></screen>
|
---|
[014d11ad] | 235 |
|
---|
[dc19fbff] | 236 | <para>If your <application>X Window System</application> is installed into
|
---|
| 237 | any prefix other than <filename class="directory">/usr/X11R6</filename>,
|
---|
| 238 | execute the following command, replacing
|
---|
| 239 | <replaceable><PREFIX></replaceable> with the installation prefix of
|
---|
| 240 | the <application>X Window System</application>:</para>
|
---|
[985c02e] | 241 |
|
---|
[dc19fbff] | 242 | <screen><userinput>find . -type f -exec sed -i 's@/usr/X11R6@<replaceable><PREFIX></replaceable>@g' {} \;</userinput></screen>
|
---|
[985c02e] | 243 |
|
---|
[4378f935] | 244 | <para>Set/unset some variables which affect the build:</para>
|
---|
[2a7340c2] | 245 |
|
---|
[bc2b746] | 246 | <screen><userinput>export ALT_BOOTDIR=${JAVA_HOME} &&
|
---|
| 247 | export CLASSPATH_HOLD=${CLASSPATH} &&
|
---|
| 248 | unset JAVA_HOME CLASSPATH CFLAGS CXXFLAGS LDFLAGS &&
|
---|
[52d29f7] | 249 | export ALT_DEVTOOLS_PATH="/usr/bin" &&
|
---|
[da18e2f] | 250 | export BUILD_NUMBER="update-8" &&
|
---|
[52d29f7] | 251 | export DEV_ONLY=true &&
|
---|
[bc2b746] | 252 | export ALT_MOZILLA_HEADERS_PATH=${PWD}/share/plugin/ &&
|
---|
[52d29f7] | 253 | export INSANE=true &&
|
---|
| 254 | export MAKE_VERBOSE=true &&
|
---|
[4378f935] | 255 | export ALT_CACERTS_FILE=${ALT_BOOTDIR}/jre/lib/security/cacerts</userinput></screen>
|
---|
[014d11ad] | 256 |
|
---|
[4378f935] | 257 | <warning>
|
---|
[dae2ba0b] | 258 | <para>Setting CFLAGS/CXXFLAGS/LDFLAGS is guaranteed to make the build
|
---|
[bccbdaea] | 259 | fail. If you are interested in optimizing the build, set
|
---|
| 260 | OTHER_CFLAGS/OTHER_CXXFLAGS/OTHER_LDFLAGS instead. -O3, even in
|
---|
[0b584261] | 261 | OTHER_C{,XX}FLAGS, is known to cause a build failure.</para>
|
---|
[4378f935] | 262 | </warning>
|
---|
[014d11ad] | 263 |
|
---|
[40d6bab] | 264 | <para>Additionally, if you would like to <command>make</command> in
|
---|
| 265 | parallel, add the following:</para>
|
---|
[2a7340c2] | 266 |
|
---|
[1039de3] | 267 | <screen><userinput>export HOTSPOT_BUILD_JOBS=<replaceable><3></replaceable></userinput></screen>
|
---|
[014d11ad] | 268 |
|
---|
[4378f935] | 269 | <para>Build the <application>JDK</application> with the following
|
---|
| 270 | commands. There will be a lot of messages about missing files that look like
|
---|
[bdf7e1b] | 271 | errors. These are caused by not meeting the expected build environment
|
---|
[dae2ba0b] | 272 | (Red Hat). As long as the build doesn't stop, the messages
|
---|
[4378f935] | 273 | are harmless.</para>
|
---|
[014d11ad] | 274 |
|
---|
[4378f935] | 275 | <screen><userinput>cd control/make &&
|
---|
[52d29f7] | 276 | make &&
|
---|
[4378f935] | 277 | cd ../build/linux-i?86</userinput></screen>
|
---|
[2a7340c2] | 278 |
|
---|
[aeaebda9] | 279 | <para>To test the results, you can run one of the provided demo programs
|
---|
| 280 | using the newly created <command>java</command> binary. Issue the
|
---|
| 281 | following commands:</para>
|
---|
| 282 |
|
---|
| 283 | <screen><userinput>cd j2sdk-image/demo/jfc/Java2D &&
|
---|
| 284 | ../../../bin/java -jar Java2Demo.jar &&
|
---|
| 285 | cd ../../../..</userinput></screen>
|
---|
| 286 |
|
---|
[dae2ba0b] | 287 | <para>Now, as the <systemitem class="username">root</systemitem> user,
|
---|
[4378f935] | 288 | install the <application>JDK</application>:</para>
|
---|
[2a7340c2] | 289 |
|
---|
[4378f935] | 290 | <screen role="root"><userinput>cp -v -a j2sdk-image /opt/jdk/jdk-&jdk-src-version; &&
|
---|
[61e058b] | 291 | chown -v -R root:root /opt/jdk/jdk-&jdk-src-version; &&
|
---|
[bc2b746] | 292 | ln -v -sf motif21/libmawt.so /opt/jdk/jdk-&jdk-src-version;/jre/lib/i386/</userinput></screen>
|
---|
[2a7340c2] | 293 |
|
---|
[40d6bab] | 294 | <para>Restore the unprivileged user's environment using the following
|
---|
| 295 | commands:</para>
|
---|
[2a7340c2] | 296 |
|
---|
[bc2b746] | 297 | <screen><userinput>export JAVA_HOME=${ALT_BOOTDIR} &&
|
---|
| 298 | export CLASSPATH=${CLASSPATH_HOLD} &&
|
---|
[cb61e3a8] | 299 | export PATH=${PATH_HOLD} &&
|
---|
[bc2b746] | 300 | unset ALT_BOOTDIR CLASSPATH_HOLD ALT_DEVTOOLS_PATH BUILD_NUMBER &&
|
---|
| 301 | unset DEV_ONLY ALT_MOZILLA_HEADERS_PATH INSANE MAKE_VERBOSE &&
|
---|
| 302 | unset ALT_CACERTS_FILE PATH_HOLD</userinput></screen>
|
---|
[014d11ad] | 303 |
|
---|
[4378f935] | 304 | </sect2>
|
---|
[52d29f7] | 305 |
|
---|
[4378f935] | 306 | <sect2 role="commands">
|
---|
| 307 | <title>Command Explanations</title>
|
---|
[014d11ad] | 308 |
|
---|
[bc2b746] | 309 | <para><command>export ALT_BOOTDIR=${JAVA_HOME}</command>: This variable sets
|
---|
[4378f935] | 310 | the location of the bootstrap <application>JDK</application>.</para>
|
---|
[014d11ad] | 311 |
|
---|
[bc2b746] | 312 | <para><command>export ALT_MOZILLA_HEADERS_PATH=${PWD}/share/plugin/</command>:
|
---|
[cb61e3a8] | 313 | This tells the build exactly where to find the
|
---|
[bccbdaea] | 314 | <application>Mozilla</application> headers. This has changed since the
|
---|
| 315 | previous version and is not mentioned in the installation documentation
|
---|
[cb61e3a8] | 316 | included with the package source.</para>
|
---|
[014d11ad] | 317 |
|
---|
[4378f935] | 318 | <para><command>export ALT_DEVTOOLS_PATH="/usr/bin"</command>: This
|
---|
| 319 | changes the location where the build finds the needed executables.</para>
|
---|
[014d11ad] | 320 |
|
---|
[da18e2f] | 321 | <para><command>export BUILD_NUMBER="update-8"</command>:
|
---|
[dae2ba0b] | 322 | This will help you identify the compiled version of the runtime environment
|
---|
| 323 | and virtual machine by appending this information to the version
|
---|
[4378f935] | 324 | string.</para>
|
---|
[014d11ad] | 325 |
|
---|
[4378f935] | 326 | <para><command>export DEV_ONLY=true</command>: This command
|
---|
| 327 | skips compiling the documentation and eliminates a dependency on
|
---|
| 328 | <application>rpm</application>.</para>
|
---|
[014d11ad] | 329 |
|
---|
[bc2b746] | 330 | <para><command>unset JAVA_HOME CLASSPATH CFLAGS CXXFLAGS LDFLAGS</command>:
|
---|
| 331 | These variables cause miscompilation of the build. Never set them.</para>
|
---|
[014d11ad] | 332 |
|
---|
[dae2ba0b] | 333 | <para><command>export INSANE=true</command>: The certified platform for the
|
---|
| 334 | build is Redhat Enterprise Advanced Server 2.1. This variable ensures that
|
---|
| 335 | all the errors related to compiling on a non-certified platform will be
|
---|
[4378f935] | 336 | displayed as warnings instead of errors.</para>
|
---|
[014d11ad] | 337 |
|
---|
[dae2ba0b] | 338 | <para><command>export MAKE_VERBOSE=true</command>: Allows the compiler
|
---|
[4378f935] | 339 | commands to be displayed on the console.</para>
|
---|
[014d11ad] | 340 |
|
---|
[4378f935] | 341 | <para><command>export ALT_CACERTS_FILE...</command>: Specifies the
|
---|
[dae2ba0b] | 342 | certificate file to use (from the installed binary
|
---|
[4378f935] | 343 | <application>JDK</application>).</para>
|
---|
[014d11ad] | 344 |
|
---|
[bccbdaea] | 345 | <para><command>ln -sf motif21/libmawt.so
|
---|
| 346 | /opt/jdk/jdk-&jdk-src-version;/jre/lib/i386/</command>: This fixes
|
---|
| 347 | linking issues with other applications that expect to find the
|
---|
| 348 | <application>motif</application> libraries with the other
|
---|
[6dd0164] | 349 | <application>JDK</application> libraries.</para>
|
---|
[61e058b] | 350 |
|
---|
[4378f935] | 351 | </sect2>
|
---|
[52d29f7] | 352 |
|
---|
[4378f935] | 353 | <sect2 role="configuration">
|
---|
| 354 | <title>Configuring JDK</title>
|
---|
[014d11ad] | 355 |
|
---|
[4378f935] | 356 | <sect3>
|
---|
| 357 | <title>Configuration Information</title>
|
---|
[014d11ad] | 358 |
|
---|
[bdf7e1b] | 359 | <para>There are now two Java 2 SDKs installed in
|
---|
[4378f935] | 360 | <filename>/opt/jdk</filename>. You should decide on which one you
|
---|
[bccbdaea] | 361 | would like to use as the default. For example if you decide to use the
|
---|
[cb61e3a8] | 362 | source compiled <application>JDK</application>, do the following as the
|
---|
[ceafb03e] | 363 | <systemitem class="username">root</systemitem> user:</para>
|
---|
[014d11ad] | 364 |
|
---|
[8a64f4b] | 365 | <screen role="root"><userinput>ln -v -nsf jdk-&jdk-src-version; /opt/jdk/jdk</userinput></screen>
|
---|
[014d11ad] | 366 |
|
---|
[4378f935] | 367 | <para>Add the following <filename>jdk.sh</filename> shell startup file to
|
---|
[dae2ba0b] | 368 | the <filename>/etc/profile.d</filename> directory with the following
|
---|
[ceafb03e] | 369 | commands as the <systemitem class="username">root</systemitem> user:</para>
|
---|
[014d11ad] | 370 |
|
---|
[8a64f4b] | 371 | <screen role="root"><userinput>cat > /etc/profile.d/jdk.sh << "EOF"
|
---|
[4378f935] | 372 | <literal># Begin /etc/profile.d/jdk.sh
|
---|
[014d11ad] | 373 |
|
---|
[5f0bab7] | 374 | # Set JAVA_HOME directory
|
---|
| 375 | JAVA_HOME=/opt/jdk/jdk
|
---|
| 376 | export JAVA_HOME
|
---|
[014d11ad] | 377 |
|
---|
[92b34a8] | 378 | # Adjust PATH
|
---|
[5f0bab7] | 379 | pathappend ${JAVA_HOME}/bin PATH
|
---|
[014d11ad] | 380 |
|
---|
[5f0bab7] | 381 | # Auto Java Classpath Updating
|
---|
| 382 | # Create symlinks to this directory for auto classpath setting
|
---|
| 383 | AUTO_CLASSPATH_DIR=/usr/lib/classpath
|
---|
| 384 | if [ -z ${CLASSPATH} ]; then
|
---|
[256ee72c] | 385 | CLASSPATH=.:${AUTO_CLASSPATH_DIR}
|
---|
[5f0bab7] | 386 | else
|
---|
[256ee72c] | 387 | CLASSPATH="${CLASSPATH}:.:${AUTO_CLASSPATH_DIR}"
|
---|
[5f0bab7] | 388 | fi
|
---|
[014d11ad] | 389 |
|
---|
[92b34a8] | 390 | # Check for empty AUTO_CLASSPATH_DIR
|
---|
| 391 | ls ${AUTO_CLASSPATH_DIR}/*.jar &> /dev/null &&
|
---|
| 392 | for i in ${AUTO_CLASSPATH_DIR}/*.jar
|
---|
[256ee72c] | 393 | do CLASSPATH=${CLASSPATH}:"${i}"
|
---|
[5f0bab7] | 394 | done
|
---|
[92b34a8] | 395 | export CLASSPATH
|
---|
[014d11ad] | 396 |
|
---|
[4378f935] | 397 | # End /etc/profile.d/jdk.sh</literal>
|
---|
| 398 | EOF</userinput></screen>
|
---|
| 399 |
|
---|
[40d6bab] | 400 | <para>The <application>Java</application> plugin is located in
|
---|
[4378f935] | 401 | <filename class="directory">$JAVA_HOME/jre/plugin/i?86/ns7/</filename>.
|
---|
[40d6bab] | 402 | Make a symbolic link to the file in that directory from your browser(s)
|
---|
[4378f935] | 403 | plugins directory.</para>
|
---|
| 404 |
|
---|
[40d6bab] | 405 | <important>
|
---|
[4378f935] | 406 | <para>The plugin must be a symlink for it to work. If not, the browsers
|
---|
[40d6bab] | 407 | will crash when you attempt to load a <application>Java</application>
|
---|
[4378f935] | 408 | application.</para>
|
---|
[40d6bab] | 409 | </important>
|
---|
[4378f935] | 410 |
|
---|
| 411 | </sect3>
|
---|
| 412 |
|
---|
| 413 | </sect2>
|
---|
| 414 |
|
---|
| 415 | <sect2 role="content">
|
---|
| 416 | <title>Contents</title>
|
---|
| 417 |
|
---|
| 418 | <segmentedlist>
|
---|
| 419 | <segtitle>Installed Programs</segtitle>
|
---|
| 420 | <segtitle>Installed Libraries</segtitle>
|
---|
| 421 | <segtitle>Installed Directory</segtitle>
|
---|
| 422 |
|
---|
| 423 | <seglistitem>
|
---|
[bccbdaea] | 424 | <seg>appletviewer, extcheck, idlj, jar, jarsigner, java, javac,
|
---|
| 425 | javadoc,javah, javap, javaws, jdb, keytool, native2ascii, orbd,
|
---|
| 426 | policytool, rmic, rmid, rmiregistry, serialver, servertool, and
|
---|
[cb61e3a8] | 427 | tnameserv</seg>
|
---|
[bccbdaea] | 428 | <seg><envar>$JAVA_HOME</envar>/lib/*,
|
---|
[cb61e3a8] | 429 | <envar>$JAVA_HOME</envar>/jre/lib/*,
|
---|
[4378f935] | 430 | and libjavaplugin_oji.so</seg>
|
---|
| 431 | <seg>/opt/jdk</seg>
|
---|
| 432 | </seglistitem>
|
---|
| 433 | </segmentedlist>
|
---|
| 434 |
|
---|
| 435 | <variablelist>
|
---|
| 436 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 437 | <?dbfo list-presentation="list"?>
|
---|
| 438 | <?dbhtml list-presentation="table"?>
|
---|
| 439 |
|
---|
| 440 | <varlistentry id="appletviewer">
|
---|
| 441 | <term><command>appletviewer</command></term>
|
---|
| 442 | <listitem>
|
---|
[dae2ba0b] | 443 | <para>runs <application>Java</application> applets outside of the
|
---|
[4378f935] | 444 | context of a browser.</para>
|
---|
| 445 | <indexterm zone="jdk appletviewer">
|
---|
| 446 | <primary sortas="b-appletviewer">appletviewer</primary>
|
---|
| 447 | </indexterm>
|
---|
| 448 | </listitem>
|
---|
| 449 | </varlistentry>
|
---|
| 450 |
|
---|
| 451 | <varlistentry id="extcheck">
|
---|
| 452 | <term><command>extcheck</command></term>
|
---|
| 453 | <listitem>
|
---|
[dae2ba0b] | 454 | <para>checks a specified <filename>JAR</filename> file for title
|
---|
| 455 | and version conflicts with any extensions installed in the
|
---|
[4378f935] | 456 | <application>JDK</application> software.</para>
|
---|
| 457 | <indexterm zone="jdk extcheck">
|
---|
| 458 | <primary sortas="b-extcheck">extcheck</primary>
|
---|
| 459 | </indexterm>
|
---|
| 460 | </listitem>
|
---|
| 461 | </varlistentry>
|
---|
| 462 |
|
---|
| 463 | <varlistentry id="idlj">
|
---|
| 464 | <term><command>idlj</command></term>
|
---|
| 465 | <listitem>
|
---|
[dae2ba0b] | 466 | <para>generates <application>Java</application> bindings from a
|
---|
[4378f935] | 467 | given IDL file.</para>
|
---|
| 468 | <indexterm zone="jdk idlj">
|
---|
| 469 | <primary sortas="b-idlj">idlj</primary>
|
---|
| 470 | </indexterm>
|
---|
| 471 | </listitem>
|
---|
[0619e6d] | 472 | </varlistentry>
|
---|
[4378f935] | 473 |
|
---|
| 474 | <varlistentry id="jar">
|
---|
| 475 | <term><command>jar</command></term>
|
---|
| 476 | <listitem>
|
---|
[0619e6d] | 477 | <para>combines multiple files into a single <filename>JAR</filename>
|
---|
[4378f935] | 478 | archive file.</para>
|
---|
| 479 | <indexterm zone="jdk jar">
|
---|
| 480 | <primary sortas="b-jar">jar</primary>
|
---|
| 481 | </indexterm>
|
---|
| 482 | </listitem>
|
---|
| 483 | </varlistentry>
|
---|
| 484 |
|
---|
| 485 | <varlistentry id="jarsigner">
|
---|
| 486 | <term><command>jarsigner</command></term>
|
---|
| 487 | <listitem>
|
---|
[dae2ba0b] | 488 | <para>signs <filename>JAR</filename> (Java ARchive) files and verifies the
|
---|
[4378f935] | 489 | signatures and integrity of a signed <filename>JAR</filename>.</para>
|
---|
| 490 | <indexterm zone="jdk jarsigner">
|
---|
| 491 | <primary sortas="b-jarsigner">jarsigner</primary>
|
---|
| 492 | </indexterm>
|
---|
| 493 | </listitem>
|
---|
| 494 | </varlistentry>
|
---|
| 495 |
|
---|
| 496 | <varlistentry id="java">
|
---|
| 497 | <term><command>java</command></term>
|
---|
| 498 | <listitem>
|
---|
[dae2ba0b] | 499 | <para>launches a <application>Java</application> application by
|
---|
| 500 | starting a <application>Java</application> runtime environment, loading a
|
---|
[4378f935] | 501 | specified class and invoking its main method.</para>
|
---|
| 502 | <indexterm zone="jdk java">
|
---|
| 503 | <primary sortas="b-java">java</primary>
|
---|
| 504 | </indexterm>
|
---|
| 505 | </listitem>
|
---|
| 506 | </varlistentry>
|
---|
| 507 |
|
---|
| 508 | <varlistentry id="javac">
|
---|
| 509 | <term><command>javac</command></term>
|
---|
| 510 | <listitem>
|
---|
[dae2ba0b] | 511 | <para>reads class and interface definitions, written in the
|
---|
| 512 | <application>Java</application> programming language, and compiles
|
---|
[4378f935] | 513 | them into bytecode class files.</para>
|
---|
| 514 | <indexterm zone="jdk javac">
|
---|
| 515 | <primary sortas="b-javac">javac</primary>
|
---|
| 516 | </indexterm>
|
---|
| 517 | </listitem>
|
---|
| 518 | </varlistentry>
|
---|
| 519 |
|
---|
| 520 | <varlistentry id="javadoc">
|
---|
| 521 | <term><command>javadoc</command></term>
|
---|
| 522 | <listitem>
|
---|
[dae2ba0b] | 523 | <para>parses the declarations and documentation comments in a set of
|
---|
| 524 | <application>Java</application> source files and produces a corresponding
|
---|
| 525 | set of HTML pages describing the classes, interfaces,
|
---|
[4378f935] | 526 | constructors, methods, and fields.</para>
|
---|
| 527 | <indexterm zone="jdk javadoc">
|
---|
| 528 | <primary sortas="b-javadoc">javadoc</primary>
|
---|
| 529 | </indexterm>
|
---|
| 530 | </listitem>
|
---|
| 531 | </varlistentry>
|
---|
| 532 |
|
---|
| 533 | <varlistentry id="javah">
|
---|
| 534 | <term><command>javah</command></term>
|
---|
| 535 | <listitem>
|
---|
[dae2ba0b] | 536 | <para>generates <application>C</application> header and source files
|
---|
[4378f935] | 537 | that are needed to implement native methods.</para>
|
---|
| 538 | <indexterm zone="jdk javah">
|
---|
| 539 | <primary sortas="b-javah">javah</primary>
|
---|
| 540 | </indexterm>
|
---|
| 541 | </listitem>
|
---|
| 542 | </varlistentry>
|
---|
| 543 |
|
---|
| 544 | <varlistentry id="javap">
|
---|
| 545 | <term><command>javap</command></term>
|
---|
| 546 | <listitem>
|
---|
| 547 | <para>disassembles a <application>Java</application> class file.</para>
|
---|
| 548 | <indexterm zone="jdk javap">
|
---|
| 549 | <primary sortas="b-javap">javap</primary>
|
---|
| 550 | </indexterm>
|
---|
| 551 | </listitem>
|
---|
| 552 | </varlistentry>
|
---|
| 553 |
|
---|
| 554 | <varlistentry id="javaws">
|
---|
| 555 | <term><command>javaws</command></term>
|
---|
| 556 | <listitem>
|
---|
[dae2ba0b] | 557 | <para>launches <application>Java </application>application/applets
|
---|
[4378f935] | 558 | hosted on a network.</para>
|
---|
| 559 | <indexterm zone="jdk javaws">
|
---|
| 560 | <primary sortas="b-javaws">javaws</primary>
|
---|
| 561 | </indexterm>
|
---|
| 562 | </listitem>
|
---|
| 563 | </varlistentry>
|
---|
| 564 |
|
---|
| 565 | <varlistentry id="jdb">
|
---|
| 566 | <term><command>jdb</command></term>
|
---|
| 567 | <listitem>
|
---|
[dae2ba0b] | 568 | <para>is a simple command-line debugger for
|
---|
[4378f935] | 569 | <application>Java</application> classes.</para>
|
---|
| 570 | <indexterm zone="jdk jdb">
|
---|
| 571 | <primary sortas="b-jdb">jdb</primary>
|
---|
| 572 | </indexterm>
|
---|
| 573 | </listitem>
|
---|
| 574 | </varlistentry>
|
---|
| 575 |
|
---|
| 576 | <varlistentry id="keytool">
|
---|
| 577 | <term><command>keytool</command></term>
|
---|
| 578 | <listitem>
|
---|
| 579 | <para>is a key and certificate management utility.</para>
|
---|
| 580 | <indexterm zone="jdk keytool">
|
---|
| 581 | <primary sortas="b-keytool">keytool</primary>
|
---|
| 582 | </indexterm>
|
---|
| 583 | </listitem>
|
---|
| 584 | </varlistentry>
|
---|
| 585 |
|
---|
| 586 | <varlistentry id="native2ascii">
|
---|
| 587 | <term><command>native2ascii</command></term>
|
---|
| 588 | <listitem>
|
---|
[dae2ba0b] | 589 | <para> converts files that contain non-supported character encoding
|
---|
[4378f935] | 590 | into files containing Latin-1 or Unicode-encoded characters.</para>
|
---|
| 591 | <indexterm zone="jdk native2ascii">
|
---|
| 592 | <primary sortas="b-native2ascii">native2ascii</primary>
|
---|
| 593 | </indexterm>
|
---|
| 594 | </listitem>
|
---|
| 595 | </varlistentry>
|
---|
| 596 |
|
---|
| 597 | <varlistentry id="orbd">
|
---|
| 598 | <term><command>orbd</command></term>
|
---|
| 599 | <listitem>
|
---|
[dae2ba0b] | 600 | <para>is used to enable clients to transparently locate and invoke
|
---|
[4378f935] | 601 | persistent objects on servers in the CORBA environment.</para>
|
---|
| 602 | <indexterm zone="jdk orbd">
|
---|
| 603 | <primary sortas="b-orbd">orbd</primary>
|
---|
| 604 | </indexterm>
|
---|
| 605 | </listitem>
|
---|
| 606 | </varlistentry>
|
---|
| 607 |
|
---|
| 608 | <varlistentry id="policytool">
|
---|
| 609 | <term><command>policytool</command></term>
|
---|
| 610 | <listitem>
|
---|
| 611 | <para>creates and manages a policy file graphically.</para>
|
---|
| 612 | <indexterm zone="jdk policytool">
|
---|
| 613 | <primary sortas="b-policytool">policytool</primary>
|
---|
| 614 | </indexterm>
|
---|
| 615 | </listitem>
|
---|
| 616 | </varlistentry>
|
---|
| 617 |
|
---|
| 618 | <varlistentry id="rmic">
|
---|
| 619 | <term><command>rmic</command></term>
|
---|
| 620 | <listitem>
|
---|
[dae2ba0b] | 621 | <para>generates stub and skeleton class files for remote objects
|
---|
| 622 | from the names of compiled <application>Java</application> classes that
|
---|
[4378f935] | 623 | contain remote object implementations.</para>
|
---|
| 624 | <indexterm zone="jdk rmic">
|
---|
| 625 | <primary sortas="b-rmic">rmic</primary>
|
---|
| 626 | </indexterm>
|
---|
| 627 | </listitem>
|
---|
| 628 | </varlistentry>
|
---|
| 629 |
|
---|
| 630 | <varlistentry id="rmid">
|
---|
| 631 | <term><command>rmid</command></term>
|
---|
| 632 | <listitem>
|
---|
| 633 | <para>starts the activation system daemon.</para>
|
---|
| 634 | <indexterm zone="jdk rmid">
|
---|
| 635 | <primary sortas="b-rmid">rmid</primary>
|
---|
| 636 | </indexterm>
|
---|
| 637 | </listitem>
|
---|
| 638 | </varlistentry>
|
---|
| 639 |
|
---|
| 640 | <varlistentry id="rmiregistry">
|
---|
| 641 | <term><command>rmiregistry</command></term>
|
---|
| 642 | <listitem>
|
---|
[dae2ba0b] | 643 | <para>creates and starts a remote object registry on the specified
|
---|
[4378f935] | 644 | port on the current host.</para>
|
---|
| 645 | <indexterm zone="jdk rmiregistry">
|
---|
| 646 | <primary sortas="b-rmiregistry">rmiregistry</primary>
|
---|
| 647 | </indexterm>
|
---|
| 648 | </listitem>
|
---|
| 649 | </varlistentry>
|
---|
| 650 |
|
---|
| 651 | <varlistentry id="serialver">
|
---|
| 652 | <term><command>serialver</command></term>
|
---|
| 653 | <listitem>
|
---|
[dae2ba0b] | 654 | <para>returns the serialVersionUID for one or more classes in a
|
---|
[4378f935] | 655 | form suitable for copying into an evolving class.</para>
|
---|
| 656 | <indexterm zone="jdk serialver">
|
---|
| 657 | <primary sortas="b-serialver">serialver</primary>
|
---|
| 658 | </indexterm>
|
---|
| 659 | </listitem>
|
---|
| 660 | </varlistentry>
|
---|
| 661 |
|
---|
| 662 | <varlistentry id="servertool">
|
---|
| 663 | <term><command>servertool</command></term>
|
---|
| 664 | <listitem>
|
---|
[dae2ba0b] | 665 | <para>provides an ease-of-use interface for application programmers
|
---|
[4378f935] | 666 | to register, unregister, startup and shutdown a server.</para>
|
---|
| 667 | <indexterm zone="jdk servertool">
|
---|
| 668 | <primary sortas="b-servertool">servertool</primary>
|
---|
| 669 | </indexterm>
|
---|
| 670 | </listitem>
|
---|
| 671 | </varlistentry>
|
---|
| 672 |
|
---|
| 673 | <varlistentry id="tnameserv">
|
---|
| 674 | <term><command>tnameserv</command></term>
|
---|
| 675 | <listitem>
|
---|
| 676 | <para>starts the <application>Java</application> IDL name server.</para>
|
---|
| 677 | <indexterm zone="jdk tnameserv">
|
---|
| 678 | <primary sortas="b-tnameserv">tnameserv</primary>
|
---|
| 679 | </indexterm>
|
---|
| 680 | </listitem>
|
---|
| 681 | </varlistentry>
|
---|
| 682 |
|
---|
| 683 | </variablelist>
|
---|
| 684 |
|
---|
| 685 | </sect2>
|
---|
[74c1100] | 686 |
|
---|
| 687 | </sect1>
|
---|