28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi(C) Copyright 2013 Canonical Ltd.
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiStéphane Graber <stgraber@ubuntu.com>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiThis library is free software; you can redistribute it and/or
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumimodify it under the terms of the GNU Lesser General Public
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiLicense as published by the Free Software Foundation; either
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumiversion 2.1 of the License, or (at your option) any later version.
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiThis library is distributed in the hope that it will be useful,
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumibut WITHOUT ANY WARRANTY; without even the implied warranty of
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiLesser General Public License for more details.
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiYou should have received a copy of the GNU Lesser General Public
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiLicense along with this library; if not, write to the Free Software
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
9111aa793259eb1de897af6add5bf0400e962f9fKATOH YasufumiTranslated into Japanese
9111aa793259eb1de897af6add5bf0400e962f9fKATOH Yasufumiby KATOH Yasufumi <karma at jazz.email.ne.jp>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi start/stop/kill auto-started containers
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi 自動起動の設定がされたコンテナの開始/停止/kill
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </refpurpose>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </refnamediv>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <refsynopsisdiv>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <cmdsynopsis>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <arg choice="opt">-g <replaceable>groups</replaceable></arg>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <arg choice="opt">-t <replaceable>timeout</replaceable></arg>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </cmdsynopsis>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </refsynopsisdiv>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <command>lxc-autostart</command> processes containers
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi with lxc.start.auto set. It lets the user start, shutdown,
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi kill, restart containers in the right order, waiting the
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi right time. Supports filtering by lxc.group or just run
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi against all defined containers. It can also be used by
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi external tools in list mode where no action will be performed
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi and the list of affected containers (and if relevant, delays)
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi will be shown.
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi <command>lxc-autostart</command> は lxc.start.auto が設定されたコンテナの処理を行います。
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi ユーザがコンテナの開始、シャットダウン、kill、再起動を、設定した時間間隔で、設定した順番で行えるようにします。
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi lxc.group でのフィルタリングによって、もしくは定義された全てのコンテナを実行します。
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi 何の動作も行わず、対象のコンテナ (とコンテナに設定された起動待機時間) のリストを表示するリストモードを外部ツールから使用することも可能です。
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi The <optional>-r</optional>, <optional>-s</optional>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi and <optional>-k</optional> options specify the action to perform.
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi If none is specified, then the containers will be started.
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <optional>-a</optional> and <optional>-g</optional> are used to
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi specify which containers will be affected. By default only
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi containers without a lxc.group set will be affected.
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <optional>-t TIMEOUT</optional> specifies the maximum amount
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi of time to wait for the container to complete the shutdown
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi <optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional> オプションは実行する動作を指定します。何も指定しない場合は、コンテナを起動します。
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi <optional>-a</optional>, <optional>-g</optional> は、どのコンテナを対象にするかを指定するのに使います。デフォルトでは、lxc.group が指定されていないコンテナにだけが対象となります。
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi <optional>-t TIMEOUT</optional> はコンテナが完全にシャットダウンもしくはリブートを待つ最大時間を指定します。
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <variablelist>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi Request a reboot of the container.
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi コンテナのリブートを要求します。
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <varlistentry>
5fd9f759c1575525ef5f8d31b6c4a2ae89e0e12fKATOH Yasufumi Request a clean shutdown. If a
5fd9f759c1575525ef5f8d31b6c4a2ae89e0e12fKATOH Yasufumi <optional>-t timeout</optional> greater than 0 is
5fd9f759c1575525ef5f8d31b6c4a2ae89e0e12fKATOH Yasufumi given and the container has not shut down within
5fd9f759c1575525ef5f8d31b6c4a2ae89e0e12fKATOH Yasufumi this period, it will be killed as with the
5fd9f759c1575525ef5f8d31b6c4a2ae89e0e12fKATOH Yasufumi <optional>-k kill</optional> option.
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi クリーンなシャットダウンを要求します。もし、<optional>-t timeout</optional> が 0 より大きい場合で、コンテナがこの時間内にシャットダウンしない場合は、コンテナは <optional>-k kill</optional> オプションを指定した時のように kill されます。
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi Rather than requesting a clean shutdown of the
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi container, explicitly kill all tasks in the container.
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi コンテナのクリーンなシャットダウンを要求するのではなく、明確にコンテナの全てのタスクを kill します。
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi Rather than performing the action, just print
3ae656b54b1688d1eb8332f80f356773e762cc99KATOH Yasufumi the container name and wait delays until starting the next container.
3ae656b54b1688d1eb8332f80f356773e762cc99KATOH Yasufumi 実際の動作は行わず、コンテナ名と次のコンテナを開始するまでの間隔の表示だけを行います。
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <option>-t,--timeout <replaceable>TIMEOUT</replaceable></option>
2da1f56ce304ad8dbd651d1305de9b6d58dd19dbKATOH Yasufumi Wait TIMEOUT seconds before hard-stopping the container.
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi コンテナの強制停止まで TIMEOUT 秒待ちます。
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </varlistentry>
9111aa793259eb1de897af6add5bf0400e962f9fKATOH Yasufumi <varlistentry>
9111aa793259eb1de897af6add5bf0400e962f9fKATOH Yasufumi <option>-g,--group <replaceable>GROUP</replaceable></option>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi Comma separated list of groups to select
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi (defaults to those without a lxc.group - the NULL group).
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi This option may be specified multiple times
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi and the arguments concatenated. The NULL or
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi empty group may be specified as a leading comma,
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi trailing comma, embedded double comma, or empty
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi argument where the NULL group should be processed.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi Groups are processed in the order specified on the
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi command line. Multiple invocations of the -g option
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi may be freely intermixed with the comma separated
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi lists and will be combined in specified order.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi 対象にするコンテナのグループのカンマ区切りのリスト (デフォルトでは lxc.group 指定のないコンテナ、つまり NULL グループが対象になります)。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi このオプションは複数回指定することができ、オプションは連結されます。NULL もしくは空のグループは、NULL グループを処理すべき場所に指定された先頭のカンマ、末尾のカンマ、途中に現れる 2 つ続きのカンマ、空のオプション引数で指定することができます。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi グループはコマンドラインで指定された順番に処理されます。-g オプションの複数回の呼び出しはカンマ区切りのリストと自由に混ぜることができ、指定した順番に連結されます。
9111aa793259eb1de897af6add5bf0400e962f9fKATOH Yasufumi </varlistentry>
9111aa793259eb1de897af6add5bf0400e962f9fKATOH Yasufumi <varlistentry>
9111aa793259eb1de897af6add5bf0400e962f9fKATOH Yasufumi Ignore lxc.group and select all auto-started containers.
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi lxc.group の指定を無視して、自動起動が設定されているコンテナを全て選択します。
9111aa793259eb1de897af6add5bf0400e962f9fKATOH Yasufumi </varlistentry>
800648d24ad2791bc656e47f3a048c01fbe27587KATOH Yasufumi <varlistentry>
800648d24ad2791bc656e47f3a048c01fbe27587KATOH Yasufumi Ignore the lxc.start.auto flag. Combined with
800648d24ad2791bc656e47f3a048c01fbe27587KATOH Yasufumi -a, will select all containers on the system.
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi lxc.start.auto で設定されているフラグを無視します。-a と組み合わせることにより、システム上の全てのコンテナを選択します。
800648d24ad2791bc656e47f3a048c01fbe27587KATOH Yasufumi </varlistentry>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi </variablelist>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi <title><!-- Autostart and System Boot -->自動起動とシステムブート</title>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi The <command>lxc-autostart</command> command is used as part of the
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi LXC system service, when enabled to run on host system at bootup and at
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi shutdown. It's used to select which containers to start in what order
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi and how much to delay between each startup when the host system boots.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi <command>lxc-autostart</command> コマンドは、LXC システムサービスがホストシステムのブートおよびシャットダウン時に実行するように有効化されているとき、LXC システムサービスの一部として使用されます。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi このコマンドはホストシステムのブート時に、どのコンテナをどういう順番で、それぞれのコンテナの起動間隔をどれくらい開けるかを選択するのに使います。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi Each container can be part of any number of groups or no group at all.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi Two groups are special. One is the NULL group, i.e. the container does
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi not belong to any group. The other group is the "onboot" group.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi コンテナはいくつでもグループに属することができ、全く属さないことも可能です。特別なグループが 2 つ存在します。1 つは NULL グループです。これはどのグループにも属さないコンテナです。もう 1 つは "onboot" グループです。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi When the system boots with the LXC service enabled, it will first
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi attempt to boot any containers with lxc.start.auto == 1 that is a member
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi of the "onboot" group. The startup will be in order of lxc.start.order.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi If an lxc.start.delay has been specified, that delay will be honored
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi before attempting to start the next container to give the current
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi container time to begin initialization and reduce overloading the host
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi system. After starting the members of the "onboot" group, the LXC system
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi will proceed to boot containers with lxc.start.auto == 1 which are not
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi members of any group (the NULL group) and proceed as with the onboot
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi LXC サービスが有効になった状態でシステムがブートすると、最初に "onboot" グループのメンバーである lxc.start.auto == 1 が設定されたコンテナを起動しようとします。起動は lxc.start.order の順に起動します。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi lxc.start.delay が指定されている場合、現在対象となっているコンテナに初期化の時間を与え、ホストシステムの負荷を低減するために、次のコンテナを開始させるまでに遅延時間を与えます。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi "onboot" グループのメンバーが開始した後、LXC システムは lxc.start.auto == 1 が設定された、どのグループのメンバーでもない (NULL グループの) コンテナのブートを onboot グループのコンテナと同様に開始します。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi <title><!-- Startup Group Examples -->スタートアップグループの例</title>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi <variablelist>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi <varlistentry>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi Start the "onboot" group first then the NULL group.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi まず最初に "onboot" グループの処理を開始し、その後 NULL グループの処理を開始します。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi This is the equivalent of: <option>-g onboot -g ""</option>.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi </varlistentry>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi <varlistentry>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi Starts the "dns" group first, the "web" group second, then
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi the NULL group followed by the "onboot" group.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi まず最初に "dns" グループの処理を開始し、2 番目に "web" グループ、その後 NULL グループ、"onboot" グループの順に処理を開始します。
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi This is the equivalent of: <option>-g dns,web -g ,onboot</option> or <option>-g dns -g web -g "" -g onboot</option>.
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi これは以下と等価です: <option>-g dns,web -g ,onboot</option> もしくは <option>-g dns -g web -g "" -g onboot</option>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi </varlistentry>
f57517ef962c4b499d229fcf502b43fbd8a54fbeKATOH Yasufumi </variablelist>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi <para>Stéphane Graber <email>stgraber@ubuntu.com</email></para>
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumi<!-- Keep this comment at the end of the file
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH YasufumiLocal variables:
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-omittag:t
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-shorttag:t
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-minimize-attributes:nil
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-always-quote-attributes:t
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-indent-step:2
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-indent-data:t
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-parent-document:nil
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-default-dtd-file:nil
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-exposed-tags:nil
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-local-catalogs:nil
28f2ab26ea78e929253e38c6e87bb0e3c05112f2KATOH Yasufumisgml-local-ecat-files:nil