6.1 ディレクティブの注意事項

ディレクティブ設定時の注意事項について以下に説明します。

注意

本マニュアルと「Apache HTTP サーババージョン 2.4 ドキュメント」において、ディレクティブ名の大文字／小文字が異なる場合がありますが、ディレクティブ名に大文字／小文字の区別はないため、問題ありません。

注1) Aliasディレクティブの注意事項

Aliasディレクティブのディレクトリパスにネットワーク上の共有フォルダを指定する場合は、UNCパス（//コンテンツ格納先のホスト名/共有フォルダ名/）で指定してください。

注2) AliasMatchディレクティブの注意事項

AliasMatchディレクティブのディレクトリパスにネットワーク上の共有フォルダを指定する場合は、UNCパス（//コンテンツ格納先のホスト名/共有フォルダ名/）で指定してください。

注3) AuthGroupFileディレクティブの注意事項

AuthGroupFileディレクティブに指定するグループファイルには、1行にグループ名およびユーザ名を8191バイト以内の文字列で記述してください。1行に8192バイト以上の文字列を記述すると、8192バイト目以降の文字列が無効となります。

注4) CacheRootディレクティブの注意事項

ProxyRequestsディレクティブに「On」を設定し、CacheRootディレクティブを設定しなかった場合は、プロキシ機能は使用できますが、キャッシュ機能は使用できません。
CacheRootディレクティブに設定したディレクトリには、以下の権限を設定してください。
- ユーザ：Userディレクティブに設定したユーザ
- グループ：Groupディレクティブに設定したグループ

注5) DocumentRootディレクティブの注意事項

本製品のインストール直後は、DocumentRootディレクティブに設定したディレクトリ配下に、サンプルのコンテンツが格納されています。Webサーバの運用に応じて、不要なサンプルのコンテンツを削除するか、またはDocumentRootディレクティブに指定するディレクトリを変更してください。
DocumentRootディレクティブにネットワーク上の共有フォルダを指定する場合は、UNCパス（//コンテンツ格納先のホスト名/共有フォルダ名）で指定してください。
DocumentRootディレクティブに指定するディレクトリには、NFSサーバへのマウントポイントを指定できますが、Webサーバ運用中は常にNFSサーバへのアクセスが可能である必要があります。Webサーバを起動する前にNFSサーバが正常に起動されていることを確認してください。また、Webサーバ運用中は、NFSサーバへのアクセスが不可となるような操作（NFSサーバの電源断など）を行わないでください。

注6) ErrorDocumentディレクティブの注意事項

ErrorDocumentディレクティブに指定可能なエラードキュメント、およびそのエラードキュメントに対してクライアントに通知可能なステータスコードを以下に示します。ステータスコードの意味については、「メッセージ集」の「Webサーバから通知されるステータスコード」を参照してください。

エラードキュメント	ステータスコード
テキストメッセージ出力するテキストメッセージを指定する場合は、ダブルクォーテーション(")で囲んで指定します。テキストメッセージに、日本語は使用できません。	300、301、302、303、400、401、403、404、405、406、407、409、410、411、413、414、415、416、417、423、424、500、501、502、503、504、506、507
内部URL 内部URLにリダイレクトする場合は、先頭にスラッシュ(/)を付加してリダイレクト先をDocumentRootディレクティブからの相対パスで指定します。	204、300、301、302、303、401、403、404、405、406、409、410、411、413()、415、416、423、424、500、501()、502、503、504、506、507
外部URL 外部URLにリダイレクトする場合は、完全修飾URLでリダイレクト先を指定します。	204、300、301、302、303、403、404、405、406、409、410、411、413、415、416、423、424、500、501、502、503、504、506、507

*）静的コンテンツへの内部リダイレクトは指定できますが、CGIを利用した内部リダイレクトは指定できません。

注7) ErrorLogディレクティブの注意事項

Interstage HTTP Server 2.4では、「syslog」を使用できません。
メインホスト・バーチャルホストそれぞれにErrorLogディレクティブを複数設定した場合は、それぞれ最後に定義した設定が有効となります。

注8) FileETagディレクティブの注意事項

FileETagディレクティブの「デフォルト」と「All」の説明に誤りがあります。正しい説明を以下に示します。

誤	正
デフォルト：FileETag MTime Size	デフォルト：FileETag Size MTime
All：使用可能なすべてのフィールドを使います。これは FileETag MTime Size と等価です。	All：使用可能なすべてのフィールドを使います。これは FileETag Size MTime と等価です。

