blob: 58598c1ff0c794e3614861add891e56279b2222e [file] [log] [blame]
<!--
Copyright (c) 2005, 2018 Oracle and/or its affiliates. All rights reserved.
This program and the accompanying materials are made available under the
terms of the Eclipse Public License v. 2.0, which is available at
http://www.eclipse.org/legal/epl-2.0.
This Source Code may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the
Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
version 2 with the GNU Classpath Exception, which is available at
https://www.gnu.org/software/classpath/license.html.
SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-->
<p><a id="task-create-standalone-instance" name="task-create-standalone-instance"></a><a id="GHCLU00056" name="GHCLU00056"></a></p>
<h4><a id="sthref122" name="sthref122"></a><a id="sthref123" name="sthref123"></a><a id="sthref124" name="sthref124"></a>To Create a Standalone GlassFish Server Instance</h4>
<a name="BEGIN" id="BEGIN"></a>
<p>GlassFish Server instances form the basis of an application deployment. A standalone instance is not a member of a cluster. Each instance belongs to a single domain and has its own directory structure, configuration, and deployed applications. Each instance also includes the Java Platform, Enterprise Edition (Java EE) web container and Enterprise JavaBeans technology (EJB technology) container. Every new instance must contain a reference to a node that defines the host where the instance will reside.</p>
<hr>
<p><b>Note:</b></p>
<p>To create an instance on a node of type CONFIG that represents a remote host, you must use the <a href="http://www.oracle.com/pls/topic/lookup?ctx=E26576_01&id=GSRFM00044"><code>create-local-instance</code>(1)</a> subcommand. You cannot use the Administration Console for this purpose.</p>
<hr>
<a id="sthref125" name="sthref125"></a>
<h5>Before You Begin</h5>
<p>Ensure that the node on which the instance is to reside exists. See <a href="task-createnode.html">To Create a Node</a> for instructions.</p>
<ol>
<li>
<p>In the navigation tree, select the Standalone Instances node.</p>
<p>The Standalone Server Instances page opens.</p>
</li>
<li>
<p>On the Standalone Server Instances page, click New.</p>
<p>The New Standalone Server Instance page opens.</p>
</li>
<li>
<p>In the Name field, type a name for the instance.</p>
<p>The name must meet the following requirements:</p>
<ul>
<li>
<p>The name may contain only ASCII characters.</p>
</li>
<li>
<p>The name must start with a letter, a number, or an underscore.</p>
</li>
<li>
<p>The name may contain only the following characters:</p>
<ul>
<li>
<p>Lowercase letters</p>
</li>
<li>
<p>Uppercase letters</p>
</li>
<li>
<p>Numbers</p>
</li>
<li>
<p>Hyphen</p>
</li>
<li>
<p>Period</p>
</li>
<li>
<p>Underscore</p>
</li>
</ul>
</li>
<li>
<p>The name must be unique in the domain and must not be the name of another GlassFish Server instance, a cluster, a named configuration, or a node.</p>
</li>
<li>
<p>The name must not be <code>domain</code>, <code>server</code>, or any other keyword that is reserved by GlassFish Server.</p>
</li>
</ul>
</li>
<li>
<p>From the Node drop-down list, select the node where the instance will reside.</p>
</li>
<li>
<p>From the Configuration drop-down list, select the named configuration that the instance will use.</p>
<hr>
<p><b>Note:</b></p>
<p>If you select <code>default-config</code>, you must specify in the next step that the configuration is <i>not</i> shared. The <code>default-config</code> configuration cannot be shared.</p>
<hr>
</li>
<li>
<p>Specify whether the configuration that instance will use is shared.</p>
<ul>
<li>
<p>If the configuration is not shared, leave the Make a Copy of the Selected Configuration option selected.</p>
<p>The selected configuration is copied when the instance is created. The copy of the configuration is assigned the name <i>instance-name</i><code>-config</code>, where <i>instance-name</i> is the name of the instance that you are creating.</p>
</li>
<li>
<p>If the configuration is shared, select the Reference the Selected Configuration option.</p>
<p>The instance will use the specified existing named configuration.</p>
</li>
</ul>
</li>
<li>
<p>Click OK.</p>
</li>
</ol>
<a id="sthref126" name="sthref126"></a>
<h5>See Also</h5>
<ul>
<li>
<p><a href="task-delete-standalone-instances.html">To Delete Standalone GlassFish Server Instances</a></p>
</li>
<li>
<p><a href="task-start-standalone-instances.html">To Start Standalone GlassFish Server Instances</a></p>
</li>
<li>
<p><a href="task-stop-standalone-instances.html">To Stop Standalone GlassFish Server Instances</a></p>
</li>
<li>
<p><a href="task-view-logs-standalone-instance.html">To View Log Files for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-recovertransactions-standalone-instance.html">To Recover Transactions for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-app-deploy.html">To Deploy an Application to a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-app-list.html">To List Applications That Are Deployed to a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-app-undeploy.html">To Undeploy Applications From a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-app-remove.html">To Remove Applications From a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-app-edit.html">To Edit an Application That Is Deployed to a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-app-enable-disable.html">To Enable or Disable an Application That Is Deployed to a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-app-lb-enable-disable.html">To Enable or Disable Load Balancing for an Application That Is Deployed to a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-resource-create.html">To Create a Resource for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-resource-display.html">To List Resources for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-resource-enable-disable.html">To Enable or Disable a Resource for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-standalone-instance-resource-edit.html">To Edit a Resource for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-change-standalone-instance-ports.html">To Modify the Port Numbers of a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-set-props-standalone-instance.html">To Set Instance-Only Properties for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-mon-app-standalone-instance.html">To View Application Monitoring Data for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-mon-server-standalone-instance.html">To View Virtual-Server Monitoring Data for a Standalone GlassFish Server Instance</a></p>
</li>
<li>
<p><a href="task-mon-resource-standalone-instance.html">To View Resource Monitoring Data for a Standalone GlassFish Server Instance</a></p>
</li>
</ul>
<small>Copyright &#169; 2005, 2017, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></small>