PocketBBSセットアップマニュアル
改訂日:2007年12月14日
目次


はじめに
1. 概要

PocketBBSのセットアップ手順は下記の通りです。
セットアップは下記の手順にしたがって行ってください。


2. 動作環境

PocketBBS は以下のようなサーバ環境で動作させることを推奨しています。

  • Apache 1.3.*/2.0.* 以上
  • PHP 4.2.* 以上(mbstring 拡張モジュール、GD ライブラリを使用可能)
  • MySQL 4.0.* 以上
  • PostgreSQL 7.4.* 以上


3. 注意事項

本マニュアルは、PocketBBS 1.1.5を基にして記載されています。
本マニュアルは、OS、Apache、PHP、MySQL、又はPostgreSQLが既にインストールされている事を前提とします。


PocketBBS の配置
PocketBBS 以下に含まれるディレクトリ、ファイルを下記のようにWebサーバ上の任意の場所配置して下さい。
基本的には解凍したフォルダ直下の状態が下記の通りになります。そのまま配置して下さい。
- ROOT_DIR
├ css                     <--- デザインの設定ファイル格納
├ imgages                 <--- 画像ファイルを格納
├ js                      <--- JavaScriptファイルを格納(現在は使用していません)
├ lib                     <--- PocketBBS、PEAR、SMARTY等のライブラリファイルを格納
├ setup                   <--- セットアップSQLファイルを格納
├ webapp                  <--- 各種アクション、テンプレート、キャッシュ、コンフィグファイル等を格納
│   ├ cache
│   ├ configs
│   ├ lib
│   ├ modules
│   ├ templates_c
│   ├ config.php
│   └ init.php
├ img.php                 <--- 画像処理ファイル
└ index.php               <--- 初回起動ファイル

※基本的に上記の構成を変更する必要はありません。変更される場合は上級知識が必要になります。


配置後、ROOT_DIR/webapp/cachetemplates_c 以下の全ディレクトリにWebサーバからの書き込み権限を付与して下さい。

[設定例]

$ chmod -R [ XXX ] cache/* templates_c/*

※[ XXX ]には環境によって適切な値を設定して下さい。


configファイルの設定
ROOT_DIR/webapp/config.phpを環境に合わせて編集します。

[ POCKET_APL_ALIAS ]

アプリケーションのエイリアス名(DocumentRootの場合は「/」)


[ _POCKET_DSN ]

データベースへ接続するための情報です。(MySQL、又はPostgreSQL)
接続用ユーザ、パスワード、サーバホスト名、データベース名を設定して下さい。

※DSN設定にはMySQLとPostgreSQL用があります。どちらか一方を有効にして下さい。


[ _POCKET_SMTP ]

SMTPサーバの情報です。
パスワード再発行等で使用します。


[ _POCKET_POP3 ]

POP3サーバの情報です。
POP before SMTP 対応でメール送信時にPOP3認証する際に使用します。


[ POCKET_BBS_ENCRYPT_KEY ]

暗号化用の鍵(56バイト以内のASCII文字)
推測されないような文字列を設定して下さい。


[ POCKET_BBS_COLOR ]

PocketBBSのベース色
ベース色の設定が可能です。お好みに合わせて設定して下さい。


※基本的に上記の内容以外は編集する必要はありません。変更される場合は上級知識が必要になります。


Apacheの設定
httpd.conf の編集を行います。

  • [ DirectoryIndex ]に index.php を追加
  • PocketBBSにアクセスできるようにドキュメントパスを設定


[設定例]

バーチャルホストを使った設定

<VirtualHost *:80>
    ServerName        pocket.example.net
    DocumentRoot      /home/username/pocketbbs/
    DirectoryIndex    index.html index.php
</VirtualHost>

httpd.conf編集後、設定を反映させるにはApacheを再起動して下さい。


データベースの作成
PocketBBSでは、データベースにMySQLかPostgreSQLを選択することができます。
環境にあわせてセットアップを実行して下さい。

1. MySQL4.1の場合

下記の手順を順番に実行して、データベースを作成して下さい。


1. MySQL コマンドに接続

$ mysql -u [ username ] -p  <Enter>
Enter password: [ password ]  <Enter>

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is XXXXX to server version: 4.1.XX-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql>

※[ username ][ password ]は環境によって書き換えて下さい。
※mysql コマンドを利用するには、mysqlグループユーザで実行する必要があります。


2. データベースの作成

mysql> CREATE DATABASE [ DBNAME ] DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;  <Enter>

※[ DBNAME ]は環境によって書き換えて下さい。


3. MySQL コマンドの終了

mysql> exit  <Enter>
Bye


2. PostgreSQL7.4の場合

下記の手順を順番に実行して、データベース、ユーザ、スキーマを作成して下さい。


1. データベースの作成

$ createdb [ DBNAME ] -E 'UNICODE'  <Enter>
CREATE DATABASE

※[ DBNAME ]は環境によって書き換えて下さい。
※createdb コマンドを利用するには、postgreグループユーザで実行する必要があります。


2. PostgreSQL コマンドに接続

$ psql [ DBNAME ]  <Enter>
Welcome to psql 7.4.XX, the PostgreSQL interactive terminal.

Type:  \copyright for distribution terms
       \h for help with SQL commands
       \? for help on internal slash commands
       \g or terminate with semicolon to execute query
       \q to quit

pocket=#

※[ DBNAME ]には「1. データベースの作成」で作成したデータベースを指定して下さい。
※psql コマンドを利用するには、postgreグループユーザで実行する必要があります。


3. ユーザの作成

pocket=# CREATE USER [ username ] WITH ENCRYPTED PASSWORD '[ password ]';  <Enter>
CREATE USER

※[ username ][ password ]は環境によって書き換えて下さい。


4. スキーマの作成

pocket=# CREATE SCHEMA [ schemaname ] AUTHORIZATION [ username ];  <Enter>
CREATE SCHEMA

※[ schemaname ]は環境によって書き換えて下さい。
※[ username ]には、「 3. ユーザの作成 」で指定したユーザ名を指定して下さい。


5. PostgreSQL コマンドの終了

pocket=# \q  <Enter>


セットアップの実行
ブラウザからセットアップアドレスへアクセスしてください。
ユーザID、パスワード、メールアドレス、BBS名称の設定が行えます。

[アクセス例]

http://pocket.example.net/?m=setup

セットアップの無効化
セットアップ完了後、セットアップの無効化を行います。
ROOT_DIR/webapp/config.phpを下記の部分を編集します。

[ _POCKET_MODULES ]

「setup」を削除して下さい。


これで、セットアップアドレスへアクセスしても再度セットアップが実行されることはありません。

おわりに
以上でセットアップは完了です。
詳細なサイト情報の設定は、管理画面からおこなえます。
Copyright 2007 Pocket9 All Rights Reserved.
Powered by PocketBBS