Drupal [Install Maniax 3]

// $Id: INSTALL.txt,v 1.61.2.4 2008/07/09 19:15:59 goba Exp $

このファイルの目次 (CONTENTS OF THIS FILE )

———————

• 必要なもの
• 随時必要なもの
• インストール
• Drupal の管理
• テーマのカスタマイズ
• マルチサイトの構成
• 追加情報

必要なもの (REQUIREMENTS)

Drupal は web サーバー、PHP 4 (4.3.5 以上) か PHP 5 (http://www.php.net/) それと MｙSQL (http://www.mysql.com/) か PostgreSQL (http://www.postgresql.org/) のどちらかが必要です。 Apache web サーバーと MySQL データベースの組み合わせを推奨します。 その他の web サーバーとデータベースの組み合わせ、たとえば IIS と PostgreSQL でも、ある程度のテストがされています。 MｙSQL を使うときは、version 4.1.1 以上であることが、データベースを安全に移すために保証、推奨されます。

Drupal の必要なものについて、より詳細な情報を知りたいときは、Drupal ハンドブックの "Requirements" (http://drupal.org/requirements [英文]) を参照してください。

様々なオペレーティングシステムや web サーバーを使ったテストサーバーの環境の構成方法の詳細な情報は、Drupal ハンドブックの "Local server setup" (http://drupal.org/node/157602 [英文]) を参照してください。

任意の作業 (OPTIONAL TASKS)

• ブロガー API や RSS のような XML ベースのサービスを扱うためには、PHP の XML エクステンションが必要です。このエクステンションは初期設定では有効になっています。
• Apache web サーバーで Drupal の「Clean URL」機能を使うためには、mod_rewrite モジュールと .htaccess ファイルをローカルで操作できる権限が必要です。 IIS で Clean URL を使いたいときは、Drupal ハンドブックの "Using Clean URLs with IIS" (http://drupal.org/node/3854 [英文])を参照してください。
• さまざまな Drupal の特徴は web サーバー プロセス (例: httpd) が、外部への接続の開始を必要とします。これは通常有効ですが、いくつかのホスティング プロバイダーやサーバーの構成によっては、接続が禁止されることがあります。この機能に依存する特徴は、統合された「アップデート ステータス」モジュール (それは Drupal コアや、インストールされた寄贈モジュールやテーマなどの有効なアップデートに関する情報をダウンロードします)、OpenID 経由ログの機能、アグレゲーター フィード、そしてそのほかのネットワークに依存するサービスなどの特徴が、この機能に依存します。

インストール (INSTALLATION)

1. Drupal のダウンロードと任意の翻訳 (OWNLOAD DRUPAL AND OPTIONALLY A TRANSLATION)

   あなたは http://drupal.org/  [英文] から最新のDrupalリリースを得ることができます。ファイルは、.tar.gz 形式になっていて、ほとんどの圧縮ツールによって抽出できます。典型的な Unix のコマンドラインでは以下のようになります。

   wget http://drupal.org/files/projects/drupal-x.x.tar.gz

   tar -zxvf drupal-x.x.tar.gz

   これによって、すべての Drupal のファイルとディレクトリが含まれる、新しい drupal-x.x/ というディレクトリが作成されます。このディレクトリの内容を、あなたのウェブサーバーのドキュメント ルートか公開用の HTML ディレクトリに移動します。

   mv drupal-x.x/* drupal-x.x/.htaccess /var/www/html

   もし、デフォルトの英語インターフェースを別の言語に翻訳したいのならば、良いニュースがあります。あなたは Drupal を最初から別の言語でインストールして使うことができます。希望の言語でリリースされたパッケージがあるかどうかを http://drupal.org/project/translations  [英文] で確認して、このDrupalバージョン用のパッケージをダウンロードしてください。そして、Drupal を展開したのと同じディレクトリに、展開して入れてください。

2. 設定ファイルの作成と書き込み権限の割り当て (CREATE THE CONFIGURATION FILE AND GRANT WRITE PERMISSIONS)

   Drupal は最初、defaults.settings.php ファイルが sites/default ディレクトリにあります。インストーラーはこのファイルをひな形に、インストール手順の中であなたに与えられた詳細を使って設定ファイルを作ります。アップグレードするときの問題を避けるために、Drupal は実際に使用できる設定ファイルをパッケージしていません。あなたは settings.php という名前のファイルを作成しなくてはなりません。defalt.setting.php ファイルをコピーすることで、そうすることができるでしょう (もしくは同じディレクトリにこの名前の空のファイルを作成します)。例えば以下のように default.settings.php を (インストール ディレクトリから) コピーして作成します。

   cp sites/default/default.settings.php sites/default/settings.php

   次に、web サーバーに sites/default/setting ファイルの書き込み権限を、以下のコマンドで (インストールディレクトリから) 与えます。

   chmod o+w sites/default/settings.php

   ファイルやディレクトリが自動的に作成されるように、web サーバーに sites/default ディレクトリの書き込み権限を、以下のコマンドで (インストールディレクトリから) 与えます。

   chmod o+w sites/default

3. Drupal データベースの作成 (CREATE THE DRUPAL DATABASE)

   インストールのために、Drupal がデータベースにアクセスする必要があります。データベースのユーザー (アカウント) は Drupal を動かす際に十分な権限が必要です。権限についての追加情報とコマンドラインでのデータベースの操作方法は、INSTALL.mysql.txt ファイル (for MySQL) か INSTALL.pgsql.txt ファイル (for PostgreSQL) ファイルに書かれています。

   PHPMyAdmin や web ベースのコントロールパネルを使ってデータベースを作成するときは、それらのドキュメントを参考にするか、あなたが使っているホスティングサービス業者に訊いてください。

   作成するデータベースのユーザー名やパスワード、それからデータベース名、ホスト名をメモしてください。インストールスクリプトで、これらの項目を入力することになります。

4. インストールスクリプトの実行 (RUN THE INSTALL SCRIPT)

   インストールスクリプトを実行するために、ブラウザを使ってあなたの web サイトのベース URL にアクセスしてください (例 http://www.example.com)。

   データベースのセットアップやテーブルの作成、最初のユーザーアカウントの追加、そして基本的な web サイトの設定が、いくつかの画面で案内します。

   インストールスクリプトは、site/default/files ディレクトリ (Drupal のインストール後にファイルディレクトリの位置を変えるても構いません) にファイル保存ディレクトリを作成しようとします。場合によっては、手作業でディレクトリを作成してアクセス権を変更する必要があるかもしれません。ファイルディレクトリを作成して web サーバーに書き込み権限を与えるには、以下のコマンドを (インストールディレクトリから) 使います。

   mkdir sites/default/files

   chmod o+w sites/default/files

   インストールスクリプトは、設定情報を保存した後に settings.php ファイルと sites/default ディレクトリを書き込み禁止にしようとします。しかしながら、(インストールディレクトリから) コマンドを使って手作業でそれらを書き込み禁止にしなくてはならないかもしれません。

   chmod a-w sites/default/settings.php

   chmod a-w sites/default

   ファイルを変更するなら、変更した後でもう一度それを保護 (書き込み禁止に) してください。そのファイルから書き込み権限を外さずにおくと、それはセキュリティリスクになります。settings.php ファイルは sites/default/settings.php が初期値での位置ですが、マルチサイト セットアップで使う時は、以下で説明するように別の配置にもできます。

5. Drupal を構成する (CONFIGURE DRUPAL)

   インストールスクリプトが成功したら、"Welcome" ページが表示され、管理者としてログインできます。"Welcome" ページに示された初期構成手順を続けてください。

   初期設定の Drupal のテーマが適切に表示されず、「ページが見つかりません(Page Not Found)」というエラーになるのであれば、settings.php ファイルのなかにある $base_url 変数が、設定されていないかもしれないので、これを手動で構成してみてください。FastCGI で動作するサーバーで、$base_url 変数がコメントアウトのまま残されるという不具合が知られています  (http://bugs.php.net/bug.php?id=19656  [英文] を参照)。

6. ファイルシステム記憶域の設定とファイル アクセス権の再評価 (REVIEW FILE SYSTEM STORAGE SETTINGS AND FILE PERMISSIONS)

   手順 4 で作成されたファイルディレクトリは、全てのアップロード ファイルが保存される、Drupal によって作成されたいくつかの一時ファイルと同様の、規定のファイルパスです。インストールの後で、アップロード ファイルを保存するファイルパスを別の場所に変更してもかまいません。

   パスの変更は必須ではありませんが、もし以下のようなことがあるなら、それを変更しても良いでしょう。

   • ひとつのコードで複数の Drupal サイトを動かすとき。 (それぞれのインストールでアップロードが重複しないように、別のディレクトリにファイルパスを変更してください)。または、
   • 負荷分散装置やリバースプロキシの後ろで web サーバー フロントエンドを動かすとき (共有ファイル リポジトリが指し示すそれぞれのサーバーで、ファイルパスを変更してください)。

   ファイルパスは以下の様に変更します。

   • ファイルパスの新しい場所が確実に存在するように、必要に応じて作成します。 たとえば、uploads という名前のディレクトリ作成するには、以下のコマンドをシェルやシステムプロンプトから (インストールディレクトリの中で) 実行します。

     mkdir uploads

   • ファイルパスの新しい場所に web サーバー プロセスが確実に書き込めるようにします。uploads ディレクトリに書き込み権限を割り当てるには、以下のコマンドをシェルやシステムプロンプトから (インストールディレクトリの中で) 実行する必要があります。

     chmod o+w uploads

   • Drupla でナビゲーション (Navigation) メニューを選択してファイルパスにアクセスします。

     アドミニストレーター (Administer) > サイト構成 (Site configuration) > ファイルシステム (File system)

     ファイルパス (File System Path) プロンプトに新しい場所 (例 uploads) を入力します。

   ファイルがアップロードされた後にファイルパスを変更すると、予期しない不具合が既存のサイトで発生するもしれません。既存のサイトでファイルパスを変更するときは、全てのファイルを元の場所からから新しい場所に移動するのを忘れないでください。

   管理者の中には、実行中の Drupal の正確なバージョンを知ることを困難にするために、ドキュメント ファイル、特に CHANGELOG.txt を読み込み禁止にすることを提案しています。もし、この任意のセキュリティ対策を実装したいのなら、以下のコマンドをシェルやシステムプロンプトから (インストールディレクトリの中で) 実行します。

   chmod a-r CHANGELOG.txt

   この例は CHANGELOG.txt に影響するだけだということに注意してください。全てのドキュメント ファイルを外部に晒さないために、例示の CHANGELOG.txt を Drupal のドキュメント ファイルのそれぞれに置き換えて、このコマンドをインストールディレクトリの中で繰り返してください。

   ファイル アクセス権についての詳しい情報は、オンラインハンドブックの "Modifying Linux, Unix, and Mac file permissions" (http://drupal.org/node/202483  [英文]) や "Modifying Windows file permissions" (http://drupal.org/node/202491  [英文]) を参照してください。

7. cron の保守タスク (CRON MAINTENANCE TASKS)

   多くの Drupal モジュールは、cron で起動しなくてはならない、検索モジュール (キーワード検索で使われるインデクスを構築、更新する)、アグリゲーターモジュール (他のサイトからのフィードを獲得する)、ping モジュール (他のサイトの新しいコンテンツや更新を通知する)、システムモジュール (定型メンテナンスとデータベースの刈り込みを行う) に含まれる周期的なタスクがあります。 インストールされたモジュールに代わって、これらのタスクを作動させるために http://www.example.com/cron.php にアクセスして cron ページを呼び出してください。

   多くのシステムでは、このようなスケジュールされたタスクのための crontab ユーティリティをサポートしています。以下に例示する crontab の行は自動的に 1 時間ごとに cron タスクを作動させます。

   0   *   *   *   *   wget -O - -q -t 1 http://www.example.com/cron.php

   cron の保守タスクについての詳しい情報はヘルプページや http://drupal.org/cron [英文] の Drupal オンラインハンドブックで得られます。サンプルスクリプトは scripts/ ディレクトリで見つけられます。

Drupal の管理 (DRUPAL ADMINISTRATION)

新たにインストールしたばかりの Drupal は、ほんのいくつかの有効になったモジュールと最小限のアクセス権限だけの、ごく基本的な初期構成です。

サービスを有効にして、構成するときは、管理パネルを使います。例を示します。

構成オプションの詳細情報は、異なる構成を設定する際の手順を読んだり、管理パネルで利用可能な様々なヘルプページを調べたりしてください。

コミュニティが提供するモジュールやテーマは http://drupal.org/ [英文] で入手できます。

テーマのカスタマイズ (CUSTOMIZING YOUR THEME(S))

インストールしたものが動き出すと、あなたはサイトの外観をカスタマイズしたくなるでしょう。 いくつかのサンプル テーマが含まれており、それ以外にも drupal.org [英文] からダウンロードすることができます。

テーマの簡単なカスタマイズは、CSS を使うだけでできます。それ以上の変更には、Drupal で使われている PHP のテンプレート エンジンを理解する必要があります。詳細はhttp://drupal.org/handbook/customization [英文] で見つかります。

マルチサイトの構成 (MULTISITE CONFIGURATION)

ただひとつの Drupal のインストールで、それぞれ自身の構成による複数の Drupal サイトが主催できます。

追加のサイトの構成は、’site’ ディレクトリの中のサブディレクトリで作成されます。それぞれのサブディレクトリは、構成情報を持った ‘settings.php’ ファイルを持ちます。追加のサイトを作る最も簡単な方法は ‘default’ ディレクトリをコピーして、’settings.php’ ファイルを適切に変更することです。ディレクトリ名は、新しいサイトの URL で作成します。www.example.com を構成するときは ‘sites/examle.com/setting.php’ とします (そのサイトに http://example.com/ でアクセスするなら、’www’ が省略されるべきだということに注意)。

サイトは異なるドメインでなくても構いません。Drupal のサイトとして、サブドメインやサブディレクトリを持つこともできます。たとえば、example や example.com、sub.example.com、sub.example.com/site3 の全てを、独立した Drupal のサイトとして定義できます。 以下のような構成で構築します。

  sites/default/settings.php
  sites/example.com/settings.php
  sites/sub.example.com/settings.php
  sites/sub.example.com.site3/settings.php

Drupal は、サイト (たとえば www.sub.example.com/site3) の構成を以下の順で検索して、最初に見つかった構成を使います。

  sites/www.sub.example.com.site3/settings.php
  sites/sub.example.com.site3/settings.php
  sites/example.com.site3/settings.php
  sites/www.sub.example.com/settings.php
  sites/sub.example.com/settings.php
  sites/example.com/settings.php
  sites/default/settings.php

標準ではないポートでインストールしたとき、ポート番号はもっとも深いドメインとして扱われます。たとえば http://www.example.com:8080/ では sites/8080.www.example.com/ が読み込まれます。ポート指定の構成が見つけられないとき、ポート番号はまさに本当のサブドメインのように適宜削除されます。

それぞれのサイトの構成は、標準の ‘modules’ や ‘themes’ ディレクトリにインストールされたものに加えて、それ自身のサイト特有のモジュールやテーマを持つことができます。サイト特有のモジュールやテーマを使うためには、サイト構成ディレクトリに ‘modules’ や ‘themes’ ディレクトリを、単純に作成するだけです。たとえば sub.example.com に、他のサイトがアクセスしない、カスタムテーマやカスタムモジュールがある場合は、以下の様にします。

  sites/sub.example.com/:
  settings.php
  themes/custom_theme
  modules/custom_module

注: 複数の仮想ホストや構成設定についての詳細情報は、drupa.org [英文] の Drupal ハンドブックを見てください。

マルチサイト構成における Drupal のファイルパスの構成に関する詳しい情報は、上のステップ 6 を見てください。

その他の情報 (MORE INFORMATION)

• 追加のドキュメントは、http://drupal.org/handbook [英文] にある Drupal ハンドブックを参照してください。
• セキュリティ告知のリストは、http://drupal.org/security [英文] (RSS フィードが利用可能) の "Security announcements" ページにあります。 また、このページではこれらの告知を E-メールで受け取る方法についても説明しています。
• Drupal のセキュリティ手続きや、潜在的なセキュリティの問題を Drupal セキュリティチームに報告する方法については、http://drupal.org/security-team [英文] の "Security team"  ページを参照してください。
• 広範に利用可能なサポートオプションについては、http://drupal.org/support [英文] の "Support" ページを参照してください。