LiteSpeed Web Server logo LiteSpeed Web Serverユーザーズ・マニュアル
ホーム

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


最小システム要件

  • オペレーティングシステム:
    • Linux: カーネル 3.0+
    • CentOS: 7+
    • Ubuntu: 18.04+
    • Debian: 9+
    • FreeBSD: 12.0+
  • CPU:
    • Intel: x86-64
    • ARM: aarch64 (Linuxのみ)
  • メモリ: 512MB以上
  • ディスク:
    • インストール: 200MB
    • 実行時: 300MB以上。スワップ領域は使用状況によって異なります。

注意: RAM制限付きのLSWSライセンスは、LXCコンテナ (Proxmoxを含む) での利用には推奨されません。LiteSpeedは sysinfo() を使ってメモリサイズを検出します。 そのため、LXCコンテナではホスト側のメモリサイズが返され、RAM制限に達する可能性があります。 RAM無制限ライセンスではこの問題は発生しません。


インストール


インストールはコマンドライン端末で実行する必要があります。テスト目的であれば、 LiteSpeed Web Serverは非特権ユーザーがホームディレクトリにインストールできます。 本番環境では、システムディレクトリにインストールする必要があります。


Mac OS Xでは、rootユーザーはデフォルトで無効になっています。 有効化の手順は Apple のWebサイトに記載されています。 rootユーザーを有効にしなくても、sudoコマンドを使ってLSWSをシステムディレクトリへ インストールできますが、システムフォルダを操作できるのは引き続きrootユーザーのみです。 つまり、コマンドライン端末からLSWSを制御したい場合 (LSWSを起動または停止する場合など) は、 毎回sudoコマンドを使用する必要があります。


インストール手順

  1. パッケージを扱いやすい場所に展開します:
    tar xvfz lsws-xxxx.tar.gz または gunzip -c lsws-xxxx.tar.gz | tar xvf -
  2. 試用ライセンスキーまたはシリアル番号をインストールします:
    • 試用ライセンス:

      試用ライセンスは評価目的のみで使用でき、ダウンロード後15日間だけ有効です。 試用ライセンスはダウンロードページから申請できます。

      試用ライセンスキーは確認メールの添付ファイルとして送信されます。 添付ファイルを trial.key として保存し、 インストールディレクトリにコピーしてください。

      試用ライセンスから本番ライセンスへ切り替える場合は、以下の手順でライセンスを更新した後、 installスクリプトを再度実行するだけで構いません。

    • 本番ライセンス:
      1. ライセンスはLiteSpeedの ストアでレンタルまたは購入できます。
      2. 注文の処理が完了すると、確認メールでシリアル番号が送信されます。 各シリアル番号は1台のサーバーに対するインストールを許可します。
      3. シリアル番号を serial.no としてインストールディレクトリ ( install.sh がある場所) に保存してください。 LiteSpeed製品登録サーバーは、このファイルを使用してインストール中にライセンスキーを取得します。

  3. インストールディレクトリへ移動し、cd lsws-xxxx コマンド ./install.sh を実行します。これにより LiteSpeedインストーラが起動します。

    サーバーをシステムディレクトリへインストールできるのは、このコマンドを "root" ユーザーとして実行した場合のみです。その他のユーザーは、 ホームディレクトリ配下のどこかにインストールする必要があります。

    Mac OS Xユーザーは、sudo ./install.sh コマンドでサーバーをシステムディレクトリへインストールできます。

  4. エンドユーザー使用許諾契約書を読み、同意するには "Yes" と入力してください。
  5. LiteSpeed Web Serverをインストールするディレクトリを指定します。 rootユーザーのデフォルトは /usr/local/lsws です。非特権ユーザーでは ホームディレクトリがデフォルトになります。非特権ユーザーはシステムディレクトリへ サーバーをインストールできない点に注意してください。
  6. ライセンス要求を生成します。

    インストーラがシリアル番号だけを見つけ、有効なライセンスキーを見つけられない場合、 ライセンス要求の生成を促します。インストーラはLiteSpeed製品登録サーバーと通信し、 有効なライセンスキーを自動的に取得します。取得に成功すると次の手順へ進みます。 失敗した場合はインストーラが終了し、ライセンス要求ファイルが残されます。

    自動処理が失敗した場合は、オンラインストアのクライアントエリアから ライセンス部門へチケットを作成できます。

    注意: 有効な試用ライセンスまたはライセンスキーがある場合にのみ、インストールは継続されます。

  7. 画面の指示に従ってください。インストーラは次の項目の設定を求めます:
    1. 以前にインストールされたコピーがある場合、インストーラはアップグレード、 再インストール、またはディレクトリ変更のいずれかを選ぶよう求めます。 アップグレードを選ぶと現在の設定は保持されます。
    2. WebAdminコンソールの管理者ユーザー名とパスワード。
    3. LSWSで使用するコントロールパネル (必要な場合)。
    4. サーバープロセスが実行されるユーザーとグループ。
    5. 通常のWebサービス用TCPポート。
    6. WebAdminコンソール用TCPポート。
    7. LiteSpeed PHPを設定するかどうか。
    8. rootユーザーはchrootを有効にすることもできます。インストーラは初期のchroot環境を 自動的に設定します。chrootは高度な機能であり、設定の調整なしではCGIが失敗する可能性があります。 この機能に慣れていない場合は、chrootを有効にしないことを強く推奨します。 後からアップグレードインストールを実行することで、いつでも有効にできます。

    最後に、Web統計を追跡するためのAWStatsアドオンモジュールをインストールするかどうかを インストーラが確認します。rootユーザーは、LiteSpeed Web Serverをシステム起動時に サービスとして自動起動するよう設定することもできます。これでインストールは完了し、 インストーラからサーバーを起動できます。


