233 lines
7.3 KiB
Groff
233 lines
7.3 KiB
Groff
.\" $NetBSD: ccdconfig.8,v 1.1.2.1 1995/11/11 02:43:33 thorpej Exp %
|
|
.\"
|
|
.\" Copyright (c) 1995 Jason R. Thorpe.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgment:
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed for the NetBSD Project
|
|
.\" by Jason R. Thorpe.
|
|
.\" 4. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" %FreeBSD: src/sbin/ccdconfig/ccdconfig.8,v 1.9.2.8 2001/12/14 15:17:47 ru Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.Dd July 17, 1995
|
|
.Dt CCDCONFIG 8
|
|
.Os
|
|
.Sh 名称
|
|
.Nm ccdconfig
|
|
.Nd 結合ディスクドライバ用設定ユーティリティ
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl cv
|
|
.Ar ccd
|
|
.Ar ileave
|
|
.Op Ar flags
|
|
.Ar dev
|
|
.Op Ar
|
|
.Nm
|
|
.Fl C
|
|
.Op Fl v
|
|
.Op Fl f Ar config_file
|
|
.Nm
|
|
.Fl u
|
|
.Op Fl v
|
|
.Ar ccd
|
|
.Op Ar
|
|
.Nm
|
|
.Fl U
|
|
.Op Fl v
|
|
.Op Fl f Ar config_file
|
|
.Nm
|
|
.Fl g
|
|
.Op Fl M Ar core
|
|
.Op Fl N Ar system
|
|
.Op Ar ccd Op Ar ...
|
|
.Sh 解説
|
|
.Nm
|
|
は結合ディスクデバイス (concatenated disk device, ccd) の動的な設定および
|
|
解除を行う場合に使用します。ccd の詳細については、
|
|
.Xr ccd 4
|
|
を参照して下さい。
|
|
.Pp
|
|
以下のオプションが使用できます。
|
|
.Bl -tag -width indent
|
|
.It Fl c
|
|
ccd の設定を行います。
|
|
.Nm
|
|
のデフォルトの動作です。
|
|
.It Fl C
|
|
設定ファイルに書かれている全てのデバイスの設定を行います。
|
|
.It Fl f Ar config_file
|
|
全てのデバイスの設定あるいは解除を行う時に、デフォルトの
|
|
.Pa /etc/ccd.conf
|
|
ではなく、
|
|
.Pa config_file
|
|
から設定情報を読み込みます。
|
|
.It Fl g
|
|
ccd の設定ファイルとして使用できる形式で、現在の ccd の設定を出力します。
|
|
引数が指定されていなければ、設定されている全ての ccd について出力します。
|
|
引数が指定されていれば、指定された ccd についてのみ出力します。
|
|
.It Fl M Ar core
|
|
名前リストに対応する値の展開に、デフォルトの
|
|
.Pa /dev/mem
|
|
ではなく、
|
|
.Pa core
|
|
を使用します。
|
|
.It Fl N Ar system
|
|
(
|
|
.Xr getbootfile 3
|
|
により判断される)
|
|
現在稼働中のカーネルの代わりに
|
|
.Ar system
|
|
をカーネルとして使用します。
|
|
.It Fl u
|
|
ccd の設定を解除します。
|
|
.It Fl U
|
|
ccd 設定ファイルに書かれている全ての ccd デバイスの設定を解除します。
|
|
.It Fl v
|
|
より冗長な出力を行います。
|
|
.El
|
|
.Pp
|
|
ccd は、コマンド行ないし ccd 設定ファイルにて、ccd の名前、インタリーブ
|
|
ファクタ、ccd 設定フラグ、ひとつ以上のデバイスのリストの情報により
|
|
定義されます。フラグは、十進数、十六進数、コンマで区切られた名前のリスト、
|
|
.Dq none
|
|
のいずれかで表すことができます。
|
|
フラグには以下の物があります。
|
|
.Bd -unfilled -offset indent
|
|
CCDF_SWAP 0x01 dmmax 単位でインタリーブ
|
|
CCDF_UNIFORM 0x02 ディスク間で均一なインタリーブ
|
|
CCDF_MIRROR 0x04 データのミラーリングを
|
|
CCDF_PARITY 0x08 パリティ検査を行います (現状では使用不可)
|
|
.Ed
|
|
.Pp
|
|
設定ファイルのフォーマットは、コマンド行から指定する場合と
|
|
同一の形式になります。コマンド行から指定する場合も、
|
|
設定ファイルから指定する場合も、
|
|
.Pa flags
|
|
引数はオプションです。
|
|
.Bd -unfilled -offset indent
|
|
#
|
|
# /etc/ccd.conf
|
|
# Configuration file for concatenated disk devices
|
|
#
|
|
.Pp
|
|
# ccd ileave flags component devices
|
|
ccd0 16 none /dev/da2e /dev/da3e
|
|
.Ed
|
|
.Pp
|
|
構成要素のデバイスは、パーティションタイプが
|
|
.Li FS_BSDFFS
|
|
.Pf ( Xr disklabel 8
|
|
では
|
|
.Dq 4.2BSD
|
|
と表示されます) であることが必要です。
|
|
.Sh 使用例
|
|
ccdconfig の例をいくつか以下に示します。
|
|
ccdconfig に渡される引数は、
|
|
.Pa /etc/ccd.conf
|
|
設定ファイルに書けるものと正に同じものです。
|
|
1 番目の例は、
|
|
4 ディスクのストライプを 4 SCSI ディスクパーティションから作成します。
|
|
ストライプは 64 セクタインタリープを使用します。
|
|
2 番目の例は、
|
|
複雑なストライプ/ミラーの組み合わせの例です。
|
|
これは、
|
|
da2e と da3e の 2 ディスクストライプを、
|
|
da4e と da5e の 2 ディスクストライプへミラーすると、解釈します。
|
|
最後の例は、単純なミラーです。
|
|
/dev/da2e は /dev/da4e へミラーされ、ccd0 に割り当てられます。
|
|
.Pp
|
|
.Bd -unfilled -offset
|
|
# ccdconfig ccd0 64 none /dev/da2e /dev/da3e /dev/da4e /dev/da5e
|
|
# ccdconfig ccd0 128 CCDF_MIRROR /dev/da2e /dev/da3e /dev/da4e /dev/da5e
|
|
# ccdconfig ccd0 128 CCDF_MIRROR /dev/da2e /dev/da4e
|
|
.Ed
|
|
.Pp
|
|
新規 ccd ディスクを作成するとき、一般的には他のことに先駆けて
|
|
.Nm disklabel
|
|
をしたいでしょう。
|
|
最初のラベルを作成した後は、
|
|
これを編集して、追加パーティションを追加可能です。
|
|
ラベル自身は、ccd ディスクの最初の 16 セクタを占めます。
|
|
ファイルシステムを newfs で作成するだけなら、
|
|
newfs がラベル領域を飛ばしますので、心配することはありません。
|
|
しかし、ccd パーティションからまたは ccd パーティション宛へ
|
|
.Nm dd
|
|
するつもりなら、一般的には、
|
|
パーティションを作成してラベルデータに重ならないようにするのが良い考えです。
|
|
例えば、10000 セクタの ccd ディスクがある場合、
|
|
オフセット 16 大きさ 9984 のパーティション 'd' を作成するでしょう。
|
|
.Pp
|
|
.Bd -unfilled -offset
|
|
# disklabel -r -w ccd0c auto
|
|
# disklabel -e ccd0c
|
|
.Ed
|
|
.Pp
|
|
ccd ディスクに対する disklabel 処理は 1 度の機会です。
|
|
他のデバイスと異なり、disklabel 実行時には、
|
|
ccd はパーティション 'c' を指定するよう要求しています。
|
|
マシンをリブートし ccd ディスクを再構成する場合、
|
|
以前作成したディスクラベルが残っているため再作成は不要です。
|
|
ccd パラメータの変更には注意してください。
|
|
インタリーブ、フラグ、ccd ディスクを構成するデバイスリストを変えると、
|
|
通常、ccd ディスク上にあったデータを壊してしまいます。
|
|
こうなってしまった場合、
|
|
ccd ディスクを (再) 初期化する前にラベルを再初期化するのは、
|
|
通常良い考えです。
|
|
.Sh 回復
|
|
ccd ディスク上のエラーは、
|
|
ミラーリングオプションを使用していない限り、通常は回復不可能です。
|
|
しかし、ミラーリングにはそれ自身の危険性があります。
|
|
これは、すべてのセクタの両方のコピーが同一であることを仮定していることです。
|
|
この仮定は、書き込みエラーが発生するか、
|
|
どちらかのミラーを交換するまでは、成り立ちます。
|
|
.Nm ccd
|
|
は、貧者のミラーリング実装を使用しています。
|
|
ディスクエラーが発生し始めたら、
|
|
ccd ディスクのバックアップを取って、
|
|
壊れたハードウェアを交換して、
|
|
ccd ディスクを再作成可能である限りは、この実装は十分うまく働きます。
|
|
これ以上を望むなら、外部ハードウェア RAID SCSI ボックスや、
|
|
.Nm dpt
|
|
コントローラ等の RAID コントローラや、
|
|
.Nm vinum
|
|
等のソフトウェア RAID システムを検討すべきです。
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width /etc/ccd.conf -compact
|
|
.It Pa /etc/ccd.conf
|
|
デフォルトの ccd 設定ファイル
|
|
.El
|
|
.Sh 関連項目
|
|
.Xr ccd 4 ,
|
|
.Xr rc 8 ,
|
|
.Xr vinum 8
|
|
.Sh 歴史
|
|
.Nm
|
|
コマンドは
|
|
.Nx 1.0a
|
|
から登場しました。
|