IT pass HikiWiki - [EPA]apache2のインストールと設定 Diff

  • Added parts are displayed like this.
  • Deleted parts are displayed like this.

{{toc}}

以下では, Apache 2.2 のインストールと設定について記す.

サービスとして http と https の両方を提供する.

== ビルドのための設定

ソースからインストールする. インストール先は apache2 のデフォルト
である /usr/local/apache2 とする. この場合, configure へ --prefix
の必要は無い. apache-ssl を動作させたいため --enable-ssl を,
mod_rewrite を使用したいため --enable-rewrite を (gate の
登録窓口を http から https へ移動させたい),  
DSO (Dynamic shared object: 動的共有オブジェクト) を使用したいため
--enable-so をオプションとして指定した.
また, ビルド時に "Cannot use an external APR-util with the bundled APR"
とエラーが生じる場合があるため, --with-included-apr オプションも指定する.

  # cd /usr/local/src
  # wget http://www.meisei-u.ac.jp/mirror/apache/httpd/httpd-2.2.4.tar.gz
  # tar xvfz httpd-2.2.4.tar.gz
  # cd httpd-2.2.4
  # ./configure --enable-ssl --enable-rewrite --enable-so --with-included-apr

configure の結果は config.log や build/config_vars.mk を参照のこと.

== ビルドとインストール

  # make
  # make install

/usr/local/apache2 以下にファイルがあることを確認する.


== インストールした実行ファイルへのパスの設定

インストールされた Apache のバイナリファイル群へパスを通す.

((<[EPA]パスの設定>)) の((* <一般ユーザ用コマンドのパス> *))
に ((*/usr/local/apache2/bin*)) を追加する.
(システム用コマンドも一般ユーザ用コマンドと同じ場所に
インストールされているため, システム用コマンド用の設定を
別途行う必要は無い).


== インストールしたマニュアルへのパスの設定

