### OpenLiteSpeed Web Server ユーザーズマニュアル

##### Version 1.4 — Rev. 3

- ライセンス
- はじめに
- インストール
- 管理
  - サービスマネージャ
- セキュリティ
- 設定
  - サーバー全般
  - サーバーログ
  - サーバーのチューニング
  - サーバーのセキュリティ
  - 外部アプリ
  - Fast CGIアプリ
  - Fast CGIオーソライザー
  - LSAPIアプリ
  - サーブレットエンジン
  - Webサーバー
  - パイプロガー
  - ロードバランサ
  - スクリプトハンドラ
  - Rack/Railsの設定
  - モジュール設定
  - リスナー全般
  - リスナーのSSL
  - テンプレート
  - バーチャルホストの基本
  - バーチャルホスト全般
  - バーチャルホストのセキュリティ
  - バーチャルホストのSSL
  - Rewrite
  - コンテキスト
  - 静的コンテテキスト
  - Java Webアプリのコンテキスト
  - サーブレットコンテキスト
  - Fast CGIコンテキスト
  - LSAPIコンテキスト
  - プロキシコンテキスト
  - CGIコンテキスト
  - ロードバランサコンテキスト
  - コンテキストのリダイレクト
  - Rack/Railsのコンテキスト
  - モジュールハンドラのコンテキスト
  - Web Socketプロキシ
- Webコンソール
  - 管理コンソール全般
  - 管理コンソールのセキュリティ
  - 管理リスナー全般
  - 管理リスナーのSSL

# インストール/アンインストール

### 最小システム要件

- オペレーティングシステム：
  - Linux(i386): カーネル 2.4以上, glibc-2.2以上
  - CentOS: 5以上
  - Ubuntu: 8.04以上
  - Debian: 4以上
  - FreeBSD(i386): 4.5以上
  - MacOSX: 10.3以上
- CPU:
  - Intel: 80486以上
  - PowerPC: PowerPC G4
- メモリ: 32MB以上
- ディスク:
  - インストール: 200MB
  - ランタイム：300MB以上、スワップスペースは使用方法によって異なります。

### インストール

インストールはコマンドライン端末で行う必要があります。 テストの目的で、LiteSpeed Webサーバーは特権のないユーザーによってホームディレクトリにインストールできます。 プロダクション用には、システムディレクトリにインストールする必要があります。

Mac OS Xでは、ルートユーザーはデフォルトで無効になっています。 アップルのWebサイトで詳述されている一連の操作を使用して有効にすることができます。 sudoコマンドを使用して、rootユーザーを有効にせずにLSWSをシステムディレクトリにインストールすることもできますが、システムフォルダはrootユーザーだけが操作できます。 つまり、コマンドライン端末からLSWSを制御したいとき（LSWSを起動または停止したいときなど）には、sudoコマンドを使用する必要があります。

#### インストール手順：

1. 便利な場所にパッケージをダウンロードして解凍します：

   wget http://open.litespeedtech.com/packages/openlitespeed.1.0.tgz; tar zxf openlitespeed.1.0.tgz

2. インストールディレクトリに移動し、パッケージをrootユーザとしてコンパイルしてインストールします（実稼働環境用）：

   cd openlitespeed
   ./configure
   make && make install

   ノート： OpenLiteSpeedをコンパイルしてインストールする前に、PCRE、Expat、OpenSSL、GeoIP、zlibの次のパッケージをインストールする必要があります。

   - CentOS 5. *および6. *

     wget http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm; rpm -Uvh epel-release-5-4.noarch.rpm (CentOS 5.* のみ)

     wget http://dl.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm; rpm -Uvh epel-release-6-8.noarch.rpm (CentOS 6.* のみ)

     yum install gcc gcc-c++ make glibc

     yum install pcre-devel expat-devel openssl-devel geoip-devel zlib-devel

   - Ubuntu/Debian

     apt-get install build-essential

     apt-get install libpcre3-dev libexpat1-dev libssl-dev libgeoip-dev zlib1g-dev

   - FreeBSD

     pkg_addまたはportsを使用してください。 portsを使用した例をいくつか示します。
     cd /usr/ports/devel/pcre; make install clean; rehash;
     cd /usr/ports/net/GeoIP; make install clean; rehash;
     cd /usr/ports/textproc/expat2; make install clean; rehash;
     cd /usr/ports/security/openssl; make install clean; rehash;

   - Mac OS X

     Install Xcode from https://developer.apple.com/xcode/

     Install MacPorts from http://www.macports.org/install.php#pkg

     sudo port install pcre expat openssl libgeoip zlib

     ノート： OS Xユーザーがconfigureコマンドを実行するとき、PCREパッケージがMacPorts経由で追加されている場合、PCREパッケージを探す場所を指定するパラメータを追加する必要があります。 これは、MacPortsが非標準の場所（/opt/local/）にインストールするためです。 例えば：

     ./configure --with-pcre=/opt/local

