Metacat の Linux へのインストールの手引き
	KNB Home	Data	People	Informatics	Biocomplexity	Education	Software

Metacat をインストールする時に考慮するべき選択肢がいろいろある。幾つか挙げると、

• オペレーティング・システム - Metacat は Java servlet アプリケーションである。そのため、いろいろなオペレーティング・システム上でMetacatを動かすことができる。MetacatはLinux, MacOS, MS-Windows に対してテストされた。 Ubuntu Linux にインストールするのが最適である。
• Tomcat を単独で動かすか、それともApache ウェブサーバと接続させるか - Tomcat サーバは単独でウェブサーバとして動作する。しかし、TomcatはApacheに比べてサーバとして頑強ではないし、動作の調整もApacheほどには細かくできない。推奨される設定は、Tomcat を Apache と接続させて動かすことである。
• バイナリ・インストールかソース・インストールか - Metacat のインストールには3つの方法がある。
  • バイナリ配布物のインストール - Metacat war 配布物をダウンロードして、それをウェブ・アプリケーション・ディレクトリにインストールする
  • ソース配布物からインストール - ソースコード配布物をダウンロードしてビルドし、作成された war ファイルをウェブ・アプリケーション・ディレクトリにインストールする
  • ソースをチェックアウトしてインストール - ソースコードをレポジトリからチェックアウトしてビルドし、作成された war ファイルをウェブ・アプリケーション・ディレクトリにインストールする
  推奨されるインストール手順はバイナリインストールである。

管理者は、自分たちのシステムに最も適合するように、これ らの選択肢をどのように組み合わせるかを決める必要がある。

このページの最初の2節は、最適環境（Ubuntu Linux 上で Apacheと共にバイナリ配布物をインストール）における、 Metacat の新規インストールと更新のためのコマンドライン操作 について説明している。

それ以降の部分では、他のインストール方法を含め、より詳 しい説明がなされる。

ここでは、Ubuntu 8.04 がインストールされており、かつ MetacatがまだインストールされていないシステムにMetacatをイ ンストールする場合について解説する。

• KNB Software Download Page　を表示する. Metacat の節で,
  metacat-bin-X.X.X.tar.gz
  といったようなリンクを選ぶ。ここで、X.X.X というのはMetacatの 最新バージョン番号である。ファイルは手元のハードディスクに 保存すること。
• Metacat パッケージのファイルを展開するために、次のようにタイプする。
  tar -xvzf metacat-bin-X.X.X.tar.gz
• すると1個の war ファイルと数個の支援ファイルが現れるはずである。 以降の文章での便を考え、これらのファイルが展開された場所を <metacat_package_dir> と表記することとする。

• Metacat ユーティリティのベースディレクトリを作成するために、 次のようにタイプせよ。
  sudo mkdir /var/metacat
  sudo chown -R <tomcat_user> /var/metacat
  ここで、<tomcat_user> とは Tomcat を始動するユーザである。 もしTomcatが root として動作するなら、chown 命令は必要ない。

• Java のインストールのために次のようにタイプせよ。
  sudo apt-get install sun-java5-jdk
• "ok", "yes" を打ってライセンス条件に合意すること。

• Apache と Mod JK パッケージのインストールのために、次のようにタイプせよ。
  sudo apt-get install apache2 libapache2-mod-jk
• Mod JK の設定のために次のようにタイプする。
  sudo cp <metacat_package_dir>/jk.conf /etc/apache2/mods-available
  sudo cp <metacat_package_dir>/workers.properties /etc/apache2
• Apache Mod JK を有効にするため、次のようにタイプする
  sudo a2dismod jk
  sudo a2enmod jk
• knb (Metacat) サイトの構成を設定し有効化するには次のようにタイプする。
  sudo cp <metacat_package_dir>/knb /etc/apache2/sites-available
  sudo a2ensite knb
• Metacatサーバと一緒にLSIDサーバを動かしたい場合は、 認証サービスサイトの構成を設定し有効化するために次のように タイプする。
  sudo cp <metacat_package_dir>/authority /etc/apache2/sites-available
  sudo a2ensite authority
• 変更をapache に反映させるには次のようにタイプする。
  sudo /etc/init.d/apache2 force-reload

• Tomcat 5.5 をインストールするには次のようにタイプする。
  sudo sudo apt-get install tomcat5.5
• Metacat に適したTomcat 起動スクリプトのインストールのために 次のようにタイプせよ。
  sudo /etc/init.d/tomcat5.5 stop
  sudo mv /etc/init.d/tomcat5.5 /etc/init.d/tomcat5.5.bak
  sudo cp <metacat_package_dir>/tomcat5.5 /etc/init.d/tomcat5.5
  sudo chmod +x /etc/init.d/tomcat5.5

