arrayconfig - configure a simple array


SYNOPSIS

       arrayconfig [-d] [-i] [-m] [-a arrayname] hostname...


DESCRIPTION

       arrayconfig  is  a  tool for configuring a simple array of
       systems.  It can perform the following tasks:

        - Generate an array configuration file (arrayd.conf) con­
          taining  an  array definition for the nodes in a single
          array.

        - Distribute an array configuration file to the nodes  in
          an array and activate array services on them.

        - Update  the  "array services machine identifier" on the
          local system or all of the systems in  the  array  that
          support them.

       The  arrayconfig  command  itself has several command line
       options.  The valid options include:

       -a arrayname
              Sets the name of the array that  is  defined  using
              the  -m  option.   If this option is not specified,
              the name "default" is used.

       -d     (Distribute) Copies the  arrayd.conf  file  on  the
              current  system to each of the systems specified by
              the hostname arguments, then activates  array  ser­
              vices on those systems.

       -i     (ID)  Sets  the "array services machine identifier"
              on the local machine, or on each of the machines in
              the  array  if  the  -d  option was also specified.
              This allows the system  to  generate  global  array
              session  handles  without contacting the array ser­
              vices daemon, which improves the startup  time  for
              new  array  sessions.   The  actual  identifier  is
              formed from the last 15 bits of each machine's host
              ID  (see  hostid(1)  for  more  information).   The
              change does not take effect until  the  system  has
              been rebooted.  The system must be running at least
              version 6.5 of IRIX for this function to work.

       -m     (Make) Generates an arrayd.conf file  containing  a
              single  array definition.  The name of the array is
              taken from the -a option (if specified).  The indi­
              vidual  machines  in  the  array are taken from the
              hostname arguments, which  should  specify  network
              hostnames  for the machines.  At least one hostname
              must be specified.  The array is designated as  the


Typically  the  arrayconfig  command  is  only run once, when the
array is first setup.  The options can be combined to  initialize
the  array  configuration in a single step if no special require­

ments exist: arrayconfig -d -i -m -a MyArray Node1 Node2 Node3


Node4 This sets up an array consisting of four machines


(Node1-Node4). The name of the array is be "MyArray". The


resulting configuration file is copied to all machines in the


array, and array services are activated (or reactivated, if


already running) on each machine. Each machine also has its


array services machine identifier set, although the change does


not take effect until each machine has been rebooted.


If it is necessary to make local modifications to the arrayd.conf
file before distributing it to the machines in the array,  array­

config should be invoked twice: arrayconfig -m -a MyArray Node1


Node2 Node3 Node4 (edit /usr/lib/array/arrayd.conf to taste)


arrayconfig -d -i Node1 Node2 Node3 Node4



SEE ALSO

       arrayd(1M), arrayd.conf(4), array_services(5).


Man(1) output converted with man2html