New Node

Use the New Node page to create a GlassFish Server node. A node represents a host on which the GlassFish Server software is installed. A node must exist for every host on which GlassFish Server instances reside.

The options that the New Node page contains depend on the type of the node.

Options for All Types of Nodes

The following options are available for all types of nodes:

Name

The name of the node.

The name must meet the following requirements:

Type

Drop-down list to specify the type of the node, which is one of the following types:

CONFIG

The node does not support remote communication. If CONFIG, is selected, no options for SSH configuration or DCOM configuration are displayed and the Installation Directory field is cleared.

DCOM

The node supports communication over the Distributed Component Object Model (DCOM) remote protocol. The DCOM protocol is available only on Windows systems.

SSH

The node supports communication over secure shell (SSH).

Node Host

The name of the host that the node represents. Whether this field is mandatory depends on the type of the node:

Node Directory

The path to the directory that is to contain GlassFish Server instances that are created on the node. If a relative path is specified, the path is relative to the as-install directory.

The default depends on the type of the node:

Installation Directory

The full path to the parent of the base installation directory of the GlassFish Server software on the host, for example, /export/glassfish3.

The default depends on the type of the node:

Additional Options for DCOM Nodes

The following options are available only if the Type field is set to DCOM:

Install GlassFish Server

If the Enabled option is selected, the DAS will copy GlassFish Server software from the DAS host to the node host. To copy GlassFish Server software to the host, the DAS must be able to contact the host through DCOM.

Force

If the Enabled option is selected, the node is created in the DAS configuration even if validation of the node's parameters fails. To validate a node's parameters, the DAS must be able to contact the node's host through DCOM.

Validate DCOM

If the Enabled option is selected, GlassFish Server tests the connection over DCOM to the node host before creating the node. As part of the test, GlassFish Server copies a script that is named delete_me.bat to the host.

If you select this option, the Remote Test Directory field is activated to enable you to provide the directory to which GlassFish Server should copy the script.

Remote Test Directory

The folder on the remote host in which GlassFish Server should create the delete_me.bat file. The user that the Windows User Name option specifies must have write access to this folder. Otherwise, an error occurs. The default is C:\.

Windows Domain

The name of the Windows domain that contains the user that the Windows User Name option specifies. The default is the name of the host on which the Administration Console is running.

Windows User Name

The user on this node's host that is to run the process for connecting to the host through DCOM. The default is the user that is running the DAS process. If the Node Host option is set to localhost-domain, the Windows User Name option is ignored.

Windows User Authentication

Drop-down list to specify how the Windows user is authenticated when logging in to this node's host. The possible methods for authentication are as follows:

Password

The Windows user is authenticated through a password that is stored in the DAS configuration.


Caution:

This password is stored in clear text in the DAS configuration. For enhanced security, use a password alias.


If you select this option, the Windows User Password field is activated to enable you to provide the password.

Password Alias

The Windows user is authenticated through a password alias. If you select this option, select the password alias from the Password Alias drop-down list.

Windows User Password

The password that the Windows user will use when logging in to this node's host.

Password Alias

Drop-down list of password aliases that are defined for this domain.

Additional Options for SSH Nodes

The following options are available only if the Type field is set to SSH:

Install GlassFish Server

If the Enabled option is selected, the DAS will copy GlassFish Server software from the DAS host to the node host. To copy GlassFish Server software to the host, the DAS must be able to contact the host through SSH.

Force

If the Enabled option is selected, the node is created in the DAS configuration even if validation of the node's parameters fails. To validate a node's parameters, the DAS must be able to contact the node's host through SSH.

SSH Port

The port to use for SSH connections to this node's host. The default is 22. If the Node Host option is set to localhost-domain, the SSH port option is ignored.

SSH User Name

The user on this node's host that is to run the process for connecting to the host through SSH. The default is the user that is running the DAS process. To ensure that the DAS can read this user's SSH private key file, specify the user that is running the DAS process. If the Node Host option is set to localhost-domain, the User Name option is ignored.

SSH User Authentication

Drop-down list to specify how the SSH user is authenticated when logging in to this node's host. The possible methods for authentication are as follows:

Key File

The SSH user is authenticated through an SSH private key file. If you select this option, specify the absolute path to the file in the Key File field.

Password

The SSH user is authenticated through a password that is stored in the DAS configuration.


Caution:

This password is stored in clear text in the DAS configuration. For enhanced security, use a key file or a password alias.


If you select this option, the SSH User Password field is activated to enable you to provide the password.

Password Alias

The SSH user is authenticated through a password alias. If you select this option, select the password alias from the Password Alias drop-down list.

Setup SSH

If the Enabled option is selected, GlassFish Server sets up an SSH key on the node host. GlassFish Server sets up the SSH key by copying existing key files from the DAS host or, if required, by generating the files before copying the files. This option is available only if the SSH User Authentication option is set to Key File.

Generate Key

If the Enabled option is selected, GlassFish Server generates the SSH key files before copying the files to the node host if the files do not exist. If the SSH key files exist, GlassFish Server does not generate the files, even if the Enabled option is selected.


Note:

If the SSH key files do not exist, the Enabled option must be selected. Otherwise, an error occurs when you attempt to save your changes.


SSH User Password

The password that the SSH user will use when logging in to this node's host.

Password Alias

Drop-down list of password aliases that are defined for this domain.

Public Key File

The absolute path to the SSH public key file for user that the SSH User Name option specifies. The content of the public key file is appended to the user's .ssh/authorized_keys file on the node host. If the .ssh/authorized_keys file does not exist on the host, GlassFish Server creates the file.

Key File

The absolute path to the SSH private key file for user that the SSH User Name option specifies. This file is used for authentication to the sshd daemon on the node's host.


Note:

GlassFish Server also supports password authentication through the AS_ADMIN_SSHPASSWORD entry in the password file. The password file is specified in the --paswordfile option of the asadmin(1) utility.


If the SSH private key file is protected by a passphrase, the password file must contain the AS_ADMIN_SSHKEYPASSPHRASE entry.

The path to the key file must be reachable by the DAS and the key file must be readable by the DAS.

The default is a key file in the user's .ssh directory. If multiple key files are found, GlassFish Server uses the following order of preference:

  1. id_rsa

  2. id_dsa

  3. identity

Related Tasks

To Create a Node

Equivalent asadmin Subcommands
Copyright © 2005, 2017, Oracle and/or its affiliates. All rights reserved. Legal Notices