Category:Node

From ControlTier

The Node Type represents a computer host registered in a ControlTier project. The command dispatcher can execute commands to any registered Node. Nodes are also used to when modeling Services and Packages deployments.

Reference

• Node Reference

Core type model

Definition

Metadata

Each Node is described with these properties:

Nodes can be defined in a project resource model in one of several ways:

• Graphical resource editor: In Workbench
• Via modelutil command: modelutil's node-set command
• Project XML: project.xml
• Client setup: Using ctl-project

Each of these methods is described in their own section below.

Graphical resource editor

Nodes can be defined using the Graphical resource editor. From the home page, go to the "Node Manager". Once there press the "Create new object" button. Pressing that button will direct the browser to the node creation form.

Via modelutil command

Nodes can be registered via the modelutil node-set command:

ctl -p demo -m modelutil -c node-set --\
	-name centos2 -hostname centos2 -osfamily unix -osname Linux -osarch i386 -ctluser alexh -tags mytag -description 'second centos host'

This example shows how a host named "centos2" is registered as a node in the project named "demo".

Project XML

A node can be defined in XML using the project.xml format. Here is an example.

<!DOCTYPE project PUBLIC
        "-//ControlTier Software Inc.//DTD Project Document 1.0//EN" "project.dtd">
<project>
 
  <node name="development" type="Node"
    description="a development host"
    hostname="development"
    osArch="i386" osFamily="unix" osName="Darwin" osVersion="9.2.2"
    ctlBase="" ctlHome="" ctlUsername="demo" ctlPassword=""
    tags="mac,development"/>
 
</project>

You can load this XML file using the ProjectBuilder load-resources command like so:

ctl -p demo -m ProjectBuilder -c load-resources -- -filename node.xml

This XML definition is loaded to the "demo" project maintained on the server.

Client setup

On nodes where the ControlTier client is installed, hosts are registered as nodes during project setup with ctl-project. During project setup, the ctl-project command registers the node in the specified project name.

Querying

You can lookup registered nodes from the command line.

The ctl-exec command can list all registered nodes. Run it without arguments:

ctl-exec -p project

You can also use the ProjectBuilder find-resources command to query with criteria:

ctl -p project -m ProjectBuilder -c find-resources -- -type Node -name 'dev.*'

The modelutil find command can also query the resource model for matching Nodes.

For a graphical alternative, you can use the Graphical resource editor and view the nodes there.

Go to the Node list. You will see it list all nodes.