18
「おらんかに」 サーバ インストールマニュアル LINUX 版) 株式会社富士通ビー・エス・シー Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc.

「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

  • Upload
    others

  • View
    8

  • Download
    0

Embed Size (px)

Citation preview

Page 1: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

「おらんかに」

サーバ インストールマニュアル

(LINUX版)

株式会社富士通ビー・エス・シー Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc.

Page 2: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 3: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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」を「おらんかに」と表記させていただきます。

Page 4: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 5: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 6: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 7: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 8: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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 ←コメントアウトしてください

Page 9: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 10: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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" />

Page 11: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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> --> :

Page 12: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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> (←コメントの削除) :

Page 13: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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>

Page 14: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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>

Page 15: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 16: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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/

Page 17: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

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

Page 18: 「おらんかに」 - Fujitsu Global...「おらんかに」サーバソフト(LINUX 版)は、 次の環境で動作します。それ以外の環境へのインス トールはサポート対象外です。

Copyright 2002-2018 FUJITSU BROAD SOLUTION & CONSULTING Inc. 16

7.2 ログ出力ディレクトリの作成

「おらんかに」システムが出力するログファイル出力先を任意のディレクトリに 作成します。

※「おらんかに」は大量のログを出力しますので容量に余裕のあるパーティションに 作成して下さい。

7.3 データディレクトリ作成

「おらんかに」システムが参照するデータファイル格納先を任意のディレクトリに 作成します。

7.4 サーバログディレクトリの作成

「おらんかに」システムが出力するサーバログファイル出力先を任意のディレクトリに 作成します。

※「おらんかに」は大量のログを出力しますので容量に余裕のあるパーティションに 作成して下さい。

以上で、サーバインストールは終了です。 引き続き、「「おらんかに」ライセンス登録・環境設定マニュアル」を参照のうえ 「おらんかに」サーバの設定を実施して下さい。

例) $ mkdir /orkn/Log

例) $ mkdir /orkn/Data

例) $ mkdir /orkn/ServerLog