The Coda HOWTO: Building Coda

(Illustration by Gaich Muramatsu)

Home	Downloads (インフォサイエンス)	Bugs	Documentation
News	Mailing lists	FAQ	Research

戻るコンテンツ

6. Coda の構築

ファイルシステムとして、Coda は構築にメジャーなコンポーネントがいくつか必要です:

クライアントのカーネルコード
クライアントのキャッシュマネージャである Venus
ファイルサーバ
クライアントとサーバ管理者のためのユーティリティ

6.1 Linux での構築

カーネル・モジュールの構築

カーネル・モジュールを構築するのが理にかなった、融通がきくやり方です。構築時に走っていないカーネルのためのモジュールを構築することもできます。

まず、ftp://ftp.coda.cs.cmu.edu/pub/coda/src/ から linux-coda-?.?.?.tgz アーカイブを入手します。ターゲットになるシステムの適当な場所でこれを展開します。

カーネル・ツリーの用意

モジュールヘッダ情報を与えるのに便利な、カーネルツリーが必要です。用意:


make oldconfig
make dep

In the top directory of linux-coda build the coda.o module:


make config  --- answer the questions
make coda.o
su
make install
depmod -a

注

走っているカーネルに対して構築するなら、Linux リリースのソース・ツリーを持っている必要があります。そうしないとヘッダは見つかりません。しかし、ソースツリーは modversions.h 等を必要としません。
今後、2.0 の coda のメインテナンスはしません。2.1 の coda が望ましいですが、まだ完全ではありません。

ユーザレベルのコードの構築

coda は glibc システムを使って構築するのが最も簡単です。今後、libc 変数のメインテナンスはしません。Coda のバイナリにリンクするいくつかのライブラリが必要になり、lib???-devel パッケージからのファイルを含みます。Readline と termcap は最も大事なものです。

構築するには:

Unpack coda-?.?.?.tgz.
./configure --prefix=/usr
make (make coda for versions 4.6 and older)
make client-install
make server-install

6.2 FreeBSD での構築

カーネル全体の構築

Coda カーネルファイルは FreeBSD 最新カーネルソースにあります。Coda が利用できるカーネルを入手するのに必要なことは、Coda を含んだ設定を構築することです。Coda を可能にする行は GENERIC にはありません。コピーする必要のある LINT ファイルに、いくつかの Coda 行があります。 i386/conf ディレクトリで:


grep -i coda LINT

一般には:


# Coda stuff:
options         CODA                    #CODA filesystem.
pseudo-device   vcoda   4               #coda minicache <-> venus comm.

GENERIC カーネル設定か標準の個人設定にこれらの行を追加してください(grep で生じたものは何でも)。DDB と BPF を on にします。

新しい設定ファイル CODA を呼ぶものとします。入力は:


config CODA

それから構築するディレクトリに cd して、make します:


cd ../../compile/CODA
make

最後に、root でカーネルをインストールします:


make install

LKM を構築

もう一つの方法として、Coda のために lkm を構築して、カーネルにそれを入れます。やることは:


cd /usr/lkm/coda

入力:


make
make install

coda_mod.o を構築して、/lkm にコピーします。入力によりロードします:


modload -v -e coda_mod -o /var/run/lkm.coda /lkm/coda_mod.o

lkm を使う時には:

/kernel.old や /kernel.<something>ではなく、/kernel をブートしなければならない
デバッグに利用できるシンボルはない

Coda の構築: パッケージの方法


cd /usr/ports/net/coda_client
make install
cd /usr/ports/net/coda_server
make install

注: クライアントとサーバはそれぞれ作業領域に 85 Mb，インストールに 15 Mb を必要とします。デバッグは -g でコンパイルします。

Coda の構築: 別の方法

まず、coda を構築するための外部パッケージがいくつか必要です: gnu make, gdbm, readline, and perl.

少なくとも、ftp://ftp.coda.cs.cmu.edu/pub/coda/src から最新のソースを持ってくる必要があります。この例では、リリース 4.4.6 を入手するものと仮定します。注: ftp サイトにはベータとアルファ、実験的で不安定なソースリリースがあります。

ソースを構築する領域に展開します(ここでは /usr/coda だとします)。


tar zxfv coda-4.6.6.tgz -C /usr/coda

