bootadm - manage boot configuration
/usr/sbin/bootadm update-archive [-v] [-f | -n] [-R altroot [-p platform]]
/usr/sbin/bootadm list-archive [-vn] [-R altroot [-p platform]]
/usr/sbin/bootadm install-bootloader [-Mfv] [-P pool] [-R path]
[device1 ... deviceN]
/usr/sbin/bootadm boot-pool {
[{add|remove} [-P rpool] <device list>] |
list [-P rpool] |
resync [-P rpool] [-vA] [<BE_list>] |
set [-P rpool] <param>=<value> ... }
x86 only
/usr/sbin/bootadm set-menu [-P pool] [-R altroot [-p platform]]
{key=value [key=value ...]}
/usr/sbin/bootadm set-menu-password [-P pool] [-R altroot [-p platform]]
[-f <path to file>] | -s] | [-r] | [-l -t [-i entry_number] | -g]
/usr/sbin/bootadm list-menu [-P pool] [-R altroot [-p platform]]
[[-i entry_number] | entry_title]
/usr/sbin/bootadm use-batch -f file
/usr/sbin/bootadm generate-menu [-P pool] [-f]
/usr/sbin/bootadm show-entry [-P pool] <entry_name> | -i <index>
/usr/sbin/bootadm add-entry [-P pool] [-i entry_number] entry_title
/usr/sbin/bootadm change-entry [-P pool] {[entry_title[,entry_title...]
| -i entry_number[,entry_number]...]} {key=value [key=value ...]
| set-default }
/usr/sbin/bootadm remove-entry [-P pool] {[entry_title[,entry_title...]
| -i entry_number[,entry_number]...]}
bootadm コマンドは、ブートアーカイブのほか、x86 ブート環境、GRUB (GRand Unified Bootloader) メニューを管理します。x86 では、レガシー GRUB および GRUB2 の両方が (ただし同時ではない) サポートされます。
update–archive オプションを使えば、ブートアーカイブの更新を、障害予防策として、あるいは復旧手順の一環として、実施できます。
set-menu サブコマンドを使えば、GRUB メニュー内の自動ブートタイムアウトやデフォルトブートエントリを切り替えることができます。
set-menu-password サブコマンドは、GRUB メニューを表示しないように保護するパスワードを設定します。設定するには、–f <path to file> を使用します。–s を使用すると、パスワードの入力を 2 回求めます。–r はパスワードを削除します。–l はグローバルなメニューパスワードロックが設定されているかどうかを表示します。メニューエントリの userlisti –l –t はメニューエントリのユーザーリストを解析可能な出力で表示します。–l –t –i <entry number> はそのエントリ番号リストのユーザーリストを解析可能な出力で表示します。–l –t –g はグローバルなメニューパスワードロックが設定されているかどうかを解析可能な出力で表示します。
list-menu サブコマンドは、現在の GRUB メニューエントリ、あるいはオプションでインデックスにより識別される特定のエントリの詳細 (–i を使用する場合) またはタイトル文字列 (–i を省略する場合) を表示します。
use-batch サブコマンドの –f <file> は、指定されたファイル内の bootadm 命令を実行します。これは主に、マニフェストファイルからのインストール時にパスワードを設定する場合に役立ちます。
install-bootloader サブコマンドは、システムブートローダーをインストールします。これは、x86 上の installgrub(1M) と SPARC 上の installboot(1M) の機能、および GRUB2 ブートローダーの x86 へのインストールのサポートに優先します。
アクティブなブートプールが存在する場合、ブート可能データセットは保持されます。それぞれは 1 つのブート環境に対応し、ブート環境のブート可能な アーティファクト (boot_archive (x64 および SPARC プラットフォーム) および unix カーネル実行可能ファイル (x64 プラットフォームのみ) など) を格納しています。管理者は boot-pool サブコマンドを使用して、デバイスメンバーシップ (add/remove サブコマンドを使用)、ブートアーティファクトの手動同期 (resync サブコマンドを使用)、ブートプール属性の設定 (set サブコマンドを使用) などのブートプールの側面を管理できます。
generate-menu サブコマンドは、Solaris エントリ用の新しいメニュー構成ファイルの作成方法を提供します。ブートローダー構成ファイルがすでに存在する場合は、–f を指定して、このサブコマンドでこれらのファイルを強制的に上書きする必要があります。
show-entry、add-entry、change-entry、および remove-entry サブコマンドには、GRUB メニューからエントリを表示、追加、変更、または削除するオプションがあります。change-entry には、エントリにセキュリティー保護を追加するオプションもあります。
SPARC システムなどの OpenBoot PROM (OBP) ベースのマシンは GRUB を使用しないため、bootadm で管理できるブートメニューがないことに注意してください。
あるプラットフォーム上で呼び出される bootadm を使用して、プラットフォームの種類が異なるディスクレスクライアントを管理できるように、bootadm コマンドは、管理対象のイメージでサポートされるオプションを動的に判断します。
entry_title の指定をサポートするサブコマンドの場合、entry_title は二重引用符または単一引用符で囲むことのできる文字列です。
entry_number は、GRUB メニュー内のメニューエントリのインデックスを表す負でない整数です。
bootadm コマンドのサブコマンドを、次に示します。
現在のブートアーカイブを必要に応じて更新します。SPARC と x86 の両方のプラットフォームに適用されます。
ブートアーカイブに含めるファイルとディレクトリを一覧表示します。SPARC と x86 の両方のプラットフォームに適用されます。
GRUB メニューを維持管理します。スペースで区切った鍵 - 値ペアのリストを指定できます。
指定可能な値は、次のとおりです。
GRUB メニュー内のエントリ番号 (0、1、2 0、1、2 など) で、タイムアウト時にブートするオペレーティングシステムを指定します。
デフォルト項目番号で指定されたオペレーティングシステムがブートされるまでの秒数。値が -1 の場合、自動ブートは無効になります。
GRUB で使用するコンソールのタイプを設定します。
指定可能な値は、次のとおりです。
高解像度コンソールを選択します。
高解像度コンソールを選択し、これによりさらにグラフィカルブートが実行されます。BIOS コンソールリダイレクションが有効な場合は、コンソールの設定に graphics を使用してはいけません。
GRUB ブートローダー用のシリアルコンソール。シリアルパラメータ固有の設定については、次の serial_params を参照してください。
BIOS コンソールリダイレクションが有効な場合は、console の設定に 'serial' を使用してはいけません。
シリアルコンソールによるブートでシステムをインストールする場合、そのシリアルコンソールが Solaris のカーネルデフォルトコンソールデバイスになります。ただし、GRUB のコンソールは serial に変更されません ('text' になります)。
承認されたユーザーのリストにユーザー名を追加または削除します。パスワードの入力を 2 回求めます。パスワードがハッシュされた形式で格納されます。ユーザー名は Solaris ユーザー名と同じである必要はありません。
承認されたユーザーのリストに <file path> 内のユーザー名とパスワードを追加します。<file path> は、<username>=<password> ペアが入っているファイルです。
スーパーユーザーのリストにユーザー名を追加または削除します。ユーザー名は承認されたユーザーのリストにすでに存在している必要があります。
シリアルコンソール用のシリアルパラメータを指定します。
port は、シリアルポート番号を指定する数値です。
speed は、接続のデータ転送率 (ビット/秒) を指定する数値です。
databits は、各文字内のデータビット数です。
parity には、転送エラーを検出する方法を指定します。指定可能な値は、次のとおりです。
N - パリティーなし
O - 奇数パリティー
E - 偶数パリティー
parity の値では、大文字と小文字が区別されません。
stopbits には、文字伝送で送信されるストップビットを指定します。指定可能な値は 0 または 1 です。
flowcontrol にはフロー制御を指定します。指定可能な値は、次のとおりです。
H - ハードウェアフロー制御
S - ソフトウェアフロー制御
N - フロー制御なし
serial_params を設定しない場合、デフォルトは次のとおりです:
0,9600,8,N,1,N
これにより、ボーレート 9600 ビット/秒、パリティーチェックなし、1 文字 8 ビットのデータビット、ストップビット 1、およびデフォルトのフロー制御なしで最初のシリアルポート (COM1) が作成されます。
コンソールへの通知メッセージの出力を抑制するかどうかを指定します。デフォルトでは、この値は false です。
指定可能な値は true または false です。
ブート時に表示するイメージとして使用するファイルのパスを指定します。
前景色を設定します。これは、RRGGBB 形式の 16 進数値の文字列で、RR は赤、GG は緑、BB は青です。
背景色を設定します。指定可能な値については、foreground を参照してください。
GRUB メニューを表示しないように保護するパスワードを設定または削除します。また、GRUB メニュー全体のパスワードが設定されているかどうか、および各メニューエントリのユーザーリストを表示します。
現在の GRUB メニューエントリを一覧表示します。これには、自動ブートタイムアウト、デフォルトエントリ番号、および各エントリのタイトルが含まれます。x86 プラットフォームにのみ適用されます。エントリタイトルまたはエントリインデックスを指定すると、その特定エントリの詳細が出力されます。
システムに現在インストールされている Solaris エントリのみを含む新しいメニュー構成を作成します。
メニューから名前 <entry_name> またはインデックスによって見つかったエントリを表示します。entry_name と index には、複数のエントリまたはインデックスをコンマで区切ったリストも指定できます。
指定されたエントリタイトルを使って、メニュー内に新規エントリを作成します。
entry_number が指定された場合、新しいエントリを指定された位置に挿入するか、指定された entry_number が現在のエントリ数よりも多い場合に最後のエントリとして追加します。
指定されたエントリまたはコンマ区切りのエントリのリストを変更します。エントリは、エントリタイトルまたはエントリ番号で指定します。同じタイトルのエントリが複数存在する場合、すべてが影響を受けます。
特殊なプロパティー set-default は、エントリを、タイマーの期限が切れたときにブートするデフォルトエントリに設定します。このプロパティーを指定する場合、サブコマンド内のエントリを 1 つだけ指定できます。
空白区切りの鍵 : 値ペア (key=value) のリストを指定できます。
指定可能な値は、次のとおりです。
エントリの新規タイトル。
カーネルのパス。例:
/platform/i86pc/kernel/amd64/unix
ブート時にカーネルに渡される引数、または引数のリスト。指定可能なオプションについては、kernel(1M) を参照してください。リストに空白が含まれる場合は、鍵の値を単一引用符または二重引用符で囲みます。
ブートアーカイブのパス。
bootfs プロパティーの値。詳細は、zpool(1M) を参照してください。
ユーザー名に対して、エントリタイトルまたはエントリインデックスをブートする権限を付与または付与を取り消します。
指定されたエントリまたはコンマ区切りのエントリリストを削除します。指定されたタイトルのエントリが複数存在する場合は、すべてが削除されます。
システムブートローダーをインストールします。デバイスのリストが指定された場合、指定されたデバイスのみにブートローダーがインストールされます。それ以外の場合、システム構成から自動的に抽出されるデバイスのリストにブートローダーがインストールされます。
デバイスは、ルートファイルシステムが存在するディスク上のスライスまたはパーティションの raw 文字デバイスの名前です。
boot-pool サブコマンドは、アクティブなブートプールを操作します (ブートプールを有効にしてシステムがインストールされている場合)。一部のプラットフォームでは、ブートプールに含める必要があるデバイスのセットが定義されます。その他のプラットフォームでは、ブートプールを構成するためインストール時に管理者がデバイスのセットを選択する必要がある場合があります。インストール後、ブートプールのデバイスのセットを変更および検査できます。また、ブートプールの動作も変更できます。ブートプール内の各デバイスは、障害が発生して交換された場合、プールに自動的に再追加されるため、ブートプール内のデバイスのセットが指定されているかぎり、デバイスが交換され、プールを再構築するときに、管理者の操作は必要ありません。
各サブコマンドは、ルートプールを明示的に選択できる –P 引数を受け入れます。
–P 引数が指定されていない場合、ルートプールはルートファイルシステムのデータセットが配置されているプールから派生します。
ブートプールにデバイスを追加します。デバイスはただちに追加されます。独自にブート可能になるように、新たに追加されたデバイスが再同期化されるまで、システムの再起動を延期する必要があります (ブートプールはミラーであるため、再同期のプロセスが完了したあとに、ブートローダーはミラーの各デバイスにインストールされます)。
ブートプールからデバイスをただちに削除します。
ブートプールの構成と設定に関する詳細を出力します。
ブートプールを再同期化します (必要に応じて、以前に構成したデバイスのセットを使用して再構築します)。また、指定されたブート環境 (存在する場合) のブートプールにブート可能なデータセットを作成します。コマンドオプションは次のとおりです:
最後にブートされたまたは作成されたブート環境を使用してブートプール全体にデータを再度取り込みます。
再同期中の詳細出力
指定された値に指定されたブートプールパラメータを設定します。
次のパラメータがサポートされています。
eviction_algorithm には、値として none または lru のいずれかを指定できます。デフォルトでは、この値は lru に設定されます。
eviction_algorithm が none に設定されていて、ブート環境のブート可能なファイルをブートプールにコピーする必要がある場合、ブートプールに十分な領域がないと、コピー操作は失敗します。システムの最大パフォーマンスを確保するため、ブートプールが最大容量の 85% を超えることは許可されていません。
eviction_algorithm が lru に設定されている場合、コピー操作が成功するために十分な領域が確保されるまで、最長時間未使用のブート環境に対応するブート可能なデータセットが強制的に排除されます。noevict BE ポリシー (BE ごとに設定可能) は、この動作を変更して、これらの BE の強制的排除を停止しますが、たくさんの BE が noevict とマークされると、システムはデータセットを強制的に排除することによって十分な空き領域を見出すことができないために、ブート可能なデータセットの作成に失敗する可能性があることに注意してください。
bootadm コマンドには、次のオプションがあります。
install-bootloader のインストール時に、ブートローダーのインストールを強制的に実行して、システムのブートローダーのバージョンをダウングレードしないようにするためのバージョンチェックをすべてバイパスします。
指定された操作の適用先エントリ番号またはコンマ区切りのエントリ番号のリスト。
x86 システムへの install-bootloader 操作では、マスターブートレコード (MBR) にブートローダーをインストールして、システムブートローダーにします。デフォルト (BIOS ファームウェアを備えたシステム) では、ブートローダーをパーティションブートレコード (PBR) にインストールします。
update-archive 処理の場合、アーカイブ内容のチェックは行われますが、その更新は行われません。
使用する指定されたプールに関連付けられたブート構成。このオプションを使用しない場合、現在のプール (システムのブート元) がブート構成に使用されます。
クライアントのプラットフォームまたはマシンのハードウェアクラス。プラットフォームの種類は –R とともにのみ指定でき、一般にはクライアントのプラットフォームクラスがサーバーとは異なる場合のディスクレスクライアントの管理にのみ有効です。プラットフォームには、i86pc、sun4u、sun4v のいずれかを指定する必要があります。
操作は、パスまたは代替ルートパスに適用されます。
update-archive 処理の場合、無効なファイルが標準エラー出力に表示されます。install-bootloader 操作で冗長モードを有効にして、プロセスの詳細を出力します。
次のコマンドは、現在のブートアーカイブを更新します。
# bootadm update-archive使用例 2 別のルート上にあるブートアーカイブの更新
次のコマンドは、別のルート上にあるブートアーカイブを更新します。
# bootadm update-archive -R /a使用例 3 デフォルトブートエントリの切り替え
次のコマンドは、1 つ前の例で表示されたメニューを参照しています。ユーザーは、Linux (項目 2) を選択しています。
# bootadm set-menu default=2
または
# bootadm change-entry -i 2 set-default使用例 4 GRUB メニューエントリの一覧表示
次のコマンドは、GRUB メニューエントリを一覧表示します:
# bootadm list-menu The location for the active GRUB menu is: /stubboot/boot/grub/menu.lst default 0 timeout 10 0 Solaris10 1 Solaris10 failsafe 2 Linux使用例 5 メニューエントリの追加と変更
次のコマンドは、「New Solaris Entry」というタイトルのメニューエントリを GRUB メニュー内の 8 番目の位置に追加します。
# bootadm add-entry -i 8 "New Solaris Entry"
次のコマンドは、追加したばかりのエントリをカーネル引数 –s 使って変更して、レベル s でブートします。
# bootadm change-entry "New Solaris Entry" kargs="-s"使用例 6 2 番目のルートプールへのブートローダーのインストール
次のコマンドは、ブートローダーをプール secondrpool にインストールします。
# bootadm install-bootloader -P secondrpool使用例 7 前景色と背景色の設定
次のコマンドは、前景色を赤色に、背景色を青色に設定します。
# bootadm set-menu splashimage=/boot/grub/splash.xpm.gz \ foreground=ff0000 background=0000ff使用例 8 アクティブなブートプールに関する情報の表示
# bootadm boot-pool list Boot pool name: bpool Parameters: eviction_algorithm=lru Current: /dev/dsk/c1t0d0, /dev/dsk/c1t1d0 Pending: /dev/dsk/c1t0d0, /dev/dsk/c1t1d0 Platform-specified devices excluded: /dev/dsk/c1t2d0 Platform-specified (auto-added, unless excluded): /dev/dsk/c1t0d0,
この例では、プラットフォームに 3 つのブートプールデバイスが指定されていますが、システムはそれらのうち 2 つしか使用していません。現在のブートプールデバイスのリストは、保留中のブートプールデバイスのリストと同じであるため、保留中のブートプールのメンバーシップの変更はありません。アクティブなブートプールがない場合、次の出力が返されます。
bootadm: Boot pool operations are not applicable to root pool rpool.
次の終了ステータスが返されます。
コマンドが正常に完了しました。
エラーが発生したため、コマンドが終了しました。
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
bootadm は、デフォルトでは TMPDIR の設定に関係なく /var/tmp に一時ファイルを格納します。
boot(1M), installboot(1M), installgrub(1M), kernel(1M), zpool(1M), attributes(5), grub(5)
次の GRUB ホームページを参照してください。
http://www.gnu.org/