おらんかに サーバ インストールマニュアル (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 Workstation TM,VMware vsphere ESXi TM は, 米 国 およ びその 他 の 地 域 における VMware, Inc. の 登 録 商 標 または 商 標 です Apache Apache Tomcat は Apache Software Foundation の 商 標 です なお 本 書 では おらんかに V1.1.6 を おらんかに と 表 記 させていただきます 1
2 動 作 環 境 おらんかに サーバソフト(LINUX 版 )は 次 の 環 境 で 動 作 します それ 以 外 の 環 境 へのインスト ールはサポート 対 象 外 です 項 目 仕 様 Red Hat Enterprise Linux 6 (32/64bit) OS Red Hat Enterprise Linux 5 (32bit) Red Hat Enterprise Linux ES4 (32bit) Intel Celeron G1101(2 コア/2.26GHz/2MB) 以 上 のプロセッサ CPU 推 奨 メモリ 2GB 以 上 推 奨 HDD 150MB 以 上 の 空 き 容 量 が 必 要 VMware Workstation TM 8 仮 想 環 境 VMware Workstation TM 9 VMware vsphere ESXi TM 5.5 ハード 環 境 CD-ROM ドライブ(インストール 時 必 要 ) JDK 1.5 JDK 1.6 JDK 1.7 必 須 ミドルウェア Apache 2.2 Tomcat 5.5 Tomcat 6.0 2
3 インストールの 前 に おらんかに サーバソフト(LINUX 版 )のインストール 方 法 とサーバ 設 定 方 法 を 説 明 します 最 初 に Web サーバ Apache と サーブレットコンテナ Tomcat の 接 続 方 法 を 説 明 します おらんかに サーバソフトインストール 前 に LINUX サーバに Apache JDK を 事 前 にイ ンストールしておいて 下 さい また おらんかに クライアント/サーバ 間 の 通 信 に 使 用 するポ ート 番 号 をネットワーク 管 理 者 に 確 認 して 下 さい 本 書 では Apache2.2.6 JDK1.5.0.14 の 環 境 を 下 記 ディレクトリにインストールすることを 前 提 に 説 明 しております インストールマシン 名 Apache インストール 先 JDK インストール 先 orknserver /usr/local/apache2.2 /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 3
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.gz 4
5 Apache と Tomcat の 接 続 設 定 5.1 Apache 追 加 モジュールの 作 成 Apache と Tomcat のコネクタとなる mod_jk.so を 作 成 します ( 本 書 では バージョン 1.2.26 を 使 用 ダウンロード 先 は おらんかに 使 用 モジュール 配 布 先 一 覧 を 参 照 下 さい) 1 Tomcat-connectors-1.2.26-src.tar.gz をダウンロード 後 インストールし Apache と Tomcat のコネクタとなる mod_jk.so を /usr/local/apache2.2/modules へ 作 成 してください 2 サーバ 上 で Apache-Tomcat 間 のプロセスを 紐 付 ける worker 名 を 設 定 します /usr/local/tomcat/conf/server.xml を 編 集 します 修 正 前 <Engine name="catalina" defaulthost="localhost"> Engine ディレクティブ 内 に jvmroute 属 性 を 新 規 に 追 加 してください 修 正 後 <Engine name="catalina"defaulthost="localhost" jvmroute="<worker 名 >"> 例 ) <Engine name="catalina"defaulthost="localhost" jvmroute="worker01"> 3 /usr/local/apache2.2/conf/httpd.conf を 編 集 します ファイルの 末 尾 に 下 記 の 設 定 を 追 加 してください LoadModule jk_module modules/mod_jk.so JkWorkersFile conf/workers.properties JkShmFile logs/jk-runtime-status JkLogFile logs/mod_jk.log JkMount /* wlb 5
4 worker 定 義 ファイルの 作 成 Tomcat-connectors-1.2.26-src.tar.gz を 展 開 したディレクトリの conf/workers.properties.minimal を/usr/local/apache2.2/ へ workers.properties と 言 う 名 前 で 複 写 してください 例 ) cp <mod_jk ソースコード 展 開 ディレクトリ> /conf/workers.properties.minimal /usr/local/apache2.2/workers.properties 5 /usr/local/apache2.2/confworkers.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 worker.jkstatus.type=status コメントアウトしてください 6
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 worker.jkstatus.type=status 7
5.2 Tomcat サーバの 無 効 設 定 Tomcat の Web サーバ 機 能 を Apache で 行 うため 無 効 の 設 定 を 行 ないます 1 /usr/local/tomcat/conf の 中 にある server.xml ファイルを vi エディタで 開 きます 2 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" /> -- > 8
5.3 servlet の 有 効 化 設 定 servlet の 有 効 化 を 行 います 1 /usr/local/tomcat/conf の 中 にある web.xml ファイルを vi エディタ で 開 きます 2 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> 9
前 記 コメント 部 分 を 削 除 します ( コメントの 削 除 ) <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> ( コメントの 削 除 ) 10
5.4 Apache の httpd.conf ファイル 編 集 1 Apache の 設 定 ファイル/usr/local/apache2.2/conf/httpd.conf ファイルを 編 集 します おらんかに クライアント/サーバ 間 の 通 信 で 使 用 するポート 番 号 を 変 更 します httpd.conf ファイルに Listen パラメータを 追 加 します ここでは 16160 ポートを 使 用 することとし 以 下 の 説 明 もポート 番 号 16160 で 行 います Port の 記 述 を 以 下 のように 設 定 します (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.7880 Listen 80 Port80 を 使 用 しない 場 合 はコメントアウトしてください Listen 16160 おらんかに 通 信 用 ポートの 記 述 を 追 加 してください 5.5 orkn.xml ファイルの 作 成 1 /usr/local/tomcat/conf/catalina/localhost 配 下 に orkn.xml ファイルを 作 成 します $ cd /usr/local/tomcat/conf/catalina/localhost $ vi orkn.xml 2 orkn.xml ファイルに 以 下 の2 行 を 追 加 します <Context path="/orkn" debug="0" reloadable="false" crosscontext="false"> </Context> 11
5.6 Tomcat6 をお 使 いの 場 合 Tomcat6 をお 使 いの 場 合 は 以 下 の 設 定 を 行 います /usr/local/tomcat/conf/context.xml 内 の 権 限 を 変 更 します <!-- 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> 上 記 <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" /> --> </Context> 12
6 Apache Tomcat 連 携 動 作 確 認 Apache Tomcat が 連 携 して 動 作 するかどうかの 確 認 を 行 います 1 Tomcat を 起 動 します Tomcat の 起 動 $ /usr/local/tomcat/bin/startup.sh 2 Apache を 起 動 します apache の 起 動 (root ユーザにて 起 動 します) /usr/local/apache2.2/bin/apachectl start 3 Web ブラウザで 以 下 の URL を 入 力 します http//<おらんかにサーバアドレス>16160/index.jsp 以 下 の 画 面 が 表 示 されれば Apache Tomcat が 連 携 したことを 表 します Apache の 終 了 方 法 は /usr/local/apache2.2/bin/apachectl stop を 実 行 します Tomcat の 終 了 方 法 は /usr/local/tomcat/bin/shutdown.sh を 実 行 します 13
7 おらんかに サーバソフトのインストール 7.1 サーバソフトのインストール おらんかに サーバソフトを Tomcat にインストールします 1 /usr/local/tomcat/webapps ディレクトリにサーバインストール CD-ROM 内 の orkn.war ファイルを 複 写 します 例 ) サーバに cd-rom をセットします $ mkdir /media/cdrom $ mount r /dev/cdrom /media/cdrom $ cp /media/cdrom/orkn.war /usr/local/tomcat/webapps/. 2 Tomcat を 起 動 すると orkn.war が 展 開 されます Tomcat の 起 動 $ /usr/local/tomcat/bin/startup.sh 以 下 の 様 にディレクトリが 作 成 されているか 確 認 して 下 さい /usr/local/tomcat/webapps/orkn/meta-inf /WEB-INF /properties 3 Tomcat を 停 止 します Tomcat の 停 止 $ /usr/local/tomcat/bin/shutdown.sh 14
7.2 ログ 出 力 ディレクトリの 作 成 おらんかに システムが 出 力 するログファイル 出 力 先 を 任 意 のディレクトリに 作 成 します 例 ) $ mkdir /orkn/log おらんかに は 大 量 のログを 出 力 しますので 容 量 に 余 裕 のあるパーティションに 作 成 して 下 さい 7.3 データディレクトリ 作 成 おらんかに システムが 参 照 するデータファイル 格 納 先 を 任 意 のディレクトリに 作 成 します 例 ) $ mkdir /orkn/data 7.4 サーバログディレクトリの 作 成 おらんかに システムが 出 力 するサーバログファイル 出 力 先 を 任 意 のディレクトリに 作 成 します 例 ) $ mkdir /orkn/serverlog おらんかに は 大 量 のログを 出 力 しますので 容 量 に 余 裕 のあるパーティションに 作 成 して 下 さい 以 上 で サーバインストールは 終 了 です 引 き 続 き おらんかに ライセンス 登 録 環 境 設 定 マニュアル を 参 照 のうえ おらんかに サーバの 設 定 を 実 施 して 下 さい 15