DragonFly On-Line Manual Pages
AUTO-ADMIN(1) DragonFly General Commands Manual AUTO-ADMIN(1)
NAME
auto-admin - Automated systems management tools
SYNOPSIS
Common:
auto-append-line
auto-ask
auto-denyhosts-remove-ip
auto-denyhosts-setup
auto-enable-autologout
auto-harden
auto-insert-line
auto-pkgsrc-setup
auto-pxe-node-discover
auto-replace-file
auto-ssh-authorize
FreeBSD:
auto-amd-nfs-setup
auto-clean-ports
auto-config-snd-driver
auto-db-dir
auto-disable-service
auto-enable-compat32
auto-enable-hal-mount
auto-enable-passwdqc
auto-enable-procfs
auto-enable-service
auto-fastest-mirror
auto-install-packages
auto-ipfw-gateway-setup
auto-kdm3-toggle
auto-ldap-adduser
auto-ldap-client-setup
auto-package-installed
auto-print-make-variable
auto-pxe-installer-setup
auto-service-enabled
auto-set-suspend-mode
auto-update-port-framework
auto-update-xorg.conf
auto-using-pkgng
auto-xdm-toggle
NetBSD:
auto-desktop-setup
auto-install-packages
auto-install-packages-from-source
auto-install-pkgsrc-tree
auto-package-installed
auto-select-pkgsrc-dist
install-vuln
RHEL/CentOS:
auto-disable-hyperthreading
auto-ldap-client-setup
auto-pxe-installer-setup
auto-register-dhcp-hostname
auto-set-memory-limits
PURPOSE
auto-admin is a set of simple tools for automating systems management.
The tools are meant to be used in scripts that automate specific tasks,
such as desktop-installer and cluster-admin tools.
AUTO-AMD-LOCAL-SETUP
auto-amd-local-setup
Configures AMD, the automount daemon, to mount local devices such as
DVDROMs and flash drives when specified directories are accessed. The
access directories are those listed in /etc/fstab, minus /mnt. For
example, if /etc/fstab lists /mnt/dvdrom, then the dvdrom is actually
automounted and accessed by going to /dvdrom.
AUTO-AMD-NFS-SETUP
auto-amd-nfs-setup
Configures AMD, the automount daemon, to mount remote NFS filesystems
automatically when specified directories are accessed. The user is
prompted for information about the NFS server and the name of the
directory under which the server should be mounted.
AUTO-APPEND-LINE
auto-append-line [search-string] line file calling-program-name
Appends line to a text file if the file does not already contain
search-string as a whole word. ( Uses grep -w to prevent false
positives such as webcamd when searching for amd. ) If search-string is
omitted, line is used as the search string.
A comment beginning with '#' is placed above the line stating that the
line was added by calling-program-name unless calling-program-name is
"nocomment". When calling auto-append-line from another script, $0 is
usually passed to calling-program-name.
Example:
Enable USB-serial adapters at boot time if they have not already been
explicitly enabled or disabled.
auto-append-line uplcom_load 'uplcom_load="YES"' /boot/loader.conf $0
AUTO-ASK
auto-ask tag prompt default-answer
Display prompt to the terminal and echo the response entered by the
user to the standard output. Note that the prompt is send to the
terminal device via a different route so that it is not confused with
the user input. If the user enters nothing (just presses enter), echo
default-answer or the answer stored from a previous invocation with the
same tag. Tags are stored in ./auto-ask-responses.txt, so a script
using auto-ask must be run from the same directory in order to remember
previous answers. The tag may not contain any whitespace.
Example:
resp=`auto-ask edit-xorg "Edit xorg.conf? (y/n)" n`
AUTO-CLEAN-PORTS
auto-clean-ports
Run "make distclean" in all ports directories containing a work
directory. This can free a substantial amount of disk space after many
ports have been installed.
AUTO-CONFIG-SND-DRIVER
auto-config-snd-driver
Auto-detect supported sound devices and add a load command to
/boot/loader.conf for the first device detected. Does not currently
support auto-detecting multiple sound devices.
AUTO-DISABLE-SERVICE
auto-disable-service rc.conf-name
Disable the service enabled by <rc.conf-name>_enable="YES" by altering
the line in rc.conf.
AUTO-ENABLE-COMPAT32
auto-enable-compat32
Enable 32-bit compatibility on 64-bit systems, as required for certain
applications.
AUTO-ENABLE-PASSWDQC
auto-enable-passwdqc
Enable the PAM password quality control module, which requires users to
set secure local passwords.
AUTO-ENABLE-PROCFS
auto-enable-procfs
Enable and mount /proc, which is required by some applications.
AUTO-ENABLE-SERVICE
auto-enable-service [-s rc.d-name] rc.conf-name calling-program-name
Enable a service in rc.conf if it has not been explicitly enabled or
disabled (i.e. there is no line containing <rc.conf-name>_enable
already present). Some ports unfortunately have rc.d scripts with a
different name than the service name in rc.conf. If this is the case,
specify the script name following -s. The -s flag must be the first
argument. A comment is placed above the line stating that the line was
added by calling-program-name.
Examples:
# Add ntpd_enable="YES" to rc.conf and run /etc/rc.d/ntpd
auto-enable-service ntpd desktop-installer
# Add kerberos5_server_enable="YES" to rc.conf and run /etc/rc.d/kerberos
auto-enable-service -s kerberos kerberos5_server ad-client-setup
AUTO-FASTEST-MIRROR
auto-fastest-mirror
Print the URL of the fastest mirror site for downloading packages. This
is normally used to set AUTO_PACKAGEROOT for auto-install-packages.
Example:
export AUTO_PACKAGEROOT=`auto-fastest-mirror`
AUTO-INSTALL-PACKAGES
auto-install-packages category/port [category/port ...]
Install category/port from binary package or from source. If
AUTO_BUILD_FROM_SOURCE is "yes", the port is installed from source. If
AUTO_BUILD_FROM_SOURCE is "no" or "fall-back", the port is installed
from binary package using pkg_add -r, using the main site, or the site
specified by AUTO_PACKAGEROOT. If installing from binary package
fails, and AUTO_BUILD_FROM_SOURCE is "fall-back", an attempt is made to
install from source.
Unlike pkg_add, auto-install-packages allows multiple packages to be
installed in a single command, and attempts to determine whether the
package is already installed before downloading/building it.
Example:
export AUTO_PACKAGEROOT=`auto-fastest-mirror` auto-install-packages
net/samba print/cups
AUTO-IPFW-GATEWAY-SETUP
auto-ipfw-gateway-setup public-interface local-interface
Configure the server as a firewall gateway using ipfw. This installs
necessary software and a default set of firewall rules that allow ipfw
to operate efficiently. ( ipfw can use a significant amount of CPU
time if not configured properly. )
Example:
auto-ipfw-gateway-setup nfe0 nfe1
AUTO-KDM3-TOGGLE
auto-kdm3-toggle on|off
Enable/disable KDM3 in /etc/ttys.
AUTO-LDAP-ADDUSER
auto-ldap-adduser [username]
Add a local user who can authenticate logins using either local
password or the LDAP server configured by auto-ldap-client-setup. If
an LDAP configuration is detected, the LDAP server is queried to
validate the user name and extract default information for creating the
local account.
AUTO-LDAP-CLIENT-SETUP
auto-ldap-client-setup uri ou o cacert-file
Configure the machine to allow users to authenticate SSH logins using
either LDAP or local passwords. Additional login services besides SSH
can be configured by updating their entries in /etc/pam.d to resemble
/etc/pam.d/sshd.
Example:
auto-ldap-client-setup ldap://ldap.my.domain people my.domain
cacert.pem
AUTO-PACKAGE-INSTALLED
auto-package-installed category/port
Check whether category/port is installed. Exit status is 0 if
installed, and non-zero otherwise. In addition, a text message stating
whether the port is installed is printed to the standard output.
AUTO-PXE-INSTALLER-SETUP
auto-pxe-installer-setup FreeBSD-installer.iso
Configures the host as a PXE server for net booting other computers on
the network and automatically installing the FreeBSD system from the
FreeBSD ISO install image provided.
FreeBSD-installer.iso is any FreeBSD install image using bsdinstall.
Older installers using sysinstall are not supported.
auto-pxe-installer-setup enables dhcpd, tftpd, and NFS, and
automatically configures them to allow other computers on the network
to PXE boot and run an automated installation.
The newly installed systems will accept passwordless root login from
the PXE server, to facilitate automated post-install configuration.
auto-pxe-installer-setup is intended primarily for quickly deploying
nodes in a cluster or grid using the head node as a PXE server.
AUTO-PXE-NODE-DISCOVER
auto-pxe-node-discover basename digits domain
Discovers new DHCP clients on the local network, assigns each a host
name, adds them to /etc/hosts and creates a static DHCP lease.
Host names take the form basename-#.domain, where # is a 0-padded
decimal value with 'digits' digits.
For example,
auto-pxe-node-discover compute 3 local
will produce host names compute-001.local, compute-002.local, etc.
Meant to be used in conjunction with auto-pxe-installer-setup.
It is recommended, but not essential, to start auto-pxe-node-discover
before imaging any nodes, and to ensure that each node has been
assigned the desired host name before PXE booting the next node.
AUTO-REPLACE-FILE
auto-replace-file new old
Back up the file "old" to "old.orig" and replace it with the file
"new", only if "new" and "old" differ.
Example:
auto-replace-file /usr/local/etc/smb.conf my.smb.conf
AUTO-SERVICE-ENABLED
auto-service-enabled rc.conf-name
Check whether service is enabled. Exit status is 0 if enabled, and
non-zero otherwise.
Example:
if [ `auto-service-enabled cups` ]; then
printf "CUPS is already enabled.0
fi
AUTO-SET-SUSPEND-ON-LID
auto-set-suspend-on-lid S1|S2|S3|S4|S5|NONE
Configures laptop lid switch action to the specified ACPI mode.
Caution: NONE disables action when the laptop is closed, allowing the
computer to continue running. This could lead to overheating and
hardware damage.
Supported modes depend on the hardware and the available ACPI drivers.
S5 (shut down) is the most universally supported.
S3 (suspend to RAM) is generally considered the most desirable, but is
not supported on all hardware due to hardware capabilities or
incomplete drivers.
AUTO-UPDATE-PORT-FRAMEWORK
auto-update-port-framework category/port
Rename ${PORTSDIR}/category/port to ${PORTSDIR}/category/port.`date`
and replace it with the latest port framework.
This should be used with caution, as it might break dependencies for
other ports. If you are using the RELEASE ports tree, note that this
will bring the port out of sync with the binary package.
AUTO-UPDATE-XORG.CONF
auto-update-xorg.conf
Update /etc/X11/xorg.conf to match the current configuration. The X
server must be restarted before the changes will take effect. This is
used mainly after installing additional font packages.
AUTO-XDM-TOGGLE
auto-xdm-toggle on|off
Enable/disable XDM in /etc/ttys.
ENVIRONMENT
AUTO_BUILD_FROM_SOURCE - Instruct auto-install-packages to install from source.
AUTO_PACKAGEROOT - Site from which binary packages are downloaded.
BUGS
Please report bugs to the author and send patches in unified diff
format. (man diff for more information)
AUTHOR
J. Bacon
Acadix Consulting, LLC
AUTO-ADMIN(1)