aboutsummaryrefslogtreecommitdiff
path: root/fr_FR.ISO8859-1/articles/java-tomcat/article.sgml
blob: 8abe5806998e098a7a3b82c154ecee6107f2705c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
<?xml version="1.0" encoding="ISO8859-1" standalone="no"?>
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.2-Based Extension//EN"
	"../../../share/sgml/freebsd42.dtd" [
<!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//FR" "../../share/sgml/entities.ent">
%entities;

<!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">

<!ENTITY tomcat403 "http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.0.3/bin/">
]>

<!--
     The FreeBSD Documentation Project
     The FreeBSD French Documentation Project

     $FreeBSD$
     $Id: article.sgml,v 1.4 2002-11-01 22:46:21 gioria Exp $
     Original revision: 1.14
-->

<!-- 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.
-->

<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>

    <releaseinfo>$FreeBSD$</releaseinfo>

    <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 &agrave; passer une journée entière sur un tel
	projet étant donné que cela prendra du temps &agrave; assembler tous
	les éléments et &agrave; 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>

        &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 &agrave; installer et prêtes &agrave;
	fonctionner &agrave; partir d'un simple logiciel pré-compilé ou porté
	sur FreeBSD, de ce fait le rendant accessible pour les
	&ldquo;masses&rdquo;.  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 &agrave; 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 qu'il y a de plus simple,
        mais la difficulté je l'ai eue 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 ce 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 &agrave; jour l'intégralité du catalogue de logiciels
	  portés en utilisant <application>CVSup</application>.  Voir
	  <ulink url="../../books/handbook/cvsup.html"></ulink>
	  pour plus d'information. Vous pouvez aussi télécharger
	  manuellement les logiciels portés dont vous avez besoin de récupérer 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 &agrave; votre
		fichier de configuration du noyau et recompilez-le. Les
		instructions sur la compilation d'un noyau peuvent être
		trouvées dans le <ulink
                url="../../books/handbook/">manuel de
                FreeBSD</ulink>.</para>

          <programlisting>options		COMPAT_LINUX</programlisting>

          <para>L'option ci-dessus ajoutera le support Linux-ABI &agrave; 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>
	&agrave; 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 allez sur
          <ulink url="http://java.sun.com/j2se/1.3/download-linux.html"></ulink>
	  et trouvez SDK downloads.  Cliquez sur le bouton
	  &ldquo;continue&rdquo; en-dessous de &ldquo;GNUZIP Tar Shell
	  Script&rdquo;.  Soyez sûr d'avoir lu chaque mot de la page de
	  licence avant de cliquer sur le bouton &ldquo;Accept&rdquo;!
	  Cela vous emmènera sur une page au titre de &ldquo;Download
	  Java(TM) 2 SDK, Standard Edition 1.3.1_02&rdquo;.  Descendez
	  vers le bas de la page et cliquer sur le bouton &ldquo;HTTP
	  download&rdquo;.  Quand la boîte de dialogue &ldquo;File
	  Download&rdquo; s'affiche, soyez sûr de cliquer sur le bouton
	  &ldquo;Open&rdquo; plutôt que le bouton &ldquo;Save&rdquo;.
	  Une nouvelle boîte &ldquo;File Download&rdquo; s'affichera -
	  cette fois-ci choisissez &ldquo;Save&rdquo; et vous serez en
	  mesure de sauvegarder le fichier
          <filename>j2sdk-1_3_1_02-linux-i386.bin</filename>. Placez
          le dans <filename>/usr/ports/distfiles</filename>.</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 &ldquo;download&rdquo;.  Cela
	  vous amènera sur la page &ldquo;Sign On&rdquo; où vous devez
	  vous identifier si vous avez déj&agrave; un compte, ou vous
	  enregistrer pour accéder.  Une fois identifié, vous arriverez
	  &agrave; la page &ldquo;Legal&rdquo;, où vous devez accepter la
	  licence; descendez vers le bas (en lisant la licence) et cliquez sur le
	  bouton &ldquo;Continue&rdquo;.  La page suivante est la page
	  &ldquo;Receipt&rdquo;.  C'est l&agrave; que vous sauverez le
	  fichier demandé.  Vous serez en mesure de choisir l'endroit le
	  plus proche de vous.  Cliquer sur &ldquo;Java 2 SDK, Standard
	  Edition, version 1.3.1&rdquo;.  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 prend 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
    &prompt.root; cd /usr/ports/archivers/unzip; make all install clean
    &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
    &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
    &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
    &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 compiler 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
	requis pour appliquer l'&ldquo;ensemble de patches&rdquo;
	abordé ci-dessous.</para>
      </step>

      <step>
        <para>Vous aurez besoin de télécharger l'&ldquo;l'ensemble de
          patches&rdquo; 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'<acronym>ASP</acronym>
          (Application Service Provider).  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 &agrave; é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 fournit une manière simple de générer du
        contenu dynamique &agrave; 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 &agrave;
	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 &agrave; 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 &agrave; la section <xref linkend="ref"/> pour
        plus d'informations sur Tomcat et <acronym>JSP</acronym>.  La
	section suivante démontrera comment construire
	l'&ldquo;environnement Tomcat&rdquo; 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 &agrave; 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).Si vous utilisez comme shell
            &man.sh.1;, vous pouvez utilisez la commande suivante:</para>

        <screen>&prompt.root; export JAVA_HOME=/usr/local/jdk1.3.1</screen>

        <para>Si vous utilisez &man.csh.1; ou un shell compatible,
        vous devez utilisez la commande :
        </para>
        <screen>&prompt.root; setenv JAVA_HOME /usr/local/jdk1.3.1</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 &ldquo;distribution binaire&rdquo; de Tomcat sur le 		site de Jakarta, qui est situé &agrave;
	    <literal><ulink url="&tomcat403;"></ulink></literal>. Le fichier &agrave;
	    télécharger est appelé
	    <filename>jakarta-tomcat-4.0.3.tar.gz</filename>.</para>
        </step>

        <step>
          <para>Le fichier compressé et archivé que nous avons
            téléchargé &agrave; l'étape précédente utilise des
	    &ldquo;Extensions GNU&rdquo; 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/gtar  &amp;&amp; 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
        &prompt.root; gtar zxvf jakarta-tomcat-4.0.3.tar.gz
        &prompt.root; ls jakarta*
        jakarta-tomcat-4.0.3
        &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 &agrave; 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
        &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
        &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 &agrave; 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
        &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
        &prompt.root; fgrep -n 8080 server.xml
        ~65:         By default, a non-SSL HTTP/1.1 Connector is established on port 8080.
        ~89:         port="8080" minProcessors="5" maxProcessors="75"
        &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 &agrave; 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é
	&agrave; sa manière.  Pour les questions, les commentaires, les
	compliments, ou les plaintes, veuillez les envoyez &agrave;
	<ulink url="mailto:vkchan@kendryl.net">Victoria
	Chan</ulink>.</para>
    </sect2>
  </sect1>
</article>