「おらんかに」
サーバ インストールマニュアル
(LINUX 版)
株式会社富士通ビー・エス・シー
目次 1 はじめに ... 1 2 動作環境 ... 2 3 インストールの前に ... 3 4 Tomcat のインストール ... 4 5 Apache と Tomcat の接続設定 ... 5 5.1 Apache 追加モジュールの作成 ... 5 5.2 Tomcat サーバの無効設定 ... 8 5.3 servlet の有効化設定 ... 9 5.4 Apache の httpd.conf ファイル編集 ... 11 5.5 orkn.xml ファイルの作成 ... 11 5.6 Tomcat6 をお使いの場合 ... 12 6 Apache・Tomcat 連携動作確認 ... 13 7 「おらんかに」サーバソフトのインストール ... 14 7.1 サーバソフトのインストール... 14 7.2 ログ出力ディレクトリの作成... 15 7.3 データディレクトリ作成 ... 15 7.4 サーバログディレクトリの作成 ... 15
1 はじめに
(1)本書の目的 本書は、以下の製品についての導入方法および操作方法について説明しています。 ・おらんかに V1.1.6 (2)注意事項 略語表記について・Red Hat® Enterprise Linux® 6 を“RHEL-6”と略しています。 ・Red Hat® Enterprise Linux® 5 を“RHEL-5”と略しています。 ・Red Hat® Enterprise Linux® ES を“RHEL-ES4”と略しています。 ・Java Development Kit を“JDK”と略しています。
・Apache Tomcat を“Tomcat”と略しています。 (3)商標および著作権について
・Linux は、Linus Torvalds の米国およびその他の国における商標または登録商標で す。
・Red Hat、RPM および Red Hat をベースとしたすべての商標とロゴは、Red Hat, Inc.の米国およびその他の国における商標または登録商標です。
・Java、JDK は、米国およびその他の国における Oracle America, Inc. の商標、ま たは登録商標です。
・VMware®,VMware WorkstationTM,VMware vSphere® ESXiTM は,米国およ
びその他の地域における VMware, Inc. の登録商標または商標です。 ・Apache、Apache Tomcat は、Apache Software Foundation の商標です。
2 動作環境
「おらんかに」サーバソフト(LINUX 版)は次の環境で動作します。それ以外の環境へのインスト
ールはサポート対象外です。
項目 仕様
OS Red Hat® Enterprise Linux® 6 (32/64bit) Red Hat® Enterprise Linux® 5 (32bit) Red Hat® Enterprise Linux® ES4 (32bit)
CPU Intel® Celeron® G1101(2 コア/2.26GHz/2MB)以上のプロセッサ推奨
メモリ 2GB 以上推奨
HDD 150MB 以上の空き容量が必要
仮想環境 VMware Workstation
TM 8
VMware WorkstationTM 9
VMware vSphere® ESXiTM 5.5
ハード環境 CD-ROM ドライブ(インストール時必要) 必須ミドルウェア JDK 1.5 JDK 1.6 JDK 1.7 Apache 2.2 Tomcat 5.5 Tomcat 6.0
3 インストールの前に
「おらんかに」サーバソフト(LINUX 版)のインストール方法とサーバ設定方法を説明します。
最初にWeb サーバ Apache と サーブレットコンテナ Tomcat の接続方法を説明します。
「おらんかに」サーバソフトインストール前に、LINUX サーバに Apache、JDK を事前にイ ンストールしておいて下さい。また、「おらんかに」クライアント/サーバ間の通信に使用するポ ート番号をネットワーク管理者に確認して下さい。 本書では、Apache2.2.6、JDK1.5.0.14 の環境を下記ディレクトリにインストールすることを 前提に説明しております。 インストールマシン名 orknserver Apache インストール先 /usr/local/apache2.2 JDK インストール先 /usr/java/jdk1.5.0_14 Apache のディレクトリ構成は以下のとおりとします。 /usr/local/apache2.2/bin /build /cgi-bin /conf /error /htdocs /icons /include /lib /logs /man /manual /modules ※Apache は LINUX サーバにあらかじめインストールされている場合があります。 設定後、Tomcat とうまく連携されない場合は Apache を再インストールして下さい。 JDK のディレクトリ構成は以下のとおりとします。 /usr/java/ jdk1.5.0_14/bin /demo /include /jre /lib /man /sample
4 Tomcat のインストール
Tomcat をダウンロードして展開します。 (本書では、バージョン5.5.25 を使用。ダウンロード先は「「おらんかに」使用モジュール配布 先一覧」を参照下さい) 展開したものを任意のディレクトリにコピーします。 ここでは、展開先を/usr/local/Tomcat とします。展開後は以下のような構成になります。 /usr/local/Tomcat/bin /common /conf /logs /server /shared /temp /webapps /work 以降の説明はすべて上記のディレクトリにインストールしたものとして説明します。 ※ apache-Tomcat-5.5.25.tar.gz を展開するには以下のコマンドを実行します。 tar xvfz apache-Tomcat-5.5.25.tar.gz5 Apache と Tomcat の接続設定
5.1 Apache 追加モジュールの作成
Apache と Tomcat のコネクタとなる mod_jk.so を作成します。
(本書では、バージョン1.2.26 を使用。ダウンロード先は「「おらんかに」使用モジュール
配布先一覧」を参照下さい)
① Tomcat-connectors-1.2.26-src.tar.gz をダウンロード後、インストールし、 Apache と Tomcat のコネクタとなる mod_jk.so を
/usr/local/apache2.2/modules へ作成してください。 ② サーバ上で Apache-Tomcat 間のプロセスを紐付ける「worker 名」を設定します。 /usr/local/Tomcat/conf/server.xml を編集します。 Engine ディレクティブ内に、「jvmRoute」属性を新規に追加してください。 ③ /usr/local/apache2.2/conf/httpd.conf を編集します。 ファイルの末尾に下記の設定を追加してください。 【修正前】
<Engine name="Catalina" defaultHost="localhost">
【修正後】
<Engine name="Catalina"defaultHost="localhost" jvmRoute="<worker 名>"> 例)
<Engine name="Catalina"defaultHost="localhost" jvmRoute="worker01">
LoadModule jk_module modules/mod_jk.so JkWorkersFile conf/workers.properties JkShmFile logs/jk-runtime-status JkLogFile logs/mod_jk.log
④ worker 定義ファイルの作成
Tomcat-connectors-1.2.26-src.tar.gz を展開したディレクトリの
conf/workers.properties.minimal を/usr/local/apache2.2/ へ workers.properties と言う名前で複写してください。 ⑤ /usr/local/apache2.2/confworkers.properties を以下の様に編集します。 例) # cp <mod_jk ソースコード展開ディレクトリ> /conf/workers.properties.minimal /usr/local/apache2.2/workers.properties 【修正前】 : worker.ajp13w.type=ajp13 worker.ajp13w.host=localhost worker.ajp13w.port=8009 #
# Defining a load balancer #
worker.wlb.type=lb
worker.wlb.balance_workers=ajp13w #
# Define status worker #
worker.jkstatus.type=status
【修正後】 :
worker.<worker 名>.type=ajp13
worker. <worker 名>.host=<サーバアドレス> worker. <worker 名>.port=<サーバポート> #
# Defining a load balancer #
worker.wlb.type=lb
worker.wlb.balance_workers=<worker 名> #
# Define status worker #
workers.properties の修正例は以下のとおりです。 例) worker.worker01.type=ajp13 worker. worker01.host=localhost worker. worker01.port=8009 #
# Defining a load balancer #
worker.wlb.type=lb
worker.wlb.balance_workers= worker01 #
# Define status worker #
5.2 Tomcat サーバの無効設定
Tomcat の Web サーバ機能を Apache で行うため、無効の設定を行ないます。 ① /usr/local/Tomcat/conf の中にある、server.xml ファイルを vi エディタで 開きます。 ② server.xml ファイル内の以下の記述を確認して下さい。 上記記述をコメントアウトします。 コメントアウトを始める先頭行に
<!
-- 、最終行に --> と記述します。 以下の枠内のように記述して下さい。 < ! --<Connector port="8080" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" /> -- >
<Connector port="8080" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />
5.3 servlet の有効化設定 servlet の有効化を行います。 ① /usr/local/Tomcat/conf の中にある、web.xml ファイルを vi エディタ で開きます。 ② web.xml ファイル内の以下の記述を確認して下さい。 : <!-- <servlet> <servlet-name>invoker</servlet-name> <servlet-class> org.apache.catalina.servlets.InvokerServlet </servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet> --> : (省略) : <!-- <servlet-mapping> <servlet-name>invoker</servlet-name> <url-pattern>/servlet/*</url-pattern> </servlet-mapping> --> :
前記コメント部分を削除します。 : (←コメントの削除) <servlet> <servlet-name>invoker</servlet-name> <servlet-class> org.apache.catalina.servlets.InvokerServlet </servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet> (←コメントの削除) : (省略) : (←コメントの削除) <servlet-mapping> <servlet-name>invoker</servlet-name> <url-pattern>/servlet/*</url-pattern> </servlet-mapping> (←コメントの削除) :
5.4 Apache の httpd.conf ファイル編集 ① Apache の設定ファイル/usr/local/apache2.2/conf/httpd.conf ファイルを編集します。 「おらんかに」クライアント/サーバ間の通信で使用するポート番号を変更します。 httpd.conf ファイルに“Listen”パラメータを追加します。 ここでは16160 ポートを使用することとし、以下の説明もポート番号 16160 で行います。 Port の記述を以下のように設定します。 5.5 orkn.xml ファイルの作成 ① /usr/local/Tomcat/conf/Catalina/localhost 配下に、orkn.xml ファイルを作成します。 ② orkn.xml ファイルに以下の2行を追加します。 (httpd.conf 40 行目付近) :
# Change this to Listen on specific IP addresses as shown below to # prevent Apache from glomming onto all bound IP addresses. # #Listen 12.34.56.78:80 Listen 80 ←Port80 を使用しない場合はコメントアウトしてください。 Listen 16160 ←おらんかに通信用ポートの記述を追加してください。 $ cd /usr/local/Tomcat/conf/Catalina/localhost $ vi orkn.xml
<Context path="/orkn" debug="0" reloadable="false" crossContext="false"> </Context>
5.6 Tomcat6 をお使いの場合
Tomcat6 をお使いの場合は、以下の設定を行います。 /usr/local/Tomcat/conf/context.xml 内の権限を変更します。
上記、<Context>を以下のように変更します。
<!-- The contents of this file will be loaded for each web application --> <Context>
<!-- Default set of monitored resources -->
<WatchedResource>WEB-INF/web.xml</WatchedResource>
<!-- Uncomment this to disable session persistence across Tomcat restarts --> <!--
<Manager pathname="" /> -->
<!-- Uncomment this to enable Comet connection tacking (provides events on session expiration as well as webapp lifecycle) -->
<!--
<Valve className="org.apache.catalina.valves.CometConnectionManagerValve" /> -->
</Context>
<!-- The contents of this file will be loaded for each web application --> <Context privileged="true">
<!-- Default set of monitored resources -->
<WatchedResource>WEB-INF/web.xml</WatchedResource>
<!-- Uncomment this to disable session persistence across Tomcat restarts --> <!--
<Manager pathname="" /> -->
<!-- Uncomment this to enable Comet connection tacking (provides events on session expiration as well as webapp lifecycle) -->
<!--
<Valve className="org.apache.catalina.valves.CometConnectionManagerValve" /> -->
6 Apache・Tomcat 連携動作確認
Apache・Tomcat が連携して動作するかどうかの確認を行います。 ① Tomcat を起動します ② Apache を起動します ③ Web ブラウザで以下の URL を入力します http://<おらんかにサーバアドレス>:16160/index.jsp 以下の画面が表示されればApache、Tomcat が連携したことを表します。 ※Apache の終了方法は /usr/local/apache2.2/bin/apachectl stop を実行します。 Tomcat の終了方法は /usr/local/Tomcat/bin/shutdown.sh を実行します。 Tomcat の起動 $ /usr/local/Tomcat/bin/startup.sh apache の起動(root ユーザにて起動します) # /usr/local/apache2.2/bin/apachectl start7 「おらんかに」サーバソフトのインストール
7.1 サーバソフトのインストール 「おらんかに」サーバソフトをTomcat にインストールします。 ① /usr/local/Tomcat/webapps ディレクトリにサーバインストール CD-ROM 内の orkn.war ファイルを複写します。 ② Tomcat を起動すると、orkn.war が展開されます。 以下の様にディレクトリが作成されているか確認して下さい。 /usr/local/Tomcat/webapps/orkn/META-INF /WEB-INF /properties ③ Tomcat を停止します。 例) サーバにcd-rom をセットします。 $ mkdir /media/cdrom$ mount –r /dev/cdrom /media/cdrom
$ cp /media/cdrom/orkn.war /usr/local/Tomcat/webapps/.
Tomcat の起動
$ /usr/local/Tomcat/bin/startup.sh
Tomcat の停止
7.2 ログ出力ディレクトリの作成 「おらんかに」システムが出力するログファイル出力先を任意のディレクトリに 作成します。 ※「おらんかに」は大量のログを出力しますので容量に余裕のあるパーティションに 作成して下さい。 7.3 データディレクトリ作成 「おらんかに」システムが参照するデータファイル格納先を任意のディレクトリに 作成します。 7.4 サーバログディレクトリの作成 「おらんかに」システムが出力するサーバログファイル出力先を任意のディレクトリに 作成します。 ※「おらんかに」は大量のログを出力しますので容量に余裕のあるパーティションに 作成して下さい。 以上で、サーバインストールは終了です。 引き続き、「「おらんかに」ライセンス登録・環境設定マニュアル」を参照のうえ 「おらんかに」サーバの設定を実施して下さい。 例) $ mkdir /orkn/Log 例) $ mkdir /orkn/Data 例) $ mkdir /orkn/ServerLog