Installation

インストール方法は，初めてのインストールか，それとも旧バージョンのバージョンアップかに応じて， 2種類にわかれています．

A. 初めてのインストール
B. バージョンアップインストール

A. 初めてのインストール

初めてのインストールの場合のインストール手順は，あなたが利用するプロバイダ（ウェブサーバ）のCGI環境によって若干異なります． CGI環境は，大きく分けて以下の4つに分類されます．

CGIプログラムを自由なディレクトリに置くことができる場合
CGIプログラムを決まったディレクトリ（例えばcgi-bin等）に置かなければならない場合
プロバイダがCGIWRAPという，CGI起動ラッパープログラムを利用している場合（具体的には，1999年6月時点で，Hi-Ho，interq等のプロバイダが CGIWRAPを利用しています．またCobalt Networks社のCobalt Cube 2700J， Cobalt Raq J R15 125 NIUというサーバも，CGIWRAPを利用しているそうです）
プロバイダがApacheのsuEXECという機能を利用している場合（具体的には，2000年1月時点で，A-CUBE，X-Jam，BigNet等のプロバイダが suEXECを利用しています）

まずは自分の置かれたCGI環境を確認しましょう．プロバイダの利用案内やFAQを見ると，自分がどれにあてはまるかわかると思います．ちなみに「2. CGIプログラムは決まったディレクトリに置く」と「3. CGIWRAPを利用している」の両方にあてはまってしまう不幸な環境もあります．例えばHi-Hoですね．^^; とはいっても，注意深く設置すれば必ず動きます（動作実績もあります）．頑張ってください．

それでは始めましょう．インストールは以下の手順で進めてください．

ダウンロード
展開
kb.cgiの書き換え
ファイル送信
ファイルモードの設定
初期テスト
CGI動作テスト
カスタマイズ
設定ファイルテスト
カスタマイズ掲示板動作テスト
機能特別版のkb.cgiプログラムを作る
メイル投稿機能を使う

10まで（必要だったら12まで）くればインストールは終わりです．システムをインストールして頂きましたら，きのぼずインストーラリストにある，アンケートに御協力ください．今後の開発の参考にしますので，どうかよろしくお願いします．

2. 展開

圧縮パッケージを展開します．自分のパソコン上で，伸長・展開ツールを利用して，圧縮パッケージを展開してください．

圧縮パッケージを展開すると，KB_v10～というディレクトリと，そのディレクトリの中にいくつかのファイルとディレクトリが作られます．下の図において，後ろに「/」がついているのはディレクトリを，そうでないものはファイルを示します．各ディレクトリおよびファイルの役割については， MANIFESTOドキュメントを御覧ください．

+-KB_v10～/
   +-COPYING
   +-README
   +-doc/
   |  +-html/
   |     :
   |
   +-kb/
   |  +-UI/
   |  |  :
   |  |
   |  +-board/
   |  |  +-kb.aid
   |  |  +-kb.board
   |  |  +-kb.db
   |  |
   |  +-cgi.pl
   |  +-icons/
   |  |  :
   |  |
   |  +-index.html
   |  +-index.shtml
   |  +-jcode.pl
   |  +-kb.cgi
   |  +-kb.ph
   |  +-kinoboards
   |  +-kinologue.pl
   |  +-kinousers
   |  +-log/
   |  +-mimer.pl
   |  +-mimew.pl
   |  +-test/
   |     +-kb.aid
   |     +-kb.board
   |     +-kb.db
   |
   +-tools/
   |  +-conv.cgi
   |  +-kbTst.cgi
   |  :
   |
   +-redist/
      :

作成されたファイル群の中の「kb」というディレクトリが， CGIプログラム用パッケージを収めたディレクトリです．このディレクトリをまるごとプロバイダ（ウェブサーバ）に置く必要があります（まだ送らないでください; もうちょっと待ってね）．その他のファイル（COPYING，README，doc/，tools/，redist/）はあなたのパソコンに保管しておいてください．

3. kb.cgiの書き換え

さーて，最初のヤマです．ファイルの書き換えが必要です．

