<?xml version="1.0" encoding="utf-8"?>
<!--Arbortext, Inc., 1988-2008, v.4002-->
<!DOCTYPE refentry PUBLIC "-//Sun Microsystems//DTD SolBook-XML 3.7//EN" "xsolbook.dtd" [
<!ENTITY % ent SYSTEM "entities.ent">
%ent;
]>

<refentry lang="ja" id="pkg.depot-config-8">
<refmeta><refentrytitle>pkg.depot-config</refentrytitle><manvolnum>8</manvolnum> <refmiscinfo class="date">2015 年 5 月 26 日</refmiscinfo> <refmiscinfo class="sectdesc">&man8;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2016, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
</refmeta>
<refnamediv>
<refname>pkg.depot-config</refname> <refpurpose>Image Packaging System HTTP デポ構成ジェネレータ</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis>/usr/lib/pkg.depot-config ( -d <replaceable>repository_dir</replaceable> | -S )
    -r <replaceable>runtime_dir</replaceable> [-c <replaceable>cache_dir</replaceable>] [-s <replaceable>cache_size</replaceable>] [-p <replaceable>port</replaceable>]
    [-h <replaceable>hostname</replaceable>] [-l <replaceable>logs_dir</replaceable>] [-T <replaceable>template_dir</replaceable>]
    [-A] [-t <replaceable>server_type</replaceable>] ( ([-F] [-P <replaceable>server_prefix</replaceable>] ) |
    [--https ( (--cert <replaceable>server_cert_file</replaceable> --key <replaceable>server_key_file</replaceable>
    [--cert-chain <replaceable>ssl_cert_chain_file</replaceable>] ) |
    --cert-key-dir <replaceable>cert_key_directory</replaceable> )
    [ (--ca-cert <replaceable>ca_cert_file</replaceable> --ca-key <replaceable>ca_key_file</replaceable> ) ]
    [--smf-fmri <replaceable>smf_pkg_depot_fmri</replaceable>] ] )</synopsis>
