232 lines
6.9 KiB
Groff
232 lines
6.9 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.
|
|
.\" 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.29 2004/07/03 00:13:43 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 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 u
|
|
ccd の設定を解除します。
|
|
.It Fl U
|
|
ccd 設定ファイルに書かれている全ての ccd デバイスの設定を解除します。
|
|
.It Fl v
|
|
.Nm
|
|
は、より冗長な出力を行います。
|
|
.El
|
|
.Pp
|
|
ccd は、コマンド行ないし ccd 設定ファイルにて、ccd の名前、
|
|
インタリーブファクタ、ccd 設定フラグ、ひとつ以上のデバイスのリストの情報により
|
|
定義されます。
|
|
フラグは、10 進数、16 進数、コンマで区切られた名前のリスト、
|
|
.Dq none
|
|
のいずれかで表すことができます。
|
|
フラグには以下のものがあります。
|
|
.Bd -unfilled -offset indent
|
|
CCDF_UNIFORM 0x02 ディスク間で均一なインタリーブを使います
|
|
CCDF_MIRROR 0x04 データのミラーリングをサポートします
|
|
.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/da2s1 /dev/da3s1
|
|
.Ed
|
|
.Pp
|
|
構成要素のデバイスは、パーティションタイプが
|
|
.Li FS_BSDFFS
|
|
.Pf ( Xr disklabel 8
|
|
では
|
|
.Dq 4.2BSD
|
|
と表示されます) であることが必要です。
|
|
.Sh 使用例
|
|
.Nm
|
|
の例をいくつか以下に示します。
|
|
.Nm
|
|
に渡される引数は、
|
|
.Pa /etc/ccd.conf
|
|
設定ファイルに書けるものと正に同じものです。
|
|
1 番目の例は、
|
|
4 ディスクのストライプを 4 SCSI ディスクパーティションから作成します。
|
|
ストライプは 64 セクタインタリーブを使用します。
|
|
2 番目の例は、
|
|
複雑なストライプ/ミラーの組み合わせの例です。
|
|
これは、
|
|
da4 と da5 の 2 ディスクストライプを、
|
|
da6 と da7 の 2 ディスクストライプへミラーすると、解釈します。
|
|
最後の例は、単純なミラーです。
|
|
/dev/da8 の 2 番目のスライス は /dev/da9 の 3 番目のスライスへミラーされ、
|
|
ccd0 に割り当てられます。
|
|
.Pp
|
|
.Bd -unfilled -offset
|
|
# ccdconfig ccd0 64 none /dev/da0s1 /dev/da1s1 /dev/da2s1 /dev/da3s1
|
|
# ccdconfig ccd0 128 CCDF_MIRROR /dev/da4 /dev/da5 /dev/da6 /dev/da7
|
|
# ccdconfig ccd0 128 CCDF_MIRROR /dev/da8s2 /dev/da9s3
|
|
.Ed
|
|
.Pp
|
|
新規 ccd ディスクを作成するとき、一般的には他のことに先駆けて
|
|
.Xr fdisk 8
|
|
と
|
|
.Xr disklabel 8
|
|
をしたいでしょう。
|
|
最初のラベルを作成した後は、
|
|
これを編集して、追加パーティションを追加可能です。
|
|
ラベル自身は、ccd ディスクの最初の 16 セクタを占めます。
|
|
ファイルシステムを newfs で作成するだけなら、
|
|
newfs がラベル領域を飛ばしますので、心配することはありません。
|
|
しかし、ccd パーティションからまたは ccd パーティション宛へ
|
|
.Xr dd 1
|
|
するつもりなら、一般的には、
|
|
パーティションを作成してラベルデータに重ならないようにするのが良い考えです。
|
|
例えば、10000 セクタの ccd ディスクがある場合、
|
|
オフセット 16 大きさ 9984 のパーティション 'd' を作成するでしょう。
|
|
.Pp
|
|
.Bd -unfilled -offset
|
|
# disklabel ccd0 > /tmp/disklabel.ccd0
|
|
# disklabel -Rr ccd0 /tmp/disklabel.ccd0
|
|
# disklabel -e ccd0
|
|
.Ed
|
|
.Pp
|
|
ccd ディスクに対する disklabel 処理は 1 度の機会です。
|
|
マシンをリブートし ccd ディスクを再構成する場合、
|
|
以前作成したディスクラベルが残っているため再作成は不要です。
|
|
ccd パラメータの変更には注意してください。
|
|
インタリーブ、フラグ、ccd ディスクを構成するデバイスリストを変えると、
|
|
通常、ccd ディスク上にあったデータを壊してしまいます。
|
|
こうなってしまった場合、
|
|
ccd ディスクを (再) 初期化する前にラベルを再初期化するのは、
|
|
通常良い考えです。
|
|
.Sh 回復
|
|
ccd ディスク上のエラーは、
|
|
ミラーリングオプションを使用していない限り、通常は回復不可能です。
|
|
しかし、ミラーリングにはそれ自身の危険性があります。
|
|
これは、すべてのセクタの両方のコピーが同一であることを仮定していることです。
|
|
この仮定は、書き込みエラーが発生するか、
|
|
どちらかのミラーを交換するまでは、成り立ちます。
|
|
これは、貧者のミラーリング実装なのです。
|
|
ディスクエラーが発生し始めたら、
|
|
ccd ディスクのバックアップを取って、
|
|
壊れたハードウェアを交換して、
|
|
ccd ディスクを再作成可能である限りは、この実装は十分うまく働きます。
|
|
これ以上を望むなら、外部ハードウェア RAID SCSI ボックスや、
|
|
RAID コントローラ (GENERIC を参照して下さい) や、
|
|
RAIDframe
|
|
.Xr raid 4
|
|
や
|
|
.Xr vinum 8
|
|
等のソフトウェア RAID システムを検討すべきです。
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width /etc/ccd.conf -compact
|
|
.It Pa /etc/ccd.conf
|
|
デフォルトの ccd 設定ファイル
|
|
.El
|
|
.Sh 関連項目
|
|
.Xr dd 1 ,
|
|
.Xr ccd 4 ,
|
|
.Xr raid 4 ,
|
|
.Xr disklabel 8 ,
|
|
.Xr fdisk 8 ,
|
|
.Xr rc 8 ,
|
|
.Xr vinum 8
|
|
.Sh バグ
|
|
.Xr ccd 4
|
|
が最初に返すディスクラベルは、3 個のパーティションしか指定しません。
|
|
.Dq Nm disklabel Fl e
|
|
を使用し、
|
|
.Bx
|
|
が期待するように、
|
|
パーティション数を 8 に変更する必要があります。
|
|
.Sh 歴史
|
|
.Nm
|
|
ユーティリティは
|
|
.Nx 1.0a
|
|
から登場しました。
|