summaryrefslogtreecommitdiffstats
path: root/system-boot/manpages/ja/live-boot.ja.7
blob: ec0a5196bf3ea3da2eea179c286ffa4beab8e5a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LIVE\-BOOT 7 2015\-09\-22 5.0~a5\-1 "Live システムプロジェクト"

.SH 名前
\fBlive\-boot\fP \- システム起動構成要素

.SH 説明
\fBlive\-boot\fP はブートプロセス中 (早期ユーザ空間) に Live システムを設定する構成要素を収録しています。
.PP
.\" FIXME
live\-boot は initramfs\-tools 用のフックで、例えば \fIlive\-helper\fP(7) で作成した Live
システムをブートできる initramfs を生成するのに利用します。これには Live システムの ISO やネットワーク経由でブートするための
tar アーカイブ、USB メモリ用のイメージ等があります。
.PP
.\" FIXME
これはブート時に root ファイルシステム (squashfs 等圧縮ファイルシステムのイメージであることが多い)
が置かれている「/live」ディレクトリを収録する (読み取り専用の) メディアを検索します。見つけた場合は aufs
を使って書き込み可能な環境を作成してシステムを起動します。

.SH 設定
\fBlive\-boot\fP はブートパラメータまたは設定ファイル経由で設定できます。
.PP
Live イメージで利用されるデフォルトの live\-boot パラメータを設定する場合は \fIlb_config\fP(1) マニュアルページの
\-\-bootappend\-live オプションを見てください。

.SS カーネルパラメータ
\fBlive\-boot\fP はカーネルパラメータとして「boot=live」が利用された場合にのみ有効になります。
.PP
さらに、挙動に影響するブートパラメータが他にもいくつかあります。下記を見てください。