kb.cgiというファイルの先頭行には， KINOBOARDSを動かすために必要なperlというプログラムのパスが書かれています．予め一般的な設定がされていますが，プロバイダ（ウェブサーバ）に依って違うため，調べて正しく設定しなければなりません．

perlのパスについては，プロバイダの利用案内やFAQを探してみてください．「/usr/bin/perl」や「/usr/local/bin/perl」などのパスが指定されているはずです．どうしてもみつからなければ管理者に問い合わせてみましょう．

perlのパスがわかったら，kb.cgiを書き換えます．圧縮パッケージをプロバイダのマシン上で展開した人は，まずFTPソフトウェアでkb.cgiを自分のパソコンに取ってきましょう． kb.cgiを適当なエディタで開いて，先頭行を書き換えてください．「#!」に続けて，perlのパスを書き込みます．

例: Perlのパスが/usr/bin/perlだった場合

#!/usr/local/bin/perl → #!/usr/bin/perl

続いて$KBDIR_PATHに，プロバイダ（ウェブサーバ）に置く予定の kbディレクトリのパス（URLじゃなくて，パスです）を指定します．「kbディレクトリのパスがわからない!」という場合は， kbTst.cgiというツールを使ってチェックすることができます．

例1: kbディレクトリのパスが「/home/nahi/public_html/kb/」になる予定の場合

$KBDIR_PATH = '';
↓
$KBDIR_PATH = '/home/nahi/public_html/kb/';


例2: サーバがWinNTで，kbディレクトリのパスが「c:\inetpub\wwwroot\kb\」になる予定の場合

$KBDIR_PATH = '';
↓
$KBDIR_PATH = 'c:\inetpub\wwwroot\kb\';

さらに，サーバOSがWin95/Win98，もしくはMacの場合（プロバイダがこれらのマシンをサーバにすることはないでしょうから，自分のパソコンでテストする場合ですね）， kb.cgiの続く3つ目の項目を，以下のように書き換えます．サーバがWin95/Win98，Macでない場合は書き換える必要はありません．

$PC = 0;        # for UNIX / WinNT
# $PC = 1;      # for Win95 / Mac

↓

# $PC = 0;      # for UNIX / WinNT
$PC = 1;        # for Win95 / Mac

さらにさらに，最初に書いた 4種類のCGI環境のうち「3. CGIWRAPを利用している」場合は， 4つ目の項目にkbディレクトリのURL（今度はパスじゃなくて，URLです）を指定します．そうでない環境の場合，設定の必要はありません．

例: kbディレクトリのURLが「/~nahi/bbs/kb/」になる予定の場合

# $KB_RESOURCE_URL = '/~nahi/kb/';
↓
$KB_RESOURCE_URL = '/~nahi/bbs/kb/';

この時，間違えて先頭部分以外を書き換えたり，漢字コードを変更してしまったりしないようにしてください．世の中にはSJISでも動くと謌っているPerlスクリプトもありますが，基本的にPerlはEUCでなければ動きません． SJISでも一見動いているように見えることがありますが，バグの素です．必ずEUCにしましょう．

4. ファイル送信

2. 展開でできたkbディレクトリを，その中に含まれるファイル，ディレクトリごと，プロバイダ（ウェブサーバ）に送信します．もちろんkb.cgiは， 3. kb.cgiを書き換えるで書き換えたものを送信してください．

ここで，最初にも書いた，「1. CGIプログラムを自由なディレクトリに置くことができる」環境の場合は，下のディレクトリ構成図に示すように，ウェブ用のディレクトリ（例ではpublic_html）にkbという名前のディレクトリを作り，その中に各ファイルとディレクトリを設置してください．

+-public_html
   +-kb/
      +-UI/
      |  :
      |
      +-board/
      |  +-kb.aid
      |  +-kb.board
      |  +-kb.db
      |
      +-cgi.pl
      +-icons/
      |  :
      |
      +-index.html
      +-index.shtml
      +-jcode.pl
      +-kb.cgi
      +-kb.ph
      +-kinoboards
      +-kinologue.pl
      +-kinousers
      +-log/
      +-mimer.pl
      +-mimew.pl
      +-test/
         +-kb.aid
         +-kb.board
         +-kb.db

