-- FreeBSD 日本語インストーラ作成ツール -- FreeBSD 6.1-RELEASE 「日本語インストーラ/インストール FD」 を作成するシェル手続き 修正日 平成18年(2006年)04月29日 (土) 作成 小金丸信幸 E-mail kogane@koganemaru.co.jp 1. はじめに FreeBSD の日本語表示インストーラとしては多言語インストーラがありま す。FreeBSD(98) 用のインストーラも日本語表示でインストールができま すが、この PC-9800 用インストーラを改造して AT 互換機用を作成して みました。AT 互換機用日本語インストーラ用には多言語インストーラの kon2 や font を利用しています。本説明は FreeBSD 6.1-RELEASE に対 応しています。 2. 用意するファイル 1) FreeBSD 6.1-RELEASE のインストール用 CD-ROM かその中の src をコ ピーしたもの。 2) make.ATrelease.tar.gz 従来別ファイルだった patches.tar.gz ファイルは make.ATrelease.tar.gz に含まれています。 3) package ファイル リリース用のドキュメントを作成するために次のパッケージが必要です。 dsssl-docbook-modular-1.79,1 jade-1.2.1_9 links-0.98,1 tidy-20000804_2 dsssl-docbook-modular-1.78_6,1 は次の依存 package が必要です。 xmlcatmgr-2.2 その他、次の package も必要です。 docbook-1.3 次は依存 package です。 docbook-241_2 docbook-3.0_2 docbook-3.1_2 docbook-4.0_2 docbook-4.1_2 docbook-xml-4.2_1 iso8879-1986_2 日本語のドキュメントを作成するには次の package もインストールして ください。 ja-lynx-2.8.4.rel1 次は依存 package です。 zip-2.3_2 unzip-5.52_1 doc の作成のために最新の perl package が必要です。古い perl を入れ たままにしている場合は新しいものに置き換えてください。 perl の package としては perl-5.6.2_2.tbz perl-5.8.8 があります。 3. make.ATrelease.tar.gz の内容 添付している make.ATrelease.tar.gz には次のファイルが含まれています。 MAKE.Clean.sh 作業ファイルを削除します。 MAKE.I386.sh MAKE.boot.flp.AT.sh を呼び出すシェル手続き。 MAKE.boot.flp.AT.sh AT 互換機用の FreeBSD 日本語インストールフロッ ピーディスクイメージファイルを作成するシェル手続き。 MAKE.del.orig.sh *.orig ファイルを削除するシェル手続き。 MAKE.make.patches.sh を行う前などに実行します。 MAKE.doc.sh リリースドキュメントを作成するシェル手続き。 MAKE.dopatch.sh patch を実行するシェル手続き。 MAKE.get.src.sh FreeBSDリリースの src ディレクトリからソースファイル 取り出すシェル手続き。 MAKE.objdir.sh obj ディレクトリを作成するシェル手続き。 README.AT 本ファイル。 RelMakeCheck.sh release/Makefile の制御を展開するシェル手続き。 SETVAR 環境変数の設定。 VNmount.sh md の mount を行います。 VNumount.sh md の umount を行います。 bin/pastime 経過時間計測ツール (perl で作成)。 patches.tar.gz ソースにあてるパッチ。 ソースを展開するディレクトリを /usr/src となるように設定してください。 もし既に /usr/src が存在するなら一時的に名前を変更します。 # mv /usr/src /usr/src.org 現在のディレクトリを /usr/src となるように設定します。 # ln -s `pwd` /usr/src /usr/obj/usr/src ディレクトリが存在する場合も問題となります。 名前を変更しておいてください。詳細は後述。 ソースを展開するディレクトリ下に作業用ディレクトリを作成し、 上記のコマンドコピーします。例: mkdir /usr/src/makerel 一般ユーザでは作成できません。root (スーパーユーザ)で実行してくだ さい。 o 最短の場合 SETVAR 3行を修正 MAKE.get.src.sh MAKE.dopatch.sh MAKE.objdir.sh MAKE.del.orig.sh MAKE.make.patches.sh MAKE.boot.flp.AT.sh を順番に実行するだけで作成できます。 安全のために PATH に . を含めていないならば、./MAKE.get.src.sh のよ うにシェル手続きの前に ./ をつけてください。 4. 必要なディスク容量 リリース用バイナリを作成する場合: ・ソースファイルが展開されるカレントディレクトリは 290M バイト, ・/usr/obj は 15M バイト ・出力ファイルが置かれるディレクトリ(/R) は 85M バイト 合計、390M バイト以上必要です。 /usr ファイルシステムの容量が少ない場合は他のファイルシステムにシン ボリックリンクを張るとよいでしょう。 例: ln -s /otherdisk/obj /usr/obj 出力ファイルが置かれる /R ディレクトリの容量が少ない場合も他のファ イルシステムにシンボリックリンクを張るとよいでしょう。 例: ln -s /otherdisk/R /R 5. ファイルを適当なディレクトリに mount します。 # mount_cd9660 /dev/acd0 /cdrom ディスクにコピーしてあれば、必要ありません。 6. MAKE.get.src.sh の実行 添付している SETVAR の MD= の部分をリリースディレクトリにエディタで 修正してください。6.1-RELEASE ディレクトリがない場合は SRC= の部分も 修正します。 SETVAR ファイルは他のシェル手続きで参照されます。 出力ディレクトリは /R 固定です。 使用者が変更するのは MD=(又は SRC=)、ORIGMAKE= と MAKE_FIXIT= 部分 のみです。ただし、/ (ルート) ファイルシステムに余裕がない場合 sort コマンドが /tmp を使用してファイルシステムフルのエラーになる場合が ります。/tmp に余裕がない場合は TMPDIR= を設定してください。 ----- SETVAR ファイルの1部分 ----- # リリースファイルのマウントディレクトリ MD=/cdrom SRC=$MD/6.1-RELEASE/src # cvsup のソースからリリーズ用バイナリ/インストール FD を作成する場合 # のソースを置くディレクトリ名 #CVSDIR=/usr/src.releng52 CVSDIR= # 出力ディレクトリの指定 (十分大きなファイルシステムを指定してください) #RELEASEDIR=/var/98release # fixit.flp を作成する場合は MAKE_FIXIT=YES とする MAKE_FIXIT= # orig ディレクトリを作成するかどうかのフラグ # patch を作成する場合は ORIGMAKE=ON としてください。 ORIGMAKE=ON # sort が使用するテンポラリディレクトリ export TMPDIR=/var/tmp ----- SETVAR ファイルの1部分 終り ----- 「FreeBSD 日本語インストーラ作成ツール」のコマンド群は通常 /usr/src/makerel 等の(/usr/src の一つ下の)ディレクトリを作成して、 その位置で実行します。 ソースを展開するディレクトリの一つ下のディレクトリ (/usr/src/makerel 等)で MAKE.get.src.sh を実行します。 MAKE.get.src.sh は FreeBSDリリースの src ディレクトリからソースフ ァイル取り出すシェル手続きです。 # MAKE.get.src.sh ソースを取り出したかどうかは done/get.xxx というファイルで識別され ます。ソースファイルを取り出すのが不足した場合は MAKE.get.src.sh の該当部分を修正した後 done/get.xxx を削除した後、もう一度 MAKE.get.src.sh を実行すれば該当する部分のみ再び取り出すことができ ます。 7. パッチの実行 FreeBSD 6.1-RELEASE から変更のある差分のパッチを当てます。 # MAKE.dopatch.sh MAKE.dopatch.sh は patches.tar.gz ファイルを読み込みソースにパッチ を当てます。 ※だだし、新規に FreeBSD 日本語インストーラを作成する場合は patch ファイルはありませんので、 # MAKE.dopatch.sh -s でパッチはスキップします。 8. obj ディレクトリの作成 MAKE.get.src.sh, MAKE.dopatch.sh が正常に終ったなら、 MAKE.objdir.sh を実行します。 # MAKE.objdir.sh を実行します。/usr/obj の下を消してしまった後などに、再び実行する場 合もあります。 カレントディレクトリが /usr/src ではない時、/usr/obj/usr/src が既に 存在する場合、 「/usr/obj/usr/src が存在します. /usr/obj/usr/src を消すか名前を変更 してから実行してください.」 とエラーとなりますので、 cd /usr/obj/usr ; mv src src.old を行って再び MAKE.objdir.sh を実行してください。 9. /etc/make.conf の設定 /etc/make.conf を設定してください。次は FreeBSD(98) を作成する際に 使用しているフィルです。 /etc/make.conf が正しく設定されていないと、インストーラのオブジェクト コードが大きくなり、フロッピーディスクイメージに入り切れなくなります。 次の NO_CPU_CFLAGS, NO_CPU_COPTFLAGS フラグが重要です。 ---- ここから ---- # # $Id: make.conf,v 1.2 2002/10/28 07:00:53 nyan Exp $ # USA_RESIDENT=NO WITHOUT_X11=YES NO_CPU_CFLAGS=true NO_CPU_COPTFLAGS=true ---- ここまで ---- 10. 日本語インストールフロッピーイメージファイルの作成 # MAKE.boot.flp.AT.sh を実行します。 /R/stage/floppies に boot.flp, kern1.flp, kern1.flp, mfsroot1.flp ブートフロッピーイメージファイルが出来上がります。SETVAR ファイル で MAKE_FIXIT=YES の場合は fixit.flp も作成されます。 MAKE.boot.flp.AT.sh の代わりに MAKE.I386.sh を使用すると、画面に表 示されるメッセージが ERRI386.mmdd.xx というファイルに出力されます。 mmdd は月日、xx は 01 から順番にカウントアップされます。 # MAKE.I386.sh または # MAKE.I386.sh & # tail -f ERRI386.mmdd.xx エラーが生じた場合はメッセージの内容を参考にして、解決してください。 再実行する場合は cd /usr/src/release ; make clean を行えばよいでし ょう。 11. その他 本ツールは make buildworld を実行する必要がありませんので、短時間 でインストールフロッピーイメージファイルを作成することができます。 12. 日本語リリースドキュメントの作成 # MAKE.doc.sh を実行します。 /R/stage/release.doc/ja_JP.eucJP/*/article.txt に日本語のドキュメ ント /R/stage/release.doc/en_US.ISO8859-1/*/article.txt に英文のド キュメントが作成されます。 13. 作業ファイルの削除 # MAKE.Clean.sh 使用法: MAKE.Clean.sh [-s] [-o] [-r] [-g] [-a] -s ソースファイルを削除 -o /usr/obj 以下を削除 -r release 出力ファイルを削除 -g orig ソースファイルを削除 -a 上記のファイル全て削除 14. その他のシェル手続き 使用法: VNmount.sh [-r] boot_flp_file_image [/mnt] boot_flp_file_image を /mnt にマウントする。 -r リードオンリーでマウントする VNmount.sh -u [/mnt] VNmount.sh で [/mnt] にマウントしたファイル システムを umount する。 VNumount.sh [/mnt] VNmount.sh で [/mnt] にマウントしたファイル システムを umount する。 ・VNmount.sh md の mount を行います。 /R/stage/mfsroot の下に作成される mfsroot.gz (gunzip で拡張してか ら VNmount.sh を実行してください)ファイルや kern.flp, mfsroot.flp の中を見る時に使用します。umount は下記の VNumount.sh を使用します。 実行すると /mnt にマウントされます。指定すれば他のディレクトリにも マウントできます。/mnt が他のマウントに使われていないか確認した後 実行してください。-r オプションをつけるとリードオンリーでマウント されますので、イメージファイルの内容や作成日付が変更されません。 使用例: # VNmount.sh mfsroot.flp /mnt # df -i または # VNmount.sh -r kern.flp # ls -l /mnt ・VNumount.sh md の umount を行います。 # VNumount.sh または # VNumount.sh /mnt マウントした時点の md デバイス名を保存するため /tmp/MDDEV という作 業ファイルを使用します。 15. CD-ROM 版の日本語インストーラの作り方 1) まず、オリジナルの CD-ROM (iso) イメージファイルを入手します。 6.1-RELEASE-i386-disc1.iso 2) 入手したなら、その内容を UFS (通常の) ファイルにコピーします。 3) そのファイル中の boot/mfsroot.gz を上記の日本語インストーラ用に 作成された、mfsroot.gz と置き換えます。 mfsroot.gz は /R/stage/mfsroot/ に作成されます。 4) その UFS (通常の) ファイルから mkisofs を使用して CD-ROM イメー ジを作成します。 5) そのイメージを CD-R 等に書き込めば、CD-ROM 版の日本語インストー ラが作成できます。 o CD-ROM (iso) ファイルをマウントするには、 /cdrom ディレクトがないなら、mkdir /cdrom を行った後に、 MDDEVICE=`mdconfig -a -t vnode -f 6.1-RELEASE-i386-disc1.iso` mount -t cd9660 /dev/${MDDEVICE} /cdrom を行い、アンマウントするには、 umount /cdrom mdconfig -d -u /dev/${MDDEVICE} とします。 o CD-ROM (iso) イメージを作成するには、 ./6.1-RELEASE に UFS ファイルがあるなら、次のように行います。 LABEL=FreeBSD_jpn # 16 文字以内 mkisofs -b boot/cdboot -no-emul-boot -r -J -V $LABEL \ -o 6.1-RELEASE-i386-jp-disc1.iso ./6.1-RELEASE o CD-R 等に書き込む方法は、 誰か教えてくさい。:-) 私は Windows の書き込みソフトを使用しています。 16. 改版履歴 1) FreeBSD 5.1-RELEASE 「日本語インストーラ/kern.flp, mfsroot.flp」 を作成するシェル手続き "FreeBSD(98) 5.1R の「リリース用バイナリ/kern.flp, mfsroot.flp」を作 成するシェル手続き" を元に作成。 作成日 平成15年(2003年)06月03日 (火) 2) FreeBSD 5.2-RELEASE 「日本語インストーラ/kern.flp, mfsroot.flp」 を作成するシェル手続き 修正日 平成15年(2003年)12月21日 (日) 3) patches.tar.gz を make.ATrelease.tar.gz に含めた。 修正日 平成16年(2004年)01月16日 (金) 4) FreeBSD 5.2.1-RELEASE 「日本語インストーラ/kern.flp, mfsroot.flp」 を作成するシェル手続き 修正日 平成16年(2004年)02月09日 (月) 5) FreeBSD 5.3-RELEASE 「日本語インストーラ/インストール FD」 を作成するシェル手続き 修正日 平成16年(2004年)09月14日 (火) 6) FreeBSD 5.4-RELEASE 「日本語インストーラ/インストール FD」 を作成するシェル手続き 修正日 平成17年(2005年)04月13日 (水) 7) FreeBSD 6.0-RELEASE 「日本語インストーラ/インストール FD」 を作成するシェル手続き 修正日 平成17年(2005年)12月28日 (水) 8) FreeBSD 6.1-RELEASE 「日本語インストーラ/インストール FD」 を作成するシェル手続き 「CD-ROM 版の日本語インストーラの作り方」を追加。 修正日 平成18年(2006年)04月29日 (土) 以上.