Lat-hosts

From SME Server
Revision as of 17:53, 24 June 2013 by Stephdl (talk | contribs) (Created page with "===lat-hosts=== The lazy administrator's tool to manage hostnames ===DESCRIPTION=== Creates or deletes hosnames on Mitel's SME servers. This tool is func- tion...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

lat-hosts

The lazy administrator's tool to manage hostnames

DESCRIPTION

      Creates or deletes hosnames on Mitel's SME servers.  This tool is func-
      tionally equivalent to the 'Hostnames and addresses' option in the
      server-manager, but can be run from the command line or called from an
      other script.  It allows you, for example, to create a large number of
      hostnames in a batch process, or delete hostnames on a remote machine
      via an ssh console.
      See /usr/doc/lazy-admin-tools/example.hosts for the format of the input
      file.

Smecontribs repository for SME Server

yum install --enablerepo=smecontribs smeserver-lazy_admin_tools
signal-event post-upgrade; signal-event reboot

SYNOPSIS

      lat-hosts -a -c "host| domain| loc. | visib. | loc.ip | glob.ip | mac"
      lat-hosts -a -i /path/to/hosts.list
      lat-hosts -d [-f] -c "Host | Domain"
      lat-hosts -d [-f] -i /path/to/hosts.list

OPTIONS

      The following options are supported:
      -a, --add
          Add a host name to the server
      -c ""Arguments"", --command-line=""Arguments""
          Take arguments from the command line. See below for the various
          arguments that are accepted.
      -d, --delete
          Delete a hostname from the server.  Wildcards (* and ?) are
          accepted.
      -f, --force
          Don't prompt before deleting.
      -h, --help
          Extended help for this tool
      -i FILE, --input-file=FILE
          Use the information from FILE to create or delete the hostname(s).
      Arguments:
         host*      : Must contain only letters, numbers, and hyphens,
                      and must start with a letter or number. Wildcards
                      (* and ?) can only be used to delete hostnames.
         domain     : Must be an existing (virtual) domain name. If
                      omitted, the primary site is assumed.
         loc.       : Location of the server:
                      'Local' (on the LAN)
                      'Remote' (on the Internet)
                      'Self' (alias for the SME server)
         visib.     : 'Local' (only visible on the LAN)
                      'Global' (visible on the entire Internet).
         loc.ip     : Internal IP number
         glob.ip    : Public IP number
         mac        : The ethernet address is optional and causes the
                      DHCP server to statically bind the local IP address
                      to the computer with this ethernet address.
         * mandatory field

EXAMPLES

lat-hosts -a -c "ntp | hogwarts.net | self | local"
      Creates host name 'ntp.hogwarts.net' on the SME server. The host name
      will be visible only on the LAN.
lat-hosts -a -i /root/hosts.list
      Creates the host names defined in /root/hosts.list. Refer to
      /usr/doc/lazy-admin-tools/example.hosts for an example of an input
      file.
lat-hosts -d -f -c "ftp*"
      Deletes all host names that start with 'ftp'. The host names will be
      deleted without prompting (-f).