Go to main content

マニュアルページ セクション 8: システム管理コマンド

印刷ビューの終了

更新: 2022年7月27日
 
 

sysadm(8)

名前

sysadm - maintain host

形式

sysadm maintain -s [ -m "message" ]

sysadm maintain -l [-p] [-o field1,...]

sysadm maintain -e

sysadm evacuate [-arnvqw]

sysadm evacuate -l [-p] [-o field1,...]

説明

sysadm ユーティリティーは、システムの保守モードを制御したり、システムでホストされているゾーンの退避を実行したりするために使用されます。

"Maintenance and Repair" RBAC プロファイルに属しているユーザーとロールのみが sysadm コマンドを使用できます。

保守モードを開始すると、監査レコードがログに記録され、以降の接続、ブート、または任意のゾーンのシステムへの着信する移行が防止されます。これを使用すると、ゾーンホストで管理を実行したり、それをサービスから削除したりできます。

保守状態は、ホストのリブートや、異なるブート環境間の変更があっても保持されます。

ゾーンをサービスに戻すには、–e オプションで保守を終了する必要があります。

Optionally, the host may be evacuated by migrating all solaris-kz, solaris and solaris10 brand zones away from the system.ゾーンインスタンスの退避/ターゲットプロパティーで、移行先ゾーンホストの非対話型 RAD URI を指定する必要があります。ゾーンサービス svc:/system/zones/zone で、デフォルトの宛先ホストも指定できます。

サブコマンド

サポートされているサブコマンドは次のとおりです。

sysadm maintain –s [ –m "message" ]

Starts maintenance.オプションの自由形式メッセージ文字列を指定できます。

保守を開始すると、既存の退避状態がすべてクリアされます。

sysadm maintain –l [–p] [–o field1,...]

保守状態 (存在する場合) を一覧表示します。

–o field[,...], –-output=field[,...]

表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。フィールド名は、次に示すフィールドのいずれか、またはすべてのフィールドを表示するための特殊な値 all にする必要があります。

TYPE

保守のタイプ。現在は、常に admin という値です。

USER

保守モードを設定するユーザー。

DATE

保守モードが設定される日付。

MESSAGE

保守モードに関連付けられたすべてのメッセージ。

–p

安定したマシン解析可能な形式を使用して表示します。–p オプションには –o オプションが必要です。

sysadm maintain –e

保守モードを終了します。

sysadm evacuate –l [–p] [–o field1,...]

退避状態をすべて一覧表示します。部分的な退避のあと、これには、宛先システムに退避されたゾーンだけでなく、退避に失敗したゾーンが失敗の理由とともに表示される可能性があります。

–o field[,...], –-output=field[,...]

表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。フィールド名は、次に示すフィールドのいずれか、またはすべてのフィールドを表示するための特殊な値 all にする必要があります。

ZONENAME

ゾーンの名前。

STATE

ゾーンの退避の状態。EVACUATED の場合、ゾーンは DEST 値で指定された場所に退避されました。SKIPPED の場合、退避は試行されず、ゾーンはまだ実行されている可能性がありです。FAILED の場合、退避は失敗し、ERROR フィールドに詳細情報が表示されます。

DEST

ゾーンが退避された宛先の RAD URI、または FAILED の場合は最後に試行された宛先。

ERROR

状態が SKIPPED または FAILED のどちらかである場合は、関連するエラーステータスが表示されます。

–p

安定したマシン解析可能な形式を使用して表示します。–p オプションには –o オプションが必要です。

sysadm evacuate [–arnvq]

ホストシステムを退避します。または、–r オプションを指定すると、ゾーンをホストに戻します。

実行中のゾーンごとに、退避によって、ゾーンはその SMF サービスインスタンスで構成された宛先にライブ移行されます。

個々のゾーンのブランドがライブ移行をサポートしていない場合、退避はスキップされ、そのゾーンの状態は SKIPPED になります。

–a オプションが指定されている場合は、実行中でないゾーンもコールド移行を使用して退避されます。

個々のゾーンが退避に失敗した場合、そのゾーンの状態は FAILED になり、ERROR 値に詳細情報が入力されます。

–a

実行中でないゾーンと実行中のゾーンの両方を退避します。

–v [–v]

Reports evacuation progress verbosely to the standard output.Each output line has a timestamp.

When the –v option is doubled, the detailed per zone migration progress is reported too.

–q

Only reports errors.

–n

Dry-run evacuation.移行が計画され、ゾーンごとに宛先ホストへの予行演習の移行が実行されます。

–r

Returns zones.退避された各ゾーンがその宛先から移行されます。そのゾーンがそこでまだ実行されている場合は、元のソースホストに移行されます。–a オプションが指定されている場合は、実行されていなければ、コールド移行で戻されます。

–w

Overwrite zone configuration for each evacuated zone on the destination host with the respective configurations from the source host.This is mutually exclusive with the –n option.

一部のゾーンが最初の実行で退避に失敗した場合は、退避が複数回実行される可能性があります。戻りステータスが成功になるのは、退避全体が完了した場合だけです。つまり、sysadm コマンドを実行したあと、関連するホスト上でどのゾーンも実行されていてはいけません。

使用例 1 Starting Maintenance
# sysadm maintain -s -m "doing a pkg update"
# sysadm maintain -l
TYPE  USER       DATE             MESSAGE
admin root       2016-01-25 06:01 doing a pkg update
使用例 2 システムの 1 つのデフォルトの宛先への退避
# svccfg -s svc:/system/zones/zone        
svc:/system/zones/zone> setprop evacuation/target = astring: "ssh://desthost/"
svc:/system/zones/zone> refresh
svc:/system/zones/zone> exit