</refsynopsisdiv>
<refsect1 id="GLHAR" role="description"><title></title>
<para><command>pkg.depot-config</command> は、Image Packaging System (IPS) デポの構成ファイルを生成します。IPS デポは HTTP 経由で IPS パッケージリポジトリへのスケーラブルな読み取り専用アクセスを提供します。</para>
<para>IPS デポは <literal>svc:/application/pkg/depot</literal> サービスの 1 つまたは複数のインスタンスと組み合わせて <literal>svc:/application/pkg/server</literal> サービス管理機能 (SMF) サービスを使用して構成されます。</para>
<para><command>pkg.depot-config</command> は、<literal>pkg/depot</literal> サービスで使用するための構成を生成するか、または <command>pkg.depot-config</command> コマンドは、コマンド行で呼び出して、スタンドアロン構成を生成できます。</para>
<para>デポ構成を変更するには、<literal>pkg/depot</literal> サービスまたは適切な <literal>pkg/server</literal> サービスインスタンスのプロパティーを変更して、インスタンスをリフレッシュします。<literal>pkg/server</literal> サービスインスタンスの状態を変更すると、<literal>pkg/depot</literal> サービスがリフレッシュされ、デポ構成ファイルが再生成されます。</para>
<para>複数のリポジトリを提供するには、リポジトリごとに個別の <literal>pkg/server</literal> サービスインスタンスが必要ですが、<literal>pkg/depot</literal> サービスインスタンスは 1 つだけ必要です。<literal>pkg/server</literal> サービスの各インスタンスは、<literal>pkg/inst_root</literal> サービスプロパティーによって指定された IPS リポジトリにマップされます。<literal>pkg/server</literal> サービスは、次のいずれかを実行します。</para>
<itemizedlist>
<listitem><para>リポジトリの内容を提供するための関連付けられた <literal>pkg.depotd</literal> プロセスを実行します。</para></listitem>
<listitem><para>プロセスを実行せず、代わりに <literal>pkg.depot</literal> サービスの構成を支援します。</para>
</listitem>
</itemizedlist>
<para>各リポジトリは、<literal>pkg/server</literal> サービスインスタンスによってサポートされます。リポジトリは、<literal>pkg/depot:default</literal> サービスによってサポートされることもあります。特定の <literal>pkg/server</literal> インスタンスの <literal>pkg/standalone</literal> プロパティーが <literal>true</literal> に設定されている場合、そのリポジトリは <literal>pkg.depotd</literal> プロセスによって提供されます。特定の <literal>pkg/server</literal> インスタンスの <literal>pkg/standalone</literal> プロパティーが <literal>false</literal> に設定されている場合、そのリポジトリは <literal>pkg/depot:default</literal> サービスによって提供されます。各 <literal>pkg/server</literal> インスタンスは <literal>pkg.depotd</literal> を実行するか、または <literal>pkg/depot:default</literal> に構成情報を提供します。</para>
<para><literal>pkg/standalone</literal> プロパティーが <literal>false</literal> に設定され、<literal>pkg/readonly</literal> プロパティーが <literal>true</literal> に設定されている <literal>pkg/server</literal> インスタンスを有効にすると、<literal>pkg/depot:default</literal> 構成がリフレッシュされ、そのリポジトリは <literal>pkg/depot:default</literal> サービスによって提供されます。その同じ <literal>pkg/server</literal> インスタンスを無効にすると、<literal>pkg/depot:default</literal> サービスがリフレッシュされ、そのリポジトリは、<literal>pkg/depot:default</literal> サービスによって提供されなくなります。</para>
<para><option>F</option> オプションを付けた <command>pkg.depot-config</command> コマンドを使用して、デポを手動で構成できます。<option>F</option> オプションは既存の Web サーバーに追加できる Web サーバー構成ファイルを生成します。この場合、デポは、機能制限付きで実行します。<literal>pkg </literal>(1) 検索サポートおよびデポブラウザユーザーインタフェースは使用できません。Oracle Solaris 11 システムのインストールと更新に必要な、その他すべての <literal>pkg</literal>(1) 機能は使用できます。</para>
<itemizedlist>
<para>次のいずれかの方法を使用して、デポサーバーにリポジトリパスと構成を渡します。</para>
<listitem><para><option>S</option> オプションを付けて、<command>pkg.depot-config</command> コマンドを使用します。<option>S</option> オプションにより、<literal>pkg.depotd</literal> はシステムに、<literal>online</literal> としてマークされている <literal>pkg/server</literal> サービスのすべてのインスタンスをクエリーし、<literal>pkg/standalone</literal> プロパティーを <literal>false</literal> に設定し、<literal>pkg/readonly</literal> プロパティーを <literal>true</literal> に設定します。</para></listitem>
<listitem><para><option>d</option> オプションを付けて、<command>pkg.depot-config</command> コマンドを使用します。<option>d</option>オプションは使用する <literal>pkg</literal>(7) リポジトリへのパスを指定します。複数の <option>d</option> オプションが受け入れられます。</para></listitem>
</itemizedlist>
<para>リポジトリには、<literal>pkg5srv</literal> ユーザーによってリポジトリ内のファイルおよびディレクトリが読み取られることを許可するファイル権限が必要です。</para>
</refsect1>
<refsect1 role="options"><title></title>
<para>サポートしているオプションは、次のとおりです。</para>
<variablelist termlength="wholeline">
<varlistentry><term><option>d</option> <replaceable>prefix</replaceable>=<replaceable> repository_dir</replaceable></term>
<listitem><para>使用する <literal>pkg</literal>(7) ファイルリポジトリへのパスを指定します。<replaceable>prefix</replaceable> は、このリポジトリにアクセスできる <literal>depot-config</literal> Web サーバー名前空間の接頭辞として使用されます。<replaceable>repository_dir</replaceable> は、デポサーバー構成に含まれるバージョン 4 <literal>pkg</literal>(7) ファイルリポジトリを格納するディレクトリです。<option>d</option> オプションは <option>S</option> オプションと一緒に使用できません。<option>S</option> オプションを使用しない場合、少なくとも 1 つの <option>d</option> オプションが必要です。複数の <option>d</option> オプションが許可されます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>S</option></term>
<listitem><para>使用するリポジトリについて、システムをクエリーします。<option>S</option> オプションにより、<literal>pkg.depotd</literal> はシステムに、<literal>online</literal> としてマークされている <literal>pkg/server</literal> サービスのすべてのインスタンスをクエリーし、<literal>pkg/standalone</literal> プロパティーを <literal>false</literal> に設定し、<literal>pkg/readonly</literal> プロパティーを <literal>true</literal> に設定します。これらのプロパティー値により、これらのプロパティーが設定されていない <literal>pkg/server</literal> インスタンスと同時にデポを実行できます。<literal>pkg.depotd</literal> については、<literal>pkg.depotd</literal>(8) のマニュアルページを参照してください。<option>S</option>オプションは <option>d</option> オプションと一緒に使用できません。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>r</option> <replaceable>runtime_dir</replaceable></term>
<listitem><para>構成ファイルのデフォルトの出力ディレクトリを指定します。このディレクトリは、<literal>pkg/server</literal> サービスの <literal>config/runtime_dir</literal> プロパティーを設定して指定することもできます。<literal>config/runtime_dir</literal> プロパティーが使用された場合、このディレクトリの内容は、サービスの起動時に再作成されます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
<listitem><para>デポがそのキャッシュを格納するディレクトリを指定します。<option>A</option> オプションも使用されている場合、キャッシュディレクトリはサーバー側 <literal>pkg</literal>(7) 検索インデックスを格納するためにも使用されます。このディレクトリは、<literal>pkg/server</literal> サービスの <literal>config/cache_dir</literal> プロパティーを設定して指定することもできます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>s</option> <replaceable>cache_size</replaceable></term>
<listitem><para>デポのキャッシュの最大サイズを指定します。<replaceable>cache_size</replaceable> 値はメガバイトの整数です。<replaceable>cache_size</replaceable> が 0 である場合、Web サーバーによってキャッシュは実行されません。<replaceable>cache_size</replaceable> のデフォルト値は 0 です。デポサーバーによって提供されるすべてのファイルリポジトリが、デポサーバーにローカルである (NFS 経由でアクセスされない) 場合、デフォルト値の 0 で十分です。このキャッシュサイズは、<literal>pkg/server</literal> サービスの <literal>config/cache_max</literal> プロパティーを設定して指定することもできます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
<listitem><para>デポが待機するポート番号を指定します。<replaceable>port</replaceable> のデフォルト値は 80 です。このポートは、<literal>pkg/server</literal> サービスの <literal>config/port</literal> プロパティーを設定して指定することもできます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>h</option> <replaceable>hostname</replaceable></term>
<listitem><para>Apache <literal>ServerName</literal> ディレクティブへの引数として使用するホスト名を指定します。<replaceable>hostname</replaceable> のデフォルト値は <literal>0.0.0.0</literal> です。このホスト名は、<literal>pkg/server</literal> サービスの <literal>config/host</literal> プロパティーを設定して指定することもできます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>l</option> <replaceable>logs_dir</replaceable></term>
<listitem><para>デポがログファイルを格納するディレクトリを指定します。<replaceable>logs_dir</replaceable> のデフォルト値は <filename>/var/log/pkg/depot</filename> です。このディレクトリは、<literal>pkg/server</literal> サービスの <literal>config/log_dir</literal> プロパティーを設定して指定することもできます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>T</option> <replaceable>template_dir</replaceable></term>
<listitem><para>デポがデポ構成を構築して、デポの実行に必要な追加のファイルを格納するディレクトリを指定します。<replaceable>template_dir</replaceable> のデフォルト値は <filename>/etc/pkg/depot</filename> です。このディレクトリは、<literal>pkg/server</literal> サービスの <literal>config/template_dir</literal> プロパティーを設定して指定することもできます。このディレクトリは変更する必要はないと考えられます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>A</option> </term>
<listitem><para><command>pkgrepo refresh</command> が呼び出されたときに、デポによって保持されている検索インデックスをリフレッシュします。デフォルトでは、<command>pkgrepo refresh</command> が呼び出されたときに、デポによって保持されている検索インデックスはリフレッシュされません。このオプションは、<literal>pkg/server</literal> サービスの <literal>config/allow_refresh </literal> プロパティーを設定して指定することもできます。検索インデックスはデポの起動時に自動的にリフレッシュされるため、ベストプラクティスは、本番サーバーでインデックスをリフレッシュするために、<option>A</option> オプションまたは <literal>config/allow_refresh</literal> プロパティーを使用しないことです。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>t</option> <replaceable>server_type</replaceable></term>
<listitem><para><command>pkg.depot-config</command> が構成情報を出力する Web サーバーのタイプを指定します。このリリースでは、<replaceable>server_type</replaceable> のデフォルト値は <literal>apache2</literal> (Apache 2.4) で、受け入れられる値は、<literal>apache2</literal> および <literal>apache22 (Apache 2.2)</literal> です。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>F</option></term>
<listitem><para>Web サーバーが既存の Web サービスを使用して、基本の <literal>pkg</literal>(7) インストール操作を提供できるようにする部分的な構成を生成します。Oracle Solaris OS 上で実行されている Apache Web サーバーの場合、部分的な構成ファイルを <filename>/etc/apache2/2.4/conf.d </filename> に配置できます。ほかのオペレーティングシステムの場合は、OS のドキュメントを参照して、この部分的な構成ファイルを使用する方法を判断してください。<option>P</option> オプションも参照してください。
</para>
</listitem>
</varlistentry>
<varlistentry><term><option>P</option> <replaceable>server_prefix</replaceable></term>
<listitem><para>デポを Web サーバー名前空間にマップするために使用される接頭辞を指定します。<option>P</option>オプションは <option>F</option> オプションと一緒に使用することを目的としています。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-https</option></term>
<listitem><para>HTTPS サービスを有効にします。このオプションは、<option>F</option> または <option>P</option> オプションと一緒に使用できません。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-cert</option> <replaceable>server_cert_file</replaceable></term>
<listitem><para>サーバー証明書ファイルの場所を指定します。このオプションは <option>-https</option> オプションと一緒にのみ使用できます。<option>-cert</option> オプションと <option>-key</option> オプションの両方または <option>-cert-key-dir</option> オプションを <option>-https</option> オプションと一緒に使用する必要があります。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-key</option> <replaceable>server_key_file</replaceable></term>
<listitem><para>サーバー鍵ファイルの場所を指定します。このオプションは <option>-https</option> オプションと一緒にのみ使用できます。<option>-cert</option> オプションと <option>-key</option> オプションの両方または <option>-cert-key-dir</option> オプションを <option>-https</option> オプションと一緒に使用する必要があります。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-cert-key-dir</option> <replaceable>cert_key_directory</replaceable></term>
<listitem><para><option>-cert</option> および <option>-key</option> オプションが省略されている場合に、自動的に生成された証明書および鍵を格納させるディレクトリを指定します。このオプションは <option>-https</option> オプションと一緒にのみ使用できます。<option>-cert</option> オプションと <option>-key</option> オプションの両方または <option>-cert-key-dir</option> オプションを <option>-https</option> オプションと一緒に使用する必要があります。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-ca-cert</option> <replaceable>ssl_ca_cert_file</replaceable></term>
<listitem><para>最上位の CA 証明書ファイルの場所を指定します。このオプションは <option>-https</option> オプションと一緒にのみ使用でき、<option>-ca-key</option> オプションと一緒に使用する必要があります。このオプションは、この CA 証明書と <option>-ca-key</option> オプションによって指定された CA 鍵に基づいて、サーバー証明書を自動的に生成するためにのみ使用されます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-ca-key</option> <replaceable>ssl_ca_key_file</replaceable></term>
<listitem><para>最上位の CA 鍵ファイルの場所を指定します。このオプションは、<option>-https</option> オプションと一緒にのみ使用でき、<option>-ca-cert</option> オプションと一緒に使用する必要があります。このオプションは、この CA 鍵と <option>-ca-cert</option> オプションによって指定された CA 証明書に基づいて、サーバー証明書を自動的に生成するためにのみ使用されます。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-cert-chain</option> <replaceable>ssl_cert_chain_file</replaceable></term>
<listitem><para>このオプションは <option>-https</option> オプションと一緒にのみ使用できます。このオプションは、サーバー証明書が最上位 CA によって直接署名されていないが、中間権限によって署名されている場合に必要です。</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-smf-fmri</option> <replaceable>smf_pkg_depot_fmri</replaceable></term>
<listitem><para><literal>pkg/depot</literal> サービスインスタンスの FMRI を指定します。このオプションは、何らかの証明書または鍵がそのインスタンスに対して自動的に生成された場合に、そのインスタンスの対応する SMF プロパティーを更新するために使用されます。このオプションは <option>-https</option> オプションと一緒にのみ使用できます。</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="other"><title>追加のサーバー構成の提供</title>
<para><option>F</option> オプションが使用されておらず、デフォルトの <command>-t apache2</command> が設定されている場合、<literal>svc:/application/pkg/depot</literal> サービスは、起動時にサーバー構成を拡張するために使用できる追加の Apache 構成ファイルを <filename>/etc/pkg/depot/conf.d</filename> 内で検索します。Web サーバーを構成するために使用するディレクティブに関する詳細については、Apache Web サーバーのドキュメントを参照してください。</para>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>リポジトリがどのように提供されているかを示す</title>
<para>この例のシステムでは、<literal>svc:/application/pkg/server</literal> の複数のインスタンスと <literal>svc:/application/pkg/depot</literal> の 1 つのインスタンスを実行しています。<literal>pkg/server:standalone</literal> インスタンスには <command>pkg.depotd</command> プロセスが関連付けられています。<command>pkg.depotd</command> プロセスは、<literal>pkg/server:standalone</literal> サービスに構成されているリポジトリを提供します。<literal>pkg/server:userland</literal> インスタンスには、関連付けられたプロセスがありません。<literal>pkg/depot:default</literal> サービスは、<literal>pkg/server:userland</literal> サービスに構成されているリポジトリを提供します。</para>
<screen>$ <userinput>svcs pkg/server</userinput>
STATE    STIME    FMRI
disabled Feb_06   svc:/application/pkg/server:default
online   Feb_03   svc:/application/pkg/server:userland
online   Feb_03   svc:/application/pkg/server:standalone
$ <userinput>svcs pkg/depot</userinput>
STATE    STIME    FMRI
online   Feb_07   svc:/application/pkg/depot:default
$ <userinput>svcprop -p pkg/standalone -p pkg/readonly &bsol;</userinput>
<userinput>pkg/server:standalone</userinput>
true
true
$ <userinput>svcprop -p pkg/standalone -p pkg/readonly &bsol;</userinput>
<userinput>pkg/server:userland</userinput>
false
true
$ <userinput>svcs -p svc:/application/pkg/server:standalone</userinput>
STATE    STIME    FMRI
online   Feb_03   svc:/application/pkg/server:standalone
         Jan_31       1206 pkg.depotd
