Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Jetty WTP Plugin/Jetty WTP Create Server"

m
(Creating a Jetty Server)
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{Jetty}}
 
{{Jetty}}
 +
 +
==Creating a Jetty Server ==
  
 
To create a Jetty Server entry, complete the following steps.
 
To create a Jetty Server entry, complete the following steps.
 +
<ol>
 +
<li>From the main Eclipse window, select '''File -> New -> Other'''. The ''Select a Wizard'' dialog box opens.
 +
</li>
  
From the main Eclipse window, select '''File -> New''' -> Other. The ''Select a Wizard'' window opens.
 
# In the Wizards list box, scroll down to select '''Server -> Server'''.
 
# Click '''Next'''. The ''Define a New Server'' dialog box opens.
 
  
[[Image:Jetty-wtp-create1.jpg]]
+
</li>[[Image:Jetty-wtp-create1.jpg]]
  
# In the ''Select the server type'' field, scroll down to select '''Jetty -> Jetty 7.x''' or '''Jetty 8.x Server'''. This document uses the Jetty 7.x Server.
 
# Click '''Next'''.
 
[[Image:Jetty-wtp-create2.jpg]]
 
  
  
# Click the '''Next''' button.  
+
<li>In the ''Wizards'' list box, scroll down to select '''Server -> Server'''.
# To specify the installation directory for Jetty, either use the '''Browse''' button OR click '''Download and Install'''... to download  Jetty v7. This document illustrates the latter option.
+
<li>Click '''Next'''. The ''Define a New Server'' dialog box opens.
 +
</li>
  
[[Image:Jetty-wtp-create3.jpg]]
 
  
 +
</li>[[Image:Jetty-wtp-create2.jpg]]
  
Click Download and Install... the dialog opens :
 
  
[[Image:Jetty-wtp-create4.jpg]]
+
<li>In the ''Select the server type'' field, scroll down to select '''Jetty -> Jetty 7.x''' or '''Jetty 8.x Server'''. This document uses the Jetty 7.x Server.
 +
<li>Click '''Next'''. The ''Jetty Server'' dialog box opens.
 +
</li>
  