# sysadm evacuate -nv
sysadm: preparing 2 zone(s) for evacuation ...
       sysadm: initializing migration of kzone1 to desthost ...
       sysadm: initializing migration of kzone2 to desthost ...
sysadm: kzone1: planned evacuation to ssh://desthost/
sysadm: kzone2: planned evacuation to ssh://desthost/
sysadm: dry-run succeeded

# sysadm evacuate    
sysadm: preparing zones for evacuation ... 2/2
sysadm: evacuating zones ... 2/2
sysadm: evacuation completed successfully.
		
# sysadm evacuate -l -o all
ZONENAME         STATE     DEST                                     ERROR
kzone1          EVACUATED ssh://desthost/                            -
kzone2          EVACUATED ssh://desthost/                            -
使用例 3 保守状態のクリアおよび退避の復帰
# sysadm maintain -e
# sysadm evacuate -r
sysadm: preparing zones for return ... 2/2
sysadm: returning zones ... 2/2
sysadm: return completed successfully.

# sysadm evacuate -l
sysadm: no active evacuation

# zoneadm list -civ
  ID NAME             STATUS      PATH                         BRAND      IP    
   0 global           running     /                            solaris    shared
   3 kzone2           running     -                            solaris-kz excl  
   4 kzone1           running     -                            solaris-kz excl  
使用例 4 Getting the detailed evacuation progress messages.
# sysadm evacuate -vv
2021-09-09 10:38:26.844 sysadm: preparing 2 zone(s) for evacuation ...
2021-09-09 10:38:27.555 sysadm: initializing migration of kzone1 to desthost ...
2021-09-09 10:38:28.209 sysadm: initializing migration of kzone2 to desthost ...
2021-09-09 10:38:44.773 sysadm: evacuating 2 zone(s) ...
2021-09-09 10:38:44.773 sysadm: migrating kzone2 to desthost ...
2021-09-09 10:38:44.774 sysadm: migrating kzone1 to desthost ...
2021-09-09 10:38:44.792 sysadm: kzone2: Performing initial copy (total 4096MB).
2021-09-09 10:38:44.792 sysadm: kzone1: Performing initial copy (total 4096MB).
2021-09-09 10:38:44.847 sysadm: kzone2: 0.00% done: 0MB copied @ 0.0MB/s, skipped 0MB
2021-09-09 10:38:44.861 sysadm: kzone1: 0.00% done: 0MB copied @ 0.0MB/s, skipped 0MB
2021-09-09 10:38:49.848 sysadm: kzone2: 37.30% done: 768MB copied @ 153.6MB/s, skipped 759MB
2021-09-09 10:38:49.862 sysadm: kzone1: 49.11% done: 704MB copied @ 140.8MB/s, skipped 1307MB
2021-09-09 10:38:54.848 sysadm: kzone2: 63.48% done: 1600MB copied @ 166.4MB/s, skipped 1000MB
2021-09-09 10:38:54.863 sysadm: kzone1: 97.53% done: 1415MB copied @ 142.2MB/s, skipped 2578MB
2021-09-09 10:38:59.849 sysadm: kzone2: 96.73% done: 2342MB copied @ 148.4MB/s, skipped 1619MB
2021-09-09 10:38:59.864 sysadm: kzone1: 100.00% done: 1508MB copied @ 18.4MB/s, skipped 2587MB
2021-09-09 10:38:59.867 sysadm: kzone1: Performing copy of recently modified memory.
2021-09-09 10:38:59.883 sysadm: kzone1: Suspending zone on source host.
2021-09-09 10:39:00.509 sysadm: kzone1: Waiting for migration to complete.
2021-09-09 10:39:00.510 sysadm: kzone1: Halting and detaching zone on source host.
2021-09-09 10:39:00.512 sysadm: kzone1: Migration successful.
2021-09-09 10:39:04.850 sysadm: kzone2: 100.00% done: 2465MB copied @ 24.6MB/s, skipped 1630MB
2021-09-09 10:39:04.852 sysadm: kzone2: Performing copy of recently modified memory.
2021-09-09 10:39:04.862 sysadm: kzone2: Suspending zone on source host.
2021-09-09 10:39:05.284 sysadm: kzone2: Waiting for migration to complete.
2021-09-09 10:39:06.286 sysadm: kzone2: Migration successful.
2021-09-09 10:39:06.287 sysadm: kzone2: Halting and detaching zone on source host.
2021-09-09 10:39:07.124 sysadm: kzone1: evacuated to ssh://desthost/
2021-09-09 10:39:07.124 sysadm: kzone2: evacuated to ssh://desthost/
2021-09-09 10:39:07.124 sysadm: evacuation completed successfully.
      

終了ステータス

次の終了ステータスが返されます。

0

正常終了。

退避の場合、この終了値は、ソースシステム上でまだ実行されているゾーンがないことを示します。退避の復帰の場合、この終了値は、すべてのゾーンが元のソースシステムに移行されたことを示します。

1

An error occurred.

CAVEATS

When SSH transport is used, the sysadm utility requires the SSH keys to have empty passphrase to ensure non-interactive evacuation of the zones and their eventual returning.Unlike zoneadm(8), the sysadm utility ignores the SSH_AUTH_SOCK environment variable.

属性

属性についての詳細は、マニュアルページの attributes(7) を参照してください。

属性タイプ
属性値
インタフェースの安定性
下記を参照。
- CLI options
確実
- Parsable output of sysadm evacuate -l
確実
- Human readable and verbose output
インタフェースではない
使用条件
system/zones

関連項目

zones(7), solaris-kz(7), solaris(7), rad(8), beadm(8), svc.zones(8)