auto-fastest-mirror man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

AUTO-ADMIN(1)							 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 posi‐
       tives 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  ter‐
       minal  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	direc‐
       tory.   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	 pass‐
       word  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 cac‐
       ert.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  automati‐
       cally  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 deci‐
       mal 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 hard‐
       ware 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	incom‐
       plete 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  for‐
       mat.  (man diff for more information)

AUTHOR
       J. Bacon
       Acadix Consulting, LLC

								 AUTO-ADMIN(1)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net