# Accept the license and click '''Finish'''. Select the base directory where you want install the Jetty server. This example selects D:\Servers\jetty-distribution-7.2.x and the download places the stable Jetty v7 server in this folder.
 
  
[[Image:Jetty-wtp-create5.jpg]]
 
  
Once you have selected a folder, the download begins. You have an error because the wizard checks that start.jar exists in the D:\Server\jetty-distribution-7.2.x (this JAR doesn't exist because the download  is not finished). In some cases the download is slow.
+
</li>[[Image:Jetty-wtp-create3.jpg]]
  
# When the download completes, click the enabled '''Finish''' button. You now have a D:\Server\jetty-distribution-7.2.x directory that contains the start.jar...from Jetty7 :
 
  
[[Image:Jetty-wtp-create6.jpg]]
+
<li>To specify the installation directory for Jetty, use the '''Browse''' button. Navigate to a local installation of jetty7 or jetty8 and click select.
 +
</li>
  
Click '''Next'''. The      window opens.
 
  
[[Image:Jetty-wtp-create7.jpg]]
+
<li>Click '''Next'''. The ''Add and Remove'' dialog boxopens.
 +
</li>
  
  
  
In this window, you can select an existing Dynamic Web project from your workspace. In this example, there are no WTP Dynamic WebProjects.
+
</li>[[Image:Jetty-wtp-create7.jpg]]
Click '''Finish'''.  
+
  
* A Server Project is created in the workspace  
+
 
 +
Here you can select an existing Dynamic Web project from your workspace. In this example, there are no WTP Dynamic WebProjects.
 +
 
 +
 
 +
 
 +
<li>Click '''Finish'''.
 +
</ol>
 +
 
 +
 
 +
* A Server Project is created in the workspace.
 
* if you go to WTP Server View , you see the option to launch Jetty v7.0 Server at localhost, which you can use to start/stop/debug the installed Jetty server.
 
* if you go to WTP Server View , you see the option to launch Jetty v7.0 Server at localhost, which you can use to start/stop/debug the installed Jetty server.
 +
 +
  
 
[[Image:Jetty-wtp-create8.jpg]]
 
[[Image:Jetty-wtp-create8.jpg]]
  
Servers shows the Jetty v7.0 Server at localhost-config folder which contains:  
+
 
* start.ini coming from the Jetty install (D:\Servers\jetty-distribution-7.2.x)
+
 
* start.config : coming from the JAR start.jar  from the Jetty install. Notice that Server/start.config is not the same as Jetty install/start.jar. Jetty Home is not the Jetty Install server but a WTP folder (created in the .metadata of your workspace).  
+
The Servers folder includes the Jetty v7.0 Server at localhost-config folder, which contains:  
* the jetty*.xml files which are declared in the original start.ini. Jetty*.xml files are preprocessed too to transform <Property to <SystemProperty.
+
* <tt>start.ini</tt> from the Jetty install (D:\Servers\jetty-distribution-7.2.x).
* webdefault.xml is modified to avoid locking HTML files under Windows when Jetty is started and HTML files are modified (published) with the option :
+
* <tt>start.config</tt> from the JAR <tt>start.jar</tt> from the Jetty install. Notice that <tt>Server/start.config</tt> is not the same as Jetty <tt>install/start.jar</tt>. Jetty Home is not the Jetty Install server but a WTP folder (created in the .metadata of your workspace).  
 +
* the <tt>jetty*.xml</tt> files, which are declared in the original <tt>start.ini. Jetty*.xml</tt> files are preprocessed too to transform <Property to <SystemProperty.
 +
* <tt>webdefault.xml</tt> is modified to avoid locking HTML files under Windows when Jetty is started and HTML files are modified (published) with the following option:
 +
 
  
 
<source lang="xml">
 
<source lang="xml">
Line 61: Line 73:
 
</source>
 
</source>
  
When Jetty server is called it uses:  
+
When the Jetty server is called it uses:  
* -Djetty.home : which is the WTP folder.
+
* <tt>-Djetty.home</tt>, which is the WTP folder.
* -Dinstall.jetty.home : which is the Jetty install folder.
+
* <tt>-Dinstall.jetty.home</tt>, which is the Jetty install folder.

Latest revision as of 14:46, 22 December 2010



Creating a Jetty Server

To create a Jetty Server entry, complete the following steps.

  1. From the main Eclipse window, select File -> New -> Other. The Select a Wizard dialog box opens.

  2. Jetty-wtp-create1.jpg


  3. In the Wizards list box, scroll down to select Server -> Server.
  4. Click Next. The Define a New Server dialog box opens.

  5. Jetty-wtp-create2.jpg


  6. In the Select the server type field, scroll down to select Jetty -> Jetty 7.x or Jetty 8.x Server. This document uses the Jetty 7.x Server.
  7. Click Next. The Jetty Server dialog box opens.

  8. Jetty-wtp-create3.jpg


  9. To specify the installation directory for Jetty, use the Browse button. Navigate to a local installation of jetty7 or jetty8 and click select.

  10. Click Next. The Add and Remove dialog boxopens.

  11. Jetty-wtp-create7.jpg


    Here you can select an existing Dynamic Web project from your workspace. In this example, there are no WTP Dynamic WebProjects.


  12. Click Finish.


  • A Server Project is created in the workspace.
  • if you go to WTP Server View , you see the option to launch Jetty v7.0 Server at localhost, which you can use to start/stop/debug the installed Jetty server.


Jetty-wtp-create8.jpg


The Servers folder includes the Jetty v7.0 Server at localhost-config folder, which contains:

  • start.ini from the Jetty install (D:\Servers\jetty-distribution-7.2.x).
  • start.config from the JAR start.jar from the Jetty install. Notice that Server/start.config is not the same as Jetty install/start.jar. Jetty Home is not the Jetty Install server but a WTP folder (created in the .metadata of your workspace).
  • the jetty*.xml files, which are declared in the original start.ini. Jetty*.xml files are preprocessed too to transform <Property to <SystemProperty.
  • webdefault.xml is modified to avoid locking HTML files under Windows when Jetty is started and HTML files are modified (published) with the following option:


  <init-param>
    <param-name>useFileMappedBuffer</param-name>
    <param-value>false</param-value>
  </init-param>

When the Jetty server is called it uses:

  • -Djetty.home, which is the WTP folder.
  • -Dinstall.jetty.home, which is the Jetty install folder.

Back to the top