sb開発研究所よりSerene Bachのアーカイブをダウンロードします。
複数ありますが、以下のような構成になっています。
sb開発研究所で配布しているアーカイブは「tar+gzip」という形式で圧縮されています。
これらのアーカイブを解凍するために別途解凍用のソフトウェアが必要になります。解凍用のソフトウェアに関しては後述の「ソフトウェア」をご参照下さい。
Serene Bachは日記などのウェブログ生成をサポートする統合的なウェブログ管理システムです。
Serene BachはCGIとして動作するスクリプトです。Perlと呼ばれるスクリプト言語で記述されています。
CGI(Common Gateway Interface)はウェブサーバー上でスクリプトによって処理された内容をブラウザに表示する仕組みのひとつです。Serene BachではCGIの仕組みによって、ユーザーからの要求や条件に応じて、適切な内容を表示します。
レンタルウェブログサービスのように、ユーザーが与えられたパスワードでログインすればよい、というシステムではありません。
Serene Bachは一種のプログラムです。状況によって適切な内容をウェブブラウザ上に表示します。
Serene BachをCGIとして動作させるために、Serene Bachのスクリプト一式をご利用されているウェブサーバにアップロードする必要があります。
アップロードの方法としてはFTP(File Transfer Protocol)と呼ばれる形式が一般的です。FTPソフトウェアに関しては、後述の「ソフトウェア」をご参照下さい。
アップロードしたファイルに対して必要な設定を行うとSerene Bachをご利用いただけます。
ほとんどの場合、Serene Bachをウェブサーバ上にアップロードしただけでは動作しません。
Serene Bachをご利用いただくためには最低限、いくつかのファイルとディレクトリのパーミッション設定を行う必要があります。
多くのウェブサーバでは、アップロードしたファイルに対して「読込みできる」「書込みできる」「実行できる」などの情報(パーミッション)を別途設定する必要があります。
適切なパーミッションの設定は設置するウェブサーバによって大きく異なります。詳細な情報につきましては、ご利用されているウェブサーバの運営者にお問い合わせいただくよう、お願いします。
Serene Bachを動作させるために必要な知識はそれほど多くありませんし、様々な場所から情報を収集することができます。
後述する「サイト」で紹介しているサイトやsb UsersGroupのパティオには有益な情報・事例が沢山あります。
願わくば、Serene Bachがあなたのネットライフの一部になりますよう。
Serene Bachの大まかなインストール手順は以下の通りです。
強調されている操作は必ず行う必要があります。必要最低限の設定などはインストーラで行うことができます。
sbとは異なり、init.cgiは必ずしも編集する必要はありません。
sbからアップデートされる方はsbからのアップグレードをご参照下さい。
Perl 5.8 (5.008) 並びに Perl 5.6(5.006) での動作を確認しています。
対応している日本語出力コードは
です。Shift_JIS, EUC-JP, iso-2022-jp(JIS), UTF-8
環境によっては必要なライブラリが利用できないため、一部の機能がご利用いただけない場合があります。
Serene Bachでは以下の外部ライブラリを利用します。
Image::Magick が利用できる環境ではアップした画像のサムネイル生成が可能になります。
Net::SMTP が利用できる環境ではsendmailを使わずにメール通知が行えます。
Image::Magick, Net::SMTP は必須ではありません。
これらの必要なライブラリはsb_extとして、sb開発研究所からダウンロードできます。
インストーラでは上記ライブラリの有無を確認することが出来ます。
| 項目 | 説明 |
|---|---|
| sb.cgi | Serene Bachのメインスクリプトです |
| admin.cgi | Serene Bachの管理用スクリプトです |
| cnt.cgi | アクセスログ収集用スクリプトです |
| mb.cgi | 携帯電話向けの表示を行うスクリプトです |
| install.cgi | Serene Bachの初期セットアップを行うインストーラスクリプトです。 |
| init.cgi | Serene Bachの設定ファイルです |
| index.html | トップ用のhtmlファイルです |
| style.css | Serene Bachで利用されるcssスタイルシートが保存されます |
| lib/ | Serene Bach用のライブラリが収められています |
| ext/ | (必要ならば)外部ライブラリを置くディレクトリです |
| lock/ | ロックディレクトリです |
| data/ | データファイルが格納されるディレクトリです |
| log/ | Serene Bachで生成されるhtmlなどのファイルが収められるディレクトリです |
| img/ | アップロードした画像ファイルが収められるディレクトリです |
| doc/ | ヘルプドキュメントが収められています |
| plugin/ | Serene Bachで利用するプラグインを収めるディレクトリです。 |
| template/ | テンプレートインポートで画像パーツなどが収められるディレクトリです。 |
log, img, data などいくつかのディレクトには「dummy.txt」というダミーファイルが置かれています。このファイルは必要ありませんので、アーカイブを解凍後消去して下さって構いません。
Serene Bachではインストーラでディレクトリパーミッションのチェックを行うことができます。
なお、インストーラは初期セットアップ後、サーバ上から削除することをお勧めいたします。
以下はファイルパーミッションの一例です。設置するサーバによって異なる場合がありますので、ご利用されているサービスのCGIパーミッションに関する情報を確認していただくよう、お願いします。
| ファイル/ディレクトリ | パーミッション/補足説明 |
|---|---|
| sb.cgi | [755]* |
| admin.cgi | [755]* |
| cnt.cgi | [755]* |
| mb.cgi | [755]* |
| install.cgi | [755]* |
| init.cgi | [644] |
| index.html | [666]* |
| style.css | [666]* |
| lib/ | [755] この中に収められるファイルは [644] |
| ext/ | [755] この中に収められるファイルは [644] |
| lock/ | [777]* |
| data/ | [777]* |
| log/ | [777]* |
| img/ | [777]* |
| doc/ | [755] この中に収められるファイルは [644] |
| plugin/ | [755] この中に収められるファイルは [644] |
| template/ | [777]* |
/public_html/sb/上にSerene Bachを設置する例です。
- /public_html/
- sb/
- index.html [666]*
- style.css [666]*
- admin.cgi [755]*
- sb.cgi [755]*
- cnt.cgi [755]*
- mb.cgi [755]*
- install.cgi [755]*
- init.cgi [644]
- data/ [777]*
- log/ [777]*
- img/ [777]*
- lock/ [777]*
- doc/ [755]
- src/ [755]
- ja.html [644]
- lib/ [755]
- resource/ [755]
- sb/ [755]
- XML/ [755]
- ライブラリファイル… [644]
- ext/ [755]
- plugin/ [755]
- template/ [777]*
*はパーミッション設定が必須であるファイル/ディレクトリを示します。
log, img, index.html, style.cssの置く場所は変更可能です。環境設定のベースディレクトリに置くようにしてください。また、その際でもパーミッションは上記のように設定する必要があります。
log, img のディレクトリ名は環境設定により変更することが出来ます。
スクリプトの最初の行
は設置するサーバにあわせて適時設定してください。#!/usr/bin/perl
設定する必要があるのはsb.cgi, cnt.cgi, mb.cgi, install.cgiとadmin.cgiだけです。
lib/内のスクリプトにもいちいち指定してありますが、それらは変更する必要はありません。
Serene Bachをバージョンアップされる際には以下のディレクトリの中身を入れ替えます。
また、プラグインに変更があった場合、plugin/ の中の該当するファイルを入れ替える必要があります。
plugin/内のご利用中の他のプラグインファイルを消してしまわないよう、ご注意下さい。
また、文字コードを途中で変更するのは推奨いたしません。必ず該当する文字コードのアーカイブをご利用頂くよう、お願いします。
インストーラ(install.cgi)にはsbからのデータをSerene Bach用のデータに変換する機能があります。
以下の手順に従って、インストール作業を行って下さい。
インストーラにアクセスした際、最初に最初にディレクトリのパーミッションチェックなどが行われます。インストーラでデータを移行する際、sbの管理ユーザでログインする必要があります。
データ移行中に万が一トラブルが生じた場合は、データディレクトリ内に出来たバックアップディレクトリ以外のファイル・ディレクトリを削除して、再度インストーラにアクセスすることで、データ移行の手順を最初から行うことが出来ます。
sbからSerene Bachではほとんどデータを引き継ぎますが、アクセスログや一部の設定などは引き継がれません。
Serene Bachをウェブサーバ上にアップロードするためには多くの場合、FTPソフトウェア(クライアント)を利用します。
init.cgiの編集などに利用します。Windowsの「メモ帳」は利用しない方がいいでしょう。
sb開発研究所にてダウンロードできるアーカイブファイルを解凍するためのソフトウェアです。
Mac OS Xをご利用の場合、「ターミナル」を利用して解凍できますので、上記ソフトは必要ありません。
コマンドラインで「tar」がご利用できる環境でしたら、
で解凍できます(tar zxf sb2xxx.tar.gz
部分は解凍するアーカイブによって異なります)。sb2xxx
ここに挙げたソフトウェアはほんの一例に過ぎません。他にも上記と同様の機能を持ったソフトウェアはありますので、一度お調べになってください。
Serene Bachを利用する上で見ておくと便利なサイトを紹介します。