Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Web Tools Project (WTP) » What configuration option determines whether the Tomcat server uses a separate instance or the insta
What configuration option determines whether the Tomcat server uses a separate instance or the insta [message #206589] Thu, 10 January 2008 17:31 Go to next message
John J. Barton is currently offline John J. Barton
Messages: 311
Registered: July 2009
Senior Member
Hi. I am trying to decode a paragraph in
http://wiki.eclipse.org/WTP_Tomcat_FAQ
and I would appreciate your help. Here is the paragraph:

----
What configuration option determines whether the Tomcat server uses a
separate instance or the instance from the Tomcat installation?

The Run modules directly from the workspace (do not modify the Tomcat
installation) checkbox of the server editor controls this option. It is
found in the General section of the Overview view. If checked, a
separate instance is used. If not checked, the instance from the Tomcat
installation is used. The default is checked. It is best to change this
option immediately after creating the server, or at least while no
projects have been added to the server.
----
So far this is what I have: (reordered to make sense to me)

What configuration option determines whether the Tomcat server uses a
separate instance or the instance from the Tomcat installation?
MEANS
How to launch Tomcat using the configuration files in the Tomcat
directory tree rather than the eclipse-internal server configuration files?


It is best to change this option immediately after creating the
server, or at least while no projects have been added to the server.
MEANS
First delete any server-configuration objects associated with the
project you want to launch (Servers-><The config>->Delete). Next create
a new server-configuration
(Server->New->Other->Server->Apache->Next->Add<your project>).

The Run modules directly from the workspace (do not modify the Tomcat
installation) checkbox of the server editor controls this option. It is
found in the General section of the Overview view.
MEANS
?? Any idea what this means? Where in the UI is this stuff?

If checked, a separate instance is used. If not checked, the instance
from the Tomcat installation is used. The default is checked.
MEANS
If checked, the launched Tomcat will be configured with files created by
eclipse in its .metadata directory and the Tomcat directory files will
be untouched. If not checked, Tomcat will be configured with files in
the Tomcat directory tree and editing these config files will change the
Tomcat installation files.

Thanks,
John
Re: What configuration option determines whether the Tomcat server uses a separate instance or the i [message #206595 is a reply to message #206589] Thu, 10 January 2008 18:28 Go to previous messageGo to next message
Larry Isaacs is currently offline Larry Isaacs
Messages: 1310
Registered: July 2009
Senior Member
Sorry John, I'm still working on the update to this document that covers
WTP 2.0.x. The current contents were written for WTP 1.5.x. Most of
the document is still accurate for WTP 2.0.x, but this particular
feature was enhanced in WTP 2.0.x, so the UI is now different.

In the Server Locations section of the Tomcat server editor, the "Use
workspace metadata..." option is equivalent to the "Run modules
directly..." check box being checked. The "Use Tomcat installation..."
option is equivalent to the "Run modules directly..." check box being
unchecked. The "Use custom location..." option is new in WTP 2.0.x and
wasn't available in WTP 1.5.x.

Note the description string in the Server Locations section, which
includes "Server must be published with no modules present to make
changes". Until this "state" is achieved, these options will be disabled.

Additional comments below...

John J Barton wrote:
> Hi. I am trying to decode a paragraph in
> http://wiki.eclipse.org/WTP_Tomcat_FAQ
> and I would appreciate your help. Here is the paragraph:
>
> ----
> What configuration option determines whether the Tomcat server uses a
> separate instance or the instance from the Tomcat installation?
>
> The Run modules directly from the workspace (do not modify the Tomcat
> installation) checkbox of the server editor controls this option. It is
> found in the General section of the Overview view. If checked, a
> separate instance is used. If not checked, the instance from the Tomcat
> installation is used. The default is checked. It is best to change this
> option immediately after creating the server, or at least while no
> projects have been added to the server.
> ----
> So far this is what I have: (reordered to make sense to me)
>
> What configuration option determines whether the Tomcat server uses a
> separate instance or the instance from the Tomcat installation?
> MEANS
> How to launch Tomcat using the configuration files in the Tomcat
> directory tree rather than the eclipse-internal server configuration files?

The "eclipse-internal server configuration files" (I assume you mean
those in the subfolder(s) of the Servers project in your workspace.) are
always used. This is the reason for the "(takes control of Tomcat
installation)" portion of the "Use Tomcat installation..." option.
Those in the installation will be overwritten with copies from the
Servers project each time the server is published within Eclipse.

The selection you make in the Server Locations section affects the
"separate instance" issue by controlling whether "CATATINA_BASE" ==
"CATALINA_HOME" or "CATATINA_BASE" != "CATALINA_HOME". Hopefully this
is sufficiently explained in other parts of the FAQ.

>
>
> It is best to change this option immediately after creating the server,
> or at least while no projects have been added to the server.
> MEANS
> First delete any server-configuration objects associated with the
> project you want to launch (Servers-><The config>->Delete). Next create
> a new server-configuration
> (Server->New->Other->Server->Apache->Next->Add<your project>).

This means that all projects should be removed from the server before
changing this option, which is normally the state immediately after
server creation. As mentioned previously, in WTP 2.0.x you have to do
this and publish the server before you can make changes. In WTP 1.5.x,
you could change it with projects added, but that would leave
"artifacts" related to the old state of the option behind. For example,
stale work directories could get left behind that could cause undesired
behavior if you later switched the option back.

>
> The Run modules directly from the workspace (do not modify the Tomcat
> installation) checkbox of the server editor controls this option. It is
> found in the General section of the Overview view.
> MEANS
> ?? Any idea what this means? Where in the UI is this stuff?

It should have been the Server section for WTP 1.5.x.

>
> If checked, a separate instance is used. If not checked, the instance
> from the Tomcat installation is used. The default is checked.
> MEANS
> If checked, the launched Tomcat will be configured with files created by
> eclipse in its .metadata directory and the Tomcat directory files will
> be untouched. If not checked, Tomcat will be configured with files in
> the Tomcat directory tree and editing these config files will change the
> Tomcat installation files.

As mentioned previously, the configuration files in the associated
subfolder of the Servers project are always copied when publishing the
server. If using the "Use workspace metadata..." option (the default),
those in your Tomcat installation remain intact. With the "Use Tomcat
installation..." option, they will get overwritten on each publish, so
changes you make directly to the Tomcat installation's configuration
could be short lived.

Cheers,
Larry

>
> Thanks,
> John
>
Re: What configuration option determines whether the Tomcat server uses a separate instance or the i [message #206603 is a reply to message #206589] Thu, 10 January 2008 18:31 Go to previous messageGo to next message
John J. Barton is currently offline John J. Barton
Messages: 311
Registered: July 2009
Senior Member
Wait I got it: there is a hidden secret panel with the checkbox!

John J Barton wrote:
> Hi. I am trying to decode a paragraph in
> http://wiki.eclipse.org/WTP_Tomcat_FAQ
> and I would appreciate your help. Here is the paragraph:
>
> ----
> What configuration option determines whether the Tomcat server uses a
> separate instance or the instance from the Tomcat installation?
>
> The Run modules directly from the workspace (do not modify the Tomcat
> installation) checkbox of the server editor controls this option. It is
> found in the General section of the Overview view. If checked, a
> separate instance is used. If not checked, the instance from the Tomcat
> installation is used. The default is checked. It is best to change this
> option immediately after creating the server, or at least while no
> projects have been added to the server.
> ----
> So far this is what I have: (reordered to make sense to me)
>
> What configuration option determines whether the Tomcat server uses a
> separate instance or the instance from the Tomcat installation?
> MEANS
> How to launch Tomcat using the configuration files in the Tomcat
> directory tree rather than the eclipse-internal server configuration files?
>

Go to the "Servers" view in eclipse, usually at the bottom. If you don't
see it, use Window->ShowView->Servers. Double click on the eclipse
server-launcher you want to change. A new panel will appear in the
editor box called "OverView", meaning "Tomcat Launch Configuration".
Under "Server Locations", meaning "Location of Server Configuration
Files", select "Use Tomcat Installation (takes control of Tomcat
Installation)". If the entries are grey, delete this eclipse
server-launcher and create a new one.
Re: What configuration option determines whether the Tomcat server uses a separate instance or the i [message #206611 is a reply to message #206603] Thu, 10 January 2008 18:46 Go to previous message
Larry Isaacs is currently offline Larry Isaacs
Messages: 1310
Registered: July 2009
Senior Member
John J Barton wrote:
> Wait I got it: there is a hidden secret panel with the checkbox!
>
> John J Barton wrote:
>> Hi. I am trying to decode a paragraph in
>> http://wiki.eclipse.org/WTP_Tomcat_FAQ
>> and I would appreciate your help. Here is the paragraph:
>>
>> ----
>> What configuration option determines whether the Tomcat server uses a
>> separate instance or the instance from the Tomcat installation?
>>
>> The Run modules directly from the workspace (do not modify the Tomcat
>> installation) checkbox of the server editor controls this option. It
>> is found in the General section of the Overview view. If checked, a
>> separate instance is used. If not checked, the instance from the
>> Tomcat installation is used. The default is checked. It is best to
>> change this option immediately after creating the server, or at least
>> while no projects have been added to the server.
>> ----
>> So far this is what I have: (reordered to make sense to me)
>>
>> What configuration option determines whether the Tomcat server uses a
>> separate instance or the instance from the Tomcat installation?
>> MEANS
>> How to launch Tomcat using the configuration files in the Tomcat
>> directory tree rather than the eclipse-internal server configuration
>> files?
>>
>
> Go to the "Servers" view in eclipse, usually at the bottom. If you don't
> see it, use Window->ShowView->Servers. Double click on the eclipse
> server-launcher you want to change. A new panel will appear in the
> editor box called "OverView", meaning "Tomcat Launch Configuration".
> Under "Server Locations", meaning "Location of Server Configuration
> Files", select "Use Tomcat Installation (takes control of Tomcat
> Installation)". If the entries are grey, delete this eclipse
> server-launcher and create a new one.

Or remove all projects from the server and publish. This will enable
the options. Re-add the projects after the option is changed.

Cheers,
Larry
Previous Topic:Creating Web Services
Next Topic:Stop auto republish
Goto Forum:
  


Current Time: Fri Oct 31 09:13:02 GMT 2014

Powered by FUDForum. Page generated in 0.02697 seconds
.:: Contact :: Home ::.

Powered by: FUDforum 3.0.2.
Copyright ©2001-2010 FUDforum Bulletin Board Software