NAME

site - a table in the xCAT database.


SYNOPSIS

site Attributes: key, value, comments, disable


DESCRIPTION

Global settings for the whole cluster. This table is different from the other tables in that each attribute is just named in the key column, rather than having a separate column for each attribute. The following is a list of the attributes currently used by xCAT.


site Attributes:

key

Attribute Name: Description

 auditskipcmds: List of commands that will not be written to the auditlog table.
                ALL - means all cmds will be skipped. If attribute null, all
                commands will be written.
                For example: tabdump,nodels,lsdef will not log those cmds.
                ALL will not log any cmds.
 blademaxp:  The maximum number of processes for blade hardware control.
 cleanupxcatpost:  (yes/1 or no/0). Set to 'yes' or '1' to clean up the /xcatpost directory
                   on the stateless and statelite nodes after the postscripts are run.
                   Default is no.
 consoleondemand:  When set to 'yes', conserver connects and creates the console
                   output only when the user opens the console. Default is no on
                   Linux, yes on AIX.
 databaseloc:    Directory where we create the db instance directory (db2).
                 Default is /var/lib. Only DB2 is currently supported. 
                 Do not use the directory in the site.installloc attribute.
 db2installloc:  The location which the service nodes should mount for 
                 the db2 code to install. Format hostname:/path.  If hostname is
                 omitted, it defaults to the management node. Default /mntdb2.
 defserialflow:  The default serial flow - currently only used by the mknb command.
 defserialport:  The default serial port - currently only used by mknb.
 defserialspeed:  The default serial speed - currently only used by mknb.
 dhcpinterfaces:  The network interfaces DHCP should listen on.  If it is the same
                  for all nodes, use simple comma-separated list of NICs.  To
                  specify different NICs for different nodes:
                       mn|eth1,eth2;service|bond0.
 dhcpsetup:  If set to 'n', it will skip the dhcp setup process in the nodeset cmd.
 disjointdhcps:  If set to '1', the .leases file on a service node only contains
                 the nodes it manages. The default value is '0'.
 dnshandler:  Name of plugin that handles DNS setup for makedns.
 domain:  The DNS domain name used for the cluster.
 ea_primary_hmc:  The hostname of the HMC that the Integrated Switch Network
                  Management Event Analysis should send hardware serviceable
                  events to for processing and potentially sending to IBM.
 ea_backup_hmc:  The hostname of the HMC that the Integrated Switch Network
                  Management Event Analysis should send hardware serviceable
                  events to if the primary HMC is down.
 enableASMI:  (yes/1 or no/0). If yes, ASMI method will be used after fsp-api. If no,
               when fsp-api is used, ASMI method will not be used. Default is no.
 excludenodes:  A set of comma separated nodes and/or groups that would automatically
                be subtracted from any noderange, it can be used for excluding some
                failed nodes for any xCAT commands. See the 'noderange' manpage for
                details on supported formats.
 forwarders:  The DNS servers at your site that can provide names outside of the
              cluster. The makedns command will configuire the DNS on the management node
              to forward requests it does not know to these servers.
              Note that the DNS servers on the service nodes will ignore this value
              and always be configured to forward requests to the management node.
 fsptimeout:  The timeout, in milliseconds, to use when communicating with FSPs.
 genmacprefix:  When generating mac addresses automatically, use this manufacturing
                prefix (e.g. 00:11:aa)
 genpasswords:  Automatically generate random passwords for BMCs when configuring
                them.
 installdir:  The local directory name used to hold the node deployment packages.
 installloc:  The location from which the service nodes should mount the 
              deployment packages in the format hostname:/path.  If hostname is
              omitted, it defaults to the management node. The path must
              match the path in the installdir attribute.
 ipmimaxp:  The max # of processes for ipmi hw ctrl.
 ipmiretries:  The # of retries to use when communicating with BMCs.
 ipmisdrcache:  If set to 'no', then the xCAT IPMI support will not cache locally
                the target node's SDR cache to improve performance.
 ipmitimeout:  The timeout to use when communicating with BMCs.
 iscsidir:  The path to put the iscsi disks in on the mgmt node.
 master:  The hostname of the xCAT management node, as known by the nodes.
 maxssh:  The max # of SSH connections at any one time to the hw ctrl point for PPC.
          This parameter doesn't take effect on the rpower command.
          It takes effects on other PPC hardware control command  getmacs/rnetboot/rbootseq and so on.
          Default is 8.
 mnroutenames:  The name of the routes to be setup on the management node.
            It is a comma separated list of route names that are defined in the routes table.
 nameservers:  A comma delimited list of DNS servers that each node in the cluster
               should use. This value will end up in the nameserver settings of the
               /etc/resolv.conf on each node. It is common (but not required) to set
               this attribute value to the IP address of the xCAT management node, if you have
               set up the DNS on the management node by running makedns.
               In a hierarchical cluster, you can also set this attribute to "<xcatmaster>"
               to mean the DNS server for each node should be the node that is managing it
               (either its service node or the management node).
 nodestatus:  If set to 'n', the nodelist.status column will not be updated during
              the node deployment, node discovery and power operations.
 ntpservers:  A comma delimited list of NTP servers for the cluster - often the
              xCAT management node.
 syspowerinterval:  The time of seconds that rpower command on CECs will wait between.
                 The CECs should be in the same frame. It is used for controlling the
                 CECs boot up speed. Default is 0.
 powerinterval:  The time of seconds that rpower command will wait between
                 performing action on each target object.
                 It is used for controlling the cluster boot up speed
                 in large clusters. Default is 0.
                 And it's used to control the time for the power command on each lpar by each hcp.
 ppcmaxp:  The max # of processes for PPC hw ctrl. If there are more than ppcmaxp hcps,
           this parameter will take effect. It will control the max number of processes  
           for PPC hardware control commands. Default is 64.
 ppcretry:  The max # of PPC hw connection attempts before failing.
 ppctimeout:  The timeout, in milliseconds, to use when communicating with PPC hw.
 pruneservices:  Whether to enable service pruning when noderm is run (i.e.
                 removing DHCP entries when noderm is executed)
 rsh:  This is no longer used. path to remote shell command for xdsh.
 rcp:  This is no longer used. path to remote copy command for xdcp.
 sharedtftp:  Set to 0 or no, xCAT should not assume the directory
              in tftpdir is mounted on all on Service Nodes. Default is 1/yes.
              If value is set to a hostname, the directory in tftpdir
              will be mounted from that hostname on the SN
 skiptables:  Comma separated list of tables to be skipped by dumpxCATdb
 SNsyncfiledir:  The directory on the Service Node, where xdcp will copy the files
                 from the MN that will eventually be copied to the compute nodes.
 snmpc:  The snmp community string that xcat should use when communicating with the
         switches.
 sshbetweennodes:  Comma separated list of groups to enable passwordless root 
                   ssh during install, or xdsh -K. Default is ALLGROUPS.
                   Set to NOGROUPS,if you do not wish to enabled any groups.
                   Service Nodes are not affected by this attribute
                   they are always setup with
                   passwordless root access to nodes and other SN.
 svloglocal:  if set to 1, syslog on the service node will not get forwarded to the
              mgmt node.
 timezone:  (e.g. America/New_York)
 tftpdir:  tftp directory path. Default is /tftpboot
 useNmapfromMN:  When set to yes, nodestat command should obtain the node status
                 using nmap (if available) from the management node instead of the
                 service node. This will improve the performance in a flat network.
 useSSHonAIX:  (yes/1 or no/0). If yes, ssh/scp will be setup and used. If no,
               rsh/rcp will be setup and used on AIX. Default is yes.
 vcenterautojoin:  When set to no, the VMWare plugin will not attempt to auto remove
                   and add hypervisors while trying to perform operations.  If users
                   or tasks outside of xCAT perform the joining this assures xCAT
                   will not interfere.
 vmwarereconfigonpower:  When set to no, the VMWare plugin will make no effort to
                         push vm.cpus/vm.memory updates from xCAT to VMWare.
 vsftp:       Default is 'y'. If set to 'n', the xcatd on the mn will not automatically 
              bring up the vsftpd. This setting does not apply to the sn, for sn
              you need to set servicenode.ftpserver=0 if you do not want the xcatd
              bring up vsftpd.
 xcatconfdir:  Where xCAT config data is (default /etc/xcat).
 xcatdport:  The port used by the xcatd daemon for client/server communication.
 xcatiport:  The port used by xcatd to receive install status updates from nodes.
value

The value of the attribute specified in the ``key'' column.

comments

Any user-written notes.

disable

Set to 'yes' or '1' to comment out this row.


SEE ALSO

nodels(1), chtab(8), tabdump(8), tabedit(8)