Manual Pages

Table of Contents

NAME

setup - update filer configuration

SYNOPSIS

setup

DESCRIPTION

setup queries the user for the basic filer configuration parameters such as hostname, IP address, and timezone. It installs new versions of /etc/rc, /etc/hosts, /etc/exports, /etc/resolv.conf, /etc/hosts.equiv, and /etc/dgateways to reflect the new configuration. When setup completes, the configuration files have been been updated, but their new contents do not take effect until the filer is rebooted (see na_reboot(1)). The old contents of the configuration files are saved in rc.bak, exports.bak, resolv.conf.bak, hosts.bak, and dgateways.bak.

One piece of information that setup requests is the name and IP address for adminhost. In /etc/exports, adminhost is granted root access to / so that it can access and modify the configuration files in /etc. All other NFS clients are granted access only to /home. If no adminhost is specified, then all clients are granted root access to /. This is not recommended for sites where security is a concern.

If an adminhost is specified, then an additional line is added to the /etc/hosts file to point the default mailhost to the adminhost. This is used by the autosupport daemon (see na_autosupport(8)) to send email notification.

If a default gateway is provided to setup, it will be used in /etc/rc to specify a default route (see na_route(1)), and will also be used as the first entry in /etc/dgateways.

The hostname that is provided to setup is used to construct default names for all of the configured network interfaces. Ethernet interfaces are given names hostname-0, hostname-1, and so on. The FDDI interfaces are named hostname-f0, hostname-f1, and so on, and the ATM interfaces are named hostname-a0, hostname-a1, and so on.

EXAMPLE

  toaster> setup
          NetApp Release 4.0: Thu Oct 31 17:54:48 PST 1996
          System ID: 0000607626
  Please enter the new hostname, using a
  fully-qualified name if running DNS [toaster]: toaster.netapp.com
  Please enter IP address for Ethernet ns0: 192.9.200.100
  Please enter netmask [255.255.255.0]:
  Please enter media type for Ethernet ns0 {thick, tp} [tp]:
  Please enter IP address for Ethernet ns1: 192.9.201.100
  Please enter netmask [255.255.255.0]:
  Please enter media type for Ethernet ns1 {thick, tp} [tp]:
  Please enter name of default gateway []: MyRouterBox
  Please enter IP address for MyRouterBox: 192.9.200.1
          The administration host is given root access to the filer's
          /etc files for system administration.  To allow /etc root access
          to all NFS clients enter RETURN below.
  Please enter name of administration host []: adminhost
  Please enter IP address for adminhost: 192.9.200.2
  Do you want to run DNS resolver [n]: y
  You may enter upto 3 nameservers
  Please enter IP address for  the first nameserver []: 192.9.200.2
  Do you want another nameserver [n]: y
  Please enter IP address for the alternate nameserver []: 192.9.200.3
  Do you want another nameserver [n]:
  Please enter timezone [GMT]: America/Los_Angeles
  Now type 'reboot' for changes to take effect.
  toaster>

FILES

/etc
directory of filer configuration and administration files
/etc/rc
system initialization command script
/etc/exports
directories exported by the server
/etc/hosts
host name data base
/etc/hosts.equiv
list of hosts and users with rsh permission
/etc/resolv.conf
list of DNS name servers
/etc/dgateways
list of preferred default gateways for routed

SEE ALSO

na_reboot(1), na_dgateways(5), na_exports(5), na_hosts(5), na_hosts.equiv(5), na_resolv.conf(5), na_rc(5), na_autosupport(8)

NOTES

Some Ethernet boards determine the media type automatically. It is not strictly necessary to specify the media type for them, but it is best to do so anyway, in case the board is replaced with one that does not determine media type automatically.

Table of Contents