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