インストールのテスト

  1. サーバープロセスの制御に関する詳細は、 管理ガイドを参照してください。サーバーを起動するには、 [your_install_dir]/bin/lswsctrl start を実行するだけです。

  2. サイトへアクセスするには、ブラウザで http://[address]:8088/ を開きます。 [address] はWebサーバーマシンの IPアドレスまたはドメイン名です。サーバーが現在使用しているマシン上にある場合は "localhost" を使用してください。 "8088" はデフォルトポートです。インストール時にポートを変更した場合は、 指定したポートを使用してください。ブラウザにはお祝いページが表示されるはずです。 表示されない場合は、WebAdminコンソールを確認してください。

  3. WebAdminコンソールのデフォルトポートは7080です。 https://[address]:7080/ をブラウザに入力して、 WebAdminコンソールへアクセスしてください。(インストール時にWebAdminコンソールのポートを変更した場合は、 そのポートを使用してください。) サーバーと同じマシンを使用している場合、[address] には "localhost" を使用できます。WebAdminコンソールのウェルカムページが表示されるはずです。 "Log on" リンクをクリックし、インストール時に指定した管理者ユーザー名とパスワードでログインしてください。 設定に関する詳細は、設定ガイドを参照するか、 任意のページ上部にある "help" リンクをクリックしてください。

  4. サーバーでファイアウォールを使用している場合は、localhost が信頼済みであることを確認してください。 例えば Linux で IPTables を使用している場合は、 ALLOW INPUT from LO ルールが必要です。

  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 に設定されており、 デフォルト値は /tmp/lshttpd/swap です。 <swappingDir> を検索してください。

それでもインストールで問題が発生する場合は、 Wiki を確認するか、 サポートフォーラムに問題を投稿してください。


アップグレード

サーバーを更新またはアップグレードする必要があるケースはいくつかあります。


  • 新しいリリースが利用可能になった場合
  • 試用ライセンスから本番ライセンスへアップグレードする場合
  • 別の本番ライセンスへアップグレードまたはダウングレードする場合。

アップグレード方法はいくつかあります。その1つは、 install.sh を再実行し、プロンプトが表示されたら "Upgrade" を選択することです。現在の設定は保持されます。


バージョン管理は、WebAdminコンソールの Actions - Version Management からも実行できます。 ここにはインストール済みのすべてのバージョンと、新しく利用可能なリリースが一覧表示されます。 対応するリンクをクリックすることで、新しいリリースのインストールやバージョンの切り替えを行えます。 LSWSには、新しいリリースを定期的に確認してメール通知を送信する組み込みアップデートエージェントもあります。


コマンドラインツール lsup.sh を使うと、最新版へのアップグレード、 強制再インストール、または旧バージョンへのダウングレードが可能です。詳細な使用方法は [your_install_dir]/admin/misc/lsup.sh --help を参照してください。


LiteSpeed Web Serverは複数バージョンをインストールできます。次のバージョン管理ユーティリティを使うと、 バージョンの切り替えを簡単に行えます: [your_install_dir]/admin/misc/mgr_ver.sh。


  • 既にインストール済みのバージョン (例えば 6.3.5) に切り替えるには、次を実行します。 [your_install_dir_current_version]/admin/misc/mgr_ver.sh 6.3.5

  • 特定のバージョン (例えば 6.3.5) 用に以前インストールしたファイルを削除するには、次を実行します。 [your_install_dir_current_version]/admin/misc/mgr_ver.sh -d 6.3.5

ライセンスをアップグレードする場合 (例えば試用ライセンスから本番ライセンスへ)、 serial.no を手動で [your_install_dir]/conf/ ディレクトリにコピーしてから再起動できます。