Unix/Linux Go Back    


OpenSolaris 2009.06 - man page for admin (opensolaris section 4)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


admin(4)				   File Formats 				 admin(4)

NAME
       admin - installation defaults file

DESCRIPTION
       admin  is  a  generic  name for an ASCII file that defines default installation actions by
       assigning values to installation parameters. For  example,  it  allows  administrators  to
       define how to proceed when the package being installed already exists on the system.

       /var/sadm/install/admin/default is the default admin file delivered with this release. The
       default file is not writable, so to assign values different from this file, create  a  new
       admin  file.  There  are  no  naming  restrictions  for	admin  files.  Name the file when
       installing a package with the -a option of pkgadd(1M). If the -a option is not  used,  the
       default admin file is used.

       Each  entry  in	the admin file is a line that establishes the value of a parameter in the
       following form:

       param=value

       All of the parameters listed below can be defined in an admin file, but it is not required
       to assign values to all of these. If a value is not assigned, pkgadd(1M) asks the install-
       er how to proceed.

       The valid parameters and their possible values are shown below except as noted.	They  can
       be  specified in any order. Any of these parameters (except the mail and proxy parameters)
       can be assigned the value ask, which means that, when the parameter is reached during  the
       installation  sequence,	the  installer	is notified and asked to supply instructions (see
       NOTES).

       basedir			     Indicates the base directory where relocatable packages  are
				     to  be  installed. If there is no basedir entry in the file,
				     the installer will be prompted for a path name,  as  if  the
				     file  contained  the  entry  basedir=ask. This parameter can
				     also be set to default (entry is basedir=default).  In  this
				     instance,	the  package is installed into the base directory
				     specified by the BASEDIR parameter in the pkginfo(4) file.

       mail			     Defines a list of users to whom mail should be sent  follow-
				     ing installation of a package. If the list is empty, no mail
				     is sent. If the parameter is not present in the admin  file,
				     the  default  value of root is used. The ask value cannot be
				     used with this parameter.

       runlevel 		     Indicates resolution if the run level is not correct for the
				     installation or removal of a package. Options are:

				     nocheck	Do not check for run level.

				     quit	Abort installation if run level is not met.

       conflict 		     Specifies what to do if an installation expects to overwrite
				     a	previously  installed  file,  thus  creating  a  conflict
				     between packages. Options are:

				     nocheck	 Do  not  check  for  conflict; files in conflict
						 will be overwritten.

				     quit	 Abort installation if conflict is detected.

				     nochange	 Override installation of conflicting files; they
						 will not be installed.

       setuid			     Checks for executables which will have setuid or setgid bits
				     enabled after installation. Options are:

				     nocheck	 Do not check for setuid executables.

				     quit	 Abort	installation  if  setuid  processes   are
						 detected.

				     nochange	 Override  installation of setuid processes; pro-
						 cesses will be  installed  without  setuid  bits
						 enabled.

       action			     Determines  if action scripts provided by package developers
				     contain possible security impact. Options are:

				     nocheck	Ignore security impact of action scripts.

				     quit	Abort installation if action scripts may  have	a
						negative security impact.

       partial			     Checks  to  see  if a version of the package is already par-
				     tially installed on the system. Options are:

				     nocheck	Do not check for a partially installed package.

				     quit	Abort installation if a partially installed pack-
						age exists.

       instance 		     Determines  how to handle installation if a previous version
				     of the package (including a  partially  installed	instance)
				     already exists. Options are:

				     quit	  Exit	without  installing if an instance of the
						  package  already  exists  (does  not	overwrite
						  existing packages).

				     overwrite	  Overwrite  an  existing  package  if	only  one
						  instance exists. If  there  is  more	than  one
						  instance,  but  only one has the same architec-
						  ture, it overwrites that  instance.  Otherwise,
						  the	installer   is	 prompted  with  existing
						  instances and asked which to overwrite.

				     unique	  Do not overwrite  an	existing  instance  of	a
						  package. Instead, a new instance of the package
						  is created. The new instance will  be  assigned
						  the next available instance identifier.

       idepend			     Controls  resolution  if the package to be installed depends
				     on other packages and if other packages depend on the one to
				     be installed. Options are:

				     nocheck	Do not check package dependencies.

				     quit	Abort  installation  if  package dependencies are
						not met.

       rdepend			     Controls resolution if other packages depend on the  package
				     to  be removed. Also determines behavior if registered prod-
				     ucts components to be removed. See libwsreg(3LIB)	and  pro-
				     dreg(1M)  for  a  definition  of product components. Options
				     are:

				     nocheck	Do not check package or product dependencies.

				     quit	Abort removal if package or product  dependencies
						are not met.

       space			     Controls  resolution  if disk space requirements for package
				     are not met. Options are:

				     nocheck	Do not	check  space  requirements  (installation
						fails if it runs out of space).

				     quit	Abort  installation if space requirements are not
						met.

       authentication		     Controls resolution when a datastream package with signature
				     is to be installed. Options are:

				     nocheck	Do  not  verify package signature. This also dis-
						ables the use of the  Online  Certificate  Status
						Protocol (OCSP) to validate the package's signing
						certificate.

				     quit	Abort installation if package signature cannot be
						verified.

       networktimeout		     Number of seconds to wait before giving up a network connec-
				     tion when downloading a package. This entry must be a  posi-
				     tive  integer.  If  not  present, the default value of 60 is
				     used.

       networkretries		     Number of times to retry a failed	network  connection  when
				     downloading  a  package. This entry must be a positive inte-
				     ger. If not present, the default value of 5 is used.

       keystore 		     Location of trusted certificates used when downloading pack-
				     ages  over  SSL  and  when verifying signatures on packages.
				     This is the base directory of the certificate  location  for
				     trusted certificates used when validating digital signatures
				     on packages. For example, if this setting is /var/sadm/secu-
				     rity,  then pkgadd will use /var/sadm/security/pkgadd/trust-
				     store, then /var/sadm/security/truststore when searching for
				     trusted  certificates.  See  KEYSTORE LOCATIONS and KEYSTORE
				     AND CERTIFICATE FORMATS in pkgadd(1M) for	details  on  cer-
				     tificate store format and usage.

       proxy			     The  default  proxy to use when installing packages from the
				     network. Currently, only HTTP  or	HTTPS  proxies	are  sup-
				     ported. If this field is blank or nonexistent, then no proxy
				     will be used.

       rscriptalt=root | noaccess    Determines the user that  will  run  request  scripts.  This
				     parameter can have either of the values described below. See
				     pkgadd(1M) for details on the conditions  under  which  this
				     parameter is useful.

				     root	 Run  request  script  as user install, if such a
						 user exists, with the privileges of  that  user.
						 Otherwise,  run  script  as  user root, with UID
						 equal to 0 and with  all/zone	privileges.  (See
						 zones(5).)

				     noaccess	 Run  request  script  as user install, if such a
						 user exists, with the privileges of  that  user.
						 Otherwise, run script as user noaccess, with the
						 basic privileges of the unprivileged user  noac-
						 cess.

				     If  this  parameter  is not present or has a null value, the
				     user noaccess is assumed. Likewise, if this parameter is set
				     to  anything other than the values described here, a warning
				     is issued,  and  noaccess	is  assumed.  rscriptalt  is  not
				     present	  in	  the	   default	 admin	    file,
				     /var/sadm/install/admin/default.  In  this   case,   request
				     scripts are run as the user noaccess.