$ <userinput>svcs -p svc:/application/pkg/server:userland</userinput>
STATE    STIME    FMRI
online   Feb_03   svc:/application/pkg/server:userland</screen>
</example>
<example id="GMWHD"><title>デポに関連付けられたプロセスを示す</title>
<para>次のコマンドは、<literal>pkg/depot</literal> サービスに関連付けられた <literal>httpd</literal> プロセスを表示します。</para>
<screen>$ <userinput>svcs -p pkg/depot</userinput>
STATE    STIME    FMRI
online   11:43:56 svc:/application/pkg/depot:default
         11:43:55     16969 httpd
         11:43:55     16974 httpd
         11:43:55     16975 httpd
         11:43:55     16976 httpd
         11:49:01     16990 httpd
         11:51:33     16995 httpd</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<para>次の終了ステータスが返されます。</para>
<variablelist termlength="xtranarrow">
<varlistentry><term><returnvalue>0</returnvalue></term>
<listitem><para>コマンドが成功しました。</para>
</listitem>
</varlistentry>
<varlistentry><term><returnvalue>1</returnvalue></term>
<listitem><para>コマンドが失敗しました。</para>
</listitem>
</varlistentry>
<varlistentry><term><returnvalue>2</returnvalue></term>
<listitem><para>無効なコマンド行オプションが指定された。</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="attributes"><title></title>
<para>次の属性については、<literal>attributes</literal>(7) を参照してください。</para>
<informaltable frame="all" orient="port">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
<row>
<entry align="center">
<para>属性タイプ</para>
</entry>
<entry align="center">
<para>属性値</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry align="left">
<para>使用条件</para>
</entry>
<entry align="left">
<para><literal>package/pkg/depot</literal></para>
</entry>
</row>
<row>
<entry align="left">
<para>インタフェースの安定性</para>
</entry>
<entry align="left">
<para>不確実</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable></refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="refman" targetptr="svcprop-1"><citerefentry><refentrytitle>svcprop</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="svcs-1"><citerefentry><refentrytitle>svcs</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="svcadm-8"><citerefentry><refentrytitle>svcadm</refentrytitle><manvolnum>8</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="svccfg-8"><citerefentry><refentrytitle>svccfg</refentrytitle><manvolnum>8</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.depotd-8"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>8</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-7"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>7</manvolnum></citerefentry></olink></para>
<para><olink targetdoc="CCOSP"><citetitle remap="book">Oracle Solaris 11.2 パッケージリポジトリのコピーおよび作成に関するドキュメント</citetitle></olink></para>
<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
</refsect1>
</refentry>