3139N/A<?xml version="1.0" encoding="iso-8859-1"?>
3139N/A<!--Arbortext, Inc., 1988-2008, v.4002-->
3139N/A<!DOCTYPE refentry PUBLIC "-//Sun Microsystems//DTD SolBook-XML 3.7//EN" "xsolbook.dtd" [
3139N/A<!ENTITY % ent SYSTEM "entities.ent">
3139N/A%ent;
3139N/A]>
2495N/A
3356N/A<refentry id="pkg.sysrepo-8">
3356N/A<refmeta><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>8</manvolnum>
3139N/A<refmiscinfo class="date">21 May 2013</refmiscinfo>
3356N/A<refmiscinfo class="sectdesc">&man8;</refmiscinfo>
3139N/A<refmiscinfo class="software">&release;</refmiscinfo>
3139N/A<refmiscinfo class="arch">generic</refmiscinfo>
3356N/A<refmiscinfo class="copyright">Copyright (c) 2007, 2016, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
3139N/A</refmeta>
3139N/A<refnamediv>
3139N/A<refname>pkg.sysrepo</refname><refpurpose>Image Packaging System system repository configuration</refpurpose></refnamediv>
3139N/A<refsynopsisdiv><title></title>
3139N/A<synopsis>/usr/lib/pkg.sysrepo -p <replaceable>port</replaceable> [-c <replaceable>
3139N/Acache_dir</replaceable>] [-s <replaceable>cache_size</replaceable>]
3139N/A [-w <replaceable>http_proxy</replaceable>] [-W <replaceable>https_proxy</replaceable>]
3139N/A</synopsis>
3139N/A</refsynopsisdiv>
3356N/A<refsect1 id="pkgsysrepo-8-desc" role="description"><title></title>
3139N/A<para><command>pkg.sysrepo</command> is used to generate the configuration
3139N/Afiles for the Image Packaging System (IPS) system repository. <command>pkg.sysrepo
3139N/A</command> is called by the <literal>svc:/application/pkg/system-repository</literal> Service
3139N/AManagement Facility (SMF) service. Changes in configuration should be made
3139N/Ato the properties in the SMF service.</para>
3139N/A<para>The system repository is responsible for providing access to the package
3139N/Arepositories configured in a reference image through a centralized proxy.
3139N/APublisher configuration changes made to that reference image are seen immediately
3139N/Aby any clients configured to use the system repository.</para>
3139N/A<para>The system repository is primarily used in the global zone to allow
3139N/Anon-global zones to access the repositories configured in the global zone.
3139N/AThe SMF services <literal>svc:/application/pkg/zones-proxyd</literal> and <literal>
3139N/Asvc:/application/pkg/zones-proxy-client</literal> are responsible for providing
3139N/Athe transport between non-global zones and the global zone. This transport
3356N/Ais only used by <literal>pkg</literal>(7).</para>
3139N/A<para>Note that only <literal>http</literal>, <literal>https</literal>, and <literal>
3139N/Av4</literal> file repositories and <literal>p5p</literal> archives are supported.
3139N/AOlder file repository formats are not supported. See <command>pkgrepo</command>(1)
3139N/Afor more information about repository versions.</para>
3139N/A</refsect1>
3139N/A<refsect1 role="options"><title></title>
3139N/A<para>The following options are supported:</para>
3139N/A<variablelist termlength="wholeline">
3139N/A<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
3139N/A<listitem><para>Specify the absolute path to a directory that should be used
3139N/Aby the system repository for caching responses from the publishers configured.</para>
3139N/A<para>By default, a file-cache is used. However, the special value <literal>memory
3139N/A</literal> can be used to indicate the an in-memory cache should be used.
3139N/AThe special value <literal>None</literal> can be used to indicate that the
3139N/Asystem repository should not perform any caching. This setting should be configured
3139N/Ausing the <literal>config/cache_dir</literal> SMF property.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
3139N/A<listitem><para>Specify the port that the system repository should use to
3139N/Alisten for requests. This setting should be configured using the <literal>config/port
3139N/A</literal> SMF property.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A<varlistentry><term><option>s</option> <replaceable>cache_size</replaceable></term>
3139N/A<listitem><para>An integer value in megabytes that defines the maximum cache
3139N/Asize of the system repository. This setting should be configured using the <literal>
3139N/Aconfig/cache_max</literal> SMF property.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A<varlistentry><term><option>w</option> <replaceable>http_proxy</replaceable></term>
3139N/A<listitem><para>A string of the form <literal><replaceable>scheme</replaceable>://<replaceable>
3139N/Ahostname</replaceable>[:<replaceable>port</replaceable>]</literal> that defines
3139N/Aa web proxy that the system repository can use to access http-based package
3139N/Arepositories. This setting can be configured using the <literal>config/http_proxy
3139N/A</literal> SMF property.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A<varlistentry><term><option>W</option> <replaceable>https_proxy</replaceable></term>
3139N/A<listitem><para>A string of the form <literal><replaceable>scheme</replaceable>://<replaceable>
3139N/Ahostname</replaceable>[:<replaceable>port</replaceable>]</literal> that defines
3139N/Aa web proxy that the system repository can use to access https-based package
3139N/Arepositories. This setting can be configured using the <literal>config/https_proxy
3139N/A</literal> SMF property.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A</variablelist>
3139N/A</refsect1>
3139N/A<refsect1 role="examples"><title></title>
3139N/A<example><title>Enabling the System Repository</title>
3139N/A<screen>$ <userinput>svcadm enable svc:/application/pkg/system-repository</userinput></screen>
3139N/A</example>
3139N/A</refsect1>
3139N/A<refsect1 role="exit-status"><title></title>
3139N/A<para>The following exit values are returned:</para>
3139N/A<variablelist>
3139N/A<varlistentry><term><returnvalue>0</returnvalue></term>
3139N/A<listitem><para>Command succeeded.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A<varlistentry><term><returnvalue>1</returnvalue></term>
3139N/A<listitem><para>Command failed to write a valid configuration.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A<varlistentry><term><returnvalue>2</returnvalue></term>
3139N/A<listitem><para>Invalid command line options were specified.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A<varlistentry><term><returnvalue>99</returnvalue></term>
3139N/A<listitem><para>An unanticipated exception occurred.</para>
3139N/A</listitem>
3139N/A</varlistentry>
3139N/A</variablelist>
3139N/A</refsect1>
3139N/A<refsect1 role="attributes"><title></title>
3356N/A<para>See <literal>attributes</literal>(7) for descriptions of the following
3139N/Aattributes:</para>
3139N/A<informaltable frame="all" orient="port">
3139N/A<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
3139N/Aalign="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
3139N/A<row>
3139N/A<entry align="center">
3139N/A<para>ATTRIBUTE TYPE</para>
3139N/A</entry>
3139N/A<entry align="center">
3139N/A<para>ATTRIBUTE VALUE</para>
3139N/A</entry>
3139N/A</row>
3139N/A</thead>
3139N/A<tbody>
3139N/A<row>
3139N/A<entry align="left">
3139N/A<para>Availability</para>
3139N/A</entry>
3139N/A<entry align="left">
3139N/A<para><literal>package/pkg</literal></para>
3139N/A</entry>
3139N/A</row>
3139N/A<row>
3139N/A<entry align="left">
3139N/A<para>Interface Stability</para>
3139N/A</entry>
3139N/A<entry align="left">
3139N/A<para>Uncommitted</para>
3139N/A</entry>
3139N/A</row>
3139N/A</tbody>
3139N/A</tgroup>
3139N/A</informaltable></refsect1>
3139N/A<refsect1 role="see-also"><title></title>
3139N/A<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
3356N/A<olink targetdoc="refman" targetptr="pkg.depotd-8"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>8</manvolnum></citerefentry></olink>,
3356N/A<olink targetdoc="refman" targetptr="pkg-7"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink></para>
3139N/A<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
3139N/A</refsect1>
3139N/A</refentry>
2494N/A