| 1 | <?xml version="1.0" encoding="UTF-8"?> |
1 | <?xml version="1.0" encoding="UTF-8"?> |
| 2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.43 2009/09/16 15:26:43 nightmorph Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.44 2009/10/07 18:14:31 nightmorph Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | |
4 | |
| 5 | <guide link="/doc/en/java.xml"> |
5 | <guide link="/doc/en/java.xml"> |
| 6 | <title>Gentoo Java Guide</title> |
6 | <title>Gentoo Java Guide</title> |
| 7 | |
7 | |
| … | |
… | |
| 22 | |
22 | |
| 23 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
23 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 24 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
24 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 25 | <license/> |
25 | <license/> |
| 26 | |
26 | |
| 27 | <version>0.18</version> |
27 | <version>0.19</version> |
| 28 | <date>2009-09-16</date> |
28 | <date>2009-10-07</date> |
| 29 | |
29 | |
| 30 | <chapter> |
30 | <chapter> |
| 31 | <title>What is Java?</title> |
31 | <title>What is Java?</title> |
| 32 | <section> |
32 | <section> |
| 33 | <title>Overview</title> |
33 | <title>Overview</title> |
| … | |
… | |
| 124 | TODO: list free implementations? |
124 | TODO: list free implementations? |
| 125 | note about not drop-in replacements |
125 | note about not drop-in replacements |
| 126 | kaffe/sablevm/gcj/jamvm |
126 | kaffe/sablevm/gcj/jamvm |
| 127 | --> |
127 | --> |
| 128 | <p> |
128 | <p> |
| 129 | The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely |
129 | The default for Java 1.6 is the Sun JRE/JDK pair. |
| 130 | ("free as in beer") available without any registration fuss. |
|
|
| 131 | </p> |
|
|
| 132 | |
|
|
| 133 | <p> |
|
|
| 134 | JREs and JDKs from Sun, IBM, and BEA are generally faster, but getting them |
|
|
| 135 | is a bit more work, as you are required to read and accept their license before |
|
|
| 136 | downloading (IBM additionally requires you to register). |
|
|
| 137 | </p> |
130 | </p> |
| 138 | |
131 | |
| 139 | </body> |
132 | </body> |
| 140 | </section> |
133 | </section> |
| 141 | <section> |
134 | <section> |
| … | |
… | |
| 163 | <section> |
156 | <section> |
| 164 | <title>Installing fetch-restricted virtual machines</title> |
157 | <title>Installing fetch-restricted virtual machines</title> |
| 165 | <body> |
158 | <body> |
| 166 | |
159 | |
| 167 | <p> |
160 | <p> |
| 168 | As already mentioned, some of the JDKs and JREs require you to jump through a |
161 | Some of the JDKs and JREs require you to jump through a few hoops before |
| 169 | few hoops before installing. Simply emerge the packages as you normally would. |
162 | installing. Simply emerge the packages as you normally would. The ebuilds will |
| 170 | The ebuilds will then instruct you where to go and what to download. |
163 | then instruct you where to go and what to download. |
| 171 | </p> |
164 | </p> |
| 172 | |
165 | |
| 173 | <p> |
166 | <p> |
| 174 | You should download the indicated file(s) into |
167 | You should download the indicated file(s) into |
| 175 | <path>/usr/portage/distfiles</path>. Once there, you can rerun the emerge |
168 | <path>/usr/portage/distfiles</path>. Once there, you can rerun the emerge |
| … | |
… | |
| 510 | plugins by running: |
503 | plugins by running: |
| 511 | </p> |
504 | </p> |
| 512 | |
505 | |
| 513 | <pre caption="Viewing available plugins"> |
506 | <pre caption="Viewing available plugins"> |
| 514 | # <i>eselect java-nsplugin list</i> |
507 | # <i>eselect java-nsplugin list</i> |
| 515 | [1] sun-jre-bin-1.5 |
508 | [1] sun-jre-bin-1.6 |
| 516 | [2] blackdown-jre-1.4.2 |
509 | [2] icedtea6-bin |
| 517 | </pre> |
510 | </pre> |
| 518 | |
511 | |
| 519 | <p> |
512 | <p> |
| 520 | In this example, <c>sun-jre-bin</c> is selected for the browser plugin. |
513 | In this example, <c>sun-jre-bin</c> is selected for the browser plugin. |
| 521 | </p> |
514 | </p> |
| 522 | |
515 | |
| 523 | <pre caption="Selecting a plugin"> |
516 | <pre caption="Selecting a plugin"> |
| 524 | # <i>eselect java-nsplugin set sun-jre-bin-1.5</i> |
517 | # <i>eselect java-nsplugin set sun-jre-bin-1.6</i> |
| 525 | </pre> |
518 | </pre> |
| 526 | |
519 | |
| 527 | <p> |
520 | <p> |
| 528 | Verify that the correct plugin was selected: |
521 | Verify that the correct plugin was selected: |
| 529 | </p> |
522 | </p> |
| 530 | |
523 | |
| 531 | <pre caption="Verifying the correct plugin"> |
524 | <pre caption="Verifying the correct plugin"> |
| 532 | # <i>eselect java-nsplugin list</i> |
525 | # <i>eselect java-nsplugin list</i> |
| 533 | [1] sun-jre-bin-1.5 current |
526 | [1] sun-jre-bin-1.6 current |
| 534 | [2] blackdown-jre-1.4.2 |
527 | [2] icedtea6-bin |
| 535 | </pre> |
528 | </pre> |
| 536 | |
529 | |
| 537 | <p> |
530 | <p> |
| 538 | Java.com also provides a link to <uri |
531 | Java.com also provides a link to <uri |
| 539 | link="http://java.com/en/download/installed.jsp">verify your installed |
532 | link="http://java.com/en/download/installed.jsp">verify your installed |
| … | |
… | |
| 547 | <title>Plugins on multilib systems</title> |
540 | <title>Plugins on multilib systems</title> |
| 548 | <body> |
541 | <body> |
| 549 | |
542 | |
| 550 | <p> |
543 | <p> |
| 551 | If you are running a mixed 64-bit and 32-bit multilib system (for example, on |
544 | If you are running a mixed 64-bit and 32-bit multilib system (for example, on |
| 552 | AMD64), you can only use 32-bit Java plugins. |
545 | AMD64), you can use 64-bit and 32-bit Java plugins. Unless you have a pressing |
| 553 | </p> |
546 | need to run 32-bit Java applications, we recommend using native 64-bit plugins |
| 554 | |
547 | on 64-bit web browsers. |
| 555 | <p> |
548 | </p> |
| 556 | To use a 32-bit plugin, you will need to emerge <c>emul-linux-x86-java</c> with |
549 | |
|
|
550 | <p> |
|
|
551 | There are several native 64-bit browser plugins available. The default JDK/JRE |
|
|
552 | pair, <c>sun-jdk</c> and <c>sun-jre-bin</c>, both include browser plugins. Just |
| 557 | the <c>nsplugin</c> USE flag enabled. |
553 | emerge one of them with the <c>nsplugin</c> USE flag enabled. |
|
|
554 | </p> |
|
|
555 | |
|
|
556 | <pre caption="Installing a 64-bit plugin"> |
|
|
557 | # <i>echo "dev-java/sun-jre-bin nsplugin" >> /etc/portage/package.use</i> |
|
|
558 | # <i>emerge sun-jre-bin</i> |
|
|
559 | </pre> |
|
|
560 | |
|
|
561 | <p> |
|
|
562 | To use a 32-bit plugin on a 32-bit browser, you will need to emerge |
|
|
563 | <c>emul-linux-x86-java</c> with the <c>nsplugin</c> USE flag enabled. |
| 558 | </p> |
564 | </p> |
| 559 | |
565 | |
| 560 | <pre caption="Installing a 32-bit plugin"> |
566 | <pre caption="Installing a 32-bit plugin"> |
| 561 | # <i>echo "app-emulation/emul-linux-x86-java nsplugin" >> /etc/portage/package.use</i> |
567 | # <i>echo "app-emulation/emul-linux-x86-java nsplugin" >> /etc/portage/package.use</i> |
| 562 | # <i>emerge emul-linux-x86-java</i> |
568 | # <i>emerge emul-linux-x86-java</i> |
| … | |
… | |
| 567 | </p> |
573 | </p> |
| 568 | |
574 | |
| 569 | <pre caption="Viewing available plugins"> |
575 | <pre caption="Viewing available plugins"> |
| 570 | # <i>eselect java-nsplugin list</i> |
576 | # <i>eselect java-nsplugin list</i> |
| 571 | Available 32-bit Java browser plugins |
577 | Available 32-bit Java browser plugins |
| 572 | [1] emul-linux-x86-java-1.4.2 |
|
|
| 573 | [2] emul-linux-x86-java-1.5 |
578 | [1] emul-linux-x86-java-1.5 |
|
|
579 | [2] emul-linux-x86-java-1.6 |
|
|
580 | Available 64-bit Java browser plugins |
|
|
581 | [1] icedtea6-bin |
|
|
582 | [2] sun-jre-bin-1.6 |
| 574 | </pre> |
583 | </pre> |
| 575 | |
584 | |
| 576 | <p> |
|
|
| 577 | Although you must select a 32-bit browser (such as <c>mozilla-firefox-bin</c>) |
|
|
| 578 | to use with your 32-bit plugin, the 64-bit version of <c>konqueror</c> uses your |
|
|
| 579 | Java VM directly, so it's possible to use the 64-bit version of <c>blackdown</c> |
|
|
| 580 | with this browser; no further configuration is necessary. |
|
|
| 581 | </p> |
585 | <p> |
| 582 | |
|
|
| 583 | <p> |
|
|
| 584 | Now select the right plugin for your 32-bit browser: |
586 | Now select the right plugin for your browsers: |
| 585 | </p> |
587 | </p> |
| 586 | |
588 | |
| 587 | <pre caption="Selecting plugins"> |
589 | <pre caption="Selecting plugins"> |
|
|
590 | <comment>(Choose the plugins for 32-bit and 64-bit browsers)</comment> |
| 588 | # <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.5</i> |
591 | # <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.6</i> |
|
|
592 | # <i>eselect java-nsplugin set 64bit sun-jre-bin-1.6</i> |
| 589 | </pre> |
593 | </pre> |
| 590 | |
594 | |
| 591 | <p> |
595 | <p> |
| 592 | Verify the correct plugin was selected: |
596 | Verify the correct plugin was selected: |
| 593 | </p> |
597 | </p> |
| 594 | |
598 | |
| 595 | <pre caption="Verifying the correct plugin"> |
599 | <pre caption="Verifying the correct plugin"> |
| 596 | # <i>eselect java-nsplugin list</i> |
600 | # <i>eselect java-nsplugin list</i> |
| 597 | Available 32-bit Java browser plugins |
601 | Available 32-bit Java browser plugins |
| 598 | [1] emul-linux-x86-java-1.4.2 |
602 | [1] emul-linux-x86-java-1.5 |
| 599 | [2] emul-linux-x86-java-1.5 current |
603 | [2] emul-linux-x86-java-1.6 current |
|
|
604 | Available 64-bit Java browser plugins |
|
|
605 | [1] icedtea6-bin |
|
|
606 | [2] sun-jre-bin-1.6 current |
| 600 | </pre> |
607 | </pre> |
| 601 | |
608 | |
| 602 | </body> |
609 | </body> |
| 603 | </section> |
610 | </section> |
| 604 | </chapter> |
611 | </chapter> |