EXAMPLES
       Example 1 Default admin File

       The default admin file, named default, is shipped with user-, group-, and world-read priv-
       ileges(444). Its contents are as follows:

	 mail=
	 instance=unique
	 partial=ask
	 runlevel=ask
	 idepend=ask
	 rdepend=ask
	 space=ask
	 setuid=ask
	 conflict=ask
	 action=ask
	 basedir=default
	 authentication=quit
	 networktimeout=10
	 networkretries=3
	 keystore=/var/sadm/security
	 proxy=

       Example 2 Sample admin file.

       Below is a sample admin file.

	 basedir=default
	 runlevel=quit
	 conflict=quit
	 setuid=quit
	 action=quit
	 partial=quit
	 instance=unique
	 idepend=quit
	 rdepend=quit
	 space=quit
	 authentication=quit
	 networktimeout=10
	 networkretries=5
	 keystore=/opt/certs
	 proxy=syrinx.eng.example.com:8080

FILES
       The default admin file is consulted during package installation when no other  admin  file
       is specified.

       /var/sadm/install/admin/default

	   default admin file

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWpkgcmdsr		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       pkgadd(1M), prodreg(1M), libwsreg(3LIB), pkginfo(4), attributes(5), zones(5)

NOTES
       The value ask should not be defined in an admin file that will be used for non-interactive
       installation (because, by definition, there is no installer interaction). Doing so  causes
       installation to fail at the point when input is needed.

SunOS 5.11				   20 Dec 2004					 admin(4)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 09:47 AM.