/usr/coda に Cd して


mkdir obj

バイナリを構築する場所です。obj に cd して入力します:


../coda-4.6.6/configure

/usr/coda/coda-4.6.6 にインストールされたソースを設定してシャドウにするために、gnu の設定システムを使います。

最後に、gnu make を gmake にしたとして、:


gmake coda

クライアント・パッケージのインストールは:


gmake client-install

サーバ・パッケージのインストールは:


gmake server-install

6.3 NetBSD での構築

カーネル全体の構築

Coda のカーネルファイルは、NetBSD 最新カーネルソースにあります。Coda を利用できるカーネルを入手するために必要なことは、Coda を含んだ設定を構築することです。Coda を可能にする行は、あなたの設定にはないかもしれません。GENERIC にはあるはずですが、off になっているかもしれません。あなたの設定ファイルにそれをコピーすることができます。こんな感じです。


file-system     CODA                     # Coda File System
pseudo-device   vcoda            4       # coda minicache <-> venus comm.

しかし、GENERIC にあるものは何でも最新になります。

新しい設定ファイルを CODA とします。入力は:


config CODA

それから構築するディレクトリに cd して、make します。


cd ../compile/CODA
make

netbsd を root にコピーします。

LKM を構築する

もう一つの方法として、Coda のために lkm を構築してカーネルにそれを入れます。やることは:


cd /usr/sys/lkm/vfs/coda

そして入力:


make
make install

coda.o を構築して、/usr/lkm にコピーします。ロードするには:


modload -v -e coda_lkmentry -o /var/run/lkm.coda /usr/lkm/coda.o

lkm を使う際の注意:

/netbsd.old や /netbsd.<something> ではなく、/netbsd をブートしなければなりません。
デバッグを利用できるシンボルはありません。

Coda の構築: パッケージの方法


cd /usr/pkgsrc/net/coda_client
make install
cd /usr/pkgsrc/net/coda_server
make install

注: クライアントとサーバはそれぞれ作業領域として 85Mb、インストールに 15Mb を必要とします。デバッグのコンパイルは -g です。

Coda の構築: 別の方法

まず、coda を構築するための外部パッケージがいくつか必要です: gnu make, gdbm, readline, and perl

ソースを構築する領域に展開します(ここでは /usr/coda だとします)。


tar zxfv coda-4.6.6.tgz -C /usr/coda

/usr/coda に Cd して


mkdir obj

バイナリを構築します。obj に cd して:


../coda-4.6.6/configure

/usr/coda/coda-4.6.6 にインストールされたソースを設定して、シャドウにする gnu 設定システムを使います。

最後に、gnu make を gmake にして:


gmake coda

クライアント・パッケージをインストールするには:


gmake client-install

サーバ・パッケージをインストールするには:


gmake server-install

6.4 Windows 95 でのクライアントの構築

警告: Windows 95 で Coda を動かすソフトウェアは、初期のプレ・アルファのスナップショットです。Coda はカーネルレベルのコードで走り、システム・ダメージの原因となるかもしれないプロセスに特権を与えます。Coda を動かす前に全てのデータのバックアップを取ってください。

Windows 用の Coda は Michael Callahan mjc@stelias.com によって可能になりました。 Michael はメモリ・マップと TCP/IP ソケットのサポートに関して DOS のプロテクト・モードの環境を拡張しました(これは、DJGPP スタートライブラリでの低級サポートだけでなく、Windows カーネルサポートも伴っています)。彼はまた、Coda に向けたカーネル・モジュールも書きました。Michael の仕事は、Coda のチームによってデバッグされ、拡張されて。パッケージになりました。

簡単な解説

