TITLE インストール
HD 2 ダウンロード
LINK http://www.morito.mgmt.waseda.ac.jp/~tom/TomSoft/TsDiary/dist/ TDS ダウンロードページ
から最新版をダウンロードしてください。
tar.gz 形式と lzh 形式があります。

また、以下の場所でもミラーを行っています。

UL
LI
http://rainbow.morito.mgmt.waseda.ac.jp/users/tom/TDS/dist/ 
LI
http://lightning.prohosting.com/~tom-t/TDS/dist/ 
LI
http://www.na.rim.or.jp/~ah0k/TDS/ 
LI
http://www.pluto.dti.ne.jp/~kuchiki/TDS/
LI
http://www.idrive.com/kuchiki/web/TDS/ (直接ファイル名)
LI
http://www.idrive.com/kuchiki/ (ゲストログイン)
LI
ftp://ftp.morito.mgmt.waseda.ac.jp/pub/www/tds/
LI
ftp://ftp.dive-in.to/pub/tds/
/UL

開発版は
LINK http://www.morito.mgmt.waseda.ac.jp/~tom/TomSoft/TsDiary/dist/current/ current/ 以下に、
安定板は
LINK http://www.morito.mgmt.waseda.ac.jp/~tom/TomSoft/TsDiary/dist/stable/ stable/ 以下に
格納されています。
最新版は
LINK http://www.morito.mgmt.waseda.ac.jp/~tom/TomSoft/TsDiary/dist/ 直下に
置かれています(sym.link)。
未リリース版のスナップショットは、
LINK http://www.morito.mgmt.waseda.ac.jp/~tom/TomSoft/TsDiary/dist/current/snapshot/ snapshot/ 以下に
置かれています。
tar.gz 版と lzh 版を用意してありますので、
環境に合わせてお選び下さい。

HD 2 インストール
まずパッケージを展開します：

CODE
% tar zxvf tds-1.01-pl0.tar.gz
/CODE

lzh 版なら：

CODE
% lha x tds-1.01-pl0.tar.gz
/CODE

展開されたディレクトリに移動し、
install.pl という perl script を実行します。

CODE
% cd tds-1.01-pl0
% perl install.pl
/CODE

まず、前回の設定（初めてのインストールの時はデフォルト）が表示されますので、
それで良ければ 'y', 変更するのなら 'n' を入力してください。
日本語環境
FN
正確には環境変数 LANG が /^ja/ にマッチするかどうかで判断しています。
/FN
であれば日本語でメッセージが表示されます。
明示的に日本語表示を指定するには、
-j オプションをつけて下さい。

CODE
TomsoftDiarySystem 1.01-pl0 installation...

before installation, please read install document(doc/install.html).
  Perl の絶対パス                                       /usr/bin/perl
  sendmail のバス                                       /usr/sbin/sendmail
  CGI が使えるか                                        no
  SSI が使えるか                                        no
  タイムゾーン                                          JST
  日記タイトル                                          Foo's Diary
  著者名                                                Foo
  メールアドレス                                        foo@bar.com
  日記の URL                                            http://www.foo.com/~foo/diary/
  web でアクセスされるディレクトリ                      /home/foo/public_html/diary
  カスタマイズファイル用ディレクトリ                    /home/foo/public_html/diary
  日記ソースファイルを置くディレクトリ                  /home/foo/diary
  動作モード                                            static
  アクセスログを取るか                                  yes
  クッキーを食べさすか                                  no
  キャッシュ機能を使うか                                yes
OK [yN]:
/CODE

'n' と答えると、
以下のような質問がされるので、
適宜応えて下さい。
空リターンを入力すると、
デフォルト値がセットされます。

UL
LI
BOLD Site Setting
BR
不明な場合は管理者に問い合わせて下さい。

DL
DT perl path
DD perl のパス
DT sendmail path
DD sendmail のパス。mail2tdf を使わなければ特に必要ない
DT can use CGI
DD CGI が使用可能か
DT can use SSI
DD SSI(Server Side Include) が使用可能か
DT time zone
DD タイムゾーン
/DL
/LI

