[onebusaway] r5472 committed - Edited wiki page SettingUpATomcatServerInEclipse through web user inte...
onebu...@googlecode.com
Author: bdfe...@onebusaway.org
Date: Sun Feb 19 01:25:37 2012
Log: Edited wiki page SettingUpATomcatServerInEclipse through web user
interface.
http://code.google.com/p/onebusaway/source/detail?r=5472
Modified:
/wiki/SettingUpATomcatServerInEclipse.wiki
=======================================
--- /wiki/SettingUpATomcatServerInEclipse.wiki Mon Aug 2 15:27:03 2010
+++ /wiki/SettingUpATomcatServerInEclipse.wiki Sun Feb 19 01:25:37 2012
@@ -1,77 +1,2 @@
-#summary Instructions for setting up a Tomcat server in Eclipse
#labels GettingStarted
-
-<wiki:toc />
-
-= Download Tomcat =
-
-We target everything to the Java Servlet spec v2.4. Though you can use
most any compliant container, we use the Tomcat 5.5 series by default.
Download the latest version here:
-
-http://tomcat.apache.org/download-55.cgi
-
-Uncompress the software package somewhere permanent.
-
-= Installing the Server Runtime in Eclipse =
-
-Under the general Eclipse "Preferences..." menu item, browse to "Server ->
Runtime Environments", as shown in the following figure:
-
-<a href="http://www.flickr.com/photos/onebusaway/3998278274/"
title="Server Runtime Environments by onebusaway, on Flickr"><img
src="http://farm4.static.flickr.com/3454/3998278274_75a6c2bfe0_m.jpg"
width="240" height="122" alt="Server Runtime Environments" /></a>
-
-Click "Add" to add a new runtime. Select the "Apache Tomcat v5.5" runtime.
-
-<a href="http://www.flickr.com/photos/onebusaway/3997523959/"
title="Select a Server Runtime by onebusaway, on Flickr"><img
src="http://farm3.static.flickr.com/2667/3997523959_ffc9b4bcd0_m.jpg"
width="236" height="240" alt="Select a Server Runtime" /></a>
-
-Once selected, you need to specify the path to your download of Tomcat:
-
-<a href="http://www.flickr.com/photos/onebusaway/3997527617/"
title="Server Runtime Path by onebusaway, on Flickr"><img
src="http://farm4.static.flickr.com/3531/3997527617_18ed983a31_m.jpg"
width="240" height="157" alt="Server Runtime Path" /></a>
-
-= Creating a New Server Instance =
-
-We need to open the "Server" view so that we can add a new server
instance. In Eclipse, select the following menu item chain "Window -> Show
View -> Other... -> Server -> Servers". This should add a "Servers" tab
window to your workbench. Right click in that "Servers" window,
select "New -> Server". It should bring up the following dialog:
-
-<a href="http://www.flickr.com/photos/onebusaway/3997538991/" title="Add a
New Server by onebusaway, on Flickr"><img
src="http://farm4.static.flickr.com/3432/3997538991_8e55c96199_m.jpg"
width="187" height="240" alt="Add a New Server" /></a>
-
-Keep the host name as "localhost", select the "Apache Tomcat v5.5 Server"
as the type, name the server whatever you like ("onebusaway" perhaps?), and
make sure the Server runtime you installed is selected in the drop down
list. Click "Finish" and there should now be a server entry with the name
you specified in the "Servers" window.
-
-= More Server Setup =
-
-By default, Eclipse will deploy your webapp to a folder in the following
location:
-
-{{{
-<path to Eclipse workspace
directory>/.metadata/.plugins/org.eclipse.wst.server.core/tmp0
-}}}
-
-Since that's a little unwieldy to work with, I like to change it to
something more direct. To change the location, double click on the server
entry with the name you specified that should now be listed in
the "Servers" window.
-
-In the Server Locations tab, change to "Use a custom location" and select
a more reasonable path (I like `<path to Eclipse workspace
directory>/apache-tomcat-config/server_name` myself). See as an example:
-
-http://onebusaway.googlecode.com/svn/wiki/images/SettingUpATomcatServerInEclipse/ServerLocations.png
-
-Note that to update this setting, the server must not have any projects
assigned to it yet (as in the next section) and the server must be
published (right click on the server entry and click "Publish").
-
-= Add Project Modules to the Server =
-
-We now want to add project modules to the server so the server can host
their content. Right click on your newly created server entry and
select "Add and Remove Projects..."
-
-<a href="http://www.flickr.com/photos/onebusaway/3998314024/" title="Add
Projects to a Server by onebusaway, on Flickr"><img
src="http://farm3.static.flickr.com/2198/3998314024_1fc63a1324_m.jpg"
width="240" height="157" alt="Add Projects to a Server" /></a>
-
-Add any or all of the OneBusAway webapp projects that you wish to work
with.
-
-= Starting and Stopping the Server =
-
-Once you've added a few project modules to a server, it's ready to run.
Right click on your server instance and you should see methods for starting
and stopping the server instance, as well as running the instance in
debugging mode.
-
-When you run a server instance, an entry is actually created in the
standard Eclipse Run Configurations, which controls the command line
options, classpath, and other settings for running applications, unit
tests, etc in Eclipse. You can specify additional command line options
there to, for example, increase the amount of heap memory available to the
server or define other system properties.
-
-When the server is started, it will begin spitting out messages to the
console about its startup progress. When all has gone well, you'll
typically get a message like:
-
-{{{
-Oct 10, 2009 8:06:21 AM org.apache.catalina.startup.Catalina start
-INFO: Server startup in 4563 ms
-}}}
-
-However, go back and check for any exceptions that might have been thrown
when attempting to load the project module into the container.
-
-If all has gone well, you should now be able to see your project at:
-
-http://localhost:8080/name-of-project-module-here
+Moved to
https://github.com/OneBusAway/onebusaway/wiki/Setting-Up-a-Tomcat-Server-in-Eclipse