pkgadd(8) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

pkgadd(8)

System Administration Commands                                       pkgadd(8)



NAME
       pkgadd - transfer software packages to the system

SYNOPSIS
       pkgadd [-nv] [-a admin] [-G] [-x proxy]
            [ [-M] -R root_path] [-r response] [-k keystore]
            [-P passwd] [-V fs_file]
            [-d device | -d datastream pkginst | all]
            [pkginst | -Y category [, category]...]


       pkgadd -s [-d device | -d datastream pkginst | all]
            [pkginst | -Y category [, category]...]

DESCRIPTION
       pkgadd  transfers the contents of a software package from the distribu‐
       tion medium or directory to install it onto the  system.  Used  without
       the  -d   device  source  specifier,  pkgadd looks in the default spool
       directory (/var/spool/pkg) for the package. Used with the -s option, it
       writes the package to a spool directory instead of installing it.


       The  pkgadd  utility  requires an amount of temporary space the size of
       the package that is being installed. pkgadd determines which  temporary
       directory  to use by checking for the existence of the $TMPDIR environ‐
       ment variable. If $TMPDIR is not defined,  pkgadd  uses  P_tmpdir  from
       stdio.h. P_tmpdir has a default of /var/tmp/.


       Certain  unbundled and third-party packages are no longer entirely com‐
       patible with the latest version of pkgadd. These packages require  user
       interaction throughout the installation and not just at the very begin‐
       ning, or require that their request scripts be run as the root user.


       To install these older packages (released prior to  Solaris  2.4),  set
       the following environment variable: NONABI_SCRIPTS=TRUE


       As  long  as  this environment variable is set, pkgadd permits keyboard
       interaction throughout the installation and package request scripts are
       run as root.


       If  you  have package request scripts that require running as user root
       (instead  of  noaccess  [the  default]  or  user  install),   use   the
       rscript_alt  parameter  in  the  admin(5)  file  to make an appropriate
       selection. See admin(5).


       Note that, in Solaris 8 and Solaris 9, the default user when running  a
       request  script  was  either root or nobody, depending on the operating
       system's patch level. In the current release, the default user is noac‐
       cess.


       In their current implementations, pkgadd, pkgtrans(1) and other package
       commands can process a datastream of up to 4 GB.


       The -d, -Y, and pkginst arguments shown in the SYNOPSIS  are  described
       under OPERANDS, following OPTIONS.

OPTIONS
       The  supported  options are described as follows. The -d  device source
       specifier is described under OPERANDS, below.

       -a admin

           Define an installation administration file, admin, to  be  used  in
           place  of the default administration file. The token none overrides
           the use of any admin file, and thus  forces  interaction  with  the
           user.  Unless  a full path name is given, pkgadd first looks in the
           current working directory for the administration file. If the spec‐
           ified  administration file is not in the current working directory,
           pkgadd looks  in  the  /var/sadm/install/admin  directory  for  the
           administration file.


       -G

           This option is deprecated.


       -k keystore

           Use  keystore as the location from which to get trusted certificate
           authority certificates when verifying digital signatures  found  in
           packages.  If  no  keystore is specified, then the default keystore
           locations are searched for valid trusted certificates. See KEYSTORE
           LOCATIONS for more information.


       -M

           Instruct  pkgadd  not  to  use  the  $root_path/etc/vfstab file for
           determining the client's mount  points.  This  option  assumes  the
           mount  points are correct on the server and it behaves consistently
           with Solaris 2.5 and earlier releases.


       -n

           Installation occurs in non-interactive mode. Suppress output of the
           list of installed files. The default mode is interactive.


       -P passwd

           Password to use to decrypt keystore specified with -k, if required.
           See PASS PHRASE ARGUMENTS for more information about the format  of
           this option's argument.


       -r response

           Identify  a file or directory which contains output from a previous
           pkgask(8) session. This file  supplies  the  interaction  responses
           that  would  be  requested  by  the  package  in  interactive mode.
           response must be a full pathname.


       -R root_path

           Define the full path name of a directory to use as  the  root_path.
           All  files,  including  package system information files, are relo‐
           cated to a directory tree starting in the specified root_path.  The
           root_path  may  be  specified  when  installing  to a client from a
           server (for example, /export/root/client1).

           Note -



             The root file system of any non-global zones must not  be  refer‐
             enced with the -R option. Doing so might damage the global zone's
             file system, might compromise the security of  the  global  zone,
             and might damage the non-global zone's file system. See zones(7).



       -s spool

           Write  the  package  into the directory spool instead of installing
           it.


       -v

           Trace all of the scripts that get executed by  pkgadd,  located  in
           the  pkginst/install  directory.  This option is used for debugging
           the procedural and non-procedural scripts.


       -V fs_file

           Specify an alternative fs_file to map the  client's  file  systems.
           For  example,  used  in  situations where the $root_path/etc/vfstab
           file is non-existent or unreliable.


       -x proxy

           Specify a HTTP[S] proxy to use when downloading packages The format
           of  proxy  is  host:port, where host is the hostname of the HTTP[S]
           proxy, and port is the port number associated with the proxy.  This
           switch overrides all other methods of specifying a proxy. See ENVI‐
           RONMENT VARIABLES for more  information  on  alternate  methods  of
           specifying a default proxy.



       When  executed  without options or operands, pkgadd uses /var/spool/pkg
       (the default spool directory).