注9) LimitInternalRecursionディレクティブの注意事項

内部リダイレクト数またはサブリクエスト数がLimitInternalRecursionディレクティブの設定値を超過した場合は、クライアントにステータスコード「500」（Internal Server Error）で応答を返します。

注10) Listenディレクティブの注意事項

Listenディレクティブに設定するIPアドレスには、IPv4射影アドレスを指定できません。
ListenディレクティブのIPアドレスにはIPv6アドレスのリンクローカルアドレスを指定できません。リンクローカルアドレスを指定すると、システムログにエラーメッセージahs00018を出力し、Webサーバの起動に失敗します。
ポート番号には、システム上のアプリケーションを含むすべてのサービスにおいてそれぞれ異なるポート番号を設定する必要があります。
Interstage HTTP Server 2.4が使用しているポート番号については「A.2 ポート番号」を、本製品が使用しているポート番号については「システム設計ガイド」の「ポート番号」を参照してください。

注11) ListenBackLogディレクティブの注意事項

ListenBackLogディレクティブに設定するキューの最大数の指定範囲およびデフォルト値は、オペレーティングシステムにより異なります。それぞれの値を以下に示します。
キューの最大数の指定範囲
デフォルト値
1～200
ListenBacklog 200

1～2147483647
ListenBacklog 511

	キューの最大数の指定範囲	デフォルト値
	1～200	ListenBacklog 200
	1～2147483647	ListenBacklog 511

MaxRequestWorkersディレクティブに設定したクライアント同時接続数よりも多くの接続要求があった場合、キューイングされる数の最大値は、以下の条件に応じた値となります。

多重接続時の動作については、「1.2 Webサーバのプロセス構成(Windows(R))」の「最大多重動作」または「1.3 Webサーバのプロセス構成(Solaris/Linux)」の「最大多重動作」を参照してください。

	条件	接続待ちキューの最大数
	なし	ListenBackLogディレクティブの設定値＋ 1
	ListenBackLogディレクティブの設定値 ≦ 待機中TCPコネクションの最大値 (注)	ListenBackLogディレクティブの設定値
	ListenBackLogディレクティブの設定値＞待機中TCPコネクションの最大値 (注)	待機中TCPコネクションの最大値 (注)

注）待機中TCPコネクションの最大値は、各オペレーティングシステムにおいて以下のコマンドを実行して確認します。待機中TCPコネクションの設定およびコマンドの詳細については、オペレーティングシステムのドキュメントを参照してください。

	待機中TCPコネクションの最大値	コマンド実行例
	tcp_conn_req_max_q	/usr/sbin/ndd /dev/tcp tcp_conn_req_max_q
	/proc/sys/net/core/somaxconn	/sbin/sysctl -n net.core.somaxconn

クライアントからの接続要求が以下の値を超過した場合は、この接続要求を受け付けず、ステータスコードも返却しません。
```
クライアント同時接続数＋接続待ちキューの最大数 ＋1
```
```
クライアント同時接続数＋接続待ちキューの最大数 ＋α
```
α：オペレーティグシステムの仕様に応じた値

注12) MaxKeepAliveRequestsディレクティブの注意事項

サーバの機能を最大に設定する場合は、リクエスト数に「0」を指定することを推奨します。「1」以上の値を指定すると、「指定したリクエスト数＋1」のリクエストを処理したあと、コネクションを切断します。

注13) MaxRangesディレクティブの注意事項

MaxRangesディレクティブに設定するHTTP範囲指定の数がMaxRangesディレクティブの設定値を超過した場合、HTTP範囲指定は無効となります。

注14) MaxConnectionsPerChildディレクティブの注意事項

常に「0」を指定することを推奨します。設定値が「0」以外の場合、デーモンプロセスの再起動時に環境定義ファイル（httpd.conf）を再読み込みします。再読み込み時に環境定義ファイルが更新されていた場合、このタイミングで反映されるため注意してください。

注15) ScriptAliasディレクティブの注意事項

ScriptAliasディレクティブのディレクトリパスにネットワーク上の共有フォルダを指定する場合は、UNCパス（//コンテンツ格納先のホスト名/共有フォルダ名/）で指定してください。

注16) ScriptAliasMatchディレクティブの注意事項

