kusu-netedit(8)			   Kusu Base		       kusu-netedit(8)



NAME
       kusu-netedit - Network editor for nodegroups.

SYNOPSIS
       kusu-netedit  - For normal interactive operation

       kusu-netedit [-h|-l|-v]	- For information

       kusu-netedit  [-a  -n  network  -s  subnet -i ifname -t start_ipaddr -g
       gateway -e {network description} -x suffix [-o {network options}] [-y |
       -z] [-r increment]]

       kusu-netedit  [-c netid# -n network -s subnet -i ifname -t start_ipaddr
       -g gateway -e {network description} [-x suffix] [-o {network  options}]
       [-y | -z]] [-r increment]

       kusu-netedit  [-w netid# [-x suffix] [-o network options] [-y | -z] [-t
       start_ipaddr] [-e {network description}] [-r increment]]


DESCRIPTION
       The kusu-netedit tool is for managing the networks in the cluster.   It
       is  used	 to define the characteristics of a NIC in a nodegroup.	 There
       may be several networks defined	all  on	 the  same  network  but  with
       slightly different properties, such as starting IP, or interface.

       The tool is used in conjunction with kusu-ngedit to define how the NICs
       on the installed nodes should be configured.  The NICs configured  need
       not  be directly connected to the installer nodes network(s).  Only one
       NIC on a provisioned node needs to be on the  same  network(s)  as  the
       installer.

       The tool works in a Textual User Interface (TUI) mode when no arguments
       are provided, prompting for the information needed.

       When a network is in use (has a nodegroup using it with	at  least  one
       node)  kusu-netedit  will  prevent  some	 of  the parameters from being
       changed.

       The following options are available:

OPTIONS
       -h, --help
	      Provides some basic help information and exits.

       -c <NetID>, --change=<NetID>
	      Change the network defined by the NetID.	Use the -l  option  to
	      get  the	NetID.	 Not all network properties will be changeable
	      once a nodegroup using this network has a node in it.

       -d <NetID>, --delete=<NetID>
	      Delete the network defined by the NetID.	Use the -l  option  to
	      get the NetID.

       -e <Description>, --description=<Description>
	      A text string describing the use for the network.

       -g <Gateway>, --gateway=<Gateway>
	      The  gateway  to	use  for  this	network.  This is used for the
	      default gateway on a node.  The nodegroup only supports one.

       -i <NIC Interface>, --interface=<NIC Interface>
	      The NIC interface the network configuration should be associated
	      with.

       -l, --list-networks
	      Print out a list of all networks and exit.

       -n <Network>, --network=<Network>
	      The Network this is on e.g. 192.168.23.0

       -o <Options>, --options=<Options>
	      The  options  field is in support of various networking options.
	      It has no effect at this time.

       -r <Increment>, --increment=<Increment>
	      The amount to change the IP address by when adding nodes.	  This
	      may be positive or negative.  The default is 1.

       -s <Subnet>, --subnet=<Subnet>
	      The subnet to use when adding or changing a network.

       -t <Start IP>, --starting-ip=<Start IP>
	      The IP address to start assigning nodes to.  This in conjunction
	      with the increment option -i determines the IP  address  of  the
	      next added node.

       -v, --version
	      Prints the version number and exits.

       -w <Network ID>, --change-used-network=<Network ID>
	      This  is the network ID from the -l output.  This option is used
	      to change networks that are already in use.  Only	 some  parame-
	      ters  of a used network can be changed.  This option can be used
	      with: -t, -e, -r, -o, -y, -z.

       -x, --suffix
	      Specify the suffix, this is mandatory when using -a.

       -y, --provision-type
	      Sets the network type to provisioned when adding or  changing  a
	      network.

       -z, --public-type
	      Sets  the	 network type to public when adding or changing a net-
	      work.


EXAMPLES
       Normal invocation:

	  kusu-netedit

       Listing networks:

	  kusu-netedit -l

       Adding the network  192.168.10.0,  with	subnet	mask  255.255.255.128,
       using  eth0.   Nodes  will be numbered from 192.168.10.45.  The name of
       the network will be Test Network.

	  kusu-netedit -a  -n  192.168.10.0  -s	 255.255.255.128  -i  eth0  -t
       192.168.10.45 -e 'Test Network' -x '-eth0' -y

AUTHORS
       Shawn Starr <sstarr_at_platform_dot_com>

SEE ALSO
       kusu-ngedit(8) kusu-nghosts(8)



Mark Black			Version: 2.0.1		       kusu-netedit(8)