名前 | 形式 | 機能説明 | オプション | オペランド | ファイル | 属性 | 関連項目 | 注意事項
/usr/sbin/cfgadm [-c configure] [-f] [-o disable-at-boot | enable-at-boot ] ac#:bank# ...
/usr/sbin/cfgadm [-c unconfigure] [-o disable-at-bootp | enable-at-boot ] ac#:bank# ...
/usr/sbin/cfgadm [-v] [-o quick | normal | extended, [max_errors=#] ] -t ac#:bank#...
/usr/sbin/cfgadm -x relocate-test ac#:bank# ...
/usr/sbin/cfgadm [-l] -o disable-at-boot | enable-at-boot ac#:bank# ...
ac ハードウェア固有ライブラリ /usr/platform/sun4u/lib/cfgadm/cfgadm_ac.so.1 は、 cfgadm_sysctrl(1m) を使用する CPUU/メモリーボードの Dynamic Reconfiguration (DR: 動的再構成)の一部として、E6X00、E5X00、E4X00、E3X00 システムのメモリーバンクの構成と構成解除に関連する機能を提供します。
メモリーバンクは、デバイスツリー上の接続点として表されます。 CPU/メモリーボードそれぞれに2つの接続点が用意されます。1つがボード上の各バンク (バンク 0 とバンク 1) 用になります。 バンクが空いている場合は、受容体の状態は empty (空き) になります。バンクが使用されている場合は、受容体の状態は connected(接続) になります。 受容体の状態が disconnected (接続解除) になることはありません。接続されているメモリーバンクの占有状態は、構成することも構成解除することもできます。 占有状態が構成されている場合は、メモリーは Solaris によって使用されています。構成解除されている場合は、使用されていません。
コマンドオプションの詳細については、cfgadm(1M) を参照してください。
以下のオプションがサポートされています。
占有状態を変更します。引数が configure の場合は、メモリーが初期化され、Solaris のメモリープールに追加します。引数が unconfigure の場合は、Solaris によって使用されているメモリーを切り離します。CPU/メモリーボードをシステムから取り外すには、2 つのメモリーバンクを構成解除する必要があります。
ボード上のメモリーが disabled-at-boot (infoフィールド参照) に指定されていて、-f (強制) オプションやブート許可フラグ (-o enable-at-boot) がいずれも指定されていない場合は、cfgadm コマンドは、構成操作を許可しません。構成操作には、初期化する必要のあるメモリーのサイズに応じて、少し時間がかかります。
システムに十分な使用可能メモリーがない (VM viability エラー)、または構成解除されるべきバンクに切り離せないメモリーがある (non-relocatable pages エラー) 場合、cfgadm コマンドは、構成解除操作を許可しません。 再配置不可のページの現状は、info フィールドの一覧にある permanent によって表されます。 Solaris が使用しているメモリの取り外しを行うと、システム負荷や補助記憶装置のページングの大きさによって、かなり時間がかかります。構成解除操作は、いつでも中止することができ、シグナルによるコマンドの中断によって、メモリーは完全に構成されている状態に戻ります。もし、タイムアウトまでの期間内に削除できるメモリーがない場合は、構成解除操作は、自動的に取り消されます。デフォルトのタイムアウト期間は 60 秒ですが、-o timeout=# オプションで変更することもできます。この数値を 0 にすると、タイムアウトは不許可になります。
強制オプション。このオプションは、非揮発性の変数 disabled-memory-list で、disabled at boot (ブート不可) に指定された、構成されているメモリーバンクのブロックを無効にしたい場合に使用してください。詳細は、『特記事項: Sun Enterprise 6x00/5x00/4x00/3x00システム』を参照してください。
リストオプション。このオプションについての説明は、cfgadm(1M)のマニュアルページを参照してください。
type フィールドは、常に memory です。
info フィールドには、以下に示すような空のメモリーバンクについての情報が保持されます。
slot# empty |
slot# は、CPU/メモリーボードが挿入されているシステムスロットを示しています。たとえば、これがスロット 11 である場合、cfgadm が関連付けられたボードを操作するために使用する接続点は、 sysctrl0:slot11 になります。info フィールドには、以下に示すような接続されているバンクについての情報が保持されます。
slot# sizeMB|sizeGB [(sizeMB|sizeGB を使用)] base 0x### [interleaved #-way] [disabled at boot] [permanent] |
バンクのサイズは、MB か GB か適切な単位で与えられます。メモリーがまだ使い切られていない場合、使用サイズが表示されます。 物理ベースアドレスは、16 進数で与えられます。メモリーバンクが他のバンクによってインタリーブされている場合は、インタリーブファクター(因子) が出力されます。ボード上のメモリーが、 非揮発性の変数 disabled-memory-list を使ってブート不可になっている場合は、そのことが表示されます。バンクに切り離せないメモリーがあると、固定 (permanent) として出力されます。
このオプションは、非揮発性の disabled-memory-list変数を変更することを許可します。これらのオプションは、コマンド要求がない場合は、-c オプションの発行や、明白または暗示的なリスティングオプション -l と結合して、使用することができます。使用不可メモリーの一覧にあるボード上に構成されているメモリーブロックを無効にするには、 configure コマンドを -o enable-at-boot オプションで使用してください。
テストレベルを指定するには、-t オプションを使用してください。
テストレベル normal では、各メモリーセルに 0 と 1 のいずれも格納できることを確認して、さらにすべてのセルが個別にアドレス可能であるかどうか検査します。 テストレベル quick では、すべてのメモリーに 0 と 1 を書き込むテストだけを行うため、アドレス線の障害を発 見することはできません。extended テストでは、近接したセル同士の干渉の問題をテストするパターンを使用します。デフォルトのテストレベルは、normal です。 -t オプションを参照してください。
-t オプションと共に使用して、許可するエラーの最大数を指定します。このオプションを指定しなかった場合は、デフォルト値の 32 が適用されます。
構成解除コマンドと共に使用して、自動取り消しによるタイムアウトを設定します。デフォルト値は 60 で、単位は秒です。数値が 0 の場合は、タイムアウトしません。
構成されていないメモリーのバンクをテストします。-o quick | normal | extended オプションでテストレベルを指定してください。
メモリーバンクテストが実行できた場合は、cfgadm コマンドはステータス 0 (成功) で終了します。テストの結果は、接続点のためという条件で利用可能です。
詳細表示オプションです。-t オプションと組み合わせて使用することにより、テストの進行状況と結果を詳細に表示できます。
指定されたメモリーバンクで使用されているメモリーの全ページに対し、構成解除コマンドで行われるように、再配置を試みます。この操作の成功は、バンクが構成解除できるかどうかを保証しません。この操作の失敗は、構成解除できなかったことを意味します。このオプションの用途は、テストのみに限定されます。
以下のオペランドがサポートされています。
メモリーバンクの接続点は、アドレスコントローラー(ac#) ドライバ (ac) のインスタンスによって作成されます。 ac ドライバの 1 つのインスタンスは、各システムボードによって作成されますが、CPU/メモリーボードに関連付けられたインスタンスだけは、バンク 0 と バンク 1 の 2 つの接続点を作成します。
このフォームは、cfgadm(1M) によって与えられた論理 ap_id 指定と一致します。これに対応する物理 ap_id のリストは、ファイルの項目にあります。
ac ドライバインスタンスの番号付けは、対応するボードのスロット番号とは関係はありません。完全な物理接続点の識別子には、fhc@ に続く、スロット番号の 2 倍を 16 進数で表したスロット番号が入ります。
接続点
ハードウェア固有ライブラリファイル
以下の属性についての説明は、attributes(5) を参照してください。
属性タイプ |
属性値 |
---|---|
使用条件 |
SUNWkvm.u |
cfgadm(1m), cfgadm_sysctrl(1m), config_admin(3CFGADM), attributes(5)
『日本語Solaris7 Sun Enterprise 6X00, 5X00, 4X00, 3X00 システム Dynamic Reconfiguration ユーザーマニュアル』
『特記事項: Sun Enterprise 6x00/5x00/4x00/3x00 システム』
EXX00 システムの CPU/メモリーボードの Dynamic Reconfigura-tion に関する詳細は、『日本語Solaris7 Sun Enterprise 6x00, 5x00, 4x00, 3x00 システム Dynamic Reconfiguration ユーザーマニュアル』を参照してください。