「1. CGIプログラムを自由なディレクトリに置くことができる」環境の場合，送信は以上で終了です． 5. ファイルモードの設定に進んでください．

「2. CGIプログラムは決まったディレクトリに置く」環境の場合，もうちょっとややこしいです．ファイルを送る前に，まずindex.htmlを書き換えます． index.htmlのソースを見ると，「テスト」掲示板へのリンクが，

<a href="kb.cgi?b=test">テスト</a>

となっていると思います．これを次のように変更してください．

<a href="(A)/kb.cgi(B)?b=test">テスト</a>

(A): CGIプログラムを置くディレクトリのURL（例えば/cgi-bin/nahi）
(B): kbディレクトリのURL（例えば/~nahi/kb）

つまり，「kb.cgi」→「(A)/kb.cgi(B)」と変更します．上の例なら，

<a href="/cgi-bin/nahi/kb.cgi/~nahi/kb?b=test">テスト</a>

になります．

index.htmlを書き換えたら，いよいよ設置です．まず，プロバイダから指示されている， CGIスクリプトを置かなければならないディレクトリに， kb.cgi（だけ!）を置いてください．次にkbという名前のディレクトリの中に，残りの（kb.cgi以外の）ファイルとディレクトリを置いてください．

ファイル構成は，例えば以下のようになります．

CGIプログラムを置くディレクトリ
   +-cgi-bin
      +-kb.cgi

kbディレクトリ
   +-public_html
      +-kb/
         +-UI/
         |  :
         |
         +-board/
         |  +-kb.aid
         |  +-kb.board
         |  +-kb.db
         |
         +-cgi.pl
         +-icons/
         |  :
         |
         +-index.html
         +-index.shtml
         +-jcode.pl
         +-kb.ph
         +-kinoboards
         +-kinologue.pl
         +-kinousers
         +-log/
         +-mimer.pl
         +-mimew.pl
         +-test/
            +-kb.aid
            +-kb.board
            +-kb.db

5. ファイルモードの設定

次に，プロバイダ（ウェブサーバ）に設置した各ファイルとディレクトリのモード（パーミッション）を変更します．ファイルがたくさんあって大変ですが，頑張ってください．

4種類のCGI環境のうち，「4. suEXECを利用している」 じゃない 場合は，以下のように設定してください．「3. CGIWRAPを利用している」方もこちらの設定で試してみてください．

+-public_html
   +-kb/               777
      +-UI/            755
      |  :             444（UIディレクトリの中の～.plというファイル）
      |
      +-board/         777
      |  +-kb.aid      666
      |  +-kb.board    666
      |  +-kb.db       666
      |
      +-cgi.pl         444
      +-icons/         755
      |  :             444（iconsディレクトリの中の～.idef，～.gifというファイル）
      |
      +-index.html     644
      +-index.shtml    644
      +-jcode.pl       444
      +-kb.ph          644
      +-kinoboards     644
      +-kinologue.pl   444
      +-kinousers      666
      +-log/           777
      +-mimer.pl       444
      +-mimew.pl       444
      +-test/          777
         +-kb.aid      666
         +-kb.board    666
         +-kb.db       666

  kb.cgi               755（kbディレクトリに置いた場合も，例えば/cgi-binに置いた場合も）

「4. suEXECを利用している」の環境の場合は，以下のように設定します．右側2つの数字が一部0になります．

+-public_html
   +-kb/               755
      +-UI/            700
      |  :             400（UIディレクトリの中の～.plというファイル）
      |
      +-board/         700
      |  +-kb.aid      600
      |  +-kb.board    600
      |  +-kb.db       600
      |
      +-cgi.pl         400
      +-icons/         755
      |  :             644（iconsディレクトリの中の～.idef，～.gifというファイル）
      |
      +-index.html     644
      +-index.shtml    644
      +-jcode.pl       400
      +-kb.ph          600
      +-kinoboards     600
      +-kinologue.pl   400
      +-kinousers      600
      +-log/           755
      +-mimer.pl       400
      +-mimew.pl       400
      +-test/          700
         +-kb.aid      600
         +-kb.board    600
         +-kb.db       600

  kb.cgi               700（kbディレクトリに置いた場合も，例えば/cgi-binに置いた場合も）

