blob: fe647e0c9436399d6c3bf2b26c40e81fd1c011cd [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--Arbortext, Inc., 1988-2009, v.4002-->
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
"task.dtd">
<?Pub Sty _display FontColor="red"?>
<?Pub Inc?>
<task id="twcrtins_wst" xml:lang="en-us">
<title id="title">Creating a server</title>
<shortdesc><ph id="shortdesc">You can create a server to identify
the runtime environment that you want to use for testing your project
resources. The term <i>creating a server</i> defines creating a pointer
from the workbench to an existing installation of an application server</ph>.</shortdesc>
<prolog><metadata>
<keywords id="index"><indexterm keyref="twcrtins|1|serverscreating"
status="new">servers<indexterm>creating</indexterm></indexterm>
<indexterm keyref="twcrtins|2|serverscreatingapointer" status="new">servers<indexterm>creating
a pointer</indexterm></indexterm></keywords>
</metadata></prolog>
<taskbody>
<context id="context">To create a server:</context>
<steps id="steps">
<step id="step1"><cmd>Select any of the following options:</cmd>
<choices>
<choice>In the Servers view (<menucascade><uicontrol>Window</uicontrol>
<uicontrol>Show View</uicontrol><uicontrol>Servers</uicontrol>
</menucascade>), right-click and select <menucascade><uicontrol>New</uicontrol>
<uicontrol>Server</uicontrol></menucascade>.</choice>
<choice>In the menu bar, click <uicontrol>File > New > Other</uicontrol>.
Expand the <uicontrol>Server</uicontrol> folder, select <uicontrol>Server</uicontrol> and
click <uicontrol>Next</uicontrol>.</choice>
</choices>
</step>
<step id="step2"><cmd>The New Server wizard opens. This wizard defines
a new server, that contains information required to point to a specific
runtime environment for local or remote testing, or for publishing
to an application server.</cmd></step>
<step><cmd>In the <uicontrol>Select the server type</uicontrol> list,
select the type of server or test environment where you want to publish
or test your resources.</cmd>
<substeps>
<substep><cmd>(Optional) In the text field under the <uicontrol>Select
the server type</uicontrol> label, you can replace the text <userinput>type
filter text</userinput> with keywords to filter the list of available
application servers.</cmd><info>The following are examples of filter
keywords:<dl><dlentry>
<dt><userinput>Apache</userinput></dt>
<dd>Filters the list of available servers where the vendor is Apache</dd>
</dlentry><dlentry>
<dt><userinput>WebSphere</userinput></dt>
<dd>Filters the list of available servers where the name is WebSphere</dd>
</dlentry><dlentry>
<dt><userinput>ejb</userinput></dt>
<dd>Filters the list of available servers that support ejb modules.</dd>
</dlentry><dlentry>
<dt><userinput>web</userinput></dt>
<dd>Filters the list of available servers that support Web modules</dd>
</dlentry><dlentry>
<dt><userinput>5.0</userinput></dt>
<dd>Filters the list of available servers that are at version, 5.0
or supports JEE 5 specification level.</dd>
</dlentry><dlentry>
<dt><userinput>1.2</userinput></dt>
<dd>Filters the list of available servers that supports J2EE 1.2 specification
level or any servers that may have a version-level of 1.2.</dd>
</dlentry></dl></info></substep>
<substep><cmd>There is a brief description about the server selected
from the server type list.</cmd></substep>
</substeps>
</step>
<step id="step3"><cmd>In the <uicontrol>Server's host name</uicontrol> field,
you can provide the fully qualified DNS name or IP address of the
host machine that where the server is running. By default, this field
is pre-filled with the default address: <userinput>localhost</userinput>.</cmd>
</step>
<step id="step5"><cmd>(Optional) In the <uicontrol>Server name</uicontrol> field,
type a label to identify this server entry in the Servers view.</cmd>
<info> By default, this field is completed with the following naming
convention: <i>server type</i> at <i>host name</i>, for example <userinput>Tomcat
v6.0 Server at localhost</userinput>.</info></step>
<step id="step6"><cmd>The <uicontrol>Server runtime environment</uicontrol> list
is available, when you select a server from the server type list that
contains a runtime environment entry in the Runtime Environments preferences
page (<menucascade><uicontrol>Window</uicontrol><uicontrol>Preferences</uicontrol>
<uicontrol>Server</uicontrol><uicontrol>Runtime Environments</uicontrol>
</menucascade>).</cmd><info> In the <uicontrol>Server runtime environment</uicontrol> list,
select the runtime environment of an application server for compiling,
testing, or running your application. To modify the server runtime
environment, select the <uicontrol>Configure runtime environments</uicontrol> link.
To add a new server runtime environment, select the <uicontrol>Add</uicontrol> link.
For more details about runtime environments, see the <i>Defining the
server runtime environments preferences</i> link at the bottom of
this topic.</info><info><p>If the <uicontrol>Server runtime environment</uicontrol> list
is not available, continue to the next page of the New Server wizard
where it is going to prompt you for the installation directory of
the server. After you complete this New Server wizard, the workbench
automatically adds a runtime environment entry in the Runtime Environments
preference page.</p></info></step>
<step id="step7"><cmd>Click <uicontrol>Next</uicontrol> and follow
the instructions in the wizard to specify the details of the server
that you want to create.</cmd><info> See the links at the end of this
topic, as there might be documentation available when continuing through
this wizard for creating the server you have selected in the server
type list.</info></step><?Pub Caret 206?>
<step id="step8"><cmd>After completing the New Server wizard, by click <uicontrol>Finish</uicontrol>,
the new server appears in the Servers view.</cmd></step>
</steps>
</taskbody>
</task>
<?Pub *0000005898?>