672 lines
28 KiB
Text
672 lines
28 KiB
Text
<!--
|
|
The FreeBSD Documentation Project
|
|
The FreeBSD French Documentation Project
|
|
|
|
$FreeBSD$
|
|
$Id: article.sgml,v 1.2 2002-04-27 08:32:17 gioria Exp $
|
|
Original revision: 1.5
|
|
-->
|
|
|
|
<!-- Copyright (c) 2002, Hiten Pandya, Victoria Chan, All rights reserved.
|
|
|
|
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
|
(SGML, HTML, PDF, PostScript, RTF and so forth) with or without
|
|
modification, are permitted provided that the following conditions
|
|
are met:
|
|
|
|
1. Redistributions of source code (SGML DocBook) must retain the above
|
|
copyright notice, this list of conditions and the following
|
|
disclaimer as the first lines of this file unmodified.
|
|
|
|
2. Redistributions in compiled form (transformed to other DTDs,
|
|
converted to PDF, PostScript, RTF and other formats) must reproduce
|
|
the above copyright notice, this list of conditions and the
|
|
following disclaimer in the documentation and/or other materials
|
|
provided with the distribution.
|
|
|
|
THIS DOCUMENTATION IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS "AS IS"
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
|
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS AND CONTRIBUTORS BE
|
|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED
|
|
OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
-->
|
|
|
|
<!--
|
|
Written by Victoria Chan <vkchan@kendryl.net>. The original document can
|
|
be found at: http://www.kendryl.net/jdk13-1.html.
|
|
-->
|
|
|
|
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
|
|
<!ENTITY % urls PUBLIC "-//FreeBSD//ENTITIES Common Document URL Entities//FR"> %urls;
|
|
<!ENTITY % abstract PUBLIC "-//FreeBSD//ENTITIES DocBook Abstract Entities//FR"> %abstract;
|
|
<!ENTITY % artheader PUBLIC "-//FreeBSD//ENTITIES DocBook ArtHeader Entities//FR"> %artheader;
|
|
<!ENTITY % translators PUBLIC "-//FreeBSD//ENTITIES DocBook Translator Entities//FR"> %translators;
|
|
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
|
|
|
|
<!--
|
|
URL Entities. These are in place, to allow wrapping long URLs to the 80th
|
|
column.
|
|
-->
|
|
<!ENTITY wwwurl "http://www.FreeBSD.org">
|
|
<!ENTITY ftpurl "ftp://ftp.FreeBSD.org">
|
|
<!ENTITY sunurl "http://www.sun.com">
|
|
<!ENTITY tomcaturl "http://jakarta.apache.org/tomcat">
|
|
|
|
<!-- The Download URL is too long! :-) -->
|
|
<!ENTITY tomcat403 "http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.0.3/bin/"> %man;
|
|
<!ENTITY rel.current CDATA "3.2">
|
|
]>
|
|
|
|
<article lang="fr">
|
|
|
|
<!-- START of Article Metadata -->
|
|
<articleinfo>
|
|
<title>Java et Jakarta Tomcat sous FreeBSD</title>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Victoria</firstname>
|
|
<surname>Chan</surname>
|
|
<affiliation>
|
|
<address><email>vkchan@kendryl.net</email></address>
|
|
</affiliation>
|
|
</author>
|
|
|
|
<author>
|
|
<firstname>Hiten</firstname>
|
|
<surname>Pandya</surname>
|
|
<affiliation>
|
|
<address><email>hiten@uk.FreeBSD.org</email></address>
|
|
</affiliation>
|
|
</author>
|
|
</authorgroup>
|
|
|
|
<copyright>
|
|
<year>2002</year>
|
|
<holder role="mailto:vkchan@kendryl.net">Victoria Chan</holder>
|
|
<holder role="mailto:hiten@uk.FreeBSD.org">Hiten Pandya</holder>
|
|
</copyright>
|
|
|
|
<pubdate>$FreeBSD$</pubdate>
|
|
|
|
<abstract>
|
|
<para>Ce document est présenté dans l'espoir de rendre plus
|
|
facile, pour quiconque en aurait besoin, la mise en place de
|
|
Java et son fonctionnement sous FreeBSD, avec le moins d'ennuis
|
|
possibles. Préparez vous à passer une journée entière sur un tel
|
|
projet étant donné que cela prendra du temps à assembler tous
|
|
les éléments et à les compiler individuellement, puis comme un
|
|
tout. On montrera aussi comment installer les célèbres Servlet
|
|
Jakarta Tomcat et JSP container sur le système d'exploitation
|
|
FreeBSD.</para>
|
|
&abstract.license;
|
|
&abstract.disclaimer;
|
|
&trans.a.fonvieille;
|
|
</abstract>
|
|
</articleinfo>
|
|
<!-- END of Article Metadata-->
|
|
|
|
<sect1>
|
|
<title>Introduction</title>
|
|
<para>Le langage de programmation Java naquit le <literal>23 Mai
|
|
1995</literal>. On s'attendrait qu'après tout ce temps, les
|
|
applications Java soient faciles à installer et prêtes à
|
|
fonctionner à partir d'un simple logiciel pré-compilé ou porté
|
|
sur FreeBSD, de ce fait le rendant accessible pour les
|
|
<quote>masses</quote>. Ce n'est pas le cas, malheureusement,
|
|
car la distribution de Java est contrôlée très étroitement par
|
|
Sun Microsystems, qui en interdit la redistribution. Toutes les
|
|
Applets Java doivent être compilées à partir du code source,
|
|
ainsi que le Kit de Développement Java de Sun Microsystems.
|
|
Tous ces ingrédients doivent être mélangés ensemble dans le bon
|
|
ordre, assemblés, et compilés par l'utilisateur final. Avec
|
|
une telle philosophie de distribution, il est de mon opinion que
|
|
Java sera toujours l'apanage uniquement de développeurs ou de
|
|
hackers. J'ai certainement trouvé cela vrai quand j'ai dû
|
|
servir quelques pages <filename>.jsp</filename> pour un client
|
|
sur mon serveur web, et que j'ai eu besoin de faire fonctionner
|
|
<filename role="package">www/jakarta-tomcat</filename> avec
|
|
<filename role="package">www/apache13</filename> sur mon système
|
|
FreeBSD.</para>
|
|
|
|
<para>L'installation de Tomcat est tout ce qui a de plus simple,
|
|
mais la difficulté je l'ai eu quand j'ai essayé de faire
|
|
fonctionner le Kit de Développement Java sur FreeBSD 4.x, comme
|
|
Sun Microsystems fournit seulement des binaires pour Linux,
|
|
Solaris et Windows NT. Cela signifie que j'ai dû compiler mon
|
|
propre JDK pour FreeBSD. J'ai commencé par chercher de la
|
|
documentation sur l'Internet. J'ai rapidement constaté qu'il y
|
|
avait plus de code source et de patches que nécessaire, mais
|
|
très peu de documentation sur qu'il faut faire après avoir tout
|
|
récupéré.</para>
|
|
|
|
<para>Dans cet article, vous trouverez comment installer le Kit de
|
|
Développement Java pour FreeBSD, et comment le faire fonctionner
|
|
avec Tomcat. Une section <xref linkend="ref"> est également
|
|
fournie pour davantage de lecture.</para>
|
|
</sect1>
|
|
|
|
<sect1>
|
|
<title>L'environnement Java</title>
|
|
<para>Assurez-vous que vous disposez d'un catalogue des
|
|
logiciels portés récents car <command>make</command> échouera
|
|
s'il essaye de compiler des sources plus anciennes. Vous
|
|
pouvez mettre à jour l'intégralité du catalogue de logiciels
|
|
portés en utilisant <application>CVSup</application>. Voir
|
|
<ulink url="&wwwurl;/doc/en_US.ISO8859-1/books/handbook/cvsup.html"></ulink>
|
|
pour plus d'information. Vous pouvez aussi télécharger
|
|
manuellement les logiciels portés dont vous avez besoin depuis
|
|
<ulink url="&ftpurl;/pub/FreeBSD/branches/-current/ports/"></ulink>.</para>
|
|
|
|
<note>
|
|
<para>Vous aurez besoin de l'<literal>Emulation Linux</literal>
|
|
(Linux-ABI) activée dans la configuration de votre
|
|
noyau. Ajoutez simplement l'option suivante à votre
|
|
fichier de configuration du noyau et recompilez-le. Les
|
|
instructions sur la compilation d'un noyau peuvent être
|
|
trouvées dans le manuel de FreeBSD.</para>
|
|
|
|
<programlisting>options COMPAT_LINUX</programlisting>
|
|
|
|
<para>L'option ci-dessus ajoutera le support Linux-ABI à votre noyau, une
|
|
fois ce dernier recompilé.</para>
|
|
</note>
|
|
|
|
<para>La liste des dépendances qui nécessitent d'être installées
|
|
manuellement dans un certain ordre est donnée ci-dessous. Les
|
|
dépendances qui sont automatiquement téléchargées ne sont pas
|
|
énumérées ici.</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><filename role="package">java/jdk13</filename></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><filename role="package">java/linux-jdk13</filename></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><filename role="package">archivers/gtar</filename></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><filename role="package">archivers/bzip2</filename></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><filename role="package">archivers/unzip</filename></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><filename role="package">archivers/zip</filename></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<para>Vous aurez besoin récupérer ce qui suit:</para>
|
|
|
|
<procedure>
|
|
<step>
|
|
<para>Téléchargez <filename>bsd-jdk131-patches-5.tar.gz</filename>
|
|
à partir de
|
|
<ulink url="http://www.eyesbeyond.com/freebsddom/java/jdk13.html"></ulink>
|
|
et placez-le sous <filename>/usr/ports/distfiles</filename>.</para>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Ensuite lancez votre navigateur internet et aller sur
|
|
<ulink url="http://java.sun.com/j2se/1.3/download-linux.html"></ulink>
|
|
et trouvez SDK downloads. Cliquez sur le bouton
|
|
<quote>continue</quote> en-dessous de <quote>GNUZIP Tar Shell
|
|
Script</quote>. Soyez sûr d'avoir lu chaque mot de la page de
|
|
licence avant de cliquer sur le bouton <quote>Accept</quote>!
|
|
Cela vous emmènera sur une page au titre de <quote>Download
|
|
Java(TM) 2 SDK, Standard Edition 1.3.1_02</quote>. Descendez
|
|
vers le bas de la page et cliquer sur le bouton <quote>HTTP
|
|
download</quote>. Quand la boîte de dialogue <quote>File
|
|
Download</quote> s'affiche, soyez sûr de cliquer sur le bouton
|
|
<quote>Open</quote> plutôt que le bouton <quote>Save</quote>.
|
|
Une nouvelle boîte <quote>File Download</quote> s'affichera -
|
|
cette fois-ci choisissez <quote>Save</quote> et vous serez en
|
|
mesure de sauvegarder le fichier
|
|
j2sdk-1_3_1_02-linux-i386.bin. Placez le dans
|
|
/usr/ports/distfiles.</para>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Aller sur <ulink
|
|
url="http://www.sun.com/software/java2/download.html"></ulink>.
|
|
Dans le tableau sous <literal>Produce Description</literal>,
|
|
appelé <literal>Java 2 SDK 1.3.1</literal>, aller sur la
|
|
cellule de droite et cliquer <quote>download</quote>. Cela
|
|
vous amènera sur la page <quote>Sign On</quote> où vous devez
|
|
vous identifier si vous avez déjà un compte, ou vous
|
|
enregistrer pour accéder. Une fois identifié, vous arriverez
|
|
à la page <quote>Legal</quote>, où vous devez accepter la
|
|
licence; descendez (en lisant la licence) et cliquer sur le
|
|
bouton <quote>Continue</quote>. La page suivante est la page
|
|
<quote>Receipt</quote>. C'est là que vous sauverez le
|
|
fichier demandé. Vous serez en mesure de choisir l'endroit le
|
|
plus proche de vous. Cliquer sur <quote>Java 2 SDK, Standard
|
|
Edition, version 1.3.1</quote>. Sauvez le fichier
|
|
<filename>j2sdk-1_3_1-src.tar.gz</filename> dans le répertoire
|
|
<filename>/usr/ports/distfiles/</filename>.</para>
|
|
</step>
|
|
</procedure>
|
|
|
|
<note>
|
|
<para>Il est très important que vous lisiez l'Accord de
|
|
Licence qui a été émis par Sun Microsystems Corp. Il y a
|
|
plusieurs restrictions sur l'utilisation de Java, que vous devez
|
|
respecter. Le projet FreeBSD ne prends aucune responsabilités
|
|
pour vos actes.</para>
|
|
|
|
<para>N'effacer aucun des fichiers téléchargés, car ils seront
|
|
nécessaires pour compiler certains logiciels natifs portés pour
|
|
FreeBSD, ce dont on parlera plus tard.</para>
|
|
</note>
|
|
|
|
<para>Maintenant que vous avez rassemblé tous les fichiers source et
|
|
logiciels portés, vous devez commencer la compilation par
|
|
<filename role="package">java/linux-jdk13</filename>:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/ports/archivers/gtar; make all install clean</screen>
|
|
|
|
<screen>&prompt.root; cd /usr/ports/archivers/unzip; make all install clean</screen>
|
|
|
|
<screen>&prompt.root; cd /usr/ports/archivers/zip; make all install clean</screen>
|
|
|
|
<para>Et finalement:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/ports/java/linux-jdk13</screen>
|
|
|
|
<screen>&prompt.root; make all install clean</screen>
|
|
|
|
<para>Une fois que vous avez compilé
|
|
<filename role="package">java/linux-jdk13</filename>, vous devez
|
|
le tester, afin d'être sûr qu'il fonctionne comme prévu. Pour
|
|
cela faire:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/local/linux-jdk1.3.1/bin</screen>
|
|
|
|
<screen>&prompt.root; ./java -version</screen>
|
|
|
|
<para>La sortie de la commande ci-dessus devrait être comme suit:</para>
|
|
|
|
<programlisting>java version "1.3.1_02"
|
|
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1_02-b02)
|
|
Classic VM (build 1.3.1_02-b02, green threads, nojit)</programlisting>
|
|
|
|
<para>Si vous n'avez pas obtenu la réponse correcte, vous devez faire:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/ports/java/linux-jdk13</screen>
|
|
|
|
<screen>&prompt.root; make deinstall</screen>
|
|
|
|
<para>Et vérifiez que <filename>/usr/local</filename> ne contient
|
|
pas un répertoire <filename>linux-jdk1.3.1</filename> . Si vous
|
|
trouvez une partie de ce répertoire, effacez-le. Relancer
|
|
la <literal>compilation et l'installation</literal> pour <filename
|
|
role="package">java/linux-jdk13</filename>.</para>
|
|
|
|
<para>Pour fabriquer le <literal>Kit de Développement Java
|
|
1.3.1</literal> natif pour FreeBSD, faire ce qui suit:</para>
|
|
|
|
<procedure>
|
|
<step>
|
|
<para>Soyez sûr d'avoir le fichier
|
|
<filename>j2sdk-1_3_1-src.tar.gz</filename> dans votre
|
|
<filename>/usr/ports/distfiles</filename>. Ce fichier est
|
|
requit pour appliquer l'<quote>ensemble de patches</quote>
|
|
abordé ci-dessous.</para>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Vous aurez besoin de télécharger l'<quote>l'ensemble de
|
|
patches</quote> pour compiler le port. Le fichier correspondant
|
|
est appelé <filename>bsd-jdk131-patches-6.tar.gz</filename>.
|
|
Vous devrez également vérifier l'intégrité des fichiers en
|
|
comparant avec les sommes de contrôle <acronym>MD5</acronym>
|
|
suivantes. L'ensemble de patches est appelé <literal>Patch-set
|
|
6</literal>.</para>
|
|
|
|
<programlisting>
|
|
MD5 (bsd-jdk131-patches-6.tar.gz) = 9cade10b81d6034fdd2176bef32bdbf9
|
|
</programlisting>
|
|
|
|
<para>L'ensemble de patches est disponible depuis:
|
|
<ulink url="http://www.eyesbeyond.com/freebsddom/java/index.html"></ulink></para>
|
|
</step>
|
|
</procedure>
|
|
|
|
<para>La dernière procédure discutée précédemment (compiler le
|
|
<literal>jdk</literal>) prendra du temps.</para>
|
|
</sect1>
|
|
|
|
<sect1>
|
|
<title>Configuration de Jakarta Tomcat</title>
|
|
<sect2>
|
|
<title>Vue d'ensemble</title>
|
|
<para>Java devient de plus en plus populaire pour
|
|
l'élaboration de solutions diverses et adaptables
|
|
indépendantes de la plateforme. Un des besoins croissant de
|
|
Java est le marché de l'<literal>ASP (Application Service
|
|
Provider)</literal>. Java est la solution parfaite pour ce
|
|
type de marchés avec les avantages suivants:</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Indépendance de la plateforme</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Engagement à échelle industrielle</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Adaptabilité</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>Performance fiable</para>
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
<para>Distribué, Multi-threadé, Sécurisé etc...</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<para>Une technologie très importante et en pleine croissance qui
|
|
a émergée de Java est <acronym>JSP</acronym> (JavaServer Pages).</para>
|
|
|
|
<para><acronym>JSP</acronym> (JavaServer Pages) est une
|
|
technologie côté serveur introduite par <literal>Sun Microsystems
|
|
Corp.</literal>, qui fournie une manière simple de générer du
|
|
contenu dynamique à partir de pages <acronym>HTML</acronym>. Elle
|
|
utilise les balises <acronym>XML</acronym> avec des scriptlets
|
|
Java pour encapsuler et séparer la logique de la conception et
|
|
de l'affichage. Quand une page <acronym>JSP</acronym> est
|
|
invoquée, elle est dynamiquement convertie en Servlet et traitée
|
|
par le serveur pour produire la page résultante
|
|
<acronym>HTML/XML</acronym> pour le client. Quand
|
|
<acronym>JSP</acronym> est utilisé de pair avec JavaBeans, il
|
|
est alors possible de produire des applications diverses et
|
|
adaptables, qui peuvent être combinées avec la puissance et la
|
|
performance de FreeBSD.</para>
|
|
|
|
<para><application>Tomcat</application> est une implémentation
|
|
open-source des Servlets Java et des technologies de pages
|
|
JavaServer, développée dans le cadre du projet Jakarta à
|
|
l'Apache Software Foundation. Tomcat met en oeuvre une nouvelle
|
|
structure Servlet (appelée Catalina) qui est basée sur une toute
|
|
nouvelle architecture avec les spécifications Servlet 2.3 et
|
|
<acronym>JSP</acronym> 1.2. Il inclut de nombreuses
|
|
caractéristiques supplémentaires qui font de lui une plateforme
|
|
utile pour le développement et le déploiement d'applications et
|
|
de services web. En bref, Tomcat est un serveur d'application
|
|
écrit à 100% en pur Java.</para>
|
|
|
|
<para>Tomcat est utilisé dans de nombreuses situations, et n'est
|
|
pas limité aux Serveurs d'Application. Il fournit une plateforme
|
|
ouverte pour développer des services extensibles de gestion web et
|
|
du contenue. Quand Tomcat est utilisé avec un système FreeBSD
|
|
optimisé, il peut fournir des services hautement fiables et
|
|
rapides.</para>
|
|
|
|
<para>Veuillez vous référer à la section <xref linkend="ref"> pour
|
|
plus d'informations sur Tomcat et <acronym>JSP</acronym>. La
|
|
section suivante démontrera comment construire
|
|
l'<quote>environnement Tomcat</quote> pour FreeBSD. La version
|
|
de Tomcat utilisée dans ce guide est la
|
|
<literal>4.0.3</literal>. Cette version contient la correction
|
|
de bogues majeurs, et les mises à jour/changements
|
|
suivants:</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><literal>Spécification JSP 1.2</literal></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><literal>Spécification Java Servlet 2.3</literal></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><literal>Compatibilité complète avec Java Servlet 2.2
|
|
et la spécification JSP 1.1</literal></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>L'environnement Tomcat pour FreeBSD</title>
|
|
<para>Il est très simple d'installer Tomcat sur une machine
|
|
FreeBSD, après l'installation de l'environnement Java
|
|
nécessaire, ce que nous avons fait précédemment.</para>
|
|
|
|
<para>Afin d'installer Tomcat sur FreeBSD, suivez la procédure
|
|
ci-dessous:</para>
|
|
|
|
<procedure>
|
|
<step>
|
|
<para>Suivez les étapes précédentes pour installer
|
|
l'environnement Java nécessaire.</para>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Configurez une variable d'environnement
|
|
<envar>JAVA_HOME</envar> qui pointe sur le répertoire où
|
|
vous avez installé le JDK (l'exemple suivant pointe sur une
|
|
version native du JDK):</para>
|
|
|
|
<screen>&prompt.root; setenv JAVA_HOME /usr/local/jdk1.3.1 (pour l'interpréteur C Shells)</screen>
|
|
|
|
<screen>&prompt.root; export JAVA_HOME=/usr/local/jdk1.3.1 (pour l'interpréteur Bourne Shells)</screen>
|
|
|
|
<para>Cette variable d'environnement devrait être rendue
|
|
permanente en l'ajoutant soit dans
|
|
<filename>.profile</filename> soit
|
|
<filename>.cshrc</filename>, en fonction de l'interpréteur
|
|
de commandes que vous utilisez. Cette variable est cruciale
|
|
pour le fonctionnement de tous programmes Java, incluant
|
|
Tomcat lui-même.</para>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Téléchargez la <quote>distribution binaire</quote> de Tomcat sur le site de Jakarta, qui est situé à
|
|
<literal><ulink url="&tomcat403"></ulink></literal>. Le fichier à
|
|
télécharger est appelé
|
|
<filename>jakarta-tomcat-4.0.3.tar.gz</filename>.</para>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Le fichier compressée et archivé que nous avons
|
|
téléchargé à l'étape précédente utilise des
|
|
<quote>Extensions GNU</quote> spéciales. Afin de le
|
|
dé-archiver et le décompresser, nous aurons besoin
|
|
d'installer <literal>GNU Tar (<filename
|
|
role="package">archivers/gtar</filename>)</literal>, en
|
|
faisant ce qui suit:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/ports/archivers & & make all install clean</screen>
|
|
</step>
|
|
|
|
<step>
|
|
<para>Dé-archivez et décompressez le fichier
|
|
<filename>jakarta-tomcat-4.0.3.tar.gz</filename> dans le répertoire
|
|
<filename>/usr/local</filename> et renommez le répertoire en
|
|
<filename>tomcat-4.0</filename> pour une référence
|
|
aisée:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/local</screen>
|
|
|
|
<screen>&prompt.root; gtar zxvf jakarta-tomcat-4.0.3.tar.gz</screen>
|
|
|
|
<screen>&prompt.root; ls jakarta*</screen>
|
|
|
|
<screen>jakarta-tomcat-4.0.3</screen>
|
|
|
|
<screen>&prompt.root; mv jakarta-tomcat-4.0.3 tomcat-4.0</screen>
|
|
|
|
<para>Vous pouvez effacer
|
|
<filename>jakarta-tomcat-4.0.3.tar.gz</filename> si vous le
|
|
désirez.</para>
|
|
</step>
|
|
</procedure>
|
|
|
|
<note>
|
|
<para><literal>L'installation en utilisant le code source est en
|
|
dehors du cadre de ce document. Veuillez vous référer aux
|
|
fichiers suivants pour un complément d'information sur la
|
|
compilation à partir des sources, disponibles dans votre
|
|
répertoire Tomcat:</literal></para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
|
|
<para><filename>/usr/local/tomcat-4.0/README.txt</filename></para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para><filename>/usr/local/tomcat-4.0/BUILDING.txt</filename></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</note>
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Utiliser Tomcat - Les bases</title>
|
|
<para>Maintenant que nous avons terminé l'installation de
|
|
Tomcat. L'exemple suivant montre comment démarrer le serveur
|
|
Tomcat:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/local/tomcat-4.0/bin</screen>
|
|
|
|
<screen>&prompt.root; ./startup.sh (pour le lancement de Tomcat)</screen>
|
|
|
|
<para>Vous pouvez vérifier si votre serveur Tomcat a démarré en
|
|
visitant l'URL suivante:
|
|
<literal>http://127.0.0.1:8080</literal> ou
|
|
<literal>http://localhost:8080</literal>. Pour arrêter
|
|
Tomcat:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/local/tomcat-4.0/bin</screen>
|
|
|
|
<screen>&prompt.root; ./shutdown.sh</screen> <para>(pour l'arrêt de Tomcat)</para>
|
|
|
|
|
|
<para>Les fichiers <filename>startup.sh</filename> et
|
|
<filename>shutdown.sh</filename> sont des interfaces à la
|
|
procédure exécutable <filename>catalina.sh</filename> se
|
|
trouvant dans le même répertoire; Si vous désirez lancer
|
|
Tomcat automatiquement au démarrage faites:</para>
|
|
|
|
<screen>&prompt.root; cd /usr/local/etc/rc.d</screen>
|
|
|
|
<screen>&prompt.root; ln -s /usr/local/tomcat-4.0/bin/catalina.sh</screen>
|
|
|
|
<para>Editez le fichier <filename>catalina.sh</filename>, et
|
|
ajoutez ce qui suit au début du fichier (après la boîte de
|
|
commentaires):</para>
|
|
|
|
<programlisting>JAVA_HOME=/usr/local/jdk1.3.1</programlisting>
|
|
|
|
<para>Si votre port <literal>8080</literal> est utilisé par un
|
|
autre service, vous pouvez le changer en éditant le fichier
|
|
<filename>server.xml</filename> dans votre répertoire
|
|
<filename>conf/</filename> de Tomcat. Dans l'exemple
|
|
ci-dessous, le port sera changé pour 80, en supposant qu'il
|
|
n'y a aucun service tournant sur ce port.</para>
|
|
|
|
<screen>&prompt.root; cd /usr/local/tomcat-4.0/conf</screen>
|
|
|
|
<screen>&prompt.root; fgrep -n 8080 server.xml</screen>
|
|
|
|
<screen>~65: By default, a non-SSL HTTP/1.1 Connector is established on port 8080.</screen>
|
|
|
|
<screen>~89: port="8080" minProcessors="5" maxProcessors="75"</screen>
|
|
|
|
<screen>&prompt.root; cat server.xml | sed s/8080/80/ > server.xml</screen>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<sect1 id="ref" xreflabel="référence">
|
|
<title>Référence</title>
|
|
<informaltable>
|
|
<tgroup cols="1">
|
|
<tbody>
|
|
<row>
|
|
<entry>
|
|
<ulink url="&wwwurl;/java">Le project Java de FreeBSD</ulink>
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
<ulink url="http://java.sun.com">JavaSoft. Home of Java</ulink>
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
<ulink
|
|
url="&sunurl;/software/communitysource/java2/licensing.html">The
|
|
Sun Community Source Licensing for Java</ulink>
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
<ulink url="&tomcaturl">La page Jakarta Tomcat</ulink>
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
<ulink
|
|
url="http://java.sun.com/docs/index.html">Documentation
|
|
J2SE</ulink>
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
<ulink url="&wwwurl;/ports/java.html">La section Java
|
|
des logiciels portés sous FreeBSD</ulink>
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
|
|
|
|
<sect2>
|
|
<title>Conclusion</title>
|
|
<para>Finalement, nous sommes à la fin de l'article et nous
|
|
disposons d'une version de Tomcat qui fonctionne. Nous
|
|
espérons que vous avez appris les bases de l'installation et de
|
|
la compilation du Kit de Développement Java sur FreeBSD, avec
|
|
l'installation de la distribution binaire du serveur
|
|
d'application Tomcat publié par l'Apache Software Foundation.
|
|
La section <xref linkend="ref"> contient des pointeurs vers des
|
|
ressources supplémentaires sur ce sujet, certaines sous forme
|
|
papier, d'autres disponibles sur l'Internet, ou les deux.</para>
|
|
|
|
<para>La chose la plus importante est l'espace disque. Je suggère
|
|
d'avoir <literal>700MO</literal> ou plus d'espace libre dans
|
|
<filename>/usr</filename>. J'espère que cet article vous a aidé
|
|
à sa manière. Pour les questions, les commentaires, les
|
|
compliments, ou les plaintes, veuillez les envoyez à
|
|
<ulink url="mailto:vkchan@kendryl.net">Victoria
|
|
Chan</ulink>.</para>
|
|
</sect2>
|
|
</sect1>
|
|
</article>
|