モード（パーミッション）の変更はお使いのFTPソフトウェアでやっても構いませんし， telnetしてログインした後，chmodコマンドで行っても構いません．

6. 初期テスト

念のためここでプログラムのテストをします． kbTst.cgiというツールを使ってテストしてください．プロバイダにtelnetできる人は，以下の方法でもテストできますが， kbTst.cgi は大変便利なので，そちらでのテストをお勧めします． kbTst.cgi でのテストに成功した場合，この項目は飛ばして 7. CGI動作テストに進んでください．

kbTst.cgiによるテストがお勧めなら，何故この項目ごと削ってしまわないかというと．．． kbTst.cgiがまだなかったころの名残りです．^^;

まずは送ったファイルが壊れてないかどうかのチェックをします． telnetしてログインし，kb.cgiのあるディレクトリへ行ってから，

perl -c ./kb.cgi

と打ち込んでください．

./kb.cgi syntax OK

と表示されればOKです．もしエラーメッセージ（parse error in ～など）が表示されたら， kb.cgiのPerlのパス以外の部分を書き換えてしまってないか，漢字コードがSJISになってしまっていないかチェックしてください．

7. CGI動作テスト

では，試しに動かしてみましょう． index.htmlにアクセスし，タイトル一覧を表示をさせたり，テスト掲示板に書き込んだりしてみてください．ちゃんと動きましたか?

6. 初期動作テストに成功したのにエラーが出た人は，各種ファイルのモード（パーミッション）を疑ってみてください．初期動作テストができなかった人は，加えて kb.cgiのPerlのパス以外の部分を書き換えてしまってないか，漢字コードがSJISになってしまっていないかも，チェックしてください．

8. カスタマイズ