OPERANDS
       The following operands are supported:

   Sources
       By default, pkgadd looks in the /var/spool/pkg directory when searching
       for  instances of a package to install or spool. Optionally, the source
       for the package instances to be installed or spooled can  be  specified
       using:

       -d device
       -d datastream pkgname,... | all

           Install  or  copy  a  package from device. device can be any of the
           following:


               o      A full path name to a directory or the  identifiers  for
                      tape or removable medium (for example, /var/tmp).


               o      A datastream created by pkgtrans (see pkgtrans(1)).


               o      A  URL pointing to a datastream created by pkgtrans. The
                      supported  Universal  Resource  Identifiers  (URIs)  are
                      http: and https:.

           The  second  form  of the -d specifier, above, indicates the syntax
           you use when specifying a datastream. In this case you must specify
           either a comma-separated list of package names or the keyword all.



   Instances
       By  default,  pkgadd  searches  the  specified  source, and presents an
       interactive menu allowing the user to select  which  package  instances
       found on the source are to be installed. As an alternative, the package
       instances to be installed can be specified using:

       pkginst

           The package instance or list of  instances  to  be  installed.  The
           token  all  may  be  used to refer to all packages available on the
           source medium. The format pkginst.* can be  used  to  indicate  all
           instances of a package.

           The  asterisk  character  (*) is a special character to some shells
           and may need to be escaped. In the C-Shell, the  asterisk  must  be
           surrounded by single quotes (') or preceded by a backslash (\).


       -Y category[,category...]

           Install  packages  based  on  the  value  of the CATEGORY parameter
           stored in the package's pkginfo(5) file. All packages on the source
           medium  whose CATEGORY matches one of the specified categories will
           be selected for installation or spooling.


KEYSTORE LOCATIONS
       Package such as pkgadd use a set of  trusted  certificates  to  perform
       signature  validation  on  any signatures found within the packages. If
       there are no signatures included in the packages then signature valida‐
       tion is skipped. The certificates can come from a variety of locations.
       If -k  keystore is specified, and keystore is a  directory,  then  key‐
       store  is  assumed  to  be the base directory of the certificates to be
       used. If keystore is a file, then the file itself is  assumed  to  have
       all  required  keys  and  certificates.  When -k is not specified, then
       /var/sadm/security is used as the base directory.


       Within the specified base directory, the store locations to be searched
       are different based on the application doing the searching and the type
       of store being searched for. The following directories are searched  in
       the specified order:

           1.     <store_dir>/<app_name>/<store_type>


           2.     <store_dir>/<store_type>




       Where  <store_dir>  is the directory specified by -k, <app_name> is the
       name of the application doing the searching, and <store_type> is one of
       keystore  (for  private keys), certstore (for untrusted public key cer‐
       tificates), or truststore (for trusted certificate  authority  certifi‐
       cates).


       For  example,  when pkgadd is run with -k  /export/certs, then the fol‐
       lowing locations are successively searched to find the trust store:

           1.     /export/certs/pkgadd/truststore


           2.     /export/certs/truststore




       This searching order enables administrators to have a  single  location
       for  most  applications,  and special certificate locations for certain
       applications.

KEYSTORE AND CERTIFICATE FORMATS
       The packaging utilities, such as pkgtrans, require access to a  set  of
       keys  and  certificates  in order to sign, and optionally verify, pack‐
       ages.


       The keystore files found by following the search pattern  specified  in
       KEYSTORE LOCATIONS must each be a self-contained PKCS#12-format file.


       When  signing a package with pkgtrans, if a certstore has more than one
       public key certificate, then each public key must have  a  friendlyName
       attribute in order to be identifiable and selectable with the -a option
       when signing packages. In addition, the public key certificate selected
       with  -a and found in the certstore must have an associated private key
       in the keystore.


       Several browsers and utilities can be used to export  and  import  cer‐
       tificates and keys into a PKCS#12 keystore. For example, a trusted cer‐
       tificate can be exported from Mozilla, and then imported into a PKCS#12
       keystore for use with pkgadd with the OpenSSL Toolkit.

PASS PHRASE ARGUMENTS
       pkgtrans  and  pkgadd  accept password arguments, typically using -p to
       specify the password. These allow the password to be  obtained  from  a
       variety  of sources. Both of these options take a single argument whose
       format is described below. If no password argument is given and a pass‐
       word is required then the user is prompted to enter one: this will typ‐
       ically be read from the current terminal with echoing turned off.

       pass:password

           The actual password is password. Because the password is visible to
           utilities  such  as ps this form should only be used where security
           is not important.


       env:var

           Obtain the password from the environment variable var. Because  the
           environment of other processes is visible on certain platforms this
           option should be used with caution.


       file:pathname

           The first line contained within pathname is the password.  pathname
           need not refer to a regular file: it could, for example, refer to a
           device or named pipe. For example, to read the password from  stan‐
           dard input, use file:/dev/stdin.


       console

           Read the password from /dev/tty.


EXAMPLES
       Example 1 Installing a Package from a Solaris DVD



       The  following  example  installs a package from a Solaris DVD. You are
       prompted for the name of the package you want to install.




         example# pkgadd -d /cdrom/cdrom0/s0/Solaris_10/Product



       Example 2 Installing a Set of Packages from a Datastream



       The example command shown below installs all of  the  packages  in  the
       datastream specified by the -d source specifier. Prior to this command,
       this datastream must have been created with the pkgtrans(1) command.


         example# pkgadd -d /var/tmp/datastream all




       The keyword all specifies that all of the packages found in the  desig‐
       nated datastream will be installed.


EXIT STATUS
       0

           Successful completion


       1

           Fatal error.


       2

           Warning.


       3

           Interruption.


       4

           Administration.


       5

           Administration. Interaction is required. Do not use pkgadd  -n.


       10

           Reboot after installation of all packages.


       20

           Reboot after installation of this package.


ENVIRONMENT VARIABLES
       HTTPPROXY

           Specifies  an  HTTP  proxy host. Overrides administration file set‐
           ting, and http_proxy environment variable.


       HTTPPROXYPORT

           Specifies the port to use when contacting  the  host  specified  by
           HTTPPROXY. Ignored if HTTPPROXY is not set.


       http_proxy

           URL  format  for specifying proxy host and port. Overrides adminis‐
           tration file setting.


FILES
       /var/sadm/install/logs/

           Location where pkgadd logs an instance of software installation.


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


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Availabilitypackage/svr4 _ Interface StabilityCommitted


SEE ALSO
       pkginfo(1),  pkgmk(1), pkgparam(1), pkgproto(1), pkgtrans(1), admin(5),
       pkginfo(5), attributes(7), zones(7), installf(8), pkgadm(8), pkgask(8),
       pkgchk(8), pkgrm(8), removef(8)


       https://www.openssl.org

NOTES
       When  transferring  a  package to a spool directory, the -r, -n, and -a
       options cannot be used.


       The -r option can be used to indicate a directory name  as  well  as  a
       filename. The directory can contain numerous response files, each shar‐
       ing the name of the package with which it should  be  associated.  This
       would  be  used, for example, when adding multiple interactive packages
       with one invocation of pkgadd. In this situation,  each  package  would
       need  a  response file. If you create response files with the same name
       as the package (for example, pkinst1 and pkinst2), then name the direc‐
       tory in which these files reside after the -r.


       The  -n  option  causes  the installation to halt if any interaction is
       needed to complete it.


       If the default admin file is too restrictive, the  administration  file
       may  need  to  be  modified to allow for total non-interaction during a
       package installation. See admin(5) for details.


       If a package stream is specified with -d, and a  digital  signature  is
       found  in  that  stream, the default behavior is to attempt to validate
       the certificate and signature found. This behavior  can  be  overridden
       with admin file settings. See admin(5) for more information.



Oracle Solaris 11.4               4 Feb 2015                         pkgadd(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3