Attachment #35238 for bug #56936

View | Details | Raw Unified | Return to bug 56936
Collapse All | Expand All





<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
<!ENTITY % freebsd PUBLIC "-//FreeBSD//ENTITIES DocBook Miscellaneous FreeBSD Entities//EN">
%freebsd;
<!ENTITY % trademarks PUBLIC "-//FreeBSD//ENTITIES DocBook Trademark Entities//EN">
%trademarks;


	least amount of aggravation.  Plan on spending a whole day on such
	a project as it will take time to assemble all the pieces and
	compile them individually, and then as a whole.  It also shows how
	to install the famous <application>Jakarta Tomcat Servlet and &jsp; container</application> on 
	the &os; operating system.</para> 
    </abstract>
  </articleinfo>
  <!-- END of Article Metadata-->

      <filename role="package">www/apache13</filename> on my FreeBSD
      system.</para>

    <para>The <application>Tomcat</application> portion of the install is very straight forward, but
      the difficulty I had was getting &java; Development Kit up and
      running for FreeBSD 4.X, as Sun Microsystems only supplies
      Binaries for Linux, &solaris;, and &windowsnt;.  This means that I


    <para>In this article, you will find how to install the &java;
      Development Kit for FreeBSD, and how to get up and running with
      <application>Tomcat</application>. A <xref linkend="ref"> section is also provided for 
      further reading.</para> 
  </sect1>

  <sect1>

      <para><application>Tomcat</application> is an open-source
	implementation of the &java; Servlets and &javaserver.pages;
	technologies, developed under the Jakarta project at the Apache
	Software Foundation.  <application>Tomcat</application> implements a new Servlet framework
	(called Catalina) that is based on completely new architecture
	with the Servlet 2.3 and <acronym>&jsp;</acronym> 1.2
	specifications.  It includes many additional features that make
	it a useful platform for developing and deploying web
	applications and web services.  In a nutshell, <application>Tomcat</application> is an
	application server written in 100% Pure &java;.</para>

      <para><application>Tomcat</application> is used for many purposes, and is not limited to
	Application Servers.  It provides an open platform to develop
	extensible web and content management services.  When <application>Tomcat</application> is
	used with an optimized FreeBSD system, it can provide highly
	reliable and fast pacing services.</para>

      <para>Please refer to the <xref linkend="ref"> section for more
	information on <application>Tomcat</application> and <acronym>&jsp;</acronym>.  The next
	section will demonstrate how to build the <quote>Tomcat
	Environment</quote> for &os;.  The version of <application>Tomcat</application> used in
	this guide is <literal>4.0.3</literal>.  This version contains
	major bug fixes, and the following updates/changes:</para>


    <sect2>
      <title>The Tomcat environment for FreeBSD</title>

      <para>It is very simple to install <application>Tomcat</application> on a &os; machine,
	after setting up the necessary &java; environment, which we have
	previously completed.</para>

      <para>In-order to setup <application>Tomcat</application> on &os;, follow the below 
        procedure:</para>

      <procedure>

	    adding it into either <filename>.profile</filename> or
	    <filename>.cshrc</filename>, depending on the shell you are
	    using. This variable is very crucial for the functioning of
	    all the &java; based programs, including <application>Tomcat</application> itself.</para>
	</step>

	<step>
	  <para>Download the <application>Tomcat</application> <quote>binary distribution</quote>
	    from the Jakarta website, which is located at
	    <literal><ulink url="&tomcat403"></ulink></literal>.  The
	    file to download is called

	<para><literal>Installation by using the source code is currently
	  out of scope for this document.  Please refer to the following
	  files for addition information on building from source,
	  available from your <application>Tomcat</application> distribution
	  directory:</literal></para>

	<itemizedlist>

    <sect2>
      <title>Operating Tomcat - Basics</title>

<para>Now that we have finished installing <application>Tomcat</application>.  The following
example shows how to start the <application>Tomcat</application> server:</para>

      <screen>&prompt.root; cd /usr/local/tomcat-4.0/bin
&prompt.root; ./startup.sh  (for starting Tomcat)</screen>

      <para>You can test if your <application>Tomcat</application> server has started by visiting
	the following URL: <literal>http://127.0.0.1:8080</literal> or
	<literal>http://localhost:8080</literal>.  To stop
	<application>Tomcat</application>:</para>

      <screen>&prompt.root; cd /usr/local/tomcat-4.0/bin
