Installing or Syncing Nodes

You can install or sync a node from the GUI or by using the CLI.

Prerequisites

Clicking the Install or Sync button either installs the node or syncs the node by applying the latest configuration changes.

The install or sync action performs any of the following actions:
  • Creates the node on the host. This action is skipped if the node is installed or running.
  • Applies updated configuration changes.
  • Installs features.
  • Update the port number.
  • Update the JVM values
  • Enables or disables debuggers.
  • Installs the platform applications and associated resource instances.
Note: To complete the installation process, the node must be started.

GUI

Procedure

  1. Navigate to a nodes list.
  2. In the Nodes list, click one or more nodes.
  3. Choose an install option.
    Install Option Effect
    Install or Sync or

    Install or Sync > Install/ Sync

    If the Runtime State is Not Installed, the node runtime files are created in the file system, the Runtime State changes to Not Running and the Action History is Platform Install will resume after node start.

    If the Runtime State is Not Running or Running, there is no change.

    Install or Sync > Install with Resolve

    Using the Resolve mode will cause the node to restart (and by extension all components and bindings on the node).

    Applies changes to the node's configuration to the runtime and causes all applications deployed on the node to use the latest versions of the features on which they depend.

    Install or Sync > Resolve only

    Causes all applications deployed on the node to use the latest versions of the features on which they depend.

  4. If the Action History is Platform Install waiting for node start, click Start.
    The Runtime State changes to Running and the Action History changes to In Progress and then to Start Successful.

CLI

Procedure

  1. In the data file, specify an Environment and one or more Node definitions in base format. You can also use a data file previously used to create the nodes in which the nodes are specified in full format.
    <Environment name="DevEnvironment" 
    		<Node name="node1"/>
    		<Node name="node2"/>
    </Environment>
  2. In the build file, set the action attribute of the AMXAdminTask element to install and the objectSelector attribute to Environment/Node.
    <AMXAdminTask action="install" objectSelector="Environment/Node" />