LI
BOLD Base Setting
DL
DT title of diary
DD 日記のタイトル
DT URL of diary
DD 日記の URL
DT author name
DD 著者の名前
DT mail address
DD 著者のメールアドレス
DT web diary dir
DD Web 日記を置くディレクトリ。httpd からアクセスできる場所
（~/public_html などの下）を入力して下さい。
静的モードならば，
サーバにアップロードされるディレクトリを入力してください
先頭の ~/ は $ENV{'HOME'} に変換されます。
以下、
ITALIC web_diary_dir
と記します。
DT customize dir
DD カスタマイズ可能なファイル群を置くディレクトリ。
特に気にしなければ、空リターン(web diary dir と同じ)で構いません。
以下、
ITALIC customize_dir
と記します。
DT diary dir
DD 日記ソースやデータファイルを置く場所。
相対ディレクトリを入力した場合は、
ITALIC web_diary_dir
が基点となります。
以下、
ITALIC diary_dir
と記します。
/LI

LI
BOLD Mode Setting
DL
DT mode
DD 動作モードは何か？static か dynamic かのいずれかを選択する。
CGIが使えない場合は、自動的に static
/LI

LI
BOLD Log, Cookie, Cache Setting
DL
DT enable accesslog
DD アクセスログを記録するか
DT enable cookie
DD クッキーを投げるか
DT enable cache
DD キャッシュ機能を有効にするか
/DL
/LI

/UL

入力が終わると再び確認の画面になりますので、
'y' を入力すると、インストールを開始します。

途中にいくつかの質問をきいてきます：

DL
DT .htaccess enable [Yn]:
DD .htaccess が有効かどうか。
分からなければ管理者に聞くか、
y と入力してください。
/DL

パスワードもきかれますので、
適切に入力してください。

インストールが終了すると、

CODE
### install successed. ###
thank you for using TDS.

if you want to customize,
do

 % cd d:/tom/www/tawagoto_static
 % perl customize.pl

please access tds enquate page (http://www.morito.mgmt.waseda.ac.jp/~tom/TomSoft/TsDiary/enquate.html),
and let me know your answer.
it encourages me very much ^^)
magi@~/www/tds%
/CODE

と出力されます。

ITALIC web_diary_dir
 以下の conf.ph に設定が保存されます。
設定情報は ~/.tdssetup に保存されます。

HD 3 二回目以降のインストール
HD 4 質問されない項目
二回目以降のインストールでは、
以下の項目はきかれません：

UL
LI 日記タイトル
LI 著者名
LI メールアドレス
LI 日記の URL
/UL

変更したい場合は、
customize.pl をご利用下さい。

HD 4 ファイル上書き確認
前回インストールされたファイルの上書きの確認を求められます。
特に独自の変更を加えていなければ全て y で構いません。

DL
DT update Makefile [Yn]:
DD webdir 上の Makefile を上書きするか。
DT
ITALIC /home/foo/public_html/diary/admin/index.html
overwrite ? [Yn]:
DD admin のページを上書きするか。
DT
ITALIC /home/foo/public_html/diary/admin/editor_skelton.html
overwrite ? [Yn]:
DD admin 以下の各種編集用スケルトンファイルを上書きするか。
DT
ITALIC /home/foo/public_html/diary/admin/log_skelton.html
overwrite ? [Yn]:
DD ログ解析用スケルトンファイルを上書きするか。
DT overwrite .htaccess [Yn]:
DD .htaccess を上書きするか
DT update skeltons(template.ph, *skelton.html) [Yn]:
DD 各種カスタマイズファイルを上書きするか
DT update styles/ [Yn]:
DD スタイル群を上書きするか
DT update user agent conf file [Yn]:
DD UA設定ファイルを上書きするか
/DL

HD 3 install.pl のオプション
CODE
% perl install.pl [-uy] [-f filename] [-r filename]

  -f filename  setup file
  -r filename  readonly setup file
  -j           use japanese
  -u           unload setup file
  -s           user setup
  -y           yes
/CODE

HD 2 ユーザ共有環境のインストール
HD 3 システムのインストール

TDSを複数のユーザで共有する場合のインストール方法についてです。

まず、sh configure を実行します。
すると、perl, sendmail のパスが自動的に検知されます。

CODE
% pwd
/tmp/tds-1.01-pl0
% ./configure
/CODE


その後、ルートになって、make install します。
唯の make は
STRONG する必要がありません。

CODE
% su
password: XXXXXX
# make install
...
/CODE

ファイル一式が ${TDS_ROOT} 以下にコピーされます。
その後、${TDS_ROOT}/site_conf.ph を環境に合わせて変更してください。