.SS 設定ファイル
\fBlive\-boot\fP は設定ファイルを利用して設定 (但し有効化しない) できます。この設定ファイルは root ファイルシステム自体
(/etc/live/boot.conf、 /etc/live/boot/*)、または Live メディア (live/boot.conf、
live/boot/*) に配置できます。

.SH オプション
.\" FIXME
\fBlive\-boot\fP では以下のパラメータが現在有効です。
.IP \fBaccess\fP=\fIアクセス\fP 4
物理的または視覚的に障害のあるユーザ向けのアクセシビリティレベルをセットします。\fIアクセス\fPに入るのは v1、v2、v3、m1、m2
のどれかでないといけません。v1=軽度の視覚障害、 v2=中程度の視覚障害、 v3=盲目、 m1=運動神経に些細な難あり、
m2=運動神経に中程度の難あり。
.IP \fBconsole\fP=\fITTY,速度\fP 4
「live\-getty」オプションで利用するデフォルトのコンソールをセットします。例: 「console=ttyS0,115200」
.IP \fBdebug\fP 4
initramfs ブートプロセスの出力をもっと冗長にします。
.br
debug=1 としてください
.br
debug に値をセットしないとメッセージは表示されないかもしれません。
.IP \fBfetch\fP=\fIURL\fP 4
.IP \fBhttpfs\fP=\fIURL\fP 4
指定した URL から squashfs イメージをダウンロードしてネットワーク経由でブートする別のやり方で、この取得方法ではイメージを RAM
にコピーし、httpfs を使う方法では FUSE と httpfs2 を使ってイメージを適切な位置にマウントします。RAM
へのコピーにはさらに多くのメモリが必要で、大きなイメージでは多少時間がかかるかもしれません。しかしその後はネットワークを必要としないため正常に動作する可能性が高くなり、それ以上サーバとやりとりする必要がないためブート後はそのシステムは高速に動作します。
.br
busybox の現在の wget 及び DNS 解決の制限のために URL にはホスト名を使えず、IPアドレスにしか対応していません。
.br
機能しない: http://example.com/path/to/your_filesystem.squashfs
.br
機能する: http://1.2.3.4/path/to/your_filesystem.squashfs
.br
また、そのため httpd の名前ベースのバーチャルホストからイメージを取得することは、httpd
のそのホストの設定で同一のIPアドレスを共有している場合は現在不可能であることにも注意してください。
.br
また、squashfs イメージの適切な位置にある Live ISO イメージも利用できます。
.IP \fBiscsi\fP=\fIサーバのIPアドレス[,サーバのポート];対象の名前\fP 4
LUN (Logical Unit Number、論理ユニット番号) が iso またはディスクの Live イメージを指している iSCSI
ターゲットからのブートで、指定されたターゲットは LUN のうち Live メディアらしきものから検索されます。\fBiscsitarget\fP
ソフトウェアを使って iSCSI ターゲットを判定している場合の ietd.conf はこのようになります:
.br
# iscsi= パラメータで指定したターゲットの名前
.br
Target <ターゲットの名前>
  Lun 0 Path=<live\-image.iso のパス>,Type=fileio,IOMode=ro
  # 複数のマシンのブートに使いたい場合は
  # Wthreads や MaxConnections のような一部の
  # パラメータを調整してみるのもいいかもしれません。
.IP \fBfindiso\fP=\fI/イメージ/への/パス\fP 4
\&.squashfs ファイルを通常検索する位置にある全ディスクから、指定した ISO ファイルを検索します (そのため
fromiso=... で指定するデバイス名を知っている必要はありません)。
.IP \fBfromiso\fP=\fI/イメージ/への/パス\fP 4
Live メディア上で利用可能な ISO イメージ内からファイルシステムを利用できるようにします。
.IP \fBignore_uuid\fP 4
検出したメディアに合う initramfs に埋め込まれた UUID の確認を一切行いません。initramfs のビルド時に
LIVE_GENERATE_UUID=1 を設定して UUID を生成するように live\-boot に指示しているかもしれません。
.IP \fBverify\-checksums\fP 4
指定するとブート中に Live メディアの MD5 サムを計算し、その Live メディアのルートディレクトリにある md5sum.txt
中の値と比較します。
.IP "\fBip\fP=[\fIデバイス\fP]:[\fIクライアントのIPアドレス\fP]:[\fIネットマスク\fP]:[\fIゲートウェイのIPアドレス\fP]:[\fIネームサーバ\fP] [,[\fIデバイス\fP]:[\fIクライアントのIPアドレス\fP]:[\fIネットマスク\fP]:[\fIゲートウェイのIPアドレス\fP]:[\fIネームサーバ\fP]]" 4
ブート時に設定するインターフェイスの名前とオプションを指定できます。dhcp (デフォルト)
を使いたい場合は指定しないでください。将来のリリースでは公式のカーネルブートパラメータの仕様に倣って変更される (例えば
ip=10.0.0.1::10.0.0.254:255.255.255.0::eth0,:::::eth1:dhcp) かもしれません。
.IP \fBip\fP=[\fI読み込み元メディア\fP] 4
この変数をセットすると dhcp 及び固定のネットワーク設定は単に飛ばされ、システムはメディアで事前に設定されている (設定されていないといけません)
/etc/network/interfaces を代わりに利用します。
.IP {\fBlive\-media\fP|\fBbootfrom\fP}=\fIデバイス\fP 4
この2つは等価で、どちらかを指定すると live\-boot
はまずこのデバイスについて読み取り専用のルートファイルシステムが存在するであろう「/live」ディレクトリを検索します。それで使えそうなものが見つからない場合は通常のブロックデバイスの走査が行われます。
.br
実際のデバイス名を指定する代わりに「removable」というキーワードを使って、検索対象とする Live
メディアを脱着可能なものだけに限定することができます。メディアを USB
大容量記憶装置だけにさらに限定したい場合は「removable\-usb」というキーワードを使えることに注目してください。
.IP {\fBlive\-media\-encryption\fP|\fBencryption\fP}=\fI暗号化の種類\fP 4
live\-boot はパスフレーズを質問することで暗号化する種類の rootfs をマウントできます。凝った Live システムをビルドするのに有用です
:\-)。これまでのところサポートしているのは loop\-aes 暗号化を指示する「aes」です。
.IP \fBlive\-media\-offset\fP=\fIバイト数\fP 4
このようにして、上記で指定したまたは自動検出したデバイスの、指定バイト数だけずれた位置からイメージが開始することを live\-boot
に指示できます。他の ISO やイメージの中にある Live システムの ISO
やイメージを見えないようにして「クリーン」なイメージを作成するのに有用かもしれません。
.IP \fBlive\-media\-path\fP=\fIパス\fP 4
メディア上の Live
ファイルシステムへのパスをセットします。このデフォルト値は「/live」で、合わせてメディアを独自化していない限りこの値を変更すべきではありません。
.IP \fBlive\-media\-timeout\fP=\fI秒数\fP 4
「live\-media=」により指定したデバイスがその処理をあきらめるまでの制限時間を秒数で指示します。
.IP \fBmodule\fP=\fI名前\fP 4
デフォルトとなっているオプションのファイル「filesystem.module」(以下参照)
を使う代わりに別のファイルを拡張子「.module」を外して指定することができます。これは Live
メディアの「/live」ディレクトリに配置すべきです。
.IP \fBnetboot\fP[=nfs|cifs] 4
ネットワークマウントを行うことを live\-boot に指示します。(オプションの「nfsopts=」で)
パラメータ「nfsroot=」によりルートファイルシステムが置かれている場所を指定します。引数を付けない場合はまず cifs
を試し、それが失敗した場合は nfs を試します。
.IP \fBnfsopts\fP= 4
これを使って nfs オプションを指定できます。
.IP \fBnofastboot\fP 4
このパラメータは /etc/fstab
にあるファイルシステムのチェックがデフォルトで無効化されているのを無効にします。ハードディスクに静的ファイルシステムがあり、ブート時にそれをチェックさせたい場合はこのパラメータを使ってください。使わない場合はファイルシステムのチェックは飛ばされます。
.IP \fBnopersistence\fP 4
「保持 (persistence)」機能を無効化します。ブートローダ (syslinux のようなもの)
が保持機能を有効にしてインストールされている場合に有用です。
.IP \fBnoeject\fP 4
Live メディアを取り出すかどうか確認しません。
.IP \fBramdisk\-size\fP 4
このパラメータにより独自の RAM ディスクサイズ (tmpfs マウント時の「\-o サイズ」オプション) をセットできます。デフォルトでは RAM
ディスクサイズはセットされていないため、マウント時のデフォルト値が適用されます (現在は利用可能な RAM の 50%)。toram
を指定してブートした場合、このオプションは現在のところ効果がないことに注意してください
.IP \fBswap=true\fP 4
このパラメータはローカルのスワップパーティションの利用を有効にします。
.IP \fBpersistence\fP 4
live\-boot は保持用メディアのデバイスを調査します。このデバイスにはパーティション (GPT (GUID Partition
Table、GUIDパーティションテーブル) の名前を正しく指定) やファイルシステム (ラベルの名前を正しく指定)、イメージファイル
(ファイル名を正しく指定) を使えます。保存先は「persistence」(\fIpersistence.conf\fP(5) 参照)
という名前/ラベルになります。保存先のイメージファイルは「persistence」という名前になります。
.IP "\fBpersistence\-encryption\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
このオプションは保持用メディアのデバイス調査時に利用を許可する暗号化の種類を決定します。「none」が一覧にある場合は暗号化されていないメディアを許可します。「luks」が一覧にある場合は
LUKS
により暗号化されているメディアを許可します。暗号化されているメディアがデバイスにある場合はそのメディアの調査時にパスフレーズをユーザに質問します。デフォルト値は「none」です。
.IP \fBpersistence\-media\fP={\fIremovable\fP|\fIremovable\-usb\fP} 4
「removable」というキーワードを指定すると、live\-boot は保持用パーティションを脱着可能なメディアからのみ検索します。メディアを USB
大容量記憶装置だけにさらに限定したい場合は「removable\-usb」というキーワードを使えることに注目してください。
.IP "\fBpersistence\-method\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
このオプションは許可する保持用メディアの種類を決定します。「overlay」が一覧にある場合はオーバーレイと見なします
(つまり「live\-rw」と「home\-rw」)。デフォルト値は「overlay」です。
.IP \fBpersistence\-path\fP=\fIパス\fP 4
live\-boot
は保持用ファイルをパーティションのルートディレクトリから検索します。このパラメータを使ってパスを設定すると同一のパーティションの複数のディレクトリを保持用ファイルの保管先にできます。
.IP \fBpersistence\-read\-only\fP 4
ファイルシステムの変更は保持用メディアには残されません。特にオーバーレイとネットワーク経由のブート用の NFS
マウントは読み取り専用でマウントされます。
.IP "\fBpersistence\-storage\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
このオプションは保持用メディアの調査時に対象とする保持用記憶装置の種類を決定します。「filesystem」が一覧にある場合はラベルが該当するファイルシステムを利用します。「file」が一覧にある場合は全ファイルシステムについてファイル名が該当するアーカイブやイメージファイルを調査します。デフォルト値は「file,filesystem」です。
.IP \fBpersistence\-label\fP=\fIラベル\fP 4
live\-boot
は保持用記憶装置の検索時に「persistence」の代わりにここで指定した「ラベル」を使います。「ラベル」はファイル名やパーティションのラベル、GPT
の名前として有効な任意のものを使えます。
.IP \fBnoeject\fP 4
このオプションを使うと live\-boot はメディアを取り出さず、ブート用メディアを削除するかユーザに質問することもなくリブートします。
.IP \fBshowmounts\fP 4
このパラメータを使うと live\-boot は「/」で「/lib/live」上の (ほとんどの場合圧縮されている) ro
ファイルシステムを提示します。これはインストール時にバイナリのパスを記憶する「mono」のようなアプリケーションで問題を起こす可能性があるためデフォルトでは有効にされていません。
.IP \fBsilent\fP 4
通常の quiet パラメータを付けてブートすると live\-boot
が出すほとんどのメッセージを非表示にします。「silent」を付けると全て非表示にします。
.IP \fBtodisk\fP=\fIデバイス\fP 4
このパラメータを追加すると、live\-boot
はルートファイルシステムをマウントする前に読み取り専用メディア全体を指定したデバイスにコピーしようとします。これには恐らく多くの RAM
が必要となります。以後のブートではこの段階を飛ばして、今回そのデバイスで使ったのと同一の「live\-media=デバイス」ブートパラメータを単に指定するようにしてください。
.IP \fBtoram\fP 4
このパラメータを追加すると、live\-boot はルートファイルシステムをマウントする前に読み取り専用メディア全体をそのコンピュータの RAM
にコピーしようとします。その読み取り専用メディアで利用している容量により、これには多くの RAM が必要となるかもしれません。
.IP \fBunion\fP=overlay|aufs 4
.\" FIXME
デフォルトで live\-boot は overlay を利用します。このパラメータにより aufs に切り替えることができます。

.\" FIXME
.SH "ファイル (古い情報)"
.IP \fB/etc/live.conf\fP 4
一部の変数はこの (Live システム中の) 設定ファイルにより設定できます。
.IP \fBlive/filesystem.module\fP 4
.\" FIXME
この (Live メディア内の)
オプションのファイルは「/live」ディレクトリ中のディスクイメージに対応するファイル名を空白文字または復帰文字で区切った一覧を収録します。このファイルが存在する場合はその中の一覧にあるイメージだけがルート
aufs に統合され、その一覧の順に読み込まれます。このファイルの最初の項目が /overlay 直下で aufs
の「最下位の」マウントポイント、この一覧の最後のファイルが /overlay 直下で aufs
の「最上位の」マウントポイントとなります。このファイルがない場合は「/live」ディレクトリにあるイメージを英数字順に読み込みます。

.SH ファイル
.IP \fB/etc/live/boot.conf\fP 4
.IP \fB/etc/live/boot/*\fP 4
.IP \fBlive/boot.conf\fP 4
.IP \fBlive/boot/*\fP 4
.IP \fBpersistence.conf\fP 4

.SH 関連項目
\fIpersistence.conf\fP(5)
.PP
\fIlive\-build\fP(7)
.PP
\fIlive\-config\fP(7)
.PP
\fIlive\-tools\fP(7)

.SH ホームページ
live\-boot 及び Live
システムプロジェクトについてのさらなる情報は、<\fIhttp://live\-systems.org/\fP> のホームページや
<\fIhttp://live\-systems.org/manual/\fP> のマニュアルにあります。

.SH バグ
バグは <\fIhttp://bugs.debian.org/\fP> にあるバグ追跡システムに live\-boot
パッケージのバグ報告として提出するか、<\fIdebian\-live@lists.debian.org\fP> にある Live
システムのメーリングリスト宛てにメールを書くことにより報告できます。

.SH 作者
live\-boot は Daniel Baumann さん <\fImail@daniel\-baumann.ch\fP> により書かれました。