3. デフォルトでは、インストーラはサンプルサイトをポート8088にインストールし、WebAdminコンソール（LiteSpeed GUI）をポート7080に設定します。 （ユーザー：admin、パスワード：123456、管理者メール：root@localhost）

### スタートする

1. サーバープロセスの制御の詳細については、「管理者ガイド」を参照してください。

   サーバーを起動するには、単に [your_install_dir]/bin/lswsctrl start を実行してください。(それを止めるには、 [your_install_dir]/bin/lswsctrl stop。)

2. サンプルサイトがサーバー上で実行されている必要があります。

   サイトにアクセスするには、ブラウザでhttp：//[アドレス]：8088/にアクセスし、[アドレス]はWebサーバーマシンのIPアドレスまたはドメイン名を指定します。 サーバーが使用しているマシン上にある場合は、「localhost」を使用します。 "8088"がデフォルトのポートです。 インストール中にLiteSpeedの別のポートを選択した場合は、指定したポートを使用してください。

   他のテストページにリンクされているおめでとうページは、上記のアドレスを指し示すとブラウザに読み込まれます。 そうでない場合は、WebAdminインターフェイスをテストしてみてください。

3. WebAdminコンソールのデフォルトポートは7080です。

   http：// [アドレス]：7080 /をブラウザに入力し、WebAdminインターフェイスに移動します。 （インストール中にWebAdminのポートを変更した場合は、代わりにそのポートを使用してください）。

   [アドレス]にサーバーが稼動しているマシンを現在使用している場合は、「localhost」を使用することができます。

   WebAdminのウェルカムページが読み込まれます。 [ログオン]リンクをクリックし、インストール時に指定した管理者のユーザー名とパスワードを使用してログオンします。

   設定に関する詳細については、設定ガイドを参照するか、各ページの上部にある[ヘルプ]リンクをクリックしてください。

4. サーバーがファイアウォールを使用している場合は、localhostが信頼できるものであることを確認してください。

   たとえば、IPTablesを持つLinuxには、LOからのALLOW INPUTルールを含める必要があります。

5. WebサイトとWebAdminインターフェイスにアクセスできない場合は、エラーログ [your_install_dir]/logs/error.logを参照してください。

   TCPポートが他のサーバーアプリケーションと競合する場合は、Webサーバーを使用可能なポートで再インストールする必要があります。 次のコマンドを使用して、使用可能なポートを見つけることができます： netstat -an | grep XXXX XXXXはポート番号です。 ポートが使用可能な場合、コマンドは出力を生成しません。

   スワッピングディレクトリが書き込み可能でない場合は、スワッピングディレクトリの書き込み権限をWebサーバーが実行されているユーザーに許可するか、スワップディレクトリの設定を手動で変更します。 スワップディレクトリは、サーバーのXML構成ファイルで構成されます。 [your_install_dir]/conf/httpd_config.xmlに移動します。 swappingDirのXMLファイルを検索します。 スワップディレクトリのデフォルトの場所は/tmp/lshttpd/swapです。

   まだインストールに問題がある場合は、私たちのwikiをチェックするか、サポートフォーラムで問題を投稿してください。

### ノート

- OpenLiteSpeedは、ネイティブのLiteSpeed XML設定ファイルとプレーンテキスト設定ファイル（Apacheのhttpd.confの編集に使用されるもの）の両方をサポートします。 [your_install_dir]/conf/switch_config.shを実行して、これらの形式を切り替えます。
- FreeBSD、Mac OS X、Ubuntu、Debianでは、出荷されたPHP（CentOS用）は動作しません。 OpenLiteSpeedでPHPアプリケーションを実行するには、OpenLiteSpeed用の新しいPHPをビルドする必要があります。

# アンインストール手順

1. 実行中のOpenLiteSpeedを停止する： [your_install_dir]/bin/lswsctrl stop
2. インストールディレクトリを削除します： rm -rf [your_install_dir]