CODE
# cd /usr/local/share/tds
# cat site_conf.ph
package TDS::System;
$CanUseCGI = 0;
$CanUseSSI = 0;
$CGIasOwner = 0;
$TZ = 'JST';
$PerlPath = "/usr/local/bin/perl";
$SendmailPath = "/usr/lib/sendmail";
$TDS_Root = "/usr/local/share/tds";
1;
/CODE

HD 3 tds-setup
ユーザ環境を作成／更新する場合は、
そのユーザ権限で、tds-setup を実行してください。

CODE
# su foo
Password: *******
% whoami
foo
% tds-setup
...
/CODE

それらの質問に答えれば、セットアップが完了します。

tds-setup では、
システム固有の設定（$CanUse* など）については
質問されません。

COMMENT
今までと違う質問項目として、

CODE
_UseSharedLibrary:"use share library: ($TDS::System::TDS_Root/lib)"
/CODE
というのがあります。

これは、自分の webdir/lib 以下にライブラリをコピーせず、
/usr/local/share/tds/lib を使うかどうかです。


共有ライブラリを使えば、その分ディスクスペースも節約できるし、
各ユーザが自分でヴァージョンアップをする必要がありません。

が、あるヴァージョンアップが、各ユーザの webdir 以下の
*.cgi, *.pl の更新を必要とする場合、問題が生じます。
ライブラリをあげても、ユーザの cgi が古いと
エラーストップが生じる恐れがあります。
/COMMENT

################################################################
HD 2 同一ユーザの複数の日記のインストール
同じユーザが同一のアカウントで複数の日記を別々の URI に設置したい場合は、
使用する .tdssetup を別にすることで対応できます。

現在、perl install.pl によりメインの日記がインストールされているとすると、
そのインストール情報は ~/.tdssetup に記録されています。
ここで二つ目のサブの日記を設置したい場合、

CODE
% perl install -f ~/.tdssetup_sub
/CODE

とすることにより、インストール情報を別のファイルに記録する事ができます。
これによりヴァージョンアップの管理等がやりやすくなります。

もしくは、上記のユーザ共有でインストールを行い、

CODE
% tds-setup -f ~/.tdssetup_sub
/CODE

などとすることもできます。


HD 2 サーバへのアップロード
静的モードを利用し、かつサーバで CGI を使わない場合は、
サーバにシステムをインストールする必要はなく、
日記 HTML ファイルのみをアップロードすればいいです。

動的モードを利用する場合、あるいは静的モードでも
検索等の CGI を利用する場合は、
サーバに TDS をインストールしなければなりません。
サーバに telnet できるのなら、
サーバ上でインストールを行えばいいのですが、
telnet できない場合は、
ローカルでサーバの設定とあわせてインストールした後、
それらをアップロードすればよいでしょう。
ITALIC web_diary_dir
, 
ITALIC diary_dir
 は、相対パスを使うほうが良いでしょう。
なお、
ITALIC web_diary_dir
 は、インストール時のみ使用し、
システム内部では用いられません。

HD 2 ヴァージョンアップ
HD 3 0.01 系からのヴァージョンアップ
0.01 系のがそのまま使えるファイルは、

UL
LI CCYY/MM/DD.tdf などの日記ファイル
LI dat/*.dat の各種データファイル
/UL

です。
両者とも diary_dir にディレクトリごとコピーすると良いでしょう。

conf.ph は書式が大幅に変わったので、再利用できません。
今まで conf.ph で設定していた $manager_cookie_id は、
conf/author_id.txt に、
$except_user_agent は 
conf/user_agent.conf に記述します。

作業例：
CODE
% cd ~/public_html
% mv diary diary-0.01
% cd /tmp/tds-1.00-alpha0
% perl install.pl
...
web diary dir: ~/public_html/diary
diary dir: ~/diary
...
% cd ~/public_html/diary-0.01
% cp -r 199* dat ~/diary
/CODE

あとは、skelton.html, conf/author_id.txt などを編集して下さい。

HD 3 1.00 系からのヴァージョンアップ
以前の設定が ~/.tdssetup に保存されているため、
前の設定を維持することができます。
変更がある場合のみ、
適宜入力し直して下さい。

*skelton.html は上書きの確認を求めますので、
適宜答えて下さい。

% perl install.pl -y と y option をつけると、
すべての設定を前回のまま承諾とみなし、
質問をせずインストールします。
が、初めてヴァージョンアップする時は、
-y をつけないで行ってください
（上書きの確認をするため）。
