Manual Pages for UNIX Operating System command usage for man ipkg

Standards, Environments, and Macros                       ipkg(5)



NAME
     ipkg - ipkg branded zone

DESCRIPTION
     The ipkg brand uses the branded zones framework described in
     brands(5)  to  run zones installed with the same software as
     is installed in the global zone. The  system  software  must
     always  be  in  sync  with the global zone when using a ipkg
     brand. The system software  packages  within  the  zone  are
     managed using the image packaging system. See pkg(5).

  Configuration and Administration
     The ipkg brand  supports  the  whole  root  non-global  zone
     model.  All  of  the  required system software and any addi-
     tional packages are installed into the private file  systems
     of the zone. The zone must reside on its own zfs(1M) dataset
     and only ZFS  is  supported.  The  ZFS  dataset  is  created
     automatically  when  the zone is installed or attached. If a
     ZFS dataset cannot be created, the zone is not installed  or
     attached.

SUB-COMMANDS
     The following ipkg  brand-specific  subcommand  options  are
     supported by zoneadm(1M).

     attach [-a archive | -d path] [-u]

         Attach the specified ipkg branded zone  image  into  the
         zone.  If  neither  -a  or  -d  is specified, the zone's
         zonepath is assumed to  already  be  properly  installed
         with  the zone's files. zoneadm checks package levels on
         the machine to which the zone is to be attached. If  the
         packages  that  the zone depends on from the global zone
         are different (have different revision numbers) from the
         dependent   packages  on  the  source  machine,  zoneadm
         reports these conflicts and does not perform the attach.
         If the destination system has only newer dependent pack-
         ages (higher revision numbers) than those on the  source
         system,  you can use the -uoption to update the attached
         zone to match the revision of the packages that exist on
         the  new  system.  With  -u, as in the default behavior,
         zoneadm does not perform an attach if outdated  packages
         are found on the target system.

         -a archive

             The path to a cpio(1) or pax(1) xustar archive of an
             installed   ipkg   branded   zone's  zonepath.  cpio
             archives can be compressed using gzip or bzip2.






SunOS 5.11          Last change: 30 Nov 2009                    1






Standards, Environments, and Macros                       ipkg(5)



         -d path

             The path to the zonepath directory of a ipkg branded
             zone's zonepath.


         -u

             Update the packages for the zone's  system  software
             to match the global zone.



     install [-c certificate_file] [-k key_file] [-P
     publisher=uri] [-e extrapkg [...]]
     install [-a archive] | [-d path] [-p] [-s] [-u] [-v]

         The ipkg brand installer supports  installing  the  zone
         from  either the software repository or from an image of
         an installed system running the same release.  This  can
         be  a cpio(1) or pax(1) xustar archive. The cpio archive
         can be compressed with gzip or bzip2. The image can also
         be a path to the top-level of a system's root tree, or a
         pre-existing zone path.

         If neither the -a or -d option  is  used,  the  zone  is
         installed from the repository.

         To install the zone from a system image either the -a or
         -d  is  required.  Either  the  -u  or -p option is also
         required in this case.

         -a archive             The path to a cpio(1)  or  pax(1)
                                xustararchive   of  an  installed
                                system.  cpio  archives  may   be
                                compressed using gzip or bzip2.


         -c certificate_file    The path to the certificate  file
                                needed  for accessing the reposi-
                                tory.


         -d path                The path to the root directory of
                                an installed system. If path is a
                                hyphen  (-),  the   zonepath   is
                                presumed  to be already populated
                                with the system image


         -e package_name        The name of a package to  install
                                into  the  zone. The -e option is



SunOS 5.11          Last change: 30 Nov 2009                    2






Standards, Environments, and Macros                       ipkg(5)



                                used  to  specify  an  additional
                                package  to  install, in addition
                                to the base set of software which
                                is   always  installed  into  the
                                zone. Multiple -e options can  be
                                used


         -k key_file            The path to the key  file  needed
                                for accessing the repository.


         -P publisher=uri       The name of a software repository
                                publisher  and its associated URI
                                to  use  to  install   the   zone
                                instead  of  the  default  global
                                zone's repository.


         -p                     Preserve the system configuration
                                after installing the zone.


         -s                     Install silently


         -u                     Run sys-unconfig(1M) on the  zone
                                after installing it.


         -v                     Verbose output from  the  install
                                process.



ATTRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:

















SunOS 5.11          Last change: 30 Nov 2009                    3






Standards, Environments, and Macros                       ipkg(5)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | system/zones                |
    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|


SEE ALSO
     cpio(1),  pax(1),  zfs(1M),  zlogin(1),  zonename(1),   sys-
     unconfig(1M),   zoneadm(1M),   zonecfg(1M),,  attributes(5),
     brands(5), privileges(5), zones(5)


     pkg(5), available in the IPS consolidation







































SunOS 5.11          Last change: 30 Nov 2009                    4