blob: 230243af54f9db587df48832a6d0320d7c35c79c [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "">
<html lang="en-us" xml:lang="en-us">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="Copyright (c) 2000, 2011 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 Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2011" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "" l gen true r (n 0 s 0 v 0 l 0) "" l gen true r (SS~~000 1))' />
<meta content="task" name="DC.Type" />
<meta name="DC.Title" content="Testing artifacts on a server" />
<meta name="abstract" content="You can use the workbench to test one or more application artifacts on a server." />
<meta name="description" content="You can use the workbench to test one or more application artifacts on a server." />
<meta content="artifacts, testing on servers, servers, testing artifacts" name="DC.subject" />
<meta content="artifacts, testing on servers, servers, testing artifacts" name="keywords" />
<meta scheme="URI" name="DC.Relation" content="../topics/tj2ee.html" />
<meta content="XHTML" name="DC.Format" />
<meta content="testing_wst" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
<title>Testing artifacts on a server</title>
<body id="testing_wst"><a name="testing_wst"><!-- --></a>
<h1 class="topictitle1">Testing artifacts on a server</h1>
<div><p>You can use the workbench to test
one or more application artifacts on a server.</p>
<div class="section" id="testing_wst__context"><a name="testing_wst__context"><!-- --></a>To test artifacts on a server:</div>
<li class="stepexpand" id="testing_wst__testing_step1"><a name="testing_wst__testing_step1"><!-- --></a><span>In the Project Explorer view from the
Java EE perspective, expand the project that contains the file you
want to test.</span></li>
<li class="stepexpand" id="testing_wst__testing_step2"><a name="testing_wst__testing_step2"><!-- --></a><span>Right-click the artifact that you want
to test.</span> Examples of artifacts include the Web project
or a file within the Web project (such as a JSP file, servlet, or
HTML file), or an enterprise bean.</li>
<li class="stepexpand" id="testing_wst__testing_step3"><a name="testing_wst__testing_step3"><!-- --></a><span>Select <span class="uicontrol">Run As &gt; Run on Server</span>.
The Server selection wizard appears.</span></li>
<li class="stepexpand" id="testing_wst__testing_step4"><a name="testing_wst__testing_step4"><!-- --></a><span>Use the radio buttons to specify how
you want to select the server. Select from the following options:</span>
<table class="choicetableborder" summary="" cellspacing="0" cellpadding="4" rules="rows" frame="hsides" border="1">
<thead><tr><th valign="bottom" id="N1008A-option" align="left">Option</th>
<th valign="bottom" id="N1008A-desc" align="left">Description</th></tr></thead>
<tr><td valign="top" headers="N1008A-option" id="N10094"><strong>Choose an existing server</strong></td>
<td valign="top" headers="N1008A-desc N10094">This
option uses an existing server that is defined in your workbench. </td>
<tr><td valign="top" headers="N1008A-option" id="N100A4"><strong>Manually define a server</strong></td>
<td valign="top" headers="N1008A-desc N100A4">This option
creates a new server.</td>
<li class="stepexpand" id="testing_wst__testing_step5"><a name="testing_wst__testing_step5"><!-- --></a><span>Under the <span class="uicontrol">Select the server
that you want to use</span> list, select a server you want to
run your application.</span> The list of available servers, under
the <span class="uicontrol">Select the server that you want to use</span> list,
depends on the Java EE specification level you defined for the artifact
and the supported servers on this workbench.</li>
<li class="stepexpand" id="testing_wst__testing_step6"><a name="testing_wst__testing_step6"><!-- --></a><span>(Optional) Click <span class="uicontrol">Next</span> to
configure additional settings, such as configuring settings specific
to the server, and adding or removing projects configured on the server.</span>
<li class="stepexpand"><span><span id="testing_wst__testing_step7_ph1"><a name="testing_wst__testing_step7_ph1"><!-- --></a>Click <span class="uicontrol">Finish.</span></span></span>
<span id="testing_wst__testing_step7_ph2"><a name="testing_wst__testing_step7_ph2"><!-- --></a>The server tools automatically complete
the following tasks for you: </span><ul>
<li id="testing_wst__testing_li2"><a name="testing_wst__testing_li2"><!-- --></a>Creates the server and adds it to the Servers
<li id="testing_wst__testing_li3"><a name="testing_wst__testing_li3"><!-- --></a>Adds your project to the server.</li>
<li id="testing_wst__testing_li4"><a name="testing_wst__testing_li4"><!-- --></a>Starts the server. (This may take time depending
on the server settings.)</li>
<li id="testing_wst__testing_li5"><a name="testing_wst__testing_li5"><!-- --></a>If the <span class="uicontrol">Automatically publish when
starting servers</span> check box on the Server preferences page
(<span class="menucascade"><span class="uicontrol">Window &gt; Preferences &gt; Server &gt; Launching</span>
</span>) is selected, the workbench checks to see if your project
and files on the server are synchronized. If they are not, the project
and the files are automatically updated when the server is restarted.</li>
<li id="testing_wst__testing_li6"><a name="testing_wst__testing_li6"><!-- --></a>Depending on the artifact you are testing, the
output of running your artifact may display in the Console view or
in a Web browser that automatically opens.</li>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="../topics/tj2ee.html" title="You can use the workbench to test one or more projects on a server.">Testing applications on a server</a></div>