ScriptAliasMatchディレクティブのディレクトリパスにネットワーク上の共有フォルダを指定する場合は、UNCパス（//コンテンツ格納先のホスト名/共有フォルダ名/）で指定してください。

注17) SendBufferSizeディレクティブの注意事項

オペレーティングシステムに設定されているTCP/IPの送信バッファサイズは、以下のコマンドを実行して確認してください。TCP/IPの送信バッファサイズの設定およびコマンドの詳細については、オペレーティングシステムのドキュメントを参照してください。

	TCP/IPの送信バッファサイズ	コマンド実行例
	tcp_xmit_hiwat	/usr/sbin/ndd /dev/tcp tcp_xmit_hiwat
	tcp_wmem	/sbin/sysctl -n net.ipv4.tcp_wmem [表示結果] 4096 16384 131072 注）TCP/IPの送信バッファサイズは、中央の値です。上記の表示結果の場合、「16384」となります。

TCP/IPの送信バッファサイズ

コマンド実行例

tcp_xmit_hiwat

/usr/sbin/ndd /dev/tcp tcp_xmit_hiwat

tcp_wmem

/sbin/sysctl -n net.ipv4.tcp_wmem

[表示結果]
4096 16384 131072

注）TCP/IPの送信バッファサイズは、中央の値です。上記の表示結果の場合、「16384」となります。

注18) ServerLimitディレクティブの注意事項

ServerLimitディレクティブは、MaxRequestWorkersディレクティブの前に設定してください。

注19) ServerNameディレクティブの注意事項

ServerNameディレクティブに設定するIPアドレスには、IPv6アドレスを指定できません。

注20) SSLCipherSuiteディレクティブの注意事項

SSLCipherSuiteディレクティブで推奨される暗号スイートは以下となります。
以下の指定値以外の暗号スイートを指定する場合は、脆弱性、暗号強度を確認の上、ユーザの責任においてご利用ください。

■TLS1.2

指定値	一般名
ECDHE-RSA-AES128-GCM-SHA256	TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
ECDHE-RSA-AES256-GCM-SHA384	TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
ECDHE-RSA-CHACHA20-POLY1305	TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
DHE-RSA-AES128-GCM-SHA256	TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
DHE-RSA-AES256-GCM-SHA384	TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
DHE-RSA-CHACHA20-POLY1305	TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
ECDHE-RSA-AES128-SHA256	TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
ECDHE-RSA-AES256-SHA384	TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
ECDHE-RSA-AES128-SHA	TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
ECDHE-RSA-AES256-SHA	TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
DHE-RSA-AES128-SHA256	TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
DHE-RSA-AES256-SHA256	TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
DHE-RSA-AES128-SHA	TLS_DHE_RSA_WITH_AES_128_CBC_SHA
DHE-RSA-AES256-SHA	TLS_DHE_RSA_WITH_AES_256_CBC_SHA

■TLS1.3

指定値	一般名
TLS_AES_128_GCM_SHA256	TLS_AES_128_GCM_SHA256
TLS_AES_256_GCM_SHA384	TLS_AES_256_GCM_SHA384
TLS_CHACHA20_POLY1305_SHA256	TLS_CHACHA20_POLY1305_SHA256

注21) SSLOpenSSLConfCmdディレクティブの注意事項

構文：SSLOpenSSLConfCmd command-name command-value

SSLOpenSSLConfCmdディレクティブで command-name に Groups を設定した場合にcommand-valueで認識できる楕円暗号はX25519,X448のみです。
SSLOpenSSLConfCmdディレクティブで command-name に SignatureAlgorithms, ClientSignatureAlgorithms を設定した場合にcommand-valueで認識できる楕円暗号はed25519,ed448のみです。

注22) ThreadsPerChildディレクティブの注意事項

ThreadsPerChildディレクティブの設定値を超過するクライアントの接続要求があった場合は、Webサーバ内およびオペレーティングシステム内の接続待ちキューに保存されます。オペレーティングシステム内の接続待ちキュー数は、ListenBacklogディレクティブで最大数を設定します。
多重接続時の動作については、「1.2 Webサーバのプロセス構成(Windows(R))」の「最大多重動作」を参照してください。

注23) TimeOutディレクティブの注意事項

telnetを利用した場合、設定値どおりにタイムアウトされない場合があります。約30秒ほど遅れて切断される場合があります。通常のデータ送信を伴う状況では問題ありませんが、telnetのような接続のみのケースの場合、実測によりTimeoutディレクティブの値をチューニングしてください。