ここまでで，プログラムが正しく動作することが確認できました．では次に，あなたの好みに合わせて掲示板の機能，見た目，メッセージ等を変更しましょう．一部，必ず変更しなければならない場所がありますので，「このままでいいや」と読み飛ばしたりしないでくださいね．(^_^;

基本的なカスタマイズのために必要な操作は，設定ファイルkb.phの書き換えだけです（高度なカスタマイズについては，インストール後， MAINTENANCEドキュメントを参照してください）．

あなたのパソコンにあるkb.phを（プロバイダに送信したからって，消しちゃ駄目ですよ．いざという時のために，とっておいてくださいね）適当なエディタで開き，ファイルの中身を見てみてください．この時，漢字コードが日本語EUCのファイルを正しく表示できるエディタを使ってください． Win95/Win98なら秀丸エディタ（お金がかかりますが……）， K2Editor， Perl Editor， copalなど（情報をくださった綾乃介さん，感謝です）． Macなら Jedit など．現在パソコンに付属しているエディタのほとんどは，残念ながら漢字コードがSJISでないと正しく表示できません．．．

もしも上記エディタがどうしても手に入らない人は， FTPソフトウェアでkb.phを取ってくる時に，漢字コードを日本語EUCからSJISに変換するようにして，取ってきてみてください（もちろん，お使いのソフトウェアにその機能があれば，ですが……）．うまくいけば，パソコン付属のエディタでも正しく表示できるかもしれません．

うまくエディタで開けたら，kb.phを書き換えて，きのぼーずをあなたのサイト用に設定し直してください．設定の詳細はファイルに書かれています．特に変更が必要なのは，

管理者の名前（$MAINT_NAME）
管理者のメイルアドレス（$MAINT）
掲示板システムの名前（$SYSTEM_NAME）

です．忘れずに変更してくださいね．(^_^;

ただし! 記事の削除，訂正やメイル送信先の設定等の，管理用のコマンドを使えるようにするか否かを設定する以下の部分は，ここでは絶対に変更しないでください．

#
# これ以下のコマンドは必ず，
# 「正しくアクセス制限をかけた上で」利用してください．
# でないと破壊的な悪戯を匿名でやられ放題ですからね．
#
# [注意] スクリプトの名前を変えたくらいじゃ駄目ですよ．(^_^;
#
$SYS_F_D = 0;			# 記事の削除，訂正
$SYS_F_MV = 0;			# 記事の「前後順序/元記事-リプライ関係」の変更
$SYS_F_AM = 0;			# 新着記事到着時のメイル送信先の設定

理由は，コメントとして書いてある通りです．気をつけてくださいね．この設定は，（必要なら）後に「11. 機能特別版のkb.cgiプログラムを作る」で行います．

ちなみに，このkb.phでカスタマイズ可能な各種機能をブラウザから設定可能にしてしまうツールがあります． kbTst.cgi の作者，綾乃介さんの，きのぼず/1.0 WWW設定ツール kbconf です．是非一度画面サンプルを見てみてください．綺麗で機能的．なひにはないセンスです．．．なひの能力不足で未だパッケージに含めるまでには至っていませんが，とても便利なツールです．掲示板が増えてきたり， kb.phを直接いじるのに疲れてきたら，是非導入にトライしてみてください．

変更が終わったら， FTPソフトウェアでkb.phをプロバイダに送信してください．モード（パーミッション）の設定も，再度行なってください．先程kb.phを取ってくる時に漢字コードを日本語EUCからSJISに変換した人は， SJISから日本語EUCに変換し直すようにして送ってくださいね． kb.phの漢字コードは，必ず，日本語EUCでなければいけません．

9. 設定ファイルテスト

書き換えた設定ファイル，kb.phのテストをしましょう． 6. 初期テストと同じく， kbTst.cgi を使ってテストしてください．プロバイダにtelnetできる人は，以下の方法でもテストできますが， kbTst.cgi は大変便利なので，そちらでのテストをお勧めします． kbTst.cgi でのテストに成功した場合，この項目は飛ばして 10. カスタマイズ掲示板動作テストに進んでください．

telnetしてログインし，kbディレクトリへ行ってから，

perl -c ./kb.ph

と打ち込んでください．です．「syntax OK」と表示されればテストは成功です．

もしエラーメッセージ（parse error in ～など）が表示されたら， kb.phの書き方がどこか間違っている，ということです．エラーメッセージの中に，間違っている行番号が書かれていますよね? 例えば

parse error in file kb.ph at line 106, next token "～

だったら，106行目付近が間違っているという意味です． kb.phの106行目付近をチェックしてください．特に，必要な「,」や「'」を間違って消してしまったりしがちですので，注意してください．

10. カスタマイズ掲示板動作テスト

7. CGI動作テストと同じく， index.htmlにアクセスして，カスタマイズした掲示板が正しく動作することを確認してください． 7. CGI動作テストと 9. 設定ファイルテストのテストに成功していれば，ここまで来てエラーが出ることはないはずです．カスタマイズが気に入らなければ， 8. カスタマイズからやり直しましょう．

これで一通りの設定は終わりです．お疲れさまでした．しばらくきのぼずで遊んでみてください．

11. 機能特別版のkb.cgiプログラムを作る

ここまでで，掲示板運営に必要な最小限の機能は揃っています．ので，以降のインストールは特にやらなくても構いません．見ての通り長いし，それにアクセス制限とか，結構設定が面倒ですし……．

8. カスタマイズでkb.phを変更した際，一部の機能は必ずオフにしてくださいと書きました．普通に考えれば，せっかく用意されている機能なんですから，わざわざ「利用不可」になんてしたくないですよね．

では何故，「利用不可」にできるようになっているのか…… それは，ウェブサーバのアクセス制限機能を使うことによって，

管理者だけに，管理機能（記事の訂正や削除，メイル送信先の設定）を使うことを許す．
許された一部の人達だけが書き込みできるようにする（その他の人は読むだけ）．

を実現するためなのです．例えばこの場合は，

管理機能を使えるkb.cgiプログラムを作り，管理者だけがアクセスできるディレクトリに置く．
通常のkb.cgiは書き込み不可としてインストールしておいて，書き込み機能が使えるkb.cgiプログラムを，一部のユーザだけがアクセスできるディレクトリに置く．

ことで，必要なシステムを得ることができます．

前置きが長くて失礼しました．ではそろそろ，具体的なインストール方法に入りましょう．ただしCGI環境が「2. CGIプログラムは決まったディレクトリに置く」環境の場合，以下のやり方では，アクセス制限をかけられないんじゃないかと思います．プロバイダによってやり方が異なると思いますので（もしかしたら，アクセス制限のできないプロバイダもあるかも……），詳しくはプロバイダの利用案内やFAQを見たり，問い合わせたりしてください．

基本的に，ディレクトリを作ってそこにアクセス制限をかけ， kb.cgiとkb.phをコピーして，kb.phを書き換える，という作業になります．

新たにkb.cgiを置くディレクトリを決めます．ここでは管理者専用のkb.cgiを作ってみましょう．

例)

~nahi （nahi用ディレクトリ）
   |
   +-- public_html （WWW用ディレクトリ）
           |
           +-- kb （きのぼーず1.0用ディレクトリ）
                 |
                 +-- priv （管理者用kb.cgiを置くディレクトリ）

ディレクトリにアクセス制限をかけましょう．
ここでは管理者専用のkb.cgiを作るので，もしあなたが，あなたしか使えない専用のマシンを持っているなら，そのマシンからのみアクセスできるように設定しましょう．そうでないなら，パスワードによるユーザ認証を行なうように設定します． .htaccessや.nsconfigといったファイルの設定が必要ですが，この設定方法もサーバの種類に依存します．市販の参考書やウェブサイトを参考にするか，プロバイダの利用案内やFAQを見たり，問い合わせたりしてください．
FTPソフトウェアで，すでにインストール済みのkb.cgiとkb.phを自分のパソコンに取ってきましょう．そして8. カスタマイズを参考に，取ってきたkb.phを設定し直してください．
8. カスタマイズでは「利用可能にしてはダメ」と書いた管理機能（記事の訂正や削除等）ですが，ここでは利用可能に設定してみましょう．
FTPソフトウェアで，書き換えたkb.phを，サーバ内の，新たに作ったディレクトリに送ってください．
もう動くはずです．新設したkb.cgiのURLに続けて「/(きのぼーず1.0ディレクトリのURL)?(コマンド指定)」を加え，アクセスしてください．上の例なら，
- kb.cgiのURLが「/~nahi/kb/priv/kb.cgi」，
- きのぼーず1.0ディレクトリのURLが「/~nahi/kb」，
- 例えば，trial掲示板（b=trial）の記事を表示させるには，
- 「/~nahi/kb/priv/kb.cgi/~nahi/kb?b=trial」にアクセスします．
最後に，アクセスを許された以外の人（ここではあなた以外の人）が，新設したkb.cgiにアクセスできないことを確認しましょう．もし他の人にアクセスできるようだと，悪戯のし放題になってしまいます．もちろんこのプログラムによって生じたいかなる不都合に関しても，私は責任を取れません．

長々と御苦労様でした．これで機能特別版kb.cgiの出来上がりです． KINOBOARDS/1.0の様々な機能が，あなたのウェブサイト作成のお役に立てることを祈ってます．

12. メイル投稿機能を使う

きのぼずでは，コマンドラインから，

% kb.cgi 掲示板ID POST

のように起動したコマンドの標準入力に対してメイルを流し込むと，指定した掲示板に対して記事を新規投稿することができます．残念ながら今のところ，リプライを投稿することはできません．使い方によっては便利な機能ですが，設定を間違うとエラーメイルを引き起こし，各地の管理者さんに御迷惑をおかけすることになってしまいます．くれぐれも，慎重に設定してくださいね．

また，後で詳しく書きますが，あなたが管理者権限を持っていない場合，この機能が使えるか否かは，管理者さんの設定次第です．もし動かないようでしたら，管理者さんに相談してみてください．

もしあなたが管理者権限を持っている場合，つまり管理者なら， /etc/aliasesに
```
post-kb: "|/home/nahi/public_html/kb/kb.cgi test POST "
```
というエントリを追加してください．「post-kb」がメイル投稿用の宛先（変更しても構いません），「/home/nahi/public_html/kb/kb.cgi」がkb.cgiの絶対パス，「test」が掲示板IDです．「POST」はそのまま入力してください．こうすることによって，post-kb宛の全てのメイルが，自動的にtest掲示板に投稿されるようになります．
掲示板IDはkinoboardsファイルで設定します． kinoboardsファイルについては，「メンテナンス: 掲示板を新設する」を参照してください．
管理者権限を持っていない場合は，あなたのホームディレクトリの.forwardというファイルに，以下のように記述してみてください．
```
\nahi, "|/home/nahi/public_html/kb/kb.cgi test POST_IF "
```
「nahi」はあなたのメイルアカウント（nahiのままじゃ駄目ですよ ^^;），「/home/nahi/public_html/kb/kb.cgi」がkb.cgiの絶対パス，「test」が掲示板IDです．「POST_IF」はそのまま入力してください．こうすることによって，あなた宛のメイルが自動的にtest掲示板に投稿されるようになります．
ただし! 全てのメイルが投稿されてしまうわけではありません（そんなことになったら大変だ ^^;）．メイルのヘッダもしくは本文中に，行頭から「x-kb-command: POST」と書かれているメイルのみ，投稿されます．メイル投稿したい場合は，自分宛にメイルを書き，その本文中に「x-kb-command: POST」という行を入れてください．
上記の設定で，「～なんてユーザは居ないよ」というエラーメイルが返ってしまった方が居るそうです．その方の場合は，
```
post-kb: |"/home/nahi/public_html/kb/kb.cgi test POST "
```
と，「"」の位置を変更したら，うまくいったとのこと．もし同様な症状の方がいらしたら，試してみてください．

.forwardファイルに上記設定を行なって上手くいくかどうかは，そのサイトの管理者さんの設定次第です．そのサイトのメイルホストにあなたのホームディレクトリがマウントされていて，かつMTAがホームディレクトリの.forwardを参照するように configureされていなければなりません．．．

正直なところ，一般のプロバイダでこのような設定になっているところは少ないんじゃないかと思います．

13. kbTst.cgiできのぼず実行環境テスト

きのぼずのパッケージには，綾乃介さん（aya@big.or.jp）が作ってくださった， kbTst.cgiというCGIプログラムが含まれています（圧縮パッケージを展開したときに作成される toolsディレクトリの中に含まれています）． kbTst.cgiは，きのぼずの実行環境をテストするためのCGIプログラムです． kb.cgiと同じディレクトリにインストールし，ブラウザからアクセスするだけで，きのぼずが正しく動作するための準備が整っているかどうかをチェックしてくれます．

では実際に動かしてみましょう．

kbTst.cgiというファイルの先頭行には， kb.cgiと同じく， perlというプログラムのパスが書かれています．予め一般的な設定がされていますが，調べて正しく設定しなければなりません．

perlのパスがわかったら，kbTst.cgiを書き換えます．パッケージのtoolsディレクトリに含まれているkbTst.cgiを適当なエディタで開いて，先頭行を書き換えてください．「#!」に続けて，perlのパスを書き込みます．

例: Perlのパスが/usr/bin/perlだった場合

#!/usr/local/bin/perl → #!/usr/bin/perl

この時，間違えて先頭行以外を書き換えたり，漢字コードを変更してしまったりしないようにしてください．

書き換えが終了したら，kbTst.cgiを，プロバイダ（ウェブサーバ）の，kb.cgiと同じディレクトリに送信してください．この時，kbTst.cgiのモード（パーミッション）は755にしてください（もしエラーが出るようなら，700や705も試してみてください）．

ここまでで設置完了です．ウェブブラウザから，kbTst.cgiにアクセスしてみてください．きのぼずが正しく動作するための準備が整っているかどうかの診断結果が，ブラウザの画面上に表示されます．たくさんの項目についてチェックしてくれますが，もし「エラー」と表示された項目があったら，表示されるアドバイスに従って設定をチェックしてみてください．

きのぼずのサポート掲示板でも，みなさんからの「インストールできない!」という問題の多くが，このkbTst.cgiによって解決されています．ほんとに便利なツールです．このような大変便利なツールを，きのぼずのパッケージに含めてみなさんに配布できることを，大変光栄に思います．綾乃介さん，どうもありがとうございました．

B. バージョンアップインストール

古いKINOBOARDSをバージョンアップをするには，プロバイダのマシンにtelnetできる必要があります． telnetできない人は……基本的に，古いバージョンの時に書き込まれた記事は諦めてください．

古いシステムの掲示板ディレクトリを全部自分のパソコンにFTPでもってきて，次に新しいシステムにFTPで送り直せばいいんですが…… 記事ファイルは大量にあるし…… それが面倒でない方は，チャレンジしてみてください．(^_^;

telnetして旧システムのkbディレクトリへ行き，念のためバックアップを取ってください．もし記事が消えたり，設定が変わって動かなくなっても，責任は取れません(^_^;．バックアップは必ず取っておいてくださいね．
```
cd ~/public_html/kb		← KINOBOARDSをインストールしてあったディレクトリへ
chmod a-x kb.cgi		←kb.cgiの実行権をなくす
cd ..
tar cvfp kb10_old.tar kb
```
できたkb10_old.tarがバックアップファイルなので， gzipで圧縮し，消さずに残しておいてください（gzipで圧縮すると，ファイル名はkb10_old.tar.gzになります）．
```
gzip kb10_old.tar
```
KINOBOARDSを新しくインストールするため， kbのディレクトリの名前を，古いものであるとわかるように変更してください．
```
cd ~/public_html		← KINOBOARDSをインストールしてあったディレクトリへ
mv kb kb_old
```
新しいバージョンのKINOBOARDSを， kbディレクトリにインストールし直してください．

新しくインストールしたKINOBOARDSのディレクトリ（kb/）から，掲示板ディレクトリ，「kinoboards」ファイル，「kinousers」ファイルを削除してください．

cd ~/public_html/kb		← 新しくインストールしたKINOBOARDSへ
rm -rf test			← test掲示板を削除
rm -rf board			← board掲示板を削除
rm kinoboards			← 登録掲示板情報を削除
rm kinousers			← ユーザエイリアス情報を削除

古いバージョンのKINOBOARDSから，掲示板ディレクトリ，「kinoboards」ファイル，「kinousers」ファイルをコピーしてください．

cd ~/public_html/kb		← 新しくインストールしたKINOBOARDSへ
cp -pr ../kb_old/test test	← test掲示板をコピー
cp -pr ../kb_old/board board	← board掲示板をコピー
 :				← インストール後に作成した掲示板があれば，
 :				← 同様にコピーしてください．
cp -p ../kb_old/kinoboards .	← 登録掲示板情報をコピー
cp -p ../kb_old/kinousers .	← ユーザエイリアス情報をコピー

R5.4以前と最新のバージョンでは，一部使用しているファイルの名前が違います． R5.4以前のシステムからバージョンアップする場合，ファイル形式の変換を行う必要があります．パッケージ中のtoolsディレクトリにconv.cgiというperlプログラムを用意したので，これをkbディレクトリにコピーしてから，起動してください． conv.cgiもperlで書かれていますので， kb.cgiと同じく，先頭行のperlのパスを必要に応じて書き換える必要があります．

                                   まずconv.cgiをkbディレクトリにコピーする
cd ~/public_html/kb		← 新しくインストールしたKINOBOARDSへ
./conv.cgi			← 変換プログラムを起動
rm conv.cgi                     ← 実行してしまったら削除する

このプログラムは名前の通り， CGI scriptとしてブラウザから起動してもかまいません．以下のような表示がされれば終了です．

Content-type: text/plain			← conv.cgiの表示

rename: test/.db -> test/kb.db			← 名前が変更されたことを示す
rename: test/.board -> test/kb.board
rename: test/.articleid -> test/kb.aid
rename: board/.db -> board/kb.db
rename: board/.board -> board/kb.board
rename: board/.articleid -> board/kb.aid
older release -> R5.6 conversion succeeded.	← succeededと表示されれば成功
Renamed 6 file(s).				← 6つのファイルが変更された

以上でバージョンアップは終わりです．正しく動くかどうか試してみてください．