ここの情報は古いです。ご理解頂いた上でお取り扱いください。

Changes between Version 10 and Version 11 of OpenPNESetup


Ignore:
Timestamp:
Jan 29, 2007, 9:18:35 PM (14 years ago)
Author:
sakai
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OpenPNESetup

    v10 v11  
    1  {{{
    2 #!html
    3 <h1>OpenPNE セットアップガイド</h1>
     1= OpenPNE セットアップガイド =
    42
    5 <p>最終更新日: 2007/1/9</p>
    6 
    7 <h2>目次</h2>
    8 <ul>
    9 <li><a href="#section0">0. はじめに</a></li>
    10 <li><a href="#section1">1. ファイルの設置</a></li>
    11 <li><a href="#section2">2. 設定ファイルの変更</a></li>
    12 <li><a href="#section3">3. サーバ設定</a>
    13   <ul>
    14   <li><a href="#section3-1">3-1. Apacheの設定</a></li>
    15   <li><a href="#section3-2">3-2. メールサーバの設定</a></li>
    16   <li><a href="#section3-3">3-3. cronの設定</a></li>
    17   </ul></li>
    18 <li><a href="#section4">4. OpenPNE用データベースの作成</a>
    19   <ul>
    20   <li><a href="#section4-1">4-1. MySQL 4.1 の場合</a></li>
    21   <li><a href="#section4-2">4-2. MySQL 4.0 の場合</a></li>
    22   <li><a href="#section4-3">4-3. PNEBIZを使用する場合</a></li>
    23   </ul></li>
    24 <li><a href="#section5">5. セットアップモジュールの実行</a></li>
    25 <li><a href="#section6">6. 管理ページへのアクセス</a></li>
    26 </ul>
    27 
    28 <hr>
    29 
    30 <h2 id="section0">0. はじめに</h2>
    31 
    32 <p>この文書は、OpenPNE バージョン2.6.0 を基にして書かれています。</p>
    33 <p>OpenPNE は以下のようなサーバ環境で動作させることを想定しています。</p>
    34 <ul>
    35 <li>Apache 1.3.*/2.0.* 以上</li>
    36 <li>PHP 4.3.*以上/5.0.*以上 (ASPI版を推奨)
    37         <ul>
    38         <li>PHP の mbstring 拡張モジュールを使用可能</li>
    39         <li>PHP から GD ライブラリを使用可能 (JPEG/GIF/PNG サポート)</li>
    40 
    41         <li>PHP の mcrypt 拡張モジュールの使用を推奨</li>
    42         </ul></li>
    43 <li>MySQL 4.0.*以上/4.1.*以上</li>
    44 <li>メールサーバ(携帯からメール投稿する場合)
    45         <ul>
    46         <li>Postfix 2.1.* を推奨</li>
    47         </ul></li>
    48 </ul>
    49 
    50 <h2 id="section1">1. ファイルの設置</h2>
    51 
    52 <p>OpenPNE に含まれるディレクトリ、ファイルを以下のようにWebサーバ上に設置してください。</p>
    53 
    54 <pre>
    55 - <var>OPENPNE_DIR</var>
    56   ├ bin
    57   ├ lib          &lt;--- <var>OPENPNE_LIB_DIR</var>
    58   ├ var          &lt;--- <var>OPENPNE_VAR_DIR</var>
    59 
    60   │ ├ img_cache
    61   │ │ ├ gif [777]
    62   │ │ │ ├ w_h [777]
    63   │ │ │ ├ w_h_raw [777]
    64   │ │ │ ├ w76_h76 [777]
    65   │ │ │ ├ w120_h120 [777]
    66   │ │ │ └ w180_h180 [777]
    67   │ │ ├ jpg [777]
    68   │ │ │ ├ w_h [777] 
    69   │ │ │    ... [777]
    70   │ │ └ png [777]
    71   │ │    ├ w_h [777]
    72   │ │       ... [777]
    73   │ ├ log [777]
    74   │ ├ rss_cache [777]
    75   │ ├ templates_c [777]
    76   │ └ tmp [777]
    77   ├ webapp       &lt;--- <var>OPENPNE_WEBAPP_DIR</var>
    78   ├ webapp_biz   &lt;--- <var>OPENPNE_WEBAPP_BIZ_DIR</var>
    79   └ webapp_ext   &lt;--- <var>OPENPNE_WEBAPP_EXT_DIR</var>
    80 
    81 (ブラウザから閲覧可能)
    82 - <var>public_html</var> (ディレクトリ名は変更可能)
    83   ├ config.inc.php (<var>OPENPNE_DIR</var> ディレクトリを指定)
    84   ├ index.php
    85      ...
    86 
    87 ※[777]は例です。環境に合わせて適切な値に読み替えてください。
    88 
    89 </pre>
    90 
    91 <p><var>public_html</var> のパスとディレクトリ名は変更することができます。</p>
    92 <p><var>public_html</var> のパスを <var>OPENPNE_DIR</var> ディレクトリの直下(デフォルト配置)以外に変更した場合は、
    93 <var>public_html</var> 直下にある config.inc.php の内容を書き換えてください。</p>
    94 
    95 <p>また、<var>OPENPNE_DIR</var>/var 以下の<strong>全ディレクトリ</strong>にウェブサーバからの書き込み権限(例えば 777)を与えてください。</p>
    96 <pre>
    97 $ chmod -R 777 var/*
    98 </pre>
    99 
    100 <hr>
    101 
    102 <p>OpenPNE 2.2 からは画像のキャッシュディレクトリを <var>public_html</var> 以下に置き、Apache から直接読み込みを行うようにすることもできます。
    103 (OpenPNE の設定ファイル config.php で、OPENPNE_IMG_CACHE_PUBLIC を true にしてください)</p>
    104 
    105 <p>この機能を有効にする場合、Apache の設定で mod_rewrite を有効にし、.htaccess を使用可能にするかもしくは同様の内容を httpd.conf に記述する必要があります。</p>
    106 
    107 <pre>
    108 - <var>OPENPNE_DIR</var>
    109   ├ bin
    110   ├ lib          &lt;--- <var>OPENPNE_LIB_DIR</var>
    111   ├ var          &lt;--- <var>OPENPNE_VAR_DIR</var>
    112 
    113   │ ├ log [777]
    114   │ ├ rss_cache [777]
    115   │ ├ templates_c [777]
    116   │ └ tmp [777]
    117   ├ webapp       &lt;--- <var>OPENPNE_WEBAPP_DIR</var>
    118   ├ webapp_biz   &lt;--- <var>OPENPNE_WEBAPP_BIZ_DIR</var>
    119   └ webapp_ext   &lt;--- <var>OPENPNE_WEBAPP_EXT_DIR</var>
    120 
    121 (ブラウザから閲覧可能)
    122 - <var>public_html</var> (ディレクトリ名は変更可能)
    123   ├ config.inc.php (<var>OPENPNE_DIR</var> ディレクトリを指定)
    124   ├ index.php
    125   ├ img
    126   │ ├ .htaccess
    127   │ ├ index.php
    128   │ ├ gif [777]
    129   │ │ ├ w_h [777]
    130   │ │ ├ w_h_raw [777]
    131   │ │ ├ w76_h76 [777]
    132   │ │ ├ w120_h120 [777]
    133   │ │ └ w180_h180 [777]
    134   │ ├ jpg [777]
    135   │ │ ├ w_h [777]
    136   │ │    ... [777]
    137   │ └ png [777]
    138   │    ├ w_h [777]
    139   │       ... [777]
    140      ...
    141 
    142 ※[777]は例です。環境に合わせて適切な値に読み替えてください。
    143 
    144 </pre>
    145 
    146 
    147 <h2 id="section2">2. 設定ファイルの変更</h2>
    148 
    149 <p>
    150 <var>OPENPNE_DIR</var>/config.php.sample を
    151 <var>OPENPNE_DIR</var>/config.php にコピーして config.php の方を環境に合わせて編集します。</p>
    152 
    153 <dl>
    154 <dt>OPENPNE_URL</dt>
    155         <dd>ベースURL(絶対パス)</dd>
    156 
    157 <dt>DSN</dt>
    158         <dd>(MySQLの)データベースへ接続するための情報です。<br>
    159         接続用ユーザ、パスワード、サーバホスト名、データベース名を設定します。</dd>
    160 <dt>ENCRYPT_KEY</dt>
    161         <dd>会員ログイン情報の暗号キー(56バイト以内のASCII文字)<br>
    162         他人に推測されにくい文字列にしてください。</dd>
    163 <dt>MAIL_SERVER_DOMAIN</dt>
    164 
    165         <dd>メールサーバのドメイン名(携帯版でメール投稿をする場合に使います)</dd>
    166 </dl>
    167 
    168 <p>必要に応じて、オプション設定も書き換えてください。
    169 デバッグモードの設定は、本番運用に移行する際には 0 にしておくことをおすすめします。</p>
    170 
    171 <p class="caution">PHPの設定でセーフモードが有効な場合は、MAIL_SET_ENVFROM を false に設定してください。</p>
    172 
    173 
    174 <h2 id="section3">3. サーバ設定</h2>
    175 
    176 <p>レンタルサーバ等で設定済みの場合は読み飛ばしてください。</p>
    177 
    178 <h3 id="section3-1">3-1. Apacheの設定</h3>
    179 
    180 <p>httpd.confを修正し、</p>
    181 <ul>
    182 <li>DirectoryIndex に index.php を追加します。</li>
    183 <li><var>public_html</var> にアクセスできるようにドキュメントパスを通します。</li>
    184 </ul>
    185 
    186 <p><em>[設定例]</em></p>
    187 <div>
    188 バーチャルホストを使ったhttpd.confの設定
    189 
    190 <pre>
    191 &lt;VirtualHost *:80&gt;
    192     ServerName        openpne.example.com
    193     DocumentRoot      /home/username/OpenPNE/public_html/
    194     DirectoryIndex    index.html index.php
    195 &lt;/VirtualHost&gt;
    196 </pre>
    197 </div>
    198 
    199 <p>httpd.confを修正したら、Apacheを再起動してください。</p>
    200 
    201 <h3 id="section3-2">3-2. メールサーバの設定</h3>
    202 
    203 <p>携帯版を使用しない場合は以下の設定は不要です。</p>
    204 
    205 <p>MAIL_SERVER_DOMAIN に届くメールで、以下のアドレスはシステムで利用されます。</p>
    206 
    207 <table>
    208 <tr><th>項目</th><th>新形式</th><th>旧形式</th></tr>
    209 <tr><td>新規登録 / ログインURL取得</td><td>get@MAIL_SERVER_DOMAIN</td><td>get@MAIL_SERVER_DOMAIN</td></tr>
    210 <tr><td>プロフィール画像変更</td><td>p<var>XXX</var>-<var>YYY</var>@MAIL_SERVER_DOMAIN</td><td>p<var>XXX</var>@MAIL_SERVER_DOMAIN</td></tr>
    211 
    212 <tr><td>コミュニティ掲示板メール投稿</td><td>t<var>XXX</var>-<var>YYY</var>@MAIL_SERVER_DOMAIN</td><td>t<var>XXX</var>@MAIL_SERVER_DOMAIN</td></tr>
    213 <tr><td>日記メール投稿</td><td>b<var>XXX</var>-<var>YYY</var>@MAIL_SERVER_DOMAIN</td><td>blog@MAIL_SERVER_DOMAIN</td></tr>
    214 
    215 </table>
    216 <ul>
    217 <li><var>XXX</var> には数字。</li>
    218 <li><var>YYY</var> には12バイトの英数字([0-9a-f]{12})。</li>
    219 </ul>
    220 
    221 <p>新形式、旧形式のどちらのアドレスで受け付けるかは config.phpの設定(MAIL_ADDRESS_HASHED)によって切り替えることができます。</p>
    222 <p>新形式はメール投稿の際のFromアドレス偽装へのセキュリティ対策のために導入されたものです。
    223 From偽装対策を(IP制限等により)メールサーバ側で行っている場合には旧形式での運用も問題ありません。</p>
    224 
    225 <p>メールサーバの転送設定を利用して、これらのアドレスへのメールが、以下のコマンドにわたるように設定します。</p>
    226 <pre>
    227 "|/usr/local/bin/php <var>OPENPNE_DIR</var>/bin/mail.php"
    228 </pre>
    229 
    230 <h3 id="section3-3">3-3. cronの設定</h3>
    231 
    232 <p><em>[設定例]</em></p>
    233 
    234 <p>/etc/crontab に以下を記述。</p>
    235 <div>
    236 <pre>
    237 # 6時にメールを送信&20分毎にRSS更新
    238 00   6 * * * root sh <var>OPENPNE_DIR</var>/bin/tool_send_dairy_news.cron     <var>OPENPNE_DIR</var>/bin/ [bin_path]/php
    239 00   6 * * * root sh <var>OPENPNE_DIR</var>/bin/tool_send_birthday_mail.cron  <var>OPENPNE_DIR</var>/bin/ [bin_path]/php
    240 00   6 * * * root sh <var>OPENPNE_DIR</var>/bin/tool_send_schedule_mail.cron  <var>OPENPNE_DIR</var>/bin/ [bin_path]/php
    241 */20 * * * * root sh <var>OPENPNE_DIR</var>/bin/tool_rss_cache.cron           <var>OPENPNE_DIR</var>/bin/ [bin_path]/php
    242 
    243 </pre>
    244 [bin_path]はphpをインストールしたbinディレクトリ(例えば、/usr/local/bin)です。
    245 </div>
    246 
    247 <h2 id="section4">4. OpenPNE用データベースの作成</h2>
    248 
    249 <h3 id="section4-1">4-1. MySQL 4.1 の場合</h3>
    250 
    251 <p>新しくデータベースを作成する場合、以下のようなSQLクエリを実行してデータベースを作成します。</p>
    252 
    253 <pre>
    254 CREATE DATABASE `DBNAME` DEFAULT CHARACTER SET utf8 ;
    255 </pre>
    256 
    257 <p>準備したデータベース(例:DBNAME)上で、以下のSQL文を順番に実行してください。</p>
    258 <ol>
    259 <li><var>OPENPNE_DIR</var>/setup/sql/install/install-2.6-create_tables-mysql41.sql</li>
    260 <li><var>OPENPNE_DIR</var>/setup/sql/install/install-2.6-insert_data.sql</li>
    261 </ol>
    262 
    263 <div>
    264 <em>[実行例]</em>
    265 <pre>
    266 $ mysql -u username -p --default-character-set=utf8 DBNAME &lt; install-2.6-create_tables-mysql41.sql
    267 $ mysql -u username -p --default-character-set=utf8 DBNAME &lt; install-2.6-insert_data.sql
    268 </pre>
    269 </div>
    270 
    271 <h3 id="section4-2">4-2. MySQL 4.0 の場合</h3>
    272 <p>新しくデータベースを作成する場合、以下のようなSQLクエリを実行してデータベースを作成します。</p>
    273 
    274 <pre>
    275 CREATE DATABASE `DBNAME` ;
    276 </pre>
    277 
    278 <p>準備したデータベース(例:DBNAME)上で、以下のSQL文を順番に実行してください。</p>
    279 <ol>
    280 <li><var>OPENPNE_DIR</var>/setup/sql/install/install-2.6-create_tables-mysql40.sql</li>
    281 <li><var>OPENPNE_DIR</var>/setup/sql/install/install-2.6-insert_data.sql</li>
    282 </ol>
    283 
    284 <div>
    285 <em>[実行例]</em>
    286 <pre>
    287 $ mysql -u username -p DBNAME &lt; install-2.6-create_tables-mysql40.sql
    288 $ mysql -u username -p DBNAME &lt; install-2.6-insert_data.sql
    289 </pre>
    290 </div>
    291 
    292 
    293 <h3 id="section4-3">4-3. PNEBIZを使用する場合</h3>
    294 <p>PNEBIZを使用する場合は4-1(または4-2)実行後、以下のSQL文を実行してください。</p>
    295 <ol>
    296 <li><var>OPENPNE_DIR</var>/setup/sql/install/option-2.6-pnebiz-header.sql</li>
    297 </ol>
    298 
    299 <div>
    300 <em>[実行例]</em>
    301 <pre>
    302 $ mysql -u username -p DBNAME &lt; option-2.6-pnebiz-header.sql
    303 </pre>
    304 </div>
    305 
    306 <h2 id="section5">5. セットアップモジュールの実行</h2>
    307 
    308 <p>ブラウザから以下のアドレスへアクセスしてください。(セットアップ完了後はアクセスすることができません)</p>
    309 
    310 <pre>
    311 <var>OPENPNE_URL</var>?m=setup
    312 (例) http://openpne.example.com/?m=setup
    313 </pre>
    314 
    315 <p>ここでSNS名、管理用アカウント、初期ユーザの設定を行うことができます。</p>
    316 
    317 
    318 <h2 id="section6">6. 管理ページへのアクセス</h2>
    319 
    320 <p>セットアップ時に設定した管理用アカウントのユーザ名、パスワードを入力してログインしてください。ログイン後、管理メニューの「SNS設定変更」からSNSの基本情報の設定をすることができます。</p>
    321 
    322 <pre>
    323 <var>OPENPNE_URL</var>?m=admin
    324 (例) http://openpne.example.com/?m=admin
    325 </pre>
    326 
    327 <p>管理ページのURLを変更する場合は、設定ファイル config.php 内にある ADMIN_MODULE_NAME の値を変更してください。</p>
    328 <div>例えば、abcde に変更した場合、
    329 <pre>
    330 <var>OPENPNE_URL</var>?m=abcde
    331 (例) http://openpne.example.com/?m=abcde
    332 </pre>
    333 というURLから管理ページへアクセスすることができます。</div>
    334 
    335 <p>また、管理メニューの「管理用ページ名をランダム生成」でページ名置換を実行すると管理ページ内部のページ名を変更することができるので、セキュリティ向上のためセットアップ後に必ず実行しておくことをおすすめします。</p>
    336 
    337 <hr>
    338 
    339 <p>これでセットアップは完了です。友達を招待してみたり、日記を書いたり、あなただけのSNSを作り上げてください!</p>
    340 
    341  }}}
     3[http://trac2.openpne.jp/wiki/OpenPNESetup OpenPNEセットアップガイドはこちらに移動しました]