[DOC] INSTALL.txt
Along the right line? Used the formatting from the TC4 readme files. Needs some polish. - r Apache Tomcat Version 4.0 Beta 6 Install Guide = <<< cvs keyword thing >>> INTRODUCTION: Welcome! This document explains how to perform a stand-alone installation of the Tomcat 4.0 servlet container. Once you're up and running, you will have access to the more detailed documentation locally via Tomcat's default home page, as well as administration and sample applications. As well, the documentation is available locally at: $CATALINA_HOME/webapps/docs/index.html where $CATALINA_HOME is the root of the directory you extracted the Tomcat files to. The absolute latest version of the documentation is always available online at the following URL: http://jakarta.apache.org/tomcat/tomcat-4.0-doc/index.html Because the documentation released with each version of Tomcat is the latest as of that release, there is a good chance the online documentation will be slightly updated. NOTE: It is STRONGLY reccomended that you complete this minimal, stand-alone installation before continuing on to more advanced topics. === DOWNLOADING: === In the rare occurence that you find yourself reading this file without a copy of Tomcat 4 to install, you can obtain the latest version here http://jakarta.apache.org/site/binindex.html == INSTALLING: == Fortunately, installing the Tomcat servlet container consists of a few, easy steps: extract the archive, and set environment variables. Of course, since Tomcat is written in Java, it is assumed that you have install at least version 1.2 of the JDK. You can download the JDK from Sun at the following URL http://java.sun.com/j2se/ 1) Unpack the files You've most likely completed this step already =) Lets say that for installation (A), you're on a Windows machine and you've unpacked the files to "C:\tomcat" Or for installation (B) on a *nix machine, you've unpacked it to "/usr/local/tomcat" 2) Set your environment variables Tomcat 4 requires 2 environment variables: CATALINA_HOME and JAVA_HOME. CATALINA_HOME should be set to the root of your Tomcat installation, and JAVA_HOME should be set to the root of your JDK installation. For the Win9X-series of operating systems, add the following lines to your C:\AUTOEXEC.BAT file: SET CATALINA_HOME=C:\tomcat SET JAVA_HOME=C:\jdk1.3.1 In WinNT-based systems, you modify environment variables by first right- clicking on the "My Computer" icon, and going to "Properties". In NT you get to the properties by doing THIS, and in 2000, by doing THIS. For *nix, is there any different for the different shells? I'm no *nix expert by any means =) 3) Start it To start the container, execute the script appropriate to your operating system. The startup and shutdown scripts are named appropriately, and found in $CATALINA/bin. For *nix, that will be the scripts ending with the "sh" extension, and for Windows, "bat". 4) Test it Fire up your web browser, and request http://localhost:8080/ ...and you should be presented with the default Tomcat homepage. === TROUBLESHOOTING: === There are only really 2 things that can go wrong during the stand-alone install: 1) The most common hiccup is when another web server (or any process for that matter) has laid claim to port 8080. This is the default HTTP port that Tomcat attempts to bind to at startup. To change this, open the file: $CATALINA_HOME/conf/server.xml ...and search for '8080'. Change it to a port that isn't in use. Restart Tomcat and you're in business. Be sure that you replace the "8080" in the URL you're using to access Tomcat. For example, if you change the port to 1977, you would request http://localhost:1977/ with your browser. 2) An "out of environment space" error when running the batch files in Win9X/ME-based operating systems. Right-click on the STARTUP.BAT and SHUTDOWN.BAT files. Click on "Properties" then on the "Memory" tab. For the "Initial environment" field, enter in something like 4096. After you click apply, Windows will create shortcuts in the directory with which you can use to start and stop the container.
Re: [DOC] INSTALL.txt
Hi, I'm gonna follow your doc to install tomcat 4 on mandrake tonight. I'll make change to it for *nix platforms and highlight them then e-mail you the revised copy 8o) Adam. Adam Fowler Help Desk Live Project Information Services University of Wales, Aberystwyth Web guy+author on the TomcatBook Project http://tomcatbook.sourceforge.net e-mail: [EMAIL PROTECTED] On Wednesday 18 July 2001 00:23, you wrote: > Along the right line? Used the formatting from the TC4 readme files. > > Needs some polish. > > - r Content-Type: text/plain; charset="iso-8859-1"; name="INSTALL.txt" Content-Transfer-Encoding: quoted-printable Content-Description:
RE: [DOC] INSTALL.txt
Heyya Adam, > I'm gonna follow your doc to install tomcat 4 on mandrake > tonight. I'll make > change to it for *nix platforms and highlight them then e-mail you the > revised copy 8o) Cool, thanks =) Hopefully after that, one of the TC4 committers will check it out and give it the 'ok' for inclusion. As well, we've sort of petered out on the big DOC movement. At this point, I'm just going to write everything I feel like in plain readme form like the release notes. It'll be easy enough to convert to whatever we end up using. - r
Re: [DOC] INSTALL.txt
Wow, that was quick 8o) Always a good thing with install instructions! Here's the update INSTALL.txt Adam. Adam Fowler Help Desk Live Project Information Services University of Wales, Aberystwyth Web guy+author on the TomcatBook Project http://tomcatbook.sourceforge.net e-mail: [EMAIL PROTECTED] On Wednesday 18 July 2001 21:58, you wrote: > Hi, > > I'm gonna follow your doc to install tomcat 4 on mandrake tonight. I'll > make change to it for *nix platforms and highlight them then e-mail you the > revised copy 8o) > > Adam. > > > Adam Fowler > Help Desk Live Project > Information Services > University of Wales, Aberystwyth > Web guy+author on the TomcatBook Project > http://tomcatbook.sourceforge.net > e-mail: [EMAIL PROTECTED] > > > On Wednesday 18 July 2001 00:23, you wrote: > > Along the right line? Used the formatting from the TC4 readme files. > > > > Needs some polish. > > > > - r > > > Content-Type: text/plain; charset="iso-8859-1"; name="INSTALL.txt" > Content-Transfer-Encoding: quoted-printable > Content-Description: > -- Apache Tomcat Version 4.0 Beta 6 Install Guide = <<< cvs keyword thing >>> INTRODUCTION: Welcome! This document explains how to perform a stand-alone installation of the Tomcat 4.0 servlet container. Once you're up and running, you will have access to the more detailed documentation locally via Tomcat's default home page, as well as administration and sample applications. As well, the documentation is available locally at: $CATALINA_HOME/webapps/docs/index.html where $CATALINA_HOME is the root of the directory you extracted the Tomcat files to. The absolute latest version of the documentation is always available online at the following URL: http://jakarta.apache.org/tomcat/tomcat-4.0-doc/index.html Because the documentation released with each version of Tomcat is the latest as of that release, there is a good chance the online documentation will be slightly updated. NOTE: It is STRONGLY reccomended that you complete this minimal, stand-alone installation before continuing on to more advanced topics. === DOWNLOADING: === In the rare occurence that you find yourself reading this file without a copy of Tomcat 4 to install, you can obtain the latest version here http://jakarta.apache.org/site/binindex.html == INSTALLING: == Fortunately, installing the Tomcat servlet container consists of a few, easy steps: extract the archive, and set environment variables. Of course, since Tomcat is written in Java, it is assumed that you have install at least version 1.2 of the JDK. You can download the JDK from Sun at the following URL http://java.sun.com/j2se/ 1) Unpack the files You've most likely completed this step already =) Lets say that for installation (A), you're on a Windows machine and you've unpacked the files to "C:\tomcat" Or for installation (B) on a *nix machine, you've unpacked it to "/usr/local/tomcat" cd /var (I thought TC should go in /var for most platforms???) mv /var/ tar xzvf jakarta-tomcat-4.0-br.tar.gz OR unzip jakarta-tomcat-4.0-br.tar.Z tar xvf jakarta-tomcat-4.0-br.tar 2) Set your environment variables Tomcat 4 requires 2 environment variables: CATALINA_HOME and JAVA_HOME. CATALINA_HOME should be set to the root of your Tomcat installation, and JAVA_HOME should be set to the root of your JDK installation. For the Win9X-series of operating systems, add the following lines to your C:\AUTOEXEC.BAT file: SET CATALINA_HOME=C:\tomcat SET JAVA_HOME=C:\jdk1.3.1 In WinNT-based systems, you modify environment variables by first right- clicking on the "My Computer" icon, and going to "Properties". In NT you get to the properties by doing THIS, and in 2000, by doing THIS. For *nix, is there any different for the different shells? I'm no *nix expert by any means =) export CATALINA_HOME=/var/jakarta-tomcat-4.0-b5 export JAVA_HOME=/usr/java/jdk1.3 NB This should either be done in a systemV startup script or /etc/profile to make it system wide. (Preferably startup script so its available on tomcat start on boot if required) 3) Start it To start the container, execute the script appropriate to your operating system. The startup and shutdown scripts are named appropriately, and found in $CATALINA/bin. For *nix, that will be the scripts ending with the "sh" extension, and for Windows, "bat".
Re: [DOC] INSTALL.txt
Neat! It might be better to split "INSTALLATION" into two separate sections, one for Windows, one for Unix. HOWTOs work best with fewer conditionals. - A On Tue, Jul 17, 2001 at 08:23:10PM -0400, Rob S. wrote: > Along the right line? Used the formatting from the TC4 readme files. > > Needs some polish. > > - r
RE: [DOC] INSTALL.txt
Agreed... (re: Win/Unix sections). Is a Mac section worth it? I don't have access to a Mac and haven't the slightest clue how they work =) I also redid the default homepage (ROOT/index.html) but forgot to send a copy home from work =( - r > -Original Message- > From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]] > Sent: Thursday, July 19, 2001 8:40 PM > To: [EMAIL PROTECTED] > Subject: Re: [DOC] INSTALL.txt > > > Neat! > > It might be better to split "INSTALLATION" into two separate sections, > one for Windows, one for Unix. HOWTOs work best with fewer > conditionals. > > - A > > On Tue, Jul 17, 2001 at 08:23:10PM -0400, Rob S. wrote: > > Along the right line? Used the formatting from the TC4 readme files. > > > > Needs some polish. > > > > - r > >
RE: [DOC] INSTALL.txt
I'm going to include this in the beta 6 release tonight, after a couple of tweaks (and a mention of the new Windows-installer based version that Remy has created). Also, we'll need pointers to the RPMs that Henri so graciously creates, and corresponding directions to install them. MacOS X is, AFAIK, similar enough to the other Unixes that it doesn't need a separate section. Craig On Thu, 19 Jul 2001, Rob S. wrote: > Agreed... (re: Win/Unix sections). Is a Mac section worth it? I don't have > access to a Mac and haven't the slightest clue how they work =) > > I also redid the default homepage (ROOT/index.html) but forgot to send a > copy home from work =( > > - r > > > -Original Message- > > From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]] > > Sent: Thursday, July 19, 2001 8:40 PM > > To: [EMAIL PROTECTED] > > Subject: Re: [DOC] INSTALL.txt > > > > > > Neat! > > > > It might be better to split "INSTALLATION" into two separate sections, > > one for Windows, one for Unix. HOWTOs work best with fewer > > conditionals. > > > > - A > > > > On Tue, Jul 17, 2001 at 08:23:10PM -0400, Rob S. wrote: > > > Along the right line? Used the formatting from the TC4 readme files. > > > > > > Needs some polish. > > > > > > - r > > > > > >
Re: [DOC] INSTALL.txt
Rob S. at [EMAIL PROTECTED] wrote: > Agreed... (re: Win/Unix sections). Is a Mac section worth it? I don't have > access to a Mac and haven't the slightest clue how they work =) Mac? Under OS/9 it doesn't work (only Java platform 1 over there)... OS/X is basically a unix box, so, no worries there... Pier
[DOC] INSTALL.txt and Init Script...
Hey all, I've updated my initialisation script. Installation details are in the file. I also forgot to mention in my last post with regards to the nice INSTALL.txt 8o) that a symbolic link should be made like:- ln -s /var/jakarta-tomcat-4.0-b5/ /var/jakarta-tomcat So to allow easy upgrades. This is also detailed in the tomcat script (attached) Hope this helps. Adam. Adam Fowler Help Desk Live Project Information Services University of Wales, Aberystwyth Web guy+author on the TomcatBook Project http://tomcatbook.sourceforge.net e-mail: [EMAIL PROTECTED] tomcat systemV init script