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

ビルドのための設定
ビルドとインストール
インストールした実行ファイルへのパスの設定
インストールしたマニュアルへのパスの設定
設定ファイルの編集
ログローテートの設定
SSL 用の証明書の作成
動作チェック
起動スクリプトを用意する
補足事項
- ロード済みモジュールの表示
参考資料

以下では, 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 へ移動させる (参考資料 9, 10 参照).
- ~epalab/hiki と ~itpass/hiki に関しての設定を各ディレクトリごとの .htaccess で可能とする (AllowOverride)
- /hiki, /~epalab/hiki, /~itpass/hiki に対してのアクセスは HTTPS へ移動させる. その際, URI のエンコードは行わない. (参考資料 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 から入手できる. このファイルを /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

参考資料

Last modified:2007/11/24 06:31:11
Keyword(s):
References:[[EPA2007]2007年度サーバ構築ログ] [消えたページ一覧]

[EPA]apache2のインストールと設定

ビルドのための設定

ビルドとインストール

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

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

設定ファイルの編集

ログローテートの設定

SSL 用の証明書の作成

動作チェック

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

補足事項

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

参考資料

最近の更新

2024-04-09

2024-04-08

2023-10-04

2023-08-16

2023-08-09

2023-08-08

2023-08-07

2023-08-06

2023-08-05

2023-08-04