This page linked from [ AtRandomBBS | YaPw | __YaPwMenu__ ]

YaPw導入メモ

履歴閲覧: 最新 2005/04/25 {2004/03/08[差分表示]} 2003/11/26 2003/08/29 2003/08/18

配布/履歴 BBSヘルプ:導入設定 UpDate 隠し機能[着手]機能: BBS機能名前空間[完了] 署名設定Tips: Tips他: ライセンス

なんにしても、ドキュメントはろくに書かれていないので、なにかあったらガツンと要望を送ってください。
(要求されない限り機能追加もドキュメント書きもたぶんしません)。

開発版(cvs版)の導入方法.

cvs.niu.ne.jpのanonymous cvsサーバにて、開発版を公開しています。
最新の開発版は以下の手順で取得できます。
1.ログイン

cvs -d:pserver:anonymous@cvs.niu.ne.jp:/home/cvs/cvsroot login

2.開発版の取り出し

cvs -d:pserver:anonymous@cvs.niu.ne.jp:/home/cvs/cvsroot co -d checkout yapw

-> "checkout"という名のディレクトリが作られて、そこにファイルが展開されます。

3.設定

安定版・公開版と同様に、データディレクトリの作成と各種ファイルの編集を行ってください。

4.開発版への追随

cd checkout/ <- 2.の結果作られたディレクトリ名を指定。
cvs update -d

カスタマイズしていた場合、衝突が発生する可能性があります。
実際に衝突した場合には、適当に直してください。

安定版・公開版の導入方法.

a.極めていいかげんな導入方法.

YaPw修正情報から、適当なバージョンのtar.gzパッケージをダウンロードします。
パッケージを展開します。
UNIXシステムの場合は、以下のコマンドを実行します。('(version)'はバージョン名)
$ tar xzf yapw-(version).tar.gz
展開すると、yapw-(version)という名前のディレクトリが出来ます。
展開してできたディレクトリを、適当なhttp公開ディレクトリ下に置きます。
$ mv yapw-(version) public_html/(任意の名前)
移動させた先の任意の名前のディレクトリ(以下、インストール先ディレクトリ)について、
- インストール先ディレクトリでは、cgiが実行できる必要があります。
- なお、同梱の.htaccessでは、比較的適切な設定を試みていると思います。
データディレクトリを作ります。
- インストール先ディレクトリに、'DATA'という名前のディレクトリを作ってください。
- DATAディレクトリに、CGIからの書き込み権限を与えて下さい。
  - UNIXのコマンドライン上で作業ができる場合、以下の作業をすることになります。
    $ mkdir DATA
    $ chmod 777 DATA
  - CGIがsuexecで動いている場合、777ではなく701などにしたほうが安全かもしれません。
必要に応じて、インストール先ディレクトリ内の以下のファイルを編集します。
- .htaccess
- yapw.conf
- Templateディレクトリ内の各ファイル
(YaPw使い方あれこれに関連情報アリ)
適切なURLで、yapw.cgiを呼び出してください。
- うまく動かない場合、まずは以下のことを疑ってみてください。
  - yapw.cgiのパーミッション
  - yapw.cgi先頭のperlのパス指定
  - .htaccessの内容
    - 同梱のものだとAddHandler?のOverrideでこける、という事例がありました(該当行の削除で動作)。
  - suexecによるチェック(インストール先ディレクトリや、その親ディレクトリのパーミッション)
  また、同梱のtest.cgiが役に立つかもしれません。
同梱のtest.cgiが動いてしまうのが微妙に嫌な場合、test.cgiの実行権限を落として下さい。
- というか、落とすことを推奨します。
- CGIの開発/デバッグ時には便利ですが。
- エラー報告のときは、test.cgiの結果を添えていただけると助かるかも。

導入以降のバージョンアップ.

パッケージを取ってきて展開します。
以下のファイルをインストール先ディレクトリに上書きコピーしてください。
- yapw.cgi
- MyCGIlib?.pm
- TreeStore.pm
- EncodedTreeStore?.pm
- Yapwディレクトリ丸ごと。
- pluginディレクトリ丸ごと。
ときどき勝手に設定項目が増えたりするので、yapw.confも確認するのをお勧めします。
なお、使えるのであればcvs版による追随の方をお勧めします。
- アップデートパッケージとか作ってもいいですが……需要あるのか？