• PostgreSQL のインストールには次のようにタイプする。
  sudo apt-get install postgresql
• postgres のユーザに変更する。
  sudo su - postgres
• Metacatのデータベースインスタンスを設定するために、 postgreSQL の構成ファイルを編集する。
  gedit /etc/postgresql/8.3/main/pg_hba.conf
そして次の行を追加する。
host metacat metacat 127.0.0.1 255.255.255.255 password
• このファイルを保存し、metacat インスタンスを作成する。
  createdb metacat
• postgreSQL にログインするために次のようにタイプする。
  psql metacat
  そして metacat ユーザを作成するために、psql プロンプトで次のようにタイプする。
  CREATE USER metacat WITH UNENCRYPTED PASSWORD 'your_password';
  ここで your_password とは metacat ユーザ用の任意のパスワードである。
• PostgreSQL から抜けるには次のようにタイプする。
  \q
• 変更を反映させるためにPostgreSQL データベースを再始動する。
  /etc/init.d/postgresql-8.3 restart
• postgres ユーザアカウントからログアウトするには次のようにタイプする。
  logout
• インストールとmetacatアカウントのテストのために、次のようにタイプせよ。
  psql -U metacat -W -h localhost metacat
• postgreSQL からログアウトする。
  \q

• war ファイルを Tomcatにコピーする
  sudo cp <metacat_package_dir>/knb.war /usr/share/tomcat5.5/webapps
• Tomcatを再始動。
  sudo /etc/init.d/tomcat5.5 restart

• もしMetacatサーバと一緒にLSIDサーバを動かしたい場合は、 authority.war ファイルをTomcatにコピーする。
  sudo cp <metacat_package_dir>/authority.war /usr/share/tomcat5.5/webapps
• Tomcatの再始動。
  sudo /etc/init.d/tomcat5.5 restart

Metacat Confgurationを参照して、 Metacatのインストールを完了せよ

ここでは、既にMetacatがインストールされているが、Metacatの更新が必要なシステムのための説明を行なう。

• KNB Software Download Pageを表示する. Metacat の節で、 select the link that looks like:
  metacat-bin-X.X.X.tar.gz
  のようなリンクを選ぶ。ここで X.X.X はMetacat の最新バージョン番号である。 ファイルは手元のハードディスクに保存する。
• Metacat パッケージを展開するために次のようにタイプする。
  tar -xvzf metacat-bin-X.X.X.tar.gz
  すると 1個の war ファイルと幾つかの補助ファイルが現れるはずである。 以降の文章では、これらのファイルが展開された場所を<metacat_package_dir>と表記する。

• 安全のため、既にインストールされているMetacat のバックアップを取っておくことが最良である。そのためには次のようにタイプする。
  cp <web_app_dir>/knb <web_app_dir>/knb.<yyyymmdd>
  cp <web_app_dir>/knb.war <web_app_dir>/knb.war.<yyyymmdd>
  もちろん、バックアップの戦略は好きにしてよい（し、何もしなくてもいい）。

• war ファイルをTomcatにコピーする。
  sudo cp knb.war /usr/share/tomcat5.5/webapps
• Tomcatの再始動。
  sudo /etc/init.d/tomcat5.5 restart

• もしMetacatサーバと一緒にLSIDサーバを動かしたいなら、 authority.war を Tomcatにコピーする。
  sudo cp <metacat_package_dir>/authority.war /usr/share/tomcat5.5/webapps
• Tomcatの再始動。
  sudo /etc/init.d/tomcat5.5 restart

Metacat Confgurationを参照して Metacatのインストールを完成させよ.

Metacat のインストールには、SQL92に準拠したデータベース(Oracle 8i もしくは Postgresql が推奨される) が走っていて、少なくとも 128MBのRAMと Pentium III かそれ以上のプロセッサを持ったサーバが必要である。 必要なディスク容量は RDBMS の tablespace のサイズに依存する （少なくとも10MBあるだろうが、Metacat それ自体はインストール後に たった1MB程度の容量しか必要としない）。これらの説明はLinux環境を 仮定しているが、他のUNIXタイプの環境でも動作するだろう、しかし テストはされていない。

Metacatをインストールするサーバは、Metacatのインストールが試みられる前に、 以下に挙げるソフトウェアがインストールされて正しく動作していなければならない。

• Oracle 8i (あるいは、Postgres のような、 他の SQL92準拠 RDBMS)
• Apache Jakarta-Ant
• Apache Jakarta-Tomcat

  註: より頑強なウェブサービス環境にするためには、 Apache ウェブサーバをTomcatと一緒にインストールするべきであり、 またその両者を、Apache ウェブサイトで説明されているように統合する べきである。

最近の Java SDKが必要である; J2SE 1.4.2 かそれ以降が要求される。 最新のmetacatリリースは J2SE 5.0を用いて幅広くテストされており、これが推奨されるバージョンである。 JAVA_HOME 環境変数が正しく設定されているか、また java と javac のどちらもが PATH にあることを確認せよ。

Oracle RDBMS はそのシステム上で、デーモンとしてインストールされて動いていなければならない。 加えて JDBC リスナが有効になっていなければならない。 それを有効にするには、Oracle ユーザとしてログインして、次のようにタイプせよ。

インスタンスには少なくとも5MBのテーブル空間を持たせるべきである （10MB以上が推奨される）。またMetacat専用のユーザ名を作成して有効に しておくべきである。このユーザは、 CREATE SESSION, CREATE TABLE, CREATE INDEX, CREATE TRIGGER, EXECUTE PROCEDURE, EXECUTE TYPE, などを含む、通常権限の大部分を持たなければ ならない。もしある行動がMetacatによって不可解にも拒絶された場合、それは たぶんユーザの権限が正しく設定されていないからである。

PostgreSQL はほとんどのlinuxディストリビューションとWindows(cygwinを用いる）とMac OS Xに簡単にインストールできる。 Fedora Core か RedHat Linuxを使っているなら、postgres の rpms をインストールして、

を実行してデータベースを始動することができる。 Ubuntu および 他のDebianベースの Linux ディストリビューションでは、 postgres のインストールに apt-get コマンドを使うことができる。

• アカウントを"postgres" ユーザに変更する
  sudo su - postgres
• "data/pg_hba.conf"を編集し、次の行を追加する:
  
  host metacat metacat 127.0.0.1 255.255.255.255 password
  もしIPv6を使うなら、代わりに次の行が必要かも知れない:
  host metacat metacat ::1 ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff password
• もしバージョン 8.0 以前のPostgresql を使っているなら、 "data/postgres.conf" ファイルを編集して "tcpip_socket" で始まる行を有効にする。
  tcpip_socket = true
• metacat データベースを作成するために次のようにタイプする。
  createdb metacat
• postgres アカウントでログインして新規の "metacat" ユーザアカウントを作成するには次のようにタイプする。
  psql metacat
  • postgres内で、
    CREATE USER metacat WITH UNENCRYPTED PASSWORD 'apasswordyoulike';
    を実行する。
  • これによって、metacatという名前のデータベース上にmetacatという名前の新規のアカウントが作成される。
  • 註: これには色々やり方がある。パスワードを暗号化したりとか、 他の方法でも良く動作するだろう。
• アカウントをpostgres から root に戻して、postgres データベースの再始動のために次のようにタイプする。
  /etc/init.d/postgresql restart
• postgresデータベースにmetacatアカウントを使ってログインするテストには、次のコマンドを使う。
  psql -U metacat -W -h localhost metacat

Ant は、UNIXシステムのMakeに類似した、Java ベースのビルドアプリケーションである。 Ant は "build.xml"というファイルからインストール時のパラメータを取り込む。 Metacat のCVS モジュールはデフォルトの build.xml ファイルを含んでいるが、これはインストールの際には若干の 修正が必要であろう。 システムにAnt がインストールされ、また"ant"の実行スクリプトがpath上で 利用可能になっていなければならない。 最新のmetacat リリースは Ant 1.6.5によってテストされた。

Ubuntu/Debianを動かしているなら、 Apache ウェブサーバのインストールは 次のようにタイプする。

Tomcat のインストール先は好きに選んでよい。Tomcatをインストールしたディレクトリを<tomcat_home>と表記する。 Tomcat のバージョンは 5.5を勧める. もしUbuntu/Debianを動かしているなら、次のようにタイプすればTomcatを入手できる。

インストールに必要な Metacat war ファイルを準備する方法にはいくつかある。

• Metacat のバイナリ配布物をダウンロードする- これには前もってビルドされた war ファイルが含まれている.
• Metacat のソース配布物をダウンロードする - これは war ファイルを作成するためにビルドする必要がある。
• Metacat のソースを SVN からダウンロードする - これは war ファイルを作成するためにビルドする必要がある。

バイナリ配布物をダウンロードする方法が最も簡単で一般的なインストール方法であるので、それについてここでは詳しく論じる。ソースをダウンロードしてビルドしたい場合のために、その方法についてのリンクも含めておく。

KNB Software Download Pageを表示する. Metacat の節で, Linux ベースのシステムの場合は次のようなリンクを選ぶ。

Windows システムの場合は次のようなリンクを選ぶ。

ここで X.X.X は Metacat の最新バージョン番号である。ファイルは手元に保存する。

Linux システム上で Metacat パッケージを展開するには次のようにタイプする。

もしくは, Windows上では, システムにある unzip ユーティリティを使ってzipファイルを展開する。

すると1個のwarファイルと数個の補助ファイルが現れるはずである。 これらのファイルが展開された場所を、以降の文章では <metacat_package_dir> と表記する。

Metacat のソース配布物を入手するために KNB Software Download Pageを表示する. Metacat の節で、Linux ベースのシステムの場合は次のようなリンクを選ぶ。

Windows システムの場合は次のようなリンクを選ぶ。

ここで X.X.X というのは Metacatの最新バージョン番号である。ファイルは、ソースが置かれるべきディレクトリに保存する。

Linux システムで Metacat パッケージのファイルを展開するには次のようにタイプする。

もしくは, Windowsの場合、システムの unzip ユーティリティを使ってzipファイルを展開する。

ディレクトリの名前をmetacat-X.X.X から metacatに変更する。

註・ソースからインストールする場合は、Ant のビルドファイルが war ファイルを配備するための"install"ターゲットを持っているため、自分でwarファイルを直接作成する必要はない。 Installing Metacat を見よ.

もしMetacat のコードをSVNレポジトリから取り出すならば、システム上に Subversion (SVN) と CVS クライアントの両方がインストールされて設定されている必要がある。両方が必要な理由は、Metacat は SVN に移行したけれども、 補助ライブラリのいくつか（eml, utilities や seek）はまだ移行していないからである。 結局は、SVNだけですべてのバージョン管理ができるようになるだろう。 これらのシステムに適切なアカウントがあることを確かめる必要がある。 もしMetacatのソース配布物からインストールするならば、SVNやCVSについて 思い煩わなくてよい（必要なものはすべて含まれている）。

もしまだ Subversion をインストールしておらず、かつ Ubuntu/Debianを使っているなら、次のようにタイプすれば入手できる。

そうでなければ, The Subversion homepageから入手できる。

まだCVSをインストールしておらず、かつ Ubuntu/Debianを使っているなら、次のようにタイプすれば入手できる。

そうでなければ, The Ximbiot CVS homepageから入手できる。

SVNからコードを取り出すためには、コードを置いておきたいディレクトリに移動し、次のようにタイプする。

ここで <rev> とは、取り出したいコードのバージョン番号である(1_9のような).

もし head を取り出したいなら次のようにタイプする。

取り出されたファイルのリストが表示されるはずである。

註・ソースからインストールする場合は、Antのビルドファイルの中にwarファイルを作成して配置するための"install"ターゲットが含まれているので、直接warファイルを作成する必要はない。 Installing Metacat を見よ。

この節は新規インストールのみが対象である。もし既存のMetacatを更新するなら、この節を飛ばして次節に行け - Upgrading Existing Metacat

Tomcat は、設定で指定されたディレクトリの中のアプリケーションファイル（war ファイル）を探す。典型的には <tomcat_home>/webapps ディレクトリであるが、しかしあなたが使っているTomcatは他のディレクトリを見るように設定されているかも知れない。 ここではTomcatのアプリケーションディレクトリを <tomcat_app_dir>と表記する.

Metacat は、データやメタデータ、一時ファイルや設定のバックアップを保管するために、ベースディレクトリを使う。 このディレクトリはTomcatのアプリケーションディレクトリの外部にあるべきである。と言うのもアプリケーションディレクトリは更新時に消去されてしまうからである。 metacat ユーティリティのベースディレクトリを作るには次のようにタイプする。

(典型的には は '/var/metacat'である.) このディレクトリは覚えておくように。と言うのもMetacatの始動後にMetacatの設定をするために尋ねられるからである。

次のようにタイプしてディレクトリの所有権を変更する:

ここで <tomcat_user> とはTomcatを始動するユーザである。 もしroot ユーザでTomcatの始動を行なうなら、chownコマンドは必要ない。

war file を Tomcatにコピー:

ビルドするには Apache Ant が必要である. もしまだ Ant がインストールされておらず、かつ Ubuntu/Debianを使っているなら、次のようにタイプすれば入手できる。

そうでなければ, The Apache Ant homepageから入手できる

もうすでに"metacat"という名前のディレクトリにMetacatのソースが準備されているはずである。 (metacat のソースディレクトリを <metacat_src_dir>と表記する.)

ビルドの準備のため、次のファイルを編集する。

"build.tomcat.dir" プロパティがtomcatのインストールディレクトリに設定されているかどうか確かめる。たとえば、

Metacat はビルドの最中にTomcat固有のライブラリを使う。

"app.deploy.dir" プロパティがアプリケーション配置ディレクトリに設定されているかどうか確かめる。例えば。

今ログインしているユーザとcvsユーザが違うなら、cvsrootプロパティの ${env.USER} 部をcvsユーザに変更する必要がある たとえば、

ここでは cvs ユーザ名は "cvs-user"である。

<metacat_src_dir>で、次行を実行する。

独立モジュールがビルドされるのが見えるだろう。何回か、cvsパスワードの入力を促されるだろう。終わりに "BUILD SUCCESSFUL"というメッセージを見るはずである。

アプリケーション配置ディレクトリに knb.war という名前の新しいファイルが見えるはずである。

Tomcatを単独で動かすか、Apache ウェブサーバと一緒に動かすか選ぶことができる。Apacheと一緒に動かすことはより伝統的な設定である。と言うのもApacheはより頑強なウェブサーバだからである。ApacheをMetacatアプリケーションと通信させるための初期設定のやり方が

以下の解説は既存のMetacatの更新についてである。

そのためには, tomcatサーバを動かしたユーザとしてログインし(しばしばtomcatだが）、 <tomcat_home>/bin に行って次のようにタイプする。

KNB Software Download Pageを表示する. Metacat の節で, 次のようなリンクを選ぶ。

ここで X.X.X は最新のMetacatのバージョン番号である。ファイルは手元に保存する

Metacat パッケージを展開するために次のようにタイプする。

すると数個のファイルが現れるだろう。

• knb.war - Metacat アプリケーションの ウェブ書庫ファイル.
• knb - ubuntu/debian Linux システム上のApacheで使用されるウェブ定義ファイル.
• jk.conf - ubuntu/debian Linux システム上のApacheで使用される JkMount 設定ファイル.
• workers.properties - ubuntu/debian Linux システム上のApacheで使用される workers 定義ファイル.
• tomcat5.5 - ubuntu/debian Linux システム上で apt-get を用いてインストールされた Tomcat5.5 のためのTomcat始動スクリプト.
• authority - LSID サーバアプリケーションのウェブ書庫ファイル（利用は任意）

これらのファイルが展開された場所を、以降の文章では <metacat_package_dir> と表記する

Tomcat は設定で指定されたディレクトリの中のアプリケーションファイル (war ファイル) を探す。典型的には <tomcat_home>/webapps ディレクトリであるが、しかしあなたが使っている Tomcatは別のディレクトリを見るように設定されているかも知れない。 Tomcat のアプリケーションディレクトリを <tomcat_app_dir>と表記する.

望むならば、既存のwarファイルを日付を付けてバックアップせよ。

war ファイルを Tomcat のアプリケーションディレクトリにコピーする。

既存のアプリケーションディレクトリを削除する（か名前を変える）

あるいは

Tomcatの再始動

Tomcat は始動時にwarファイルを新しいアプリケーションディレクトリに展開する。

ソースからMetacatを更新する手順は、ソースからインストールする手順と同じである。 上記のInstall Metacat From Source 節を見よ.

Metacatのインストールが一旦成功したら、更にもうひと手順がある。 Tomcat (Apache と統合させている場合はApacheも) を再始動させなければならない。 そのためには、tomcatサーバを動かしているユーザ（たいてい"tomcat"）で ログインして、 <tomcat_home>/bin に移動し、次のようにタイプする。

Tomcat の始動メッセージの中で、次のようなログが見られるはずである。

上記のurlにおける"yourcontext"は、実際のコンテクスト名に置換せよ。 もしすべてが正しく動いているなら、検索結果が何もない検索画面が見える はずである。もしTomcatをApacheと統合させていないのなら、おそらく 次のようにタイプする必要がある。

もし次のようなものが見えたら:

次の行を:

tomcat の bin ディレクトリにあるcatalina.sh ファイルの第一行に加えるべきである。この理由は、GeoServer が画面を描画するために X11 windows を使用するためである.

Metacat の設定画面が一度現れたら、 Configuring Metacat Section に従ってMetacatの内部設定を完成させることができる。

登録するとユーザがウェブから簡単なメタデータをアップロードできるようになる。 Registry Installation Guideを見よ.