cfgadm_sysctrl

- EXX00 システムボードの管理

形式

/usr/sbin/cfgadm -c function [-f] 
     [-o disable-at-boot | enable-at-boot] [-n | -y] sysctrl0:slot# ...

/usr/sbin/cfgadm -x quiesce-test sysctrl0:slot# 

/usr/sbin/cfgadm -x insert-test | remove-test sysctrl0:slot# ...

/usr/sbin/cfgadm -x set-condition-test=# sysctrl0:slot# ...

/usr/sbin/cfgadm [-l]
     -o disable-at-boot | enable-at-boot sysctrl0:slot# ...

機能説明

sysctrl ハードウェア固有ライブラリ、/usr/platform/sun4u/lib/cfgadm/sysctrl.so.1 により、E6X00、E5X00、E4X00、E3X00 システム上で、動的再構成を用いてシステムボードの構成や構成解除ができるようになります。これによりシステムが稼働中であってもリブートせずに、I/O ボード、および CPU ボードを、Solaris 用に設定されたシステムのスロットに挿入できるようになります。また同様に、いずれのタイプのボードも稼働中のシステムから切断および取り外しが可能になり、リブートの必要はなくなります。

システムスロットはデバイスツリー上で「接続点 (attachment point)」として表現され、システムシャーシ内の各スロットには、この接続点が 1 つづつ設定されます。スロットにボードが設置されていない場合は、受容体の状態は empty と認識されます。ボードの電源が切断されシステムから取り外せる状態の場合は、受容体の状態は disconnected (接続解除) と認識されます。ボードに電源が投入されシステムバスに接続されている状態であれば、受容体の状態は connected (接続) と認識されます。

受容体の状態が empty または disconnected の場合、その受容体の占有装置は unconfigured の状態にあると認識されます。受容体の状態が connected の場合は、その受容体の占有装置は configured またはunconfigured のいずれかの状態を取ります。

Solaris でボード上のデバイスを利用できるのは、この状態が configured になっている場合です。unconfigured になっている場合、ボード上のデバイスは利用できません。

ボードを挿入すると、受容体の状態は empty から disconnected に変わります。ボードを取り外すと、受容体の状態は disconnected から empty に変わります。connected になっているボードを取り外してしまうと、オペレーティングシステムのクラッシュを起こし、システムに修復不可能な障害を与える場合があります。

オプション

オプションについての詳細は、cfgadm(1M) の項目を参照してください。

次のオプションがサポートされています。

-c function

状態の変更に使用します。function の部分に connect 、disconnect 、configure 、unconfigure のいずれかを指定します。

configure

占有装置の状態を configure に変更します。

受容体の状態が disconnected になっている場合は、configure 機能はまず受容体への接続を試みます。connect 機能の一部として作成される OBP デバイスツリーを調べて Solaris デバイスノードを作成し、要求のあったデバイスを接続します。CPU/メモリーボードの場合は、電源が切断状態にある CPUのリストに、この CPU を加えます。この情報は psrinfo(1M) または psradm(1M) コマンドを用いて見ることができます。CPU/メモリーボードにはメモリー接続点が 2 つ作成されます。新規に設置したボード上の I/Oデバイスを使えるように設定するには、mount(1M) および ifconfig(1M) コマンドを利用します。CPU を使用するには、psradm -n を使用して新たなプロセッサをオンラインに設定します。メモリーバンクのテストおよび設定には cfgadm_ac(1M) を利用します。

connect

受容体の状態を connected に変更します。

受容体の状態の変更を要求すると、バス信号の接続中はシステムバスを凍結し、その間にボードをテストします。休止処理によってバスは凍結します。この休止処理の間は、すべてのプロセス活動は停止し、すべてのドライバの動作が中断します。この休止処理およびそれに後続する復元処理にはかなりの時間がかかります。またすべてのドライバがこの機能をサポートしているわけではありません。このため、-x quiesce-test というオプションが用意されています。これを使用してシステムバスを凍結させている間に、接続されているボードをファームウェアからテストできます。I/O ボードの場合はこの処理には短時間しか費やしませんが、CPU/メモリーボードの場合は CPU 外部キャッシュのテストが原因で非常に長時間かかります。ここではメモリーのテストはしません。休止処理を開始する前には、実行の確認を促してきます。オプションに -y または -n を使用すると、この確認作業を省略できます。disabled-at-bootに指定されているボードは、接続処理を拒否します。ただし、指定された処理を強制実行する -f フラグを利用、または -o enable-at-boot を使って指定を無効化した場合は、接続処理が実行されます。-l の解説を参照してください。

disconnect

受容体の状態を disconnected に変更します。

占有装置の状態が configure になっている場合は、まず占有装置を構成解除します。この disconnect では休止処理を実行しないので、短時間で終了します。ボードの電源は切断され、取り外しが可能な状態になります。

unconfigure

