DragonFly On-Line Manual Pages

Search: Section:  


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)

Search: Section: