SunOS リファレンスマニュアル 1M : システム管理コマンド

svc.startd(1M)

名前

svc.startd – サービス管理機能のマスターリスタータ

形式

/lib/svc/bin/svc.startd

svc:/system/svc/restarter:default

機能説明

svc.startd はサービス管理機能 (SMF) のマスターリスタータデーモンであり、すべてのサービスのデフォルトリスタータです。svc.startd は、管理要求、システム障害、またはアプリケーション障害に基づいて、サービスの開始、停止、および再起動を行います。

svc.startd は、各サービスの依存関係に基づいて障害管理を担うほか、サービスの状態の維持も行います。

svc.startd はシステムの起動時に自動的に呼び出されます。なんらかの障害が発生した場合は再起動されます。直接 svc.startd を呼び出さないでください。

すべてのリスタータに共通する構成および動作の詳細については、smf_restarter(5) を参照してください。

svcs(1) は、サービス構成機能によって管理されているすべてのサービスについて状態を報告します。svcadm(1M) を使用すると、サービスのリスタータに関連してサービスインスタンスを操作できます。

環境変数

「SMF_」という接頭辞を持つ環境変数は予約済みであり、上書きが可能です。

svc.startd は、smf_method(5) で指定されている「SMF_」環境変数をメソッドに渡します。デフォルトでは、PATH は /usr/sbin:/usr/bin に設定されます。デフォルトでは、svc.startd に渡されるその他すべての環境変数は、init(1M) から継承されたものです。

重複するエントリは削減されて単一のエントリになります。使用される値は不定です。「<名前>=」という接頭辞を持たない環境エントリは無視されます。

リスタータオプション

svc.startd の構成はコマンド行オプションでは設定されません。代わりに、サービス構成リポジトリから構成が読み込まれます。svccfg(1M) を使用すると、すべてのオプションおよびプロパティーを設定できます。

次に示す options プロパティーグループ内の構成変数は、開発者および管理者が使用できます。

boot_messages

astring は、ブート中にコンソールに出力するメッセージのデフォルトレベルを示します (scf_value_is_type で定義される。scf_value_create(3SCF) を参照)。サポートされているメッセージオプションには、quiet と verbose があります。quiet オプションは、ブート中に最小限のメッセージをコンソールに出力します。verbose オプションは、開始されるサービスごとに 1 つのメッセージを出力して、成功または失敗を示します。boot -m オプションを使用すると、ブート時に boot_messages 設定を上書きできます。kernel(1M) のマニュアルページを参照してください。

logging

svc.startd のグローバルサービスログ記録レベルを制御します。astring (scf_value_is_type で定義される。scf_value_create(3SCF) を参照) は、syslog (syslog(3C)) および svc.startd のグローバルログファイル /var/svc/log/svc.startd.log に記録するメッセージのデフォルトレベルを示します。サポートされているメッセージオプションには、quiet、verbose、および debug があります。quiet オプションは、管理者の介入を必要とするエラーメッセージを、コンソール、syslog、および svc.startd のグローバルログファイルに送信します。verbose オプションは、管理者の介入を必要とするエラーメッセージをコンソール、syslog、および svc.startd のグローバルログファイルに、管理者の介入を必要としないエラーに関する情報を svc.startd のグローバルログファイルに、それぞれ送信します。さらに、サービスが起動されるたびに単一のメッセージがコンソールに送信されます。debug オプションは、svc.startd デバッグメッセージを svc.startd のグローバルログファイルに、管理者の介入を必要とするエラーメッセージをコンソール、syslog、および svc.startd のグローバルログファイルに、サービスが起動されるたびに単一のメッセージをコンソールに、それぞれ送信します。

milestone

デフォルトのブートレベルとして使用するマイルストーンを決定する FMRI です。指定できるオプションは、次に示すメジャーマイルストーンです。

svc:/milestone/single-user:default
svc:/milestone/multi-user:default
svc:/milestone/multi-user-server:default

あるいは特殊値 all または none も指定できます。all は、すべてのサービスに依存する理想化されたマイルストーンを表します。none は、マスター svc:/system/svc/restarter:default 以外にはどのサービスも実行されていない、特殊なマイルストーンです。デフォルトでは、svc.startd は、すべてのサービスに依存する統合的なマイルストーン all を使用します。このプロパティーが指定された場合、inittab(4) の initdefault 設定はすべて上書きされます。

system/reconfigure

再構成リブートが要求されたことを示します。再構成リブートに応じて動作する必要のあるサービスでは、このプロパティーが存在し 1 に設定されているかどうかをチェックして、再構成ブートが要求されたかどうかを確認できます。

このプロパティーは svc.startd によって管理されます。管理者はこのプロパティーを変更しないでください。

svc.startd を無効にするなどの構成エラーは、syslog によってログに記録されますが、無視されます。

サービスの状態

svc.startd によって管理されるサービスは、smf(5) で説明されている状態のいずれかになります。このリスタータによって状態の定義が変更されることはありません。

サービスの報告機能

管理対象サービスによって実行されるログ記録のほかに、svc.startd には、サービスの報告およびログ記録を行う共通の機構が用意されています。

報告機能プロパティー svc.startd は、管理しているすべてのサービスについて、共通のプロパティーセットを更新します。これらのプロパティーは、サービスインスタンスの状態に基づいてアクションを実行するための共通インタフェースとして使用できます。svcs(1) コマンドを使用すると、これらのプロパティーを簡単に表示できます。

restarter/state restarter/next_state

インスタンスの現在の状態および次の状態 (移行中の場合)。

restarter/auxiliary_state

現在のインスタンス状態について詳細情報を示す説明文。svc.startd によって管理されるサービスには、次に示す補助状態を使用できます。

maintenance

fault_threshold_reached
stop_method_failed
administrative_request

restarter/state_timestamp

現在の状態に到達した時刻。

restarter/contract

サービスインスタンスを実行している主プロセス契約 ID (存在する場合)。

ログ

デフォルトでは、svc.startd は、メソッドの標準出力および標準エラーのファイル記述子に加えて、サービスに対する重要なリスタータアクションを /var/svc/log/service:instance.log に記録します。/var/svc/log/svc.startd.log や syslog など、システムのグローバルな場所へのロギングレベルは、options/logging プロパティーによって制御されます。

サービスの定義

svc.startd によって管理されるサービスを開発または構成するとき、サービスインスタンスとリスタータの相互作用を操作するために、一連の共通プロパティーが使用されます。

メソッド

svc.startd で提供されている fork/exec モデル用メソッドの一般的な形式は、smf_method(5) に示されています。svc.startd によって管理されるサービスでは、次に示すメソッドが必須メソッドまたは省略可能メソッドとしてサポートされています。

refresh

サービスを中断することなく、リポジトリまたは config ファイルから適切な構成パラメータを読み込み直します。多くの場合、これはシステムデーモン用の SIGHUP を使用して実装されます。再起動しないとサービスが構成の変更を認識できない場合、refresh メソッドは提供されません。

このメソッドは省略可能です。

start

サービスを開始します。アプリケーションがコンシューマに対して利用可能になったときに初めて成功を返します。競合するインスタンスがすでに実行されている場合や、サービスを開始できない場合は、失敗を返します。

このメソッドは必須です。

stop

サービスを停止します。場合によっては、一部またはすべてのサービスがすでに停止されているときに stop メソッドを呼び出すこともできます。メソッドが戻るときにサービスが完全に停止していない場合だけ、エラーを返します。

このメソッドは必須です。

サービスが必須メソッド内で何もアクションを実行する必要がない場合、そのメソッドに :true トークンを指定する必要があります。

svc.startd は、サービスや特定のメソッドに対して指定されたメソッドコンテキストをすべて尊重します。smf_method(5) で説明されているメソッド拡張トークンは、svc.startd によって呼び出されるすべてのメソッドで使用できます。

プロパティー

smf(5) で使用できる一般的なプロパティーの概要。これらの一般的なプロパティーは、次のような特定の方法で svc.startd と対話します。

general/enabled: enabled が true に設定されている場合、リスタータは、サービスの依存関係がすべて満たされるとサービスの開始を試みます。false に設定されている場合、サービスは実行されず、無効にされた状態のままになります。
general/restarter: この FMRI プロパティーが空または svc:/system/svc/restarter:default に設定されている場合、サービスは svc.startd によって管理されます。それ以外の場合は、指定されたリスタータが (利用可能になったときに) サービスの管理を担当します。
general/single_instance: single_instance が true に設定されている場合、svc.startd は、常にこのサービスの 1 つのインスタンスのみ、オンラインまたは機能低下状態に移行することを許可します。

また、svc.startd によって管理されるサービスは、下記に示す省略可能プロパティーを startd プロパティーグループ内に定義できます。

