| <!-- |
| |
| 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-virtualservercreate" name="task-virtualservercreate"></a><a id="GHWEB00036" name="GHWEB00036"></a></p> |
| |
| <h4><a id="sthref35" name="sthref35"></a>To Create a Virtual Server</h4> |
| <a name="BEGIN" id="BEGIN"></a> |
| <ol> |
| <li> |
| <p>In the navigation tree, expand the Configuration node.</p> |
| </li> |
| <li> |
| <p>Select the configuration that you are changing.</p> |
| </li> |
| <li> |
| <p>Under the Configuration node, select the Virtual Servers node.</p> |
| <p>The Virtual Servers page opens.</p> |
| </li> |
| <li> |
| <p>On the Virtual Servers page, click New.</p> |
| <p>The New Virtual Server page opens.</p> |
| </li> |
| <li> |
| <p>In the Id field, type a value that will identify the virtual server internally.</p> |
| <p>This value is not exposed to HTTP clients. The host names that are exposed to HTTP clients must be specified in the Hosts field.</p> |
| </li> |
| <li> |
| <p>In the Hosts field, type the host names or IP addresses for the machine on which the server is running.</p> |
| <p>Use either actual or virtual host names that are registered with the DNS server for your network (and, on a UNIX system, in your <code>/etc/hosts</code> file).</p> |
| <p>The default value is the system property value <code>${com.sun.aas.hostName}</code>.</p> |
| </li> |
| <li> |
| <p>Select a State option for the new virtual server.</p> |
| <p>The virtual server can be On (that is, active), Off, or Disabled. The default value is On.</p> |
| </li> |
| <li> |
| <p>Select an SSO option for the new virtual server.</p> |
| <p>By default, a virtual server inherits the single sign-on (SSO) setting of the HTTP service. Select Enabled or Disabled to override the HTTP service setting by enabling or disabling single sign-on for this virtual server.</p> |
| <p>Single sign-on across applications on the GlassFish Server is supported by servlets and JSP files. This feature allows multiple applications that require the same user sign-on information to share this information, rather than have the user sign on separately for each application.</p> |
| </li> |
| <li> |
| <p>From the Network Listeners drop-down list, select one or more network listeners, or leave the field blank.</p> |
| </li> |
| <li> |
| <p>From the Default Web Module drop-down list, select the module that is to respond to all requests that cannot be mapped to other web modules deployed to the virtual server.</p> |
| <p>If a default web module is not specified, the web module that has an empty context root is used. If there is no web module with an empty context root, a system default web module is created and used.</p> |
| </li> |
| <li> |
| <p>In the Log File field, type the path name of the file where logging messages from this virtual server will appear.</p> |
| <p>By default, logging messages will be sent to the default server log, <i>domain-dir</i><code>/logs/server.log</code>.</p> |
| </li> |
| <li> |
| <p>In the Docroot field, type the absolute path to the root document directory for the server.</p> |
| <p>If the field is left blank, <i>domain-dir</i><code>/docroot</code> will be used.</p> |
| </li> |
| <li> |
| <p>Select an Access Logging option to enable or disable access logging.</p> |
| <p>Alternatively, you can specify if access logging is inherited from the HTTP Service. By default, it is inherited from the HTTP Service.</p> |
| </li> |
| <li> |
| <p>In the Directory field, type the absolute directory path to the server access logs.</p> |
| <p>The default value is <i>domain-dir</i><code>/logs/access</code>.</p> |
| </li> |
| <li> |
| <p>In the Additional Properties section, specify additional properties for the virtual server.</p> |
| <p>For information on available properties, see <a href="ref-virtualserverprops.html">Properties Specific to Virtual Servers</a>.</p> |
| <p>To add a property, click the Add Property button. In the blank row that appears, type the property name in the Name field, and type the property value in the Value field.</p> |
| </li> |
| <li> |
| <p>Click OK.</p> |
| </li> |
| </ol> |
| <a id="sthref36" name="sthref36"></a> |
| <h5>See Also</h5> |
| <ul> |
| <li> |
| <p><a href="task-virtualserveredit.html">To Edit a Virtual Server</a></p> |
| </li> |
| <li> |
| <p><a href="task-virtualserverdelete.html">To Delete a Virtual Server</a></p> |
| </li> |
| </ul> |
| |
| |
| <small>Copyright © 2005, 2017, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></small> |