Upload
others
View
8
Download
0
Embed Size (px)
Citation preview
「おらんかに」
サーバ インストールマニュアル
(LINUX版)
株式会社富士通ビー・エス・シー Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc.
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc.
目次 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 ログ出力ディレクトリの作成............................................................................................. 16 7.3 データディレクトリ作成 .................................................................................................... 16 7.4 サーバログディレクトリの作成 ......................................................................................... 16
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 1
1 はじめに
(1)本書の目的 本書は、以下の製品についての導入方法および操作方法について説明しています。 ・おらんかに V1.1.9
(2)注意事項 略語表記について ・Red Hat® Enterprise Linux® 7 を“RHEL-7”と略しています。 ・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 の商標です。
なお、本書では「おらんかに V1.1.9」を「おらんかに」と表記させていただきます。
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 2
2 動作環境
「おらんかに」サーバソフト(LINUX 版)は、次の環境で動作します。それ以外の環境へのインス
トールはサポート対象外です。
項目 仕様
OS Red Hat® Enterprise Linux® 7 (64bit) 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 WorkstationTM 8 VMware WorkstationTM 9 VMware WorkstationTM 10 VMware WorkstationTM 11 VMware WorkstationTM 12 VMware vSphere® ESXiTM 5.5
ハード環境 CD-ROM ドライブ(インストール時必要)
必須ミドルウェア
JDK 1.5 JDK 1.6 JDK 1.7 JDK 1.8 Apache 2.2 Tomcat 5.5 Tomcat 6.0 Tomcat 7.0 Tomcat 8.0
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 3
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 /build /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
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 4
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
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 5
5 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 JkMount /* wlb
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 6
④ 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 # #worker.jkstatus.type=status ←コメントアウトしてください
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 7
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
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 8
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" />
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 9
5.3 servlet の有効化設定
servlet の有効化を行います。 ※Tomcat7 をお使いの場合は、本設定を行う必要はありません。
① /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> --> :
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 10
前記コメント部分を削除します。
: (←コメントの削除) <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> (←コメントの削除) :
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 11
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>
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 12
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" /> --> </Context>
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 13
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 start
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 14
7 「おらんかに」サーバソフトのインストール
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 を停止します。
④ web.xml を配置します(Tomcat7 をお使いの場合)。
例) サーバに cd-rom をセットします。 $ mkdir /media/cdrom $ mount –r /dev/cdrom /media/cdrom $ cp /media/cdrom/sv/orkn.war /usr/local/Tomcat/webapps/.
Tomcat の起動 $ /usr/local/Tomcat/bin/startup.sh
Tomcat の停止 $ /usr/local/Tomcat/bin/shutdown.sh
例) サーバに cd-rom をセットします。 $ mkdir /media/cdrom $ mount –r /dev/cdrom /media/cdrom $ cp /media/cdrom/sv/web.xml /usr/local/Tomcat/webapps/orkn/WEB-INF/
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 15
⑤ properties を編集します(Tomcat8 をお使いの場合)。
インストール時は、以下の設定になっています。
上記設定を以下の通り編集します。
$ vi /usr/local/Tomcat/webapps/orkn/properties/ppx.server.ppxSearchMembers. properties
include=ppx.properties LimitCount=100 UrlDecode=ISO_8859_1
include=ppx.properties LimitCount=100 UrlDecode=UTF-8
Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 16
7.2 ログ出力ディレクトリの作成
「おらんかに」システムが出力するログファイル出力先を任意のディレクトリに 作成します。
※「おらんかに」は大量のログを出力しますので容量に余裕のあるパーティションに 作成して下さい。
7.3 データディレクトリ作成
「おらんかに」システムが参照するデータファイル格納先を任意のディレクトリに 作成します。
7.4 サーバログディレクトリの作成
「おらんかに」システムが出力するサーバログファイル出力先を任意のディレクトリに 作成します。
※「おらんかに」は大量のログを出力しますので容量に余裕のあるパーティションに 作成して下さい。
以上で、サーバインストールは終了です。 引き続き、「「おらんかに」ライセンス登録・環境設定マニュアル」を参照のうえ 「おらんかに」サーバの設定を実施して下さい。
例) $ mkdir /orkn/Log
例) $ mkdir /orkn/Data
例) $ mkdir /orkn/ServerLog