blob: 7184905ff6d1d960c7de6d92de862d387053137a [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>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="Copyright (c) 2000, 2006 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" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2006" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="task" name="DC.Type" />
<meta name="DC.Title" content="Defining the installed server runtime environments preferences" />
<meta name="abstract" content="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:" />
<meta name="description" content="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:" />
<meta content="preferences, installed server runtime environments, defining, servers, runtime environment, workbench, defining server runtime environment, wizards, New Server Runtime, applications, New Server Runtime wizard, installed server runtime environments, setting preferences" name="DC.subject" />
<meta content="preferences, installed server runtime environments, defining, servers, runtime environment, workbench, defining server runtime environment, wizards, New Server Runtime, applications, New Server Runtime wizard, installed server runtime environments, setting preferences" name="keywords" />
<meta content="XHTML" name="DC.Format" />
<meta content="twinstprf_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>Defining the installed server runtime environments preferences</title>
</head>
<body id="twinstprf_wst"><a name="twinstprf_wst"><!-- --></a>
<h1 class="topictitle1">Defining the installed server runtime environments preferences</h1>
<div><p>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:</p>
<a name="twinstprf_wst__steps"><!-- --></a><ol id="twinstprf_wst__steps">
<li class="stepexpand"><span>From the Window menu, select <span class="uicontrol">Preferences</span>.</span>
</li>
<li class="stepexpand"><span>In the Preferences window, expand the <span class="uicontrol">Server</span> folder
and then select <span class="uicontrol">Installed Runtimes</span>.</span> The
Installed Server Runtime Environments section of the Preferences dialog is
displayed.</li>
<li class="stepexpand"><span><strong>Optional: </strong>Click the <span class="uicontrol">Search</span> button.
This searches your local directory for installed server runtime environments.
Searching on a remote host is not supported.</span>
<ol type="a">
<li><span>The Search for Runtimes dialog box opens. In the <span class="uicontrol">Folder</span> field,
browse or type the directory where you would like the workbench to start searching
for installed server runtime environments. Click <span class="uicontrol">OK</span>.</span>
</li>
<li><span>If a list of installations is displayed, select the desired
target server and click <span class="uicontrol">OK</span> in the displayed dialog;
then click <span class="uicontrol">OK</span> in the Preferences dialog. If no installations
of any application servers are found, continue completing the steps for this
task.</span></li>
</ol>
</li>
<li class="stepexpand"><span>Click <span class="uicontrol">Add</span>.</span> The New Server Runtime
wizard opens.
<ol type="a">
<li class="substepexpand"><span>Select the target server runtime and click <span class="uicontrol">Next</span>.
The <em>product_name</em> Runtime panel is displayed.</span></li>
<li class="substepexpand"><span>For <span class="uicontrol">Installation directory</span> or <span class="uicontrol">Location</span> field,
type or browse to the location of the target server.</span> <div class="tip"><span class="tiptitle">Tip:</span> If
you specify a false location for the target server, use the workbench to assemble
modules and then use the application server to deploy the modules.</div>
If you selected the target server as <strong>J2EE Runtime Library</strong> (a
generic J2EE container), specify a directory that contains <tt>.jar</tt> files
such a <tt>\bin\lib</tt> directory for a Java™ development kit installation.
</li>
<li class="substepexpand"><span>Click <span class="uicontrol">Finish</span>.</span> The target server
name and type is added to the table in the Installed Server Runtime Environment
section.</li>
<li class="substepexpand"><span>In the Preferences dialog, click <span class="uicontrol">OK</span>.</span>
</li>
</ol>
</li>
</ol>
<div class="section" id="twinstprf_wst__postreq"><a name="twinstprf_wst__postreq"><!-- --></a><p id="twinstprf_wst__postreq_p1"><a name="twinstprf_wst__postreq_p1"><!-- --></a>To change the list of available target
servers, click <strong>Window &gt; Preferences &gt; Server &gt; Installed Runtimes</strong> to
go to the Installed Server Runtime Environments section of the Preferences
dialog. Use the <strong>Add</strong>, <strong>Edit</strong>, <strong>Remove</strong> or <strong>Search</strong> options
to change the list of target servers as needed.</p>
<div class="p" id="twinstprf_wst__postreq_p2"><a name="twinstprf_wst__postreq_p2"><!-- --></a>To change
the target server for a module:<ol>
<li>Right-click on the module in the Project Explorer view and click <strong>Properties
&gt; Project Facets</strong>. The Project Facets page opens.</li>
<li>Select the <span class="uicontrol">Add/Remove Project Facets</span> button. The
Add/Remove Project Facets dialog box opens.</li>
<li>Select the <span class="uicontrol">Show Runtimes</span> button.</li>
<li>Under the <strong>Runtimes</strong> table, select the target servers for the module.</li>
</ol>
</div>
</div>
</div>
</body>
</html>