/etc/manpath.config に以下の行を追加する.
詳しくは ((<[EPA]パスの設定#man 関連のパスの設定>)) を参照のこと.

  MANDATORY_MANPATH                          /usr/local/apache2/man
  MANPATH_MAP        /usr/local/apache2/bin  /usr/local/apache2/man
  MANDB_MAP          /usr/local/apache2/man  /usr/local/apache2/man


== 設定ファイルの編集

設定ファイルは httpd 用が /usr/local/apache2/conf/httpd.conf,
httpd-ssl 用が /usr/local/apache2/conf/extra/httpd-ssl.conf である.
また各ユーザの public_html 以下の設定用が
/usr/local/apache2/conf/extra/httpd-userdir.conf である.
これらを編集する.

変更の要点は以下の通りである.

* httpd.conf
  * HTTP デーモンを起動するユーザを www-data にする.
  * サーバ管理者 (ServerAdmin) のメールアドレスを設定
  * サーバ名 (ServerName) を設定
  * サーバのデフォルトルート (DefaultRoot) を /~epalab に設定
  * ディレクトリのインデックスファイルに index.html 以外に
    index.htm index.htm.en index.html.en index.htm.ja index.html.ja
    も追加.
  * エラーログファイルを /var/log/httpd-error.log に設定
  * アクセスログファイルを /var/log/httpd-access.log に設定
  * CGI に関する設定を変更
  * extra/httpd-userdir.conf をロード
  * extra/httpd-ssl.conf をロード
  * /~gate, および /cgi-bin に対してのアクセスは
    HTTPS へ移動させる
    (((<参考資料|URL:#参考資料>)) 9, 10 参照).
  * ~epalab/hiki と ~itpass/hiki に関しての設定を各ディレクトリごとの
    .htaccess で可能とする (AllowOverride)
  * /hiki, /~epalab/hiki, /~itpass/hiki に対してのアクセスは
    HTTPS へ移動させる. その際, URI のエンコードは行わない.
    (((<参考資料|URL:#参考資料>)) 9, 10, 11 参照).

* httpd-userdir.conf
  * 所有者がマッチしなくてもシンボリックリンクの公開を許可する.
    (SymLinksIfOwnerMatch -> FollowSymLinks).

* httpd-ssl.conf
  * ドキュメントルート (DocumentRoot),
    サーバ名 (ServerName),
    サーバ管理者アドレス (ServerAdmin),
    エラーログ (ErrorLog),
    アクセスログ (TransferLog) の設定.


オリジナルとの diff は以下の通り.

  diff -u original/httpd.conf httpd.conf
  --- original/httpd.conf 2007-08-09 18:49:18.000000000 +0900
  +++ ./httpd.conf 2007-11-09 02:31:21.000000000 +0900
  @@ -61,8 +61,8 @@
   # It is usually good practice to create a dedicated user and group for
   # running httpd, as with most system services.
   #
  -User daemon
  -Group daemon
  +User www-data
  +Group www-data
   </IfModule>
  
   # 'Main' server configuration
  @@ -81,8 +81,8 @@
   # ServerAdmin: Your address, where problems with the server should be
   # e-mailed.  This address appears on some server-generated pages, such
   # as error documents.  e.g. admin@your-domain.com
  -#
  -ServerAdmin you@example.com
  +
  +ServerAdmin epaadmin_at_epa.scitec.kobe-u.ac.jp
  
   #
   # ServerName gives the name and port that the server uses to identify itself.
  @@ -91,14 +91,15 @@
   #
   # If your host doesn't have a registered DNS name, enter its IP address here.
   #
  -#ServerName www.example.com:80
  +ServerName epa.scitec.kobe-u.ac.jp:80
  
   #
   # DocumentRoot: The directory out of which you will serve your
   # documents. By default, all requests are taken from this directory, but
   # symbolic links and aliases may be used to point to other locations.
   #
  -DocumentRoot "/usr/local/apache2/htdocs"
  +#DocumentRoot "/usr/local/apache2/htdocs"
  +DocumentRoot "/home/epalab/public_html"
  
   #
   # Each directory to which Apache has access can be configured with respect
  @@ -112,7 +113,7 @@
       Options FollowSymLinks
       AllowOverride None
       Order deny,allow
  -    Deny from all
  +#    Deny from all
   </Directory>
  
   #
  @@ -125,7 +126,8 @@
   #
   # This should be changed to whatever you set DocumentRoot to.
   #
  -<Directory "/usr/local/apache2/htdocs">
  +#<Directory "/usr/local/apache2/htdocs">
  +<Directory "/home/epalab/public_html">
       #
       # Possible values for the Options directive are "None", "All",
       # or any combination of:
  @@ -160,7 +162,7 @@
   # is requested.
   #
   <IfModule dir_module>
  -    DirectoryIndex index.html
  +    DirectoryIndex index.html index.htm index.htm.en index.html.en index.htm.ja index.html.ja
   </IfModule>
  
   #
  @@ -180,7 +182,7 @@
   # logged here.  If you *do* define an error logfile for a <VirtualHost>
   # container, that host's errors will be logged there and not here.
   #
  -ErrorLog logs/error_log
  +ErrorLog /var/log/httpd-error.log
  
   #
   # LogLevel: Control the number of messages logged to the error_log.
  @@ -209,13 +211,13 @@
       # define per-<VirtualHost> access logfiles, transactions will be
       # logged therein and *not* in this file.
       #
  -    CustomLog logs/access_log common
  +    #CustomLog logs/access_log common
  
       #
       # If you prefer a logfile with access, agent, and referer information
       # (Combined Logfile Format) you can use the following directive.
       #
  -    #CustomLog logs/access_log combined
  +    CustomLog /var/log/httpd-access.log combined
   </IfModule>
  
   <IfModule alias_module>
  @@ -262,10 +264,12 @@
   # CGI directory exists, if you have that configured.
   #
   <Directory "/usr/local/apache2/cgi-bin">
  -    AllowOverride None
  -    Options None
  -    Order allow,deny
  -    Allow from all
  +    AllowOverride AuthConfig Limit
  +    Options ExecCGI FollowSymLinks IncludesNoExec
  +#    AllowOverride None
  +#    Options None
  +#    Order allow,deny
  +#    Allow from all
   </Directory>
  
   #
  @@ -376,7 +380,7 @@
   #Include conf/extra/httpd-languages.conf
  
   # User home directories
  -#Include conf/extra/httpd-userdir.conf
  +Include conf/extra/httpd-userdir.conf
  
   # Real-time info on requests and configuration
   #Include conf/extra/httpd-info.conf
  @@ -390,11 +394,10 @@
   # Distributed authoring and versioning (WebDAV)
   #Include conf/extra/httpd-dav.conf
  
  -# Various default settings
   #Include conf/extra/httpd-default.conf
  
   # Secure (SSL/TLS) connections
  -#Include conf/extra/httpd-ssl.conf
  +Include conf/extra/httpd-ssl.conf
   #
   # Note: The following must must be present to support
   #       starting without SSL on platforms with no /dev/random equivalent
  @@ -404,3 +407,62 @@
   SSLRandomSeed startup builtin
   SSLRandomSeed connect builtin
   </IfModule>
  +
  +#
  +# Settings for gate-toroku-system
  +#
  +<IfModule mod_rewrite.c>
  +    RewriteEngine On
  +    RewriteLog "/var/log/httpd-rewrite.log"
  +    RewriteLogLevel 0
  +
  +    RewriteCond %{SERVER_PORT} !^443$
  +    RewriteRule ^/~gate/(.*)?$ https://%{HTTP_HOST}/~gate/$1 [L,R]
  +</IfModule>
  +
  +<IfModule mod_rewrite.c>
  +    RewriteEngine On
  +    RewriteLog "/var/log/httpd-rewrite.log"
  +    RewriteLogLevel 0
  +
  +    RewriteCond %{SERVER_PORT} !^443$
  +    RewriteRule ^/cgi-bin/(.*)?$ https://%{HTTP_HOST}/cgi-bin/$1 [L,R]
  +</IfModule>
  +
  +#
  +# Settings for Hiki Area
  +#
  +<Directory /home/epalab/public_html/hiki >
  +    AllowOverride ALL
  +</Directory>
  +
  +<Directory /home/itpass/public_html/hiki >
  +    AllowOverride ALL
  +</Directory>
  +
  +<IfModule mod_rewrite.c>
  +    RewriteEngine On
  +    RewriteLog "/var/log/httpd-rewrite.log"
  +    RewriteLogLevel 0
  +
  +    RewriteCond %{SERVER_PORT} !^443$
  +    RewriteRule ^/hiki/(.*)?$ https://%{HTTP_HOST}/hiki/$1 [L,R]
  +</IfModule>
  +
  +<IfModule mod_rewrite.c>
  +    RewriteEngine On
  +    RewriteLog "/var/log/httpd-rewrite.log"
  +    RewriteLogLevel 0
  +
  +    RewriteCond %{SERVER_PORT} !^443$
  +    RewriteRule ^/~epalab/hiki/(.*)?$ https://%{HTTP_HOST}/~epalab/hiki/$1 [L,R,NE]
  +</IfModule>
  +
  +<IfModule mod_rewrite.c>
  +    RewriteEngine On
  +    RewriteLog "/var/log/httpd-rewrite.log"
  +    RewriteLogLevel 0
  +
  +    RewriteCond %{SERVER_PORT} !^443$
  +    RewriteRule ^/~itpass/hiki/(.*)?$ https://%{HTTP_HOST}/~itpass/hiki/$1 [L,R,NE]
  +</IfModule>


  diff -u original/extra/httpd-userdir.conf extra/httpd-userdir.conf
  --- original/extra/httpd-userdir.conf 2007-08-09 18:49:18.000000000 +0900
  +++ extra/httpd-userdir.conf  2007-11-08 05:01:27.000000000 +0900
  @@ -15,7 +15,7 @@
   #
   <Directory /home/*/public_html>
       AllowOverride FileInfo AuthConfig Limit Indexes
  -    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
  +    Options MultiViews Indexes FollowSymLinks IncludesNoExec
       <Limit GET POST OPTIONS>
           Order allow,deny
           Allow from all

  diff -u original/extra/httpd-ssl.conf extra/httpd-ssl.conf
  --- original/extra/httpd-ssl.conf       2007-08-09 18:49:18.000000000 +0900
  +++ extra/httpd-ssl.conf        2007-08-09 18:56:37.000000000 +0900
  @@ -74,11 +74,11 @@
  
   #   General setup for the virtual host
  -DocumentRoot "/usr/local/apache2/htdocs"
  -ServerName www.example.com:443
  -ServerAdmin you@example.com
  -ErrorLog /usr/local/apache2/logs/error_log
  -TransferLog /usr/local/apache2/logs/access_log
  +DocumentRoot "/home/epalab/public_html"
  +ServerName epa.scitec.kobe-u.ac.jp:443
  +ServerAdmin epaadmin_at_epa.scitec.kobe-u.ac.jp
  +ErrorLog /var/log/httpd-ssl-error.log
  +TransferLog /var/log/httpd-ssl-access.log
  
   #   SSL Engine Switch:
   #   Enable/Disable SSL for this virtual host.


== ログローテートの設定

/etc/logrotate.conf を編集して圧縮オプションを追加する. (compressのコ
メントアウトを外す).

/etc/logrotate.d/ 以下に apache2 というファイルを置き, 以下の
内容を書き込む.

    /var/log/httpd-access.log {
        missingok
        rotate 12
        postrotate
            /usr/bin/killall -HUP httpd 2> /dev/null || true
        endscript
    }

    /var/log/httpd-error.log {
        missingok
        rotate 12
        postrotate
            /usr/bin/killall -HUP httpd 2> /dev/null || true
        endscript
    }

    /var/log/httpd-ssl-access.log {
        missingok
        rotate 12
        postrotate
            /usr/bin/killall -HUP httpd 2> /dev/null || true
        endscript
    }

    /var/log/httpd-ssl-error.log {
        missingok
        rotate 12
        postrotate
            /usr/bin/killall -HUP httpd 2> /dev/null || true
        endscript
    }

== SSL 用の証明書の作成

openssl の設定を変更

  # vi /etc/ssl/openssl.cnf

  [usr_cert] セクションの
  nsCertType=server のコメントを外す

  [v3_ca] セクションの
  nsCertType=sslCA,emailCA のコメントを外す.

証明書を作成する.

  # cd /usr/local/apache2/conf
  # /usr/lib/ssl/misc/CA.sh -newca

  CA certificate filename: (空で Enter)

  Enter PEM pass phrase: (適当な文字列入力. 後で消す)

  Country Name (2 letter code) [AU]: JP
  State or Province Name [Some-State]: Hyogo
  Locality Name (eg, city) []: Kobe
  Organization Name (eg, company) []: Kobe University
  Organizational Unit Name (eg, section) []: EPA lab.
  Common Name: epa.scitec.kobe-u.ac.jp
  Email Address: epaadmin_at_epa.scitec.kobe-u.ac.jp
  A challenge password: (空で Enter)
  A optional company name: (空で Enter)

  Enter pass phrase for ./demoCA/private/./cakey.pem: (適当な文字列入力. 後で消す)

パスフレーズを消す. 問われるパスフレーズには空文字を与える.

  # openssl rsa -in ./demoCA/private/cakey.pem -out ./demoCA/private/cakey.pem

証明書の作成.

  # openssl x509 -in ./demoCA/cacert.pem -out ./demoCA/server.crt

ブラウザに登録されるバイナリ DER フォーマットで記述された
ファイルの作成.

  # openssl x509 -inform pem -in ./demoCA/cacert.pem -outform der -out ./demoCA/ca.der

これらの作業により, demoCA 以下に server.crt と ca.der が作成される.
これらのファイルをカレントディレクトリである
/usr/local/apache2/conf 以下にコピーする.

  # cp demoCA/server.crt .
  # cp demoCA/ca.der .

server.key を demoCA/private/cakey.pem からコピーする.

  # cp demoCA/private/cakey.pem ./server.key

これで鍵の作成は完了である.

== 動作チェック

apache は /usr/local/apache2/bin/apachectl で起動/停止する.
以下のコマンドで apache を起動する.

  # /usr/local/apache2/bin/apachectl -k start

停止するには以下のようにすると良い

  # /usr/local/apache2/bin/apachectl -k graceful-stop


== 起動スクリプトを用意する

サーバの起動時に自動的に起動させるため, apache2 の起動スクリプト
を用意する.

Debian の apache パッケージに含まれる/etc/init.d/apache を元に
起動スクリプトを apache2 用に多少書き換えたものが
((<apache2|URL:../epa/apache/apache2>))
から入手できる. このファイルを /etc/init.d/apache2 にコピーし,
以下のようにパーミッションを設定する.

  # wget http://epa.scitec.kobe-u.ac.jp/~itpass/epa/apache/apache2
  # cp apache2 /etc/init.d/
  # chown root:root /etc/init.d/apache2
  # chmod 755 /etc/init.d/apache2

ランレベルごとに apache2 の動作を設定する.

  # update-rc.d apache2 defaults

サーバを再起動し, 起動時にa pache が起動することを確認する.


== 補足事項

=== ロード済みモジュールの表示

以下のように httpd コマンドに -M オプションをつけて実行することで,
静的にロードされたモジュールと動的にロードされたモジュールの両方が
表示される.

  $ /usr/local/apache2/bin/httpd -M

以下のように -l オプションを指定すると, 組み込みモジュールのリストが
表示できる.

  $ /usr/local/apache2/bin/httpd -l

== 参考資料

(1) ((<平衡点 -- equilibrium point -- > [comp][debian] apache2 + sslCommentsAdd Star|URL:http://d.hatena.ne.jp/sasakyh/searchdiary?word=apache2+ssl&.submit=%B8%A1%BA%F7&type=detail>))

(2) ((<EP WWW サーバ構築ログ (ログローテートに関して)|URL:http://www.ep.sci.hokudai.ac.jp/~epwww/dvlop/apache.html>))
  
(3) ((<apxsでapacheにモジュールを追加する|URL:http://kazmax.zpp.jp/apache/apache3.html>))

(4) ((<@IT > Linux Square > Apacheの基本インストール|URL:http://www.atmarkit.co.jp/flinux/rensai/apache03/apache03e.html>))

(5) ((<@IT > Linux Square > Apache 2.2でWebサイトをパフォーマンスアップ!|URL:http://www.atmarkit.co.jp/flinux/special/apache22/apache01.html>))

(6) ((<SSL-Webサーバー-CA公開カギを準備する|URL:http://safe-linux.homeip.net/web/linux-ssl_web-07.html>))

(7) ((<OpenSSLでの自己認証局(CA)と自己証明書の作成|URL:http://park15.wakwak.com/~unixlife/practical/openssl.html>))

(8) ((<apache2.2 インストール|URL:http://kazmax.zpp.jp/apache/apache.html>))

(9) ((<パソコンおやじ -- HTTPでアクセスした時、自動的にHTTPSにrewriteする方法|URL:http://www.aconus.com/~oyaji/tips/apache_tips1.htm>))

(10) ((<SquirrelMailの導入|URL:http://www.aconus.com/~oyaji/mail2/squirrelmail.htm>))

(11) ((<Apache 2.0 Documentation -- mod_rewrite|URL:http://httpd.apache.org/docs/2.0/ja/mod/mod_rewrite.html>))