blob: f796321fb0855a3fc454f834ce8f94aa8871a831 [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>Servers view</title>
</head>
<body onresize="location.reload();" id="rwrcview_wst"><a name="rwrcview_wst"><!-- --></a>
<h1 class="topictitle1">Servers view</h1>
<div><div>The Servers view (similar to the one shown
below) allows you to manage the servers. This view displays a list of all
your servers and configurations that are associated with that server. You
can use this view to start, start in debug mode, restart, or stop the servers.</div><div class="section"><p> <img src="../images/scpview.gif" alt="Picture of Server view" onload="javascript:resizeimage(this);" name="../images/scpview.gif" /> </p>
<p id="rwrcview_wst__rwrcview_p2"><a name="rwrcview_wst__rwrcview_p2"><!-- --></a>Use the Servers view to perform the following
tasks:</p>
<ul><li id="rwrcview_wst__rwrcview_li1"><a name="rwrcview_wst__rwrcview_li1"><!-- --></a>Create a server</li>
<li id="rwrcview_wst__rwrcview_li2"><a name="rwrcview_wst__rwrcview_li2"><!-- --></a>Edit a server</li>
<li id="rwrcview_wst__rwrcview_li3"><a name="rwrcview_wst__rwrcview_li3"><!-- --></a>Delete a server</li>
<li id="rwrcview_wst__rwrcview_li4"><a name="rwrcview_wst__rwrcview_li4"><!-- --></a>Start a server in debug mode</li>
<li id="rwrcview_wst__rwrcview_li5"><a name="rwrcview_wst__rwrcview_li5"><!-- --></a>Start a server </li>
<li id="rwrcview_wst__rwrcview_li6"><a name="rwrcview_wst__rwrcview_li6"><!-- --></a>Restart a server in debug mode</li>
<li id="rwrcview_wst__rwrcview_li7"><a name="rwrcview_wst__rwrcview_li7"><!-- --></a>Restart a server</li>
<li id="rwrcview_wst__rwrcview_li8"><a name="rwrcview_wst__rwrcview_li8"><!-- --></a>Stop a server</li>
<li id="rwrcview_wst__rwrcview_li10"><a name="rwrcview_wst__rwrcview_li10"><!-- --></a>Publish your application</li>
<li id="rwrcview_wst__rwrcview_li11"><a name="rwrcview_wst__rwrcview_li11"><!-- --></a>Monitor server ports</li>
<li id="rwrcview_wst__rwrcview_li11b"><a name="rwrcview_wst__rwrcview_li11b"><!-- --></a>Displaying or hiding the metadata of the server from
the workbench</li>
<li id="rwrcview_wst__rwrcview_li12"><a name="rwrcview_wst__rwrcview_li12"><!-- --></a>Add and remove projects from a server</li>
</ul>
<p id="rwrcview_wst__rwrcview_p3"><a name="rwrcview_wst__rwrcview_p3"><!-- --></a>The Servers view displays the current status of all
the servers. The <strong>Status</strong> column indicates whether or not a server has
been started. The following lists the possible server status:</p>
<ul><li id="rwrcview_wst__rwrcview_ul2li1"><a name="rwrcview_wst__rwrcview_ul2li1"><!-- --></a>Starting</li>
<li id="rwrcview_wst__rwrcview_ul2li2"><a name="rwrcview_wst__rwrcview_ul2li2"><!-- --></a>Started</li>
<li id="rwrcview_wst__rwrcview_ul2li3"><a name="rwrcview_wst__rwrcview_ul2li3"><!-- --></a>Debugging</li>
<li id="rwrcview_wst__rwrcview_ul2li4"><a name="rwrcview_wst__rwrcview_ul2li4"><!-- --></a>Stopping</li>
<li id="rwrcview_wst__rwrcview_ul2li5"><a name="rwrcview_wst__rwrcview_ul2li5"><!-- --></a>Stopped</li>
</ul>
<div class="tip" id="rwrcview_wst__rwrcview_note"><a name="rwrcview_wst__rwrcview_note"><!-- --></a><span class="tiptitle">Tip:</span> When the Servers view is first opened
after restarting a workbench session, the status of a server might be missing.
To update the status of the server, right-click on the server in the Servers
view and select <span class="uicontrol">Refresh Status</span> from the pop-up menu.</div>
<p id="rwrcview_wst__rwrcview_p4"><a name="rwrcview_wst__rwrcview_p4"><!-- --></a>The Servers view also displays the current state of all the
servers. Depending on the status of the server and the preference options
that are selected for that particular server, the workbench determines the
server actions that may be taken. Use the <strong>State</strong> column as an indicator
for possible actions that you may want to take. For example, if the workbench
detects that a file defined to run on a particular server has
changed, and the <span class="uicontrol">Automatically restart servers when necessary</span> check
box has been selected on the Server preferences page ( <span class="uicontrol">Window &gt;
Preferences &gt; Server</span>), the server tools automatically restart
that server. The <span class="uicontrol">Status</span> column in the Servers view
changes from <var class="varname">Started</var> to <var class="varname">Stopped</var> to
<var class="varname">Started</var>. However, if this check box is not selected, the
<span class="uicontrol">State</span> column in the Servers view changes to <var class="varname">Republish</var>.</p>
<p id="rwrcview_wst__rwrcview_p5"><a name="rwrcview_wst__rwrcview_p5"><!-- --></a>The following table lists the possible server states:</p>
<div class="tablenoborder"><a name="rwrcview_wst__rwrcview_table"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rwrcview_wst__rwrcview_table" frame="border" border="1" rules="all"><caption>Table 1. Description of server states</caption><thead align="left"><tr><th valign="top" id="d0e101"> Server states </th>
<th valign="top" id="d0e103"> Description of states </th>
</tr>
</thead>
<tbody><tr><td valign="top" headers="d0e101 ">Synchronized</td>
<td valign="top" headers="d0e103 ">Both the server and the applications are in synch.</td>
</tr>
<tr><td valign="top" headers="d0e101 ">Publishing</td>
<td valign="top" headers="d0e103 ">Files (projects, resource files, and server configurations)
are copied to the correct location for the server to find and use them.</td>
</tr>
<tr><td valign="top" headers="d0e101 ">Restart</td>
<td valign="top" headers="d0e103 ">The server needs to be restarted in order for the changes to take place.</td>
</tr>
<tr><td valign="top" headers="d0e101 ">Republish</td>
<td valign="top" headers="d0e103 "> Either the server or the applications or both have changed. The changed
files need to be republished.</td>
</tr>
<tr><td valign="top" headers="d0e101 ">Restart and republish</td>
<td valign="top" headers="d0e103 "> Either the server or the applications or both have changed. When the
server is restarted, the changed files are also republished.</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</body>
</html>