&prompt.root; ./shutdown.sh</screen>

      <para>(for stopping <application>Tomcat</application>)</para>

      <para>The <filename>startup.sh</filename> and
	<filename>shutdown.sh</filename> are frontends to the
	<filename>catalina.sh</filename> executable script in the same
	directory; if you would like to start <application>Tomcat</application> automatically at
	boot-time run:</para>

      <screen>&prompt.root; cd /usr/local/etc/rc.d


      <para>If your port <literal>8080</literal> is occupied by some other
	service, you can change it by editing the
	<filename>server.xml</filename> in your <application>Tomcat's</application>
	<filename>conf/</filename> directory.  In the example below, the
	port will be changed to 80, assuming there is no service running
	on that port.</para>

      <title>Conclusion</title>

      <para>Finally, we are at the end of the article and have a working
	version of <application>Tomcat</application>.  We hope that you have learned the basics of
	installing and building the &java; Development Kit on FreeBSD,
	along with installation of the <application>Tomcat</application> binary distribution
	application server released by the Apache Software Foundation.
	The <xref linkend="ref"> section contains pointers to additional
	resources on this topic, some which are in print, some which are

Return to bug 56936

Lines 35-41 Link Here

(-)article.sgml (-26 / +27 lines)
35		35
36	<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [	36	<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
37	<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">	37	<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
38		38	<!ENTITY % freebsd PUBLIC "-//FreeBSD//ENTITIES DocBook Miscellaneous FreeBSD Entities//EN">
		39	%freebsd;
39	<!ENTITY % trademarks PUBLIC "-//FreeBSD//ENTITIES DocBook Trademark Entities//EN">	40	<!ENTITY % trademarks PUBLIC "-//FreeBSD//ENTITIES DocBook Trademark Entities//EN">
40	%trademarks;	41	%trademarks;
41		42
Lines 99-106 Link Here
99	least amount of aggravation. Plan on spending a whole day on such	100	least amount of aggravation. Plan on spending a whole day on such
100	a project as it will take time to assemble all the pieces and	101	a project as it will take time to assemble all the pieces and
101	compile them individually, and then as a whole. It also shows how	102	compile them individually, and then as a whole. It also shows how
102	to install the famous Jakarta Tomcat Servlet and &jsp; container on	103	to install the famous <application>Jakarta Tomcat Servlet and &jsp; container</application> on
103	the FreeBSD operating system.</para>	104	the &os; operating system.</para>
104	</abstract>	105	</abstract>
105	</articleinfo>	106	</articleinfo>
106	<!-- END of Article Metadata-->	107	<!-- END of Article Metadata-->
Lines 127-133 Link Here
127	<filename role="package">www/apache13</filename> on my FreeBSD	128	<filename role="package">www/apache13</filename> on my FreeBSD
128	system.</para>	129	system.</para>
129		130
130	<para>The Tomcat portion of the install is very straight forward, but	131	<para>The <application>Tomcat</application> portion of the install is very straight forward, but
131	the difficulty I had was getting &java; Development Kit up and	132	the difficulty I had was getting &java; Development Kit up and
132	running for FreeBSD 4.X, as Sun Microsystems only supplies	133	running for FreeBSD 4.X, as Sun Microsystems only supplies
133	Binaries for Linux, &solaris;, and &windowsnt;. This means that I	134	Binaries for Linux, &solaris;, and &windowsnt;. This means that I
Lines 139-146 Link Here
139		140
140	<para>In this article, you will find how to install the &java;	141	<para>In this article, you will find how to install the &java;
141	Development Kit for FreeBSD, and how to get up and running with	142	Development Kit for FreeBSD, and how to get up and running with
142	Tomcat. A <xref linkend="ref"> section is also provided for	143	<application>Tomcat</application>. A <xref linkend="ref"> section is also provided for
143	further reading.</para>	144	further reading.</para>
144	</sect1>	145	</sect1>
145		146
146	<sect1>	147	<sect1>
Lines 383-406 Link Here
383	<para><application>Tomcat</application> is an open-source	384	<para><application>Tomcat</application> is an open-source
384	implementation of the &java; Servlets and &javaserver.pages;	385	implementation of the &java; Servlets and &javaserver.pages;
385	technologies, developed under the Jakarta project at the Apache	386	technologies, developed under the Jakarta project at the Apache
386	Software Foundation. Tomcat implements a new Servlet framework	387	Software Foundation. <application>Tomcat</application> implements a new Servlet framework
387	(called Catalina) that is based on completely new architecture	388	(called Catalina) that is based on completely new architecture
388	with the Servlet 2.3 and <acronym>&jsp;</acronym> 1.2	389	with the Servlet 2.3 and <acronym>&jsp;</acronym> 1.2
389	specifications. It includes many additional features that make	390	specifications. It includes many additional features that make
390	it a useful platform for developing and deploying web	391	it a useful platform for developing and deploying web
391	applications and web services. In a nutshell, Tomcat is an	392	applications and web services. In a nutshell, <application>Tomcat</application> is an
392	application server written in 100% Pure &java;.</para>	393	application server written in 100% Pure &java;.</para>
393		394
394	<para>Tomcat is used for many purposes, and is not limited to	395	<para><application>Tomcat</application> is used for many purposes, and is not limited to
395	Application Servers. It provides an open platform to develop	396	Application Servers. It provides an open platform to develop
396	extensible web and content management services. When Tomcat is	397	extensible web and content management services. When <application>Tomcat</application> is
397	used with an optimized FreeBSD system, it can provide highly	398	used with an optimized FreeBSD system, it can provide highly
398	reliable and fast pacing services.</para>	399	reliable and fast pacing services.</para>
399		400
400	<para>Please refer to the <xref linkend="ref"> section for more	401	<para>Please refer to the <xref linkend="ref"> section for more
401	information on Tomcat and <acronym>&jsp;</acronym>. The next	402	information on <application>Tomcat</application> and <acronym>&jsp;</acronym>. The next
402	section will demonstrate how to build the <quote>Tomcat	403	section will demonstrate how to build the <quote>Tomcat
403	Environment</quote> for FreeBSD. The version of Tomcat used in	404	Environment</quote> for &os;. The version of <application>Tomcat</application> used in
404	this guide is <literal>4.0.3</literal>. This version contains	405	this guide is <literal>4.0.3</literal>. This version contains
405	major bug fixes, and the following updates/changes:</para>	406	major bug fixes, and the following updates/changes:</para>
406		407
Lines 423-433 Link Here
423	<sect2>	424	<sect2>
424	<title>The Tomcat environment for FreeBSD</title>	425	<title>The Tomcat environment for FreeBSD</title>
425		426
426	<para>It is very simple to install Tomcat on a FreeBSD machine,	427	<para>It is very simple to install <application>Tomcat</application> on a &os; machine,
427	after setting up the necessary &java; environment, which we have	428	after setting up the necessary &java; environment, which we have
428	previously completed.</para>	429	previously completed.</para>
429		430
430	<para>In-order to setup Tomcat on FreeBSD, follow the below	431	<para>In-order to setup <application>Tomcat</application> on &os;, follow the below
431	procedure:</para>	432	procedure:</para>
432		433
433	<procedure>	434	<procedure>
Lines 454-464 Link Here
454	adding it into either <filename>.profile</filename> or	455	adding it into either <filename>.profile</filename> or
455	<filename>.cshrc</filename>, depending on the shell you are	456	<filename>.cshrc</filename>, depending on the shell you are
456	using. This variable is very crucial for the functioning of	457	using. This variable is very crucial for the functioning of
457	all the &java; based programs, including Tomcat itself.</para>	458	all the &java; based programs, including <application>Tomcat</application> itself.</para>
458	</step>	459	</step>
459		460
460	<step>	461	<step>
461	<para>Download the Tomcat <quote>binary distribution</quote>	462	<para>Download the <application>Tomcat</application> <quote>binary distribution</quote>
462	from the Jakarta website, which is located at	463	from the Jakarta website, which is located at
463	<literal><ulink url="&tomcat403"></ulink></literal>. The	464	<literal><ulink url="&tomcat403"></ulink></literal>. The
464	file to download is called	465	file to download is called
Lines 499-505 Link Here
499	<para><literal>Installation by using the source code is currently	500	<para><literal>Installation by using the source code is currently
500	out of scope for this document. Please refer to the following	501	out of scope for this document. Please refer to the following
501	files for addition information on building from source,	502	files for addition information on building from source,
502	available from your Tomcat distribution	503	available from your <application>Tomcat</application> distribution
503	directory:</literal></para>	504	directory:</literal></para>
504		505
505	<itemizedlist>	506	<itemizedlist>
Lines 517-542 Link Here
517	<sect2>	518	<sect2>
518	<title>Operating Tomcat - Basics</title>	519	<title>Operating Tomcat - Basics</title>
519		520
520	<para>Now that we have finished installing Tomcat. The following	521	<para>Now that we have finished installing <application>Tomcat</application>. The following
521	example shows how to start the Tomcat server:</para>	522	example shows how to start the <application>Tomcat</application> server:</para>
522		523
523	<screen>&prompt.root; cd /usr/local/tomcat-4.0/bin	524	<screen>&prompt.root; cd /usr/local/tomcat-4.0/bin
524	&prompt.root; ./startup.sh (for starting Tomcat)</screen>	525	&prompt.root; ./startup.sh (for starting Tomcat)</screen>
525		526
526	<para>You can test if your Tomcat server has started by visiting	527	<para>You can test if your <application>Tomcat</application> server has started by visiting
527	the following URL: <literal>http://127.0.0.1:8080</literal> or	528	the following URL: <literal>http://127.0.0.1:8080</literal> or
528	<literal>http://localhost:8080</literal>. To stop	529	<literal>http://localhost:8080</literal>. To stop
529	Tomcat:</para>	530	<application>Tomcat</application>:</para>
530		531
531	<screen>&prompt.root; cd /usr/local/tomcat-4.0/bin	532	<screen>&prompt.root; cd /usr/local/tomcat-4.0/bin
532	&prompt.root; ./shutdown.sh</screen>	533	&prompt.root; ./shutdown.sh</screen>
533		534
534	<para>(for stopping Tomcat)</para>	535	<para>(for stopping <application>Tomcat</application>)</para>
535		536
536	<para>The <filename>startup.sh</filename> and	537	<para>The <filename>startup.sh</filename> and
537	<filename>shutdown.sh</filename> are frontends to the	538	<filename>shutdown.sh</filename> are frontends to the
538	<filename>catalina.sh</filename> executable script in the same	539	<filename>catalina.sh</filename> executable script in the same
539	directory; if you would like to start Tomcat automatically at	540	directory; if you would like to start <application>Tomcat</application> automatically at
540	boot-time run:</para>	541	boot-time run:</para>
541		542
542	<screen>&prompt.root; cd /usr/local/etc/rc.d	543	<screen>&prompt.root; cd /usr/local/etc/rc.d
Lines 550-556 Link Here
550		551
551	<para>If your port <literal>8080</literal> is occupied by some other	552	<para>If your port <literal>8080</literal> is occupied by some other
552	service, you can change it by editing the	553	service, you can change it by editing the
553	<filename>server.xml</filename> in your Tomcat's	554	<filename>server.xml</filename> in your <application>Tomcat's</application>
554	<filename>conf/</filename> directory. In the example below, the	555	<filename>conf/</filename> directory. In the example below, the
555	port will be changed to 80, assuming there is no service running	556	port will be changed to 80, assuming there is no service running
556	on that port.</para>	557	on that port.</para>
Lines 617-625 Link Here
617	<title>Conclusion</title>	618	<title>Conclusion</title>
618		619
619	<para>Finally, we are at the end of the article and have a working	620	<para>Finally, we are at the end of the article and have a working
620	version of Tomcat. We hope that you have learned the basics of	621	version of <application>Tomcat</application>. We hope that you have learned the basics of
621	installing and building the &java; Development Kit on FreeBSD,	622	installing and building the &java; Development Kit on FreeBSD,
622	along with installation of the Tomcat binary distribution	623	along with installation of the <application>Tomcat</application> binary distribution
623	application server released by the Apache Software Foundation.	624	application server released by the Apache Software Foundation.
624	The <xref linkend="ref"> section contains pointers to additional	625	The <xref linkend="ref"> section contains pointers to additional
625	resources on this topic, some which are in print, some which are	626	resources on this topic, some which are in print, some which are