blob: 321eee1ace20f6e413fc790d436777fefca3b2e6 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<!-- /*******************************************************************************
* Copyright (c) 2000, 2005 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/ -->
<link rel="stylesheet" type="text/css" href="../../org.eclipse.wst.doc.user/common.css" />
<title>Resources used to test and publish on your server</title>
</head>
<body onresize="location.reload();" id="cwres_wst"><a name="cwres_wst"><!-- --></a>
<h1 class="topictitle1">Resources used to test and publish on your server</h1>
<div><div>To test and publish on your server, you need
to define one or more of the following resources:</div><a name="cwres_wst__cwres_ul"><!-- --></a><ul id="cwres_wst__cwres_ul"><li>A server</li>
<li>An installed server runtime environment</li>
</ul>
<p id="cwres_wst__cwres_p1"><a name="cwres_wst__cwres_p1"><!-- --></a>If a server has server configuration files, in most situations,
these server configuration files are created for you automatically and contained
in a server project.</p>
<div class="section" id="cwres_wst__cwres_server_project"><a name="cwres_wst__cwres_server_project"><!-- --></a><h4 class="sectiontitle">Server Project</h4><p>A <em>server
project</em> contains servers and server configuration files. When a server
project is created automatically by the workbench, the name given to the project
is <span class="uicontrol">Servers</span> and is available in the Project Explorer
view under the Other Projects folder.</p>
</div>
<div class="section" id="cwres_wst__cwres_servers"><a name="cwres_wst__cwres_servers"><!-- --></a><h4 class="sectiontitle">Servers</h4><p id="cwres_wst__cwres_servers_p1"><a name="cwres_wst__cwres_servers_p1"><!-- --></a>A <em>server</em> identifies where you want to test or
publish your application. A server points to a specific runtime environment
such as a local test environment, a full installation of a server, or a server
on another machine. A server contains the logic of how to publish to the server;
and what application projects and configurations to run.</p>
<p id="cwres_wst__cwres_servers_p2"><a name="cwres_wst__cwres_servers_p2"><!-- --></a>On
the workbench, when the metadata of the server is automatically created, it
is stored in a <em>serverName</em>.server file, where <em>serverName</em> is the
name assigned to the server. For details on the metadata of the server, refer
to the <em>Displaying or hiding the metadata of the server</em> link at the
bottom of this topic.</p>
</div>
<div class="section"><h4 class="sectiontitle">Server configurations</h4><p id="cwres_wst__cwres_serverconfig_p1"><a name="cwres_wst__cwres_serverconfig_p1"><!-- --></a><span>Server configurations are files that contains
information that is required to set up and publish to a server. For example,
these files may include information about what port to run the server, security
preferences and other vendor-specific server settings.</span></p>
<p id="cwres_wst__cwres_serverconfig_p2"><a name="cwres_wst__cwres_serverconfig_p2"><!-- --></a>On
the workbench, the metadata of the server configurations is automatically
created and stored in a <em>configuration data folder</em> under a server project.
The naming convention of the configuration data folder is dependant on the
vendor, typically it has the following convention: <em>serverName</em>@<em>hostname</em>-config,
where <em>serverName</em> is the name assigned to the server, and <em>hostname</em> is
the fully qualified DNS name or IP address of the host machine where the server
is running.</p>
</div>
<div class="section" id="cwres_wst__cwres_installed_runtime"><a name="cwres_wst__cwres_installed_runtime"><!-- --></a><h4 class="sectiontitle">Installed Server Runtime Environment</h4>You
need to define the runtime environment of an application server for compiling
your application. A server contains a reference to an installed server runtime
environment it is currently using. For details on how to define an installed
server runtime environment, refer to the <em>Defining the installed server
runtime environments</em> link at the bottom of this topic.</div>
<div class="section" id="cwres_wst__cwres_relationship"><a name="cwres_wst__cwres_relationship"><!-- --></a><h4 class="sectiontitle">Relationship between the resources</h4><p>For
each server, you can specify the server configuration and installed server
runtime environment that should be used for that server. A server can only
point to one or no server configuration. However, a server configuration can
be pointed to from one or more servers.</p>
<p>A relationship between a server
configuration and an application project, for example an EAR project, is created
when a project is added to the server configuration. A server can point to
one or more projects. A project can be pointed to from one or more server
configurations.</p>
</div>
</div>
<div><div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="../topics/tmetasrv.html" title="On the workbench, you have the option to display or hide the metadata of the server.">Displaying or hiding the metadata of the server</a></div>
<div><a href="../topics/twinstprf.html" title="Using the Preferences page, you can direct the workbench to use a specific runtime environment of an application server for compiling your application. You can complete this by defining the installation directory of the server:">Defining the installed server runtime environments</a></div>
</div>
</div>
</body>
</html>