なぜ DOS のアプリケーションなのか？ Win32 のアプリケーションである、Venus というユーザレベルの Coda のクライアント・キャッシュ・マネージャを実装するのが簡単なように見えます。悲しいことに Windows 95 では、(良く知られた)以下の問題があります。ユーザのアプリケーションが Win32 のファイル・システム・コールを呼ぶと、アプリケーションは win16 システムの dll でミューテックスを要求することがあるからです。要求はカーネルに届いて、Venus につながります。ミューテックスを取れないせいで、Venus はその時リクエストをサービスできません。デッドロックになります(参照: Schulman's, Unauthorized Windows 95, IDG)。

カーネルレベルのキャッシュ・マネージャとして Venus の全てを実装すると、災いを引き起こすようです。代わりに、DOS プロテクトモードのインターフェースを持つアプリケーションとして、バーチャルの DOS マシンでキャッシュマネージャを走らせます。そのアプリケーションが、ミューテックスを得るような Windows のダイナミック・ライブラリを共有しないので、この問題を回避できます。このやり方と取った代償は高くなります。DPMI のようなアプリケーションのために自由に使えるソケットのサポートがなく、メモリー・マッピングのサポートもありません。これは Michaels VXD によるもので、標準的なライブラリ・コールは現在 DJGPP ツールチェーンに組み込まれています。

ユーザレベルのコードの構築

必要なのは:

100M の空きがある Linux マシン
利用できるツール・チェーンをダウンロードします: ftp://ftp.coda.cs.cmu.edu/pub/tools/{95,win32}
必要な rpm:
- djgpp package.
- djgpp-win95ext.
- cygwin.
- libgdbm-nt.
- DPMI アプリケーションのためのリモートデバッグ環境である gdb-djgpp
Windows のボックスで Linux のバイナリを共有するためには、Samba のセットアップを強く勧めます。

Coda のソースの最新 tar アーカイブ入手します。例: ftp://ftp.coda.cs.cmu.edu/pub/coda/src/coda-?.?.?.tgz.

Linux で Venus を再構築できます


./configure --host=windows95 
make

クライアント・ユーティリティとサーバについては


./configure --host=nt

ここでの Venus は NT のための構築で、Win95 では使えません。

カーネルレベルのコードの構築 (VXDs)

必要なのは:

Visual C++ 5.0 (と Internet Explorer).
MS assembler 6.11.
Win95 DDK (professional MSDN 付属).
ネットワークのためにヘッダファイル vxdtdi.zip のコレクションもダウンロードする必要があります。 ftp://ftp.microsoft.com/developr/drg/WinSock/MS-Extensions/VXDTDI.ZIP.

注: 95DDK は MSVC20 ディレクトリにある 95DDK に VC2.0 リンカーを必要とします(リンカーのために Link.err と DBI.DLL の入手が必要となります)。MASM611C ディレクトリにある 95DDK には、最新の MS アセンブラ 6.11 も必要です。

構築する VxD のソースは: ftp://ftp.coda.cs.cmu.edu/pub/coda/src/win95-coda-5.2.0.zip. sock.vxd を構築するためには、マイクロソフトから提供されるヘッダファイルが必要で、VXDTDI.ZIP にあります。Developer Studio による、VxD のハウツーを知る必要があります:

全ての .mak ファイルにあるリンカーのパスを変更すること
MS-Studio 環境 (オプション) で追加:
- アセンブラ 6.11 の実行パス
- 95DDK inc32 (Inc32) のインクルードパス
- 95DDK inc16 (Inc16) のインクルードパス
- 95DDK (lib) の lib パス
- VXDTDI ヘッダのあるインクルードパス
- 95DDK (Block/Inc) のインクルードパス

Developer Studio Project である "95projects" を使います。個々に VXD を構築します。Coda の起動を簡単にする CodaStart を構築します。

構築後の Coda のインストール

C:\usr\coda\{bin, etc, spool, venus.cache} ディレクトリを作ります。
C:\usr\coda\bin というディレクトリに Venus.exe, Relay.exe, Mount.exe, Unmount.exe, sock.vxd, mc.vxd, mcstub.vxd, mmap.vxd を置きます。

以下のような行のある C:\usr\coda\etc\vstab ファイルを作ります。


/coda:/dev/cfs0:<ip adress of server 1>,..,<ip adress of server n>,<cachesize>:1

CMU-testserver で動かすには


/coda:/dev/cfs0:128.2.209.213:100000:1

あなたの IP アドレスを記述した C:\usr\coda\venus.cache\myhost ファイルを作ります
"device=C:\usr\coda\bin\mcstub.vxd" のように 386Enh セクションで C:\Windows\System.ini ファイルに VXD を二つ、mcstub.vxd と mmap.vxd を追加します。
c:\autoexec.bat の PATH 環境変数に c:\usr\coda\bin のパスを追加
マシンを再起動
clog.exe, ctokens.exe, cunlog.exe, cfs.exe, hoard.exe, codacon.exe, venus-setup.bat が NT の coda サーバで構築されます。

インストーラはあなたまかせになっています。Coda を起動するには、Windows95: Coda クライアントの起動と設定を見てください。

6.5 NT の Coda サーバの構築とインストール

注: 現在、利用できるクライアントのカーネルソースはまだありません。間も無く試験的なバイナリがリリースされるでしょう。もちろん、そう遠くない将来にソースをリリースします。

しかし、Venus を構築できて(NT 用に供給されたカーネル Coda FSD で)、サーバを構築できます。

Coda は NT と Windows 95 で走っている Coda サーバのアルファ・サポートです。Win32 バイナリは、効果的に Unix システムコールを Win32 コールにトランスレートする、Cygnus Win32 キットを使って構築されます。

クロスコンパイラを使って Linux ワークステーション上で Win32 バイナリを構築するのが、簡単な方法です。その時これが心配が無用なのは、完全な手動だからです。もちろん、私たちは動くようにヘルプをしたりバグをフィックスしたりします。

構築の方法

必要なのは:

クロス・コンパイルキットの入手: ftp://ftp.coda.cs.cmu.edu/pub/tools/win32/cygwin-b20_glibc-3.i386.rpm.
ftp://ftp.coda.cs.cmu.edu/pub/tools/win32/libgdbm-nt-1.7.3-3.i386.rpm. (RedHat 5.0 用の rpm です。もちろんソースが使えます。)
coda-?.?.? tar アーカイブの入手 ftp://ftp.coda.cs.cmu.edu/pub/coda/src.
解凍 & 構築
./configure --host=nt make coda
コーヒーでも飲んで、コンパイラの warning でも出ない限り、リラックスします。

Windows マシンでの構築も可能なはずです; configs/coda.m4 を 2、3 変更して、新しい configs/Makeconfig.ntnative ファイルを作ります; それから autoconf を走らせて、クラッキングを手に入れます。しかし、Windoze マシン(訳注: doze = まどろむ、居眠りする) によって作成された ^M キャラクタのパッチを私たちに送ることはしないでください！

構築後の手動設定

まだ Linux にある NT のバイナリの領域にインストールします。適切な場所にバイナリを置きます: make BINDIR=TARGET/bin SBINDIR=TARGET/bin server-install
RH マシンで samba を走らせて、Coda のために構築領域をエクスポートします。
ftp://ftp.coda.cs.cmu.edu/pub/coda/support/nt-patches にあるものか、cygnus から直接置き換えます
C:\cygwin\cygwin-b20\H-i586-cygwin32\bin\cygwin1.dll
cygwin1.dll のバージョンは 01/15/99 かそれより新しいものです。
バッシュの実行になります。"Start" メニューから起動できます。
Cywin のためにマウントポイントを観察してください。c:\ にマウントされた root ボリュームがあります。これを c:\coda に変更してください:
umount / mount -b C:\coda /
バイナリのマウントがバイタルなら -b です。
Cygwin パスで cygnus.bat ファイルのどこかにエントリを追加します。
SET HOME=C:\Coda
c:\coda ディレクトリに .bashrc ファイルを作ると、Cygwin シェルが開始します。エクスポートパスを設定して(以下に記述)、ホーム・ディレクトリに cd します。

いくつかディレクトリを作って、/bin/sh を作り、パスをエクスポートします:


mkdir /bin /vice /rvm /vicepa /tmp
touch /rvm/LOG
touch /rvm/DATA
cp //c/cygwin/cygwin-b20/H-i586-cygwin32/bin/bash /bin/sh
export PATH=/bin:$PATH

上記のように構築された Coda をインストールします。coda-?.?.? 領域は、バッシュで NT マシンのドライブ H: にマップされるドライブです:
cd //H/ cp * /bin
バイナリファイルは .exe 拡張子を持っていないかもしれません。その場合は名前を変えて、バッシュのシェルスクリプトとバイナリを区別します。

インストーラはあなたまかせになっています。サーバを設定して起動するには Codaserv -- the server セクションを見てください。

戻るコンテンツ

詳しくはメールで

このページの情報に関わる、ご質問、お問い合わせは、 japache@infoscience.co.jpまで。

Coda ホームページ