Kusu-addhost(8)			   Kusu Base		       Kusu-addhost(8)



NAME
       kusu-addhost - Add hosts to the Kusu cluster.

SYNOPSIS
       kusu-addhost [-h|-v|-u]

       kusu-addhost [-e {nodes_to_remove}]
	  - Remove Node(s)

       kusu-addhost [-p {nodes_to_replace}]
	  - Replace Node

       kusu-addhost [-s staticHostname -x ip_addr]
	  - Add an unmanaged host with a static IP.

       kusu-addhost [-s staticHostname -i ifname]
	  - Add an unmanaged host with a dynamic IP.

       kusu-addhost [-i ifname -n {node group} [-r rack #]]
	  - Add Host(s)

       kusu-addhost [-f file -j ifname -n {node group} [-r rack#]]
	  - Import MAC addresses (for managed nodegroups only)

       kusu-addhost [-f file -n {node group}]
	  - Import unmanaged hosts file (for unmanaged nodegroup only)

       You  use	 -b  with any of the usages above to run kusu-addhost in batch
       mode.

DESCRIPTION
       Kusu-addhost is a tool for adding/removing nodes (hosts) from the clus-
       ter.  The tool provides a Textual User Interface (TUI) when run with no
       arguments.  The tool will prompt for the information it	needs  to  add
       hosts.	The  use  of this tool can be scripted and allows for the bulk
       addition of files through a MAC file.

       The nodes in the cluster that are managed by Kusu must be configured to
       boot  from  the	network using PXE.  When adding nodes the kusu-addhost
       tool should be run prior to booting the new nodes.

       When adding nodes to the cluster interactively the tool will prompt for
       the nodegroup to add the hosts to and the network to listen on.	If the
       name format used by the nodegroup uses the rack	number	it  will  also
       prompt  for  the	 rack number.  The nodegroup the node is added to will
       control the installation of the node.  The network to  listen  on  will
       control	which network the installer node will listen for DHCP requests
       on.  The installer can install nodes from more than one NIC.

       Node names are assigned based on the nodegroups Name Format.   This  is
       editable	 using	kusu-ngedit, provided there are no nodes in that node-
       group.

       Nodes of managed nodegroups may be added in bulk once  a	 MAC  file  is
       provided.   The	file should contain a list of the MAC addresses of the
       nodes in the order that they should be named.

       Nodes of unmanaged nodegroups may be added in bulk is once a  unmanaged
       hosts file is provided. The file should contain a list of the unmanaged
       node records in <static host name>:<static IP address> format.

       The tool has the following options:


OPTIONS
       -e <List of Nodes>, --remove <List of Nodes>
	      A space separated list of nodes to remove.

       -f <File>, --file=<File>
	      Specifies the name of the	 file,	containing  the	 Ethernet  MAC
	      addresses	 of the managed nodes or the unmanaged node records in
	      <static host name>:<static IP address> format, to	 be  added  to
	      the  cluster.  This  option  must be used with the -n and -j and
	      possibly -r to import MAC file for managed  nodes.  This	option
	      must  only  be  used  with the -n when importing unmanaged hosts
	      file for unmanaged nodes.

       -h, --help
	      Print the help information and exit.

       -i <Interface>, --interface=<Interface>
	      The Interface on the Installer node to listen for DHCP requests.
	      DHCP requests on this interface will trigger adding this node to
	      the cluster.  This is not the same as the boot interface of  the
	      installing  nodes.   This	 option is used in conjunction with -n
	      and possibly -r

       -j <Node Interface>, --node-interface=<Node Interface>
	      The Node Interface is the interface  of  the  node(s)  that  are
	      being  installed	to associate the MAC address from the MAC file
	      with.  This is not the same as the Installers  interface.	  This
	      option is used in conjunction with -f, -n and possibly -r.

       -n <Nodegroup>, --nodegroup=<Nodegroup>
	      Specifies the name of the nodegroup to add new nodes to.

       -p <Nodename>, --replace=<Nodename>
	      Run  the	tool  and  replace  the	 node with a new system.  This
	      option is used to replace existing hardware, without  having  to
	      swap  out the NIC cards.	When this option is used the tool will
	      wait for the replacement node to boot to gather its MAC address.

       -r <Rack Number>, --rack=<Rack Number>
	      Specifies	 the  rank  number  to associate the nodes with.  This
	      option is only needed if the nodegroup specified	by  -n	has  a
	      name  format that has the rank number as part of the nodes name.

       -s <Static Hostname>, --static=<Static Hostname>
	      Specifies the name of a host to add to the cluster.   This  host
	      will be listed in the hosts and DNS records of the cluster.  The
	      host will belong to the Unmanaged	 nodegroup.   This  option  is
	      used in conjunction with -x

       -u, --update
	      Calls the addhost plugins to update the configuration files.

       -v, --version
	      Print the version information and exit.

       -x <IP Address>, --ip-address=<IP Address>
	      Specifies	 the  IP  address of the unmanaged node that was named
	      with the -s option.

       -b, --batch
	      Runs the addhost tool in non-graphical batch mode

       -c <Rank Number>, --rank=<Rank Number>
	      Use a different rank value to start with instead of 0.

       More commandline options can be provided by plugins.  Run 'kusu-addhost
       --help' for documentation on those.

FILES
       /opt/kusu/lib/plugins/addhost/*

AUTHORS
       Shawn Starr <sstarr_at_platform_dot_com>

SEE ALSO
       kusu-nghosts(8)



Mark Black			Version: 2.0.1		       Kusu-addhost(8)