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

source: OpenPNE/trunk/setup/OpenPNE_Setup.html @ 1480

Last change on this file since 1480 was 1480, checked in by takanashi, 14 years ago

セットアップドキュメントの修正

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