; たかのちゃっと TCPS ; ; TCPS Version 6.13 ; ; Copyright (C) 1997-2001 Takano Yuji takachan@running-dog.net All rights reserved. 「たかのちゃっと」マニュアル ************** 高野有司 作成 1997/09/23 更新 2001/06/12 ************** このマニュアルは「たかのちゃっと」の Version.6.13 のリリースマニュア ルです。また、管理者の為の管理、運用、メンテナンスに付いて書かれたマニュ アルです。利用するにあたり、関連するマニュアル、説明書、コピーライトな どのファイル群を熟読してください。 o メニュー。 1. 「たかのちゃっと」とは # 2. シェアウェア「たかのちゃっと」に付いて 3. 「たかのちゃっと」仕様 4. 「たかのちゃっと」のサポート 5. 「たかのちゃっと」の出来るまで 6. 「たかのちゃっと」の今後 7. 「たかのちゃっと」インストール運用マニュアル（購入者のみ提供します） 8. 「たかのちゃっと」改版履歴 **************** 1. 「たかのちゃっと」とは 　世の中の Web サイトには httpd を利用し、ブラウザでいろんな人とお話が 出来るちゃっとシステム「ウェブチャット」と呼ばれるものが多数存在します。 「たかのちゃっと」（以下、TCPS(Takano Chat Package System)と呼びます） もその一つです。 　TCPS は高負荷のウェブサイトに実装しても耐え得る早さと軽さを目指して 作られた高機能ウェブチャットです。 o 基本的な動作、作りはそのままに、config ファイルの設定を変更するだけ でカスタマイズが可能である。 o 以下のプラットホームでの動作を保証します。 SunOS4.1.4 Solaris2.5 以上 FreeBSD2.1.5-R 以上 i386 WindowsNT4.0 SP4 i386 Windows2000 SP1+Cygwin o 以下の httpd サーバで動作を保証します。 -. UNIX 上の動作確認 apache-1.2.6 以上 -. Win32 上の動作確認 *1 apache-1.3b3 for Win32 apache-1.13.19 IIS(PWS)3.0 ※Windows2000 上の IIS では動作確認が取れませんでした。 o 記述言語は perl です。 -. perl4.036 は動作保証が無くなりました。 -. perl5 以降 perl5.005 で動作確認済。TCPS-6.00 からは、perl のデェ フォルトパスは /usr/bin/perl になりました。 o その他 UNIX 系：tail コマンドが必要 Win32 系： Cygwin が必要 *1 他 CPU チップは cygwin 等のコマンド群を用意する事により対応可能。 また、IIS(PWS)3.0 上での動作はかろうじて動く様です。私の PC では WinNT4.0WS を再インストールしたら動く様になりました。もしかしたら VC++5.0 が悪さをしているのかも。(1998/03/14 現在) *2 CGI 中では flock を使用している為、SVR4 系の OS の perl4.036 では動 作しないと思われます。その時は perl5.003 以上を利用してください。ま た、perl for Win32 では、PW32i315.exe 以降のバージョン対応です。 TCPS-5.00 からは perl5 が必須となりました。推奨は perl5.005 以上です。 **************** 2. シェアウェア「たかのちゃっと」に付いて オープンソースにしようかな・・。欲しい方居ましたら連絡ください。 **************** 3. 「たかのちゃっと」仕様 TCPS は管理人が自分の思い通りにいろいろな設定が可能となっています。 以下はその機能のリストです。 o ちゃっとルーム名、ディレクトリ名は任意の名前が設定可能 一つのサーバ上（ドメイン）で複数のちゃっとルームを開設する時、 この設定を変更するだけで、複数のちゃっとルームが作成可能です。 o ちゃっとの生データは任意のファイル名が設定可能 皆さんの会話は一つのファイルに溜ります。それが生データファイル ですが、この設定を変更するだけでお好きな名前が付けられます。 o login/logout 履歴ファイル名は任意の名前が設定可能 ちゃっとルームへの login および logout 時にその人の履歴情報が 保存されます。その保存するファイル名を設定します。 o login リストディレクトリ名は任意の名前が設定可能 ちゃっとルームに login した時、その人のハンドル名等を保存する ファイルを作成しますが、そのファイルを格納するディレクトリ名を 設定します。 o login 時間の指定は任意の時間が設定可能 TCPS は上記の通り、login した時にファイルを作成します。そのファ イルを削除するタイミングは正常に logout した時です。正常に logout しなかった場合、最後に書き込みした時間から、この設定で 指定した時間後に、login 時に作成したファイルを消します *1。 o ちゃっと名とメッセージは任意の文字列が設定可能 例えば http://www.running-dog.net/chiba/ をご覧になってもらっ た場合、"「走るワンちゃんねっと」のメインちゃっと へようこそ" と表示されています。この様にディレクトリ名とは別の任意のちゃっ と名が指定可能です。 o ちゃっとルームのコメントを表示する／しないの設定が可能（マスク機能） 「おたぬきさん」（狸寝入りをする人、アマチュア無線用語でこっそ りと聞き耳を立てる人）対応として追加した機能です。ちゃっとルー ムに login しないとちゃっとに書いてある内容が読めない機能で、 ON/OFF の指定が可能です。 o SYSTEM メッセージを表示する／しないの設定が可能 (Ver 6.10 で機能追加) システムからのメッセージを表示しない様にする事が可能です。結 構すっきりしますがややこしいです;-)。 o コメント間の線(
タグ)を表示する／しないの設定が可能 (Ver 6.10 で機能追加) コメントとコメントの間に線(
タグ)が必要無い場合に指定します。 下のフレームがすっきりします。 o ちゃっと荒し対応機能の充実 -.使用できないタグの設定が可能 IMG タグで有るとか META、FORM 等サーバ負荷の原因となるタグを排 除する機能です。タグは複数個指定可能です。 -.ちゃっとルームに入る事の出来ないドメイン名の設定が可能 ちゃっと荒しのドメインを指定する事によりその人（と、そのプロバ イダを利用している人も(^^;）は login を許可されません *2。 -.login/logout 時リモートドメイン名を表示する／しないの設定が可能 偽名、偽称等はリモートドメイン名により有る程度解決出来ます。 login/logout 時にリモートドメイン名を表示するかしないかの設定 が可能です。 o バックグラウンドの色が自由に選択可能(Ver 6.10 で機能拡張) o ソースコード渡しユーザの方の為のデバック用サブルーチン機能 当然作成時自分が利用しました(^^;;。 これらは複数の CGI と HTML を個々に直す必要は無く、一つの設定ファイ ルの設定を変更する事により簡単に変更が可能となっています。 *1 この仕様により、この時間を過ぎてちゃっとを続けていた場合、ちゃっと ルームに入り直さなければなりません。 *2 荒しがひどい時の最後の切札です;-)。 **************** 4. 「たかのちゃっと」のサポート 最近の TCPS は高速かつ軽いとの評判を頂き、Ver3.xx で安定期に入りまし た。今後は細かい所の作り直し、ちゃっと荒し対応機能の充実を目標にバージョ ンアップを進めて行きます。 ご購入していただいた皆様にはバージョンアップ毎に新しいバージョンのソー スコード一式をお送りします。改造等を施していた場合はその対応は致しませ ん。あしからずご了承ください。 ただし、良い機能であれば、基本となるソースコードに反映して行きたいと 思いますので出来れば無償で提供してください;-P。 サポートにつきしては、たかのまでメールをください。 takachan@running-dog.net 現在、オフィシャルサポートホームページを作成中。また、FAQ を同梱しま した。(98/06/20 現在) TCPS の開発環境、動作確認環境は以下になります。 -. OS FreeBSD2.1.5-RELEASE 以降の各バージョン -. httpd Server Apache1.1.3 以降 Apache1.2.x 以降 Apache1.3.x 以降の各バージョン Win32 系 IIS(WinNT PWS)3.0 Win32 版 Apache1.3.19+Cygwin32 IIS5.0 では perl の path がセットできないみたいで動作していま せん。 -. perl perl5 以降 perl5.005 以降 Win32 版 は Cygwin に同梱の perl を利用 -. Web ブラウザ FreeBSD 版 Netscape 4.7.6 FreeBSD 版 Mozilla-0.8.1 Windows2000 IE5.5 **************** 5. 「たかのちゃっと」の出来るまで こんなの書いてもしかたが無いのですが・・(^^;。 「たかのちゃっと TCPS」製作者 たかの は 1997 年の正月休みがあまりに も暇だったので、ふと、とあるちゃっとに顔を出しました。 その時からちゃっとにはまり出したのですが、そのサイトの web ちゃっと がサーバ負荷に耐えられずサーバエラーの連発で、「こんなんじゃちゃっとが 出来ないっ!!自分で作ってやるっ!!」ってんで作りはじめたのがきっかけでし た。 作成当時はバグも多くリロードがうまく行かなかったり、書き込んだ順序が きれいに並ばなかったり、ロストしてしまったりでした・・。その頃のバージョ ンが Ver.1.xx でした。 その後、改造を加えたりして行ったのですが、今度は過去ログが全部見る事 が出来たりと、セキュリティ面で問題が発生しました。この頃が Ver.2.xx の 世代でした。 セキュリティ強化に力を注いで完成したのが Ver.3.xx でした。この頃にな るとテスターの皆様もアタックを諦めた様でした(^^;。その後は速さを求めて コードを書き換えたりしていきまいした。 この後、Ver3.10、3.20、3.30 とバージョンをあげて行きますが、その頃に なると、たかの の自宅の PC には WinNT4.0 がインストールされ、PWS が動 く様になり、「うん。Win32 へ移植だっ!!」となりました。その後、 Apache for Win32 がβ版ですが、リリースされ、移植は更に拍車が掛かりま す。Ver4.00 は Win32 へも移植が完了しました。これで、一応、マルチプラッ トホーム化を完了しました(^^)V。 Ver4.01 は、Ver4.00 で出たバグのフィックスを行うとともに、MSIE4.01 対応の高速化処理等に力を注ぎました。また、 IIS(PWS)3.0 ででも動作確認 がとれ、現在は動作しています。 Ver5.00 からは perl5 対応のみとさせて頂きました。メモリ管理等が 4.036 よりも優れている為、サーバにやさしいのです。とかく、チャットは嫌 われているのでメモリ消費を少ないモノを選びました。 Ver6.00 は過去ログを閲覧できる機能をプラグインとして提供する様にしま した。今まではチャットとしての機能の充実と言う事でマスクの機能等を組み 込んでいましたが、今後は過去ログが表示出来る様に。等と言う BBS 的方向 に進むのではと思います。 FreeBSD な人々からの仕様要求により、6.00 と 6.10 と作り込んできまし た。6.10 では 萌え萌え対応とでも言いましょうか;-)。そー言えば mule に は[あおい]と言うバージョンがありますね;-)。 6.11 では初めて JAVA スクリプトを利用しましたが、これがなんとっ!!モ ジラでは動作しなかったのであっと言う間に消しました。と、言う事で JAVA スクリプトを利用しているバージョンは 6.11 だけになります。6.12 では JAVA スクリプトは利用していません。 とある方から、URL エンコードはださいやんけ。と、言うお言葉を頂きまし た。確かにダサいですね。なので、バージョン 6.13 では URL エンコードを 使うのをやめました。Cookie を使う事にしました。そして、このバージョン で JAVA スクリプトを復活させました。Netscape では正しく動作してくれま す。Mozilla では動いてくれませんがちゃっとは出来ます。 **************** 6. 「たかのちゃっと」の今後 TCPS は一応安定期に入りました。クッキーも使ってないし Java スクリプ トも使ってない、純粋な perl スクリプトなので安定性、速さでは他の web チャットに負けないと自負しています;-)。 TCPS-6.11 だけは Java スクリプトを使ってしまいました。あれれ;-)。 不正なアクセス等ちゃっと荒し対応は 一応、Ver3.2x 台で完了しました。 Ver4.00 以降はマルチプラットホーム化等、OS を限定しないちゃっとを作って 行きたいと思います。 他、速さを損なわない、よりよい機能、最新技術が見付かればどんどん採用 して行きたいと思います。どうぞ御期待ください。また、採用するべき機能、 技術等ありましたらどしどしお声掛けください。 と、言う事で、Ver6.00 では過去ログの閲覧機能が追加されました。他には 仕様的要求はあるでしょうか？え？スレッド表示？(^^;;。 **************** 7. 「たかのちゃっと」インストール運用マニュアル（購入者のみ提供します） こちらは購入者のみの情報提供となっています。あしからずご了承ください。 連絡先 → takachan@running-dog.net になります。 **************** 8. 「たかのちゃっと」改版履歴 　このマニュアルが出来たのは、Ver3.10 からです。それ以前のバージョンは 製品として成り立たない為、改版履歴が有りません。御了承ください(^^;;。 6.13 とある方から URL エンコードはダサいやんけ。と、メールを頂いたので このバージョンからはその利用をやめた。代わりに Cookie を使う事に した。そして、ちゃっとへの書き込み時には JAVA スクリプトを利用し、 書いた文字列を削除出来る様にした。(2001/06/13) 6.12 Java スクリプトはモジラでは動かない事が判明し、このバージョンから 使うのは止めた。それにしても二回書き込み防止策は必要なのでそのロ ジックを組み込む。忙しくて中々メンテ出来なかったのだがアイデアは sanpei さん から頂いた。(2001/05/15) 6.11 チャットの文を書き込んだ後、フォームからメッセージが消えないのは 面倒だ。と、言うコメントを頂いたので泣く泣く Java スクリプトを埋 め込んだ;-)。このバージョンの改造は、Java スクリプトの埋め込みで ある。(2001/04/12) 6.10 FreeBSD な花見に参加した時に、仕様要求が有ったのでそれを吸収した 版がこのバージョン。下のフレームを表示する為のオプションを増やし た。これにより生データの持ち方の変更も行う。 当初 6.01 にしようかと思ったが、実は改造した所が多かったので、 6.10 としてリリースすることにした。そして、Windows2000 上の apache-Win32-1.13.19 で動作を目視により確認。Win32 は久々に復活で ある。(2001/04/03) 6.00 一年ぶりのバージョンアップである。コードの美しさ、性能の向上など の為ロジック見直しを行いサブルーチン化する。 過去ログ閲覧用プラグインを作成。このバージョンより過去ログの閲覧 が可能になった。perl のパスを /usr/bin/perl に変更。これらの充実 の機能追加によりメジャーバージョンアップとする。(2001/03/26) 5.02 2000 年問題に対応した。後、コピーライトの年号の変更。ドキュメント 整備のみの改変である。(2000/01/15) 5.01 メモリを食いそうなロジックを修正。サーバに優しいちゃっとを心掛け た。コメント表示ルーチンの見直を行う。BGCOLOR の色を設定で変更出 来る様にする。最初に表示するチャット名を茶色から任意の色に変えら れる様にしする。と、言う事で一つバージョンアップである。 (99/05/02) 5.00 FreeBSD 標準添付の perl のバージョンが 5.00502 になりそれに伴い TCPS の開発環境が変更した。このバージョンから perl4.036 での動作 確認はなくなった。実質的にこのバージョンからは perl5 でのみの動作 保証になる。 機能的追加はほとんど何もない。perl5 以上での動作保証。と、言う事 でメジャーバージョンのアップを行う。(99/03/23) 4.02 4.01 で文字化けはしないと思っていたのにまだ文字化けするのでもう一 度徹底的にソースを見直しを行う。また、速さをアップした。細かい所 の修正を行う。(98/09/07) 4.01 4.00 で生まれた虫を取り除く。コメント書き込み時の date 表示を変更。 なんと、このバージョンで、なぁんもしてないのに IIS 上で動いてしま った。と、言う事でこのバージョンから「IIS にも対応」と、うたう事 にした(^^;;。詳細については README.WIN32 を参照。(98/03/14) 4.00 今回のバージョンで UNIX 版はほぼ完成にしたい。Win32 への移植も Apache1.3b3 と言う httpd ではあるが動作確認済で一応移植は成功した。 TCPS はバージョン 4.00 にしてマルチプラットホーム対応である。後、 かねてからの懸案であった、同一窓からの複数ブラウザによるアクセス を可能とした。 これら充実の機能拡張によりメジャーバージョンのアップである。 (98/02/15) 3.50 実はこの間に 3.30 と言うバージョンが存在していたのだが日のめを見 る事は無かった。主にファイル回りの制御に力を注いだバージョンであっ たが、いまいち不安定要素が多かった。 今回のバージョンではこのファイル回りのバグをフィックスし、なおか つ、機能追加として、現在の参加者リストを表示する様にした。二つほ どマイナーバージョンがアップした。(98/01/30) 3.20 引続き、ダサいロジックの変更（ダサダサなちゃっとやんっ!!て声が聞 こえて来そう(^^;;）と、ちゃっとの使用言語を EUC から ISO-2022-JP へと変更。それによりマイナーバージョンアップとする。(97/11/17) 3.14 以前から「ちゃっとに入れない」と言う声が聞こえていたので、その可 能性があると思われるロジックを修正。今度はだいじょぶっ!! 3.12 前のバージョン同様、ダサいロジックの変更。退出時のファイル削除の ロジックを変更。 3.11 ダサいロジックのコーディング変更。それによりリロード時のスピード アップを計る。 3.10 製品化を目指した完成品第一作目。既にリリースが行われるもユーザは 付かず(g_g)。 ;**************** ; 99. 最後に・・。 ; ; 「たかのちゃっと（TCPS）」発展の為に初期の段階からテストにつき合い、 ; 携わってくださった、はっとさん、えぞさん、れーこさん、まゆりんさん、 ; その他普段からたかのちゃっとをご利用してくださった多くの方々に心から ; 感謝します。ありがとうございました。 ; ; -------- ; たかのちゃっと TCPS Version 6.13 ; Copyright (C) 1997-2001 Takano Yuji takachan@running-dog.net All rights reserved. ; -------- ; ; "TCPS" ShareWare Num NO.00-000000 ; ^^ ^^^^^^ ; ↑ ↑ ; ｜　└シリアル番号 ; └−−リース区分