占有装置の状態を unconfigureed に変更します。

この処理の間、ボード上のデバイス はSolaris からは見えない状態になります。I/O ボード上の I/O デバイスは、Solaris のデバイスツリーから削除されます。デバイスが使用中の場合、この unconfigure の処理は停止し、使用中であることを報告してきます。この場合はデバイスの使用を停止して、その後で unconfigure 処理を再試行する必要があります。CPU/メモリーボードの場合は、ボードの unconfigure 処理を実行する前に、メモリーの状態を unconfigure に設定しておかなければいけません。ボード上の CPU をオフラインにしてから、電源を切断して Solaris CPU リストから削除します。接続中のプロセスが存在する CPU をオフラインにすることはできません。CPU のオフライン化についての詳細は、psradm(1M)、psrinfo(1M)、pbind(1M)、p_online(2) の各項目を参照してください。

-f

強制的に、ボードに接続されているブロックの非揮発性変数 disabled-board-list を、disabled-at-boot に指定します。『特記事項: Sun Enterprise 6x00、5x00、4x00、3x00 システム』のマニュアルも参照してください。

-l

リストを表示させるオプションです。これはcfgadm(1M) で解説しているものと同様の機能です。

type フィールドには cpu/mem、mem、dual-sbus、sbus-upa、dual-pci、soc+sbus、soc+upa、disk、unknown のいずれかを指定できます。

ハードウェア固有情報のフィールドは、次のように設定されています。 [disabled at boot] [non-detachable] [100 MHz capable]

ボードのタイプが sbus-upa または soc+upa の場合は、まず最初に次のような追加情報が表示されます。 [single buffered ffb|double buffered ffb|no ffb installed] ボードのタイプが disk の場合は、次のような追加情報が最初に表示されます。 {target: # | no disk} {target: # | no disk}

-o disable-at-boot | enable-at-boot

非揮発性変数 disabled-board-list の変更に使用します。この -o オプションを使う時は、-c function または -l オプションと併用します。

disabled-at-boot に設定されているボードに関連するブロックをブート時に有効となるようにするには、-o enable-at-boot と -c connect を併用します。

-x insert-test | remove-test

テストを実行します。

ここで remove-test を使うと、ボードを物理的に取り外さなくても、テストシーケンスを自動処理している間、指定したスロットのドライバ状態は disconnected から empty に変更されます。

また、insert-test の方を使った場合は、remove-testコマンドで empty に指定したスロットのドライバ状態が isconnected に変更され、ボードはスロットに挿入されているものとして認識されます。

-x quiesce-test sysctrl0:slot1

テストを実行します。

このテストの実行により、ボードの接続処理に必要となる quiesce 処理が実行できる状態になります。現在のソフトウェアおよびハードウェアの構成を保ったままで、システムを確実に休止できるようになります。休止処理できないデバイスやプロセスが存在した場合は、エラーメッセージでその名前を表示します。このコマンドは有効なボード接続点に対してであればどれにでも使用可能ですが、いかなるシステムも必ず slot1 を 1 つ所有しているので、上に示した形式での使用を推奨しておきます。

-x set-condition-test=#

テストを実行します。

状態変更コマンドのポリシーロジックをテストできるように、システムボードの接続点の条件を設定します。新しい設定の内容は、1 から 4 の数字で表現されます。各数字の意味は、以下のようになります。

0      unknown
1      ok 
2      failing
3      failed
4      unusable

オペランド

次のオペランドがサポートされています。

sysctrl0:slot#

sysctrl ドライバのインスタンス 0 (sysctrl0) が、EXX00 システム上のボードに接続点を発行します。接続点の名前には、slot0 から slot15 までの番号を割り当てます。# の部分には 0 から 15 までの数字を入れます。この値がスロット番号を示すことになります。この形式は、cfgadm(1M) を用いた論理的な ap_id の指定と一致します。これに対応する物理的な ap_id は、次項の【ファイル】に記載してあります。

ファイル

/usr/platform/sun4u/lib/cfgadm/sysctrl.so.1

ハードウェア固有ライブラリ

/devices/central@1f,0/fhc@0,f8800000/clock-board@0,900000:slot*

接続点

属性

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

関連項目

cfgadm(1M), cfgadm_ac(1M), ifconfig(1M), mount(1M), pbind(1M), psradm(1M), psrinfo(1M), config_admin(3CFGADM), attributes(5)

『Sun Enterprise 6x00、5x00、4x00、3x00 システム Dynamic Reconfiguration ユーザーマニュアル』

『特記事項: Sun Enterprise 6x00、5x00、4x00、3x00 システム』

注意事項

EXX00 システムの CPU/メモリーボードの動的再構成について、更に詳しい情報が必要な場合は、『Sun Enterprise 6x00、5x00、4x00、3x00 システム Dynamic Reconfiguration ユーザーマニュアル』を参照してください。