Installation differs a bit between Windows and Linux environments. Hopefully most of you you use Linux as a development environment :D
First you need to obtain the Tomcat package. You can get it from http://tomcat.apache.org.
Note: In Windows environment you should not use the installer version. Use the zipped version instead.
Unzip the package to a proper location. The path should not have any spaces in it, because this might bring problems during the build time. Good places are in Windows c:\tomcat and in Linux /usr/local/tomcat. These are the usual places, but you may use different places if you wish, but be sure to do the matching changes in the instructions where needed.
Note also that the downloaded package already includes a folder named apache-tomcat-versionnumber and content of this folder should be the content of your tomcat installation folder.
You may wish to (and is highly recommended to) also create an environmental variable called CATALINA_HOME which points to the Tomcat installation folder. This variable is used by many software and tools to locate the Tomcat installation location.
Next you can test your tomcat installation executing the following command in the console (or promt window):
Wait for the tomcat to startup. In Windows the above command will open a log window to observe the procedure, in Linux you can use command like
to see the log and then press SHIFT+F to tail the log file. Next point your browser to http://localhost:8080 and verify that you see the Tomcat startup page.
To use Tomcat for Jetspeed, you must make few changes to the configuration files.
First, you need to add the user that Jetspeed uses to deploy the portlet-applications. Open a file called tomcat-users.xml under conf folder in Tomcat installation folder (on Linux systems it could be /usr/local/tomcat/conf/tomcat-users.xml). Add the following line between <tomcat-users> tags, likely to the end of the other user definitions:
<user username="j2deployer" password="j2deployer" roles="manager"/>
If you wish to (and again is recommended to) add an admin user to use the built-in Tomcat manager and the addon package Tomcat Administrator, add also the following line to userlist:
<user username="admin" password="admin" roles="admin,manager"/>
You should change the password to your likings (or leave it as it is, if only on a personal development machine).
Installing the administrator package is as simple as was the installing of Tomcat. Download either the Windows package or the Unix/Linux package. Now you should just unzip or untar the contents of the package over the existing tomcat. Note that this package also contains the apache-tomcat-* folder so you may have to copy the contents of that folder manually to the actual location of you Tomcat installation.
That's it. Enjoy.