startd/duration: duration プロパティーは、サービスのモデルを定義します。このプロパティーは、transient、wait とも呼ばれる child モデルサービス、または contract (デフォルト) に設定できます。
startd/ignore_error: ignore_error プロパティーは、設定されている場合、無視するイベントをコンマ区切りのリストで指定します。このリストで有効な文字列値は core と signal です。デフォルトでは、すべてのエラーで再起動が行われます。
startd/need_session: need_session プロパティーが true に設定されている場合は、インスタンスを独自のセッションで起動する必要があることを示します。デフォルトでは、そのようにはなりません。
startd/utmpx_prefix: utmpx_prefix 文字列プロパティーは、メソッドを実行する前にインスタンスに有効な utmpx エントリが必要であることを定義します。デフォルトでは、utmpx エントリは作成されません。

サービス障害

メソッドからゼロ以外の終了コードが返されると、svc.startd はメソッドが失敗したと見なします。$SMF_EXIT_ERR_CONFIG または $SMF_EXIT_ERR_FATAL が返された場合、svc.startd はすぐにサービスを保守状態にします。その他すべての障害では、svc.startd はサービスをオフライン状態にします。サービスがオフラインの場合で、その依存関係が満たされているときは、svc.startd は再びサービスの開始を試みます (smf(5) を参照)。

メソッドの失敗が 3 回連続して発生した場合や、サービスの再起動が 1 秒あたり 1 回以上発生している場合は、svc.startd はサービスを保守状態にします。

サービス障害の条件は、startd/duration プロパティーで定義されるサービスモデルと、startd/ignore_error プロパティーの値との組み合わせによって定義されます。

次に示す条件のいずれかが発生すると、contract モデルサービスは障害状態になります。

サービスのすべてのプロセスが終了する
サービスのプロセスのいずれかでコアダンプが生成される
サービス外部のプロセスからサービスプロセスに致命的な信号が送信される (たとえば、管理者が pkill コマンドを使用してサービスプロセスを終了する)

startd/ignore_error に core または signal、あるいはその両方を指定すると、サービスでは最後の 2 つの条件を無視できます。

サービスを transient として定義すると、svc.startd はそのサービスのプロセスを追跡しません。したがって、contract モデルサービスについて記述されている潜在的な障害は、transient サービスについては障害と見なされません。transient サービスは、メソッド失敗条件のいずれかが発生した場合だけ保守状態になります。

wait モデルサービスは、サービスに関連付けられている子プロセスが終了するたびに再起動されます。「wait」モデルサービスの場合、子プロセスの終了はエラーとは見なされず、障害が繰り返し発生しても保守状態への移行にはつながりません。

従来のサービス

svc.startd は、起動時の実行レベル移行中に呼び出されるサービスを引き続きサポートしています。同等の実行レベルのマイルストーンを構成しているすべての管理対象サービスがオンライン状態に移行したあと、各 /etc/rc?.d ディレクトリが処理されます。/etc/rc?.d ディレクトリにある標準の init スクリプトは、そのシーケンス番号の順に実行されます。

マイルストーンと実行レベルのマッピングは次のとおりです。

milestone/single-user: シングルユーザー (S)
milestone/multi-user: マルチユーザー (2)
milestone/multi-user-server: ネットワークサービス付きマルチユーザー (3)

また、svc.startd は、スクリプトごとに 1 つのインスタンスをリポジトリに挿入することにより、これらの従来のサービスが SMF で表示されるようにします。これらの従来のインスタンスは、svcs(1) などの標準の SMF インタフェースを使用して表示でき、常に LEGACY-RUN 状態で表示されます。変更したり、ほかのサービスの依存関係として指定したりすることはできません。管理者に役立つように、従来のサービスの初期の開始時刻が取り込まれます。

ファイル

/var/svc/log: svc.startd がログファイルを格納するディレクトリ。
/etc/svc/volatile: /var が読み書き用にマウントされる前のブートの初期段階で svc.startd がログファイルを格納するディレクトリ。

使用例

例 1 詳細ログをオンに設定する

詳細ログをオンに設定するには、次のように入力します。

# /usr/sbin/svccfg -s system/svc/restarter:default
svc:/system/svc/restarter:default> addpg options application
svc:/system/svc/restarter:default> setprop options/logging = \
astring: verbose
svc:/system/svc/restarter:default> exit

この要求は、次に svc.startd を再起動したときに有効になります。

属性

次の属性については、attributes(5) を参照してください。

属性タイプ	属性値
使用条件	SUNWcsu