Durian

インストール手順

ネットワーク設定

始めにネットワークの設定を行います。

DNSサーバの設定

DNSサーバの設定を行います。nslookupコマンド、digコマンドなどでホストの名前解決ができることを確認します。

アウトバウンドHTTPS接続の許可

Durianは端末情報自動更新を行う際、Durian更新サーバにHTTPSで接続します。ルーター・ファイアウォールなどでHTTPSアウトバウンド接続が拒否されていないかどうかを確認します。

アウトバウンドHTTP接続の許可（Durian Proxyのみ）

Durian Proxyはプロキシ先サーバにHTTPで接続します。Durianをインストールするサーバからプロキシ先サーバにHTTP接続可能かどうかを確認します。必要であれば、ファイアウォールなどの設定を変更します。

アウトバウンドSMTP/POP接続の許可（Durian フィルタ エンタープライズ版のみ）

メール機能を利用する場合、DurianからSMTPサーバおよびPOPサーバに接続します。DurianをインストールするサーバからSMTPサーバおよびPOPサーバにSMTP/POP接続可能かどうかを確認します。必要であれば、ファイアウォールなどの設定を変更します。


ライブラリのインストール

Durianをインストールする前に、必要に応じて以下のライブラリのインストールを行います。

Java Advanced Imaging(JAI)

画像変換機能を利用する場合、JAI 及び JAI Image I/O Tools が必要です。ライブラリは、JDKにインストールするか、もしくはアプリケーションサーバの共有ライブラリとしてインストールします。

IBM WebSphere Application Server のJDKへインストールする手順

  1. アプリケーションサーバが動作している場合は、停止します。
  2. JAI 1.1.2 と JAI Image I/O Tools 1.1 を http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-java-client-419417.html よりダウンロードします。
  3. JDKホームディレクトリ（例：/opt/IBM/WebSphere/AppServer/java）へ移動します。
  4. ./jai-1_1_2-lib-linux-i586-jdk.bin を実行します。
  5. ライセンス規約に同意する場合、yes を入力します。
  6. ./jai_imageio-1_1-lib-linux-i586-jdk.bin を実行します。
  7. ライセンス規約に同意する場合、yes を入力します。

Interstage Application Server のJDK6へインストールする手順

  1. アプリケーションサーバが動作している場合は、停止します。
  2. JAI 1.1.2 を http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-java-client-419417.html よりダウンロードします。
  3. jai-1_1_2_01-lib-windows-i586.exeを実行し、作成されたC:\jai-1_1_2_01\lib内のjai_codec.jar、jai_core.jar、mlibwrapper_jai.jarをJDK6\jre\lib\extへコピーします。

※"This is not a proper JDK directory. "というエラーメッセージが出力されインストールできない場合は、JDKディレクトリ内にディレクトリ jre/lib/i386 を作成してからインストーラを再度実行します。

※インストール手順の詳細は、JAI および JAI Image I/O Tools 同梱のドキュメントを参照してください。

※JDK 6以上をご利用の場合、JAI Image I/O Tools のインストール作業は不要です。


JavaMail/JavaBeans Activation Framework(JAF)

Durian フィルタ エンタープライズ版 では、JavaMail 1.3以上 及び JavaBeans Activation Framework(JAF) 1.0以上 が必要です。ライブラリは、JDKにインストールするか、もしくはアプリケーションサーバの共有ライブラリとしてインストールします。

以下に Apache Tomcat 5.0 の共有ライブラリとしてインストールする手順を示します。

  1. アプリケーションサーバが動作している場合は、停止します。
  2. JavaMail 1.4 を http://www.oracle.com/technetwork/java/javamail/ よりダウンロードします。
  3. ダウンロードしたファイル javamail-1_4.zip を解凍します。
  4. 解凍したディレクトリ内のファイル mail.jar を共有ライブラリディレクトリ（例：/usr/local/tomcat/shared/lib）へコピーします。
  5. JAF を http://www.oracle.com/technetwork/java/javase/downloads/index-135046.html よりダウンロードします。
  6. ダウンロードしたファイル jaf-1_1-fr.zip を解凍します。
  7. 解凍したディレクトリ内のファイル activation.jar を共有ライブラリディレクトリ（例：/usr/local/tomcat/shared/lib）へコピーします。

※アプリケーションサーバやJDKによっては、既にインストールされている場合があります。

※インストール手順の詳細は、JavaMail および JAF 同梱のドキュメントを参照してください。

Java Secure Socket Extension(JSSE)

JDK 1.3を使用する場合、Java Secure Socket Extension(JSSE) が必要です。ライブラリは、JDKにインストールするか、もしくはアプリケーションサーバの共有ライブラリとしてインストールします。

以下に Apache Tomcat 5.0 の共有ライブラリとしてインストールする手順を示します。

  1. アプリケーションサーバが動作している場合は、停止します。
  2. JSSE を http://java.sun.com/products/jsse/ よりダウンロードします。
  3. ダウンロードしたファイル jsse-1_0_3_04-gl.zip を解凍します。
  4. 解凍したディレクトリ内のファイル jsse.jar, jcert.jar, jnet.jar を共有ライブラリディレクトリ（例：/usr/local/java/lib/jre/ext）へコピーします。

※アプリケーションサーバやJDKによっては、既にインストールされている場合があります。

※インストール手順の詳細は、JSSE同梱のドキュメントを参照してください。


Durianのインストール

Durianモジュールはwar形式（Web Application Archive形式）となっています。通常のWebアプリケーションをインストールする方法でインストールします。

※Durianは、Webアプリケーション内のディレクトリ WEB-INF/durian/ 以下にファイルを書き込みます。アプリケーションサーバの実行ユーザからの書き込み権限が必要です。

IBM WebSphere Application Server 8/7/6/5

  1. WebSphere管理コンソールを開きます。
  2. 左側のペインで[アプリケーション]-[新規アプリケーションのインストール]を選択します。
  3. アプリケーション・インストールの準備画面で、[参照]を選択し、warファイルを選択します。
  4. コンテキスト・ルートを入力し（例：/foo）、[次へ]を選択します。
  5. [次へ]を4回選択します（必要があれば、項目を設定します）。
  6. 設定に間違いがないことを確認し、[終了]を選択します。
  7. 左側のペインで[アプリケーション]-[エンタープライズ・アプリケーション]を選択します。
  8. インストールしたアプリケーションを選択します。
  9. 追加プロパティにある[セッション管理]を選択します。
  10. [セッション管理のオーバーライド]および[URL 再書き込みを使用可能にする]の左側のチェックボックスを選択し、[適用]を選択します。
  11. [保管]を選択し、マスタ構成に変更を適用します。
  12. 左側のペインで[アプリケーション]-[エンタープライズ・アプリケーション]を選択します。
  13. インストールされたアプリケーションの左側のチェックボックスを選択し、[始動]を選択します。

Oracle WebLogic Server 8

  1. WebLogic Administration Console を開きます。
  2. ナビゲーションツリーで[mydomain]-[デプロイメント]-[Webアプリケーションモジュール]ノードを選択します。
  3. 右ペインで、[新しいWebアプリケーションモジュールのデプロイ...]を選択します。
  4. warアーカイブもしくはwarファイルを展開したディレクトリを選択し、[モジュールの割り当て]を選択します。
  5. [デプロイ]を選択します（必要があれば、項目を設定します）。

※Durian 4.3.1以前では、warアーカイブによるデプロイに対応しておりません。

Oracle WebLogic Server 10/9

  1. WebLogic Server Administration Console を開きます。
  2. ナビゲーションツリーで[mydomain]-[デプロイメント]ノードを選択します。
  3. [ロックして編集]ボタンを選択します。
  4. 右ペインで、[インストール]を選択します。
  5. warアーカイブもしくはwarファイルを展開したディレクトリを選択し、[次へ]を選択します。
  6. [このデプロイメントをアプリケーションとしてインストールする]を選択し、[次へ]を選択します。
  7. [次へ]を選択します（必要があれば、項目を設定します）。
  8. [完了]を選択します（必要があれば、項目を設定します）。
  9. [変更のアクティブ化]を選択します。
  10. ナビゲーションツリーで[mydomain]-[デプロイメント]ノードを選択します。
  11. [ロックして編集]ボタンを選択します。
  12. 右ペインで、デプロイしたアプリケーションをチェックし、[起動]-[すべての要求を処理]を選択します。
  13. [はい]ボタンを選択します。

※Durian 4.3.1以前では、warアーカイブによるデプロイに対応しておりません。

Oracle WebLogic Server 12c

  1. WebLogic Server Administration Console を開きます。
  2. ナビゲーションツリーで[mydomain]-[デプロイメント]ノードを選択します。
  3. 制御タブで[インストール]を選択します。
  4. warファイルを選択し、[次へ]を選択します。
  5. [このデプロイメントをアプリケーションとしてインストールする]を選択し、[次へ]を選択します。
  6. [次へ]を選択します（必要があれば、項目を設定します）。
  7. [終了]を選択します（必要があれば、項目を設定します）。
  8. [変更のアクティブ化]を選択します。
  9. ナビゲーションツリーで[mydomain]-[デプロイメント]ノードを選択します。
  10. 右ペインで、デプロイしたアプリケーションをチェックし、[起動]-[すべての要求を処理]を選択します。
  11. [はい]ボタンを選択します。

※WEB-INF/weblogic.xmlデプロイメント・デスクリプタに以下に示す記述を追加します（url-rewriting-enabled 要素をtrueに設定します）。

<weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/weblogic-web-app">
        <session-descriptor>
                <url-rewriting-enabled>true</url-rewriting-enabled>
        </session-descriptor>
</weblogic-web-app>

Adobe JRun 4

  1. 適当なディレクトリにコンテキストパスに使用する名前でディレクトリを作成します（例：foo）。
  2. 作成されたディレクトリ内でwarファイルを展開します（warファイルはzip形式です）。
  3. JRun Default Serverのルートディレクトリの下にディレクトリをコピーします。
  4. JRun のオートデプロイ機能がOFFの場合には JRun Default Server を再起動します。

Adobe ColdFusion 11/10 サーバー設定

  1. 適当なディレクトリにディレクトリを作成します（例：foo）。
  2. 作成されたディレクトリ内でwarファイルを展開します（warファイルはzip形式です）。
  3. 展開されたディレクトリ内の WEB-INF/web.xml ファイルを別のファイル名に変更します（例：web.xml.durian）。
  4. [ColdFusionルート]/cfusion/wwwroot ディレクトリに展開したファイルをコピーします（上書きされるファイルはありません）。
  5. [ColdFusionルート]/cfusion/wwwroot/WEB-INF/web.xml ファイルをバックアップします（例：web.xml.org）。
  6. [ColdFusionルート]/cfusion/wwwroot/WEB-INF/web.xml に以下に示す記述を追加します（filterタグ、filter-mappingタグ、servletタグ及びservlet-mappingタグを追加します）。
  7. ColdFusionサーバーを再起動します。

[ColdFusionルート]/cfusion/wwwroot/WEB-INF/web.xml へ追加する記述

	<filter>
		<filter-name>Durian Filter</filter-name>
		<filter-class>jp.co.symmetric.durian.DurianFilter</filter-class>
	</filter>
        
	<filter-mapping>
		<filter-name>Durian Filter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

	<servlet>
		<servlet-name>Durian Admin Servlet</servlet-name>
		<servlet-class>jp.co.symmetric.durian.admin.servlet.DurianAdminServlet</servlet-class>
	</servlet>
        
	<servlet-mapping>
		<servlet-name>Durian Admin Servlet</servlet-name>
		<url-pattern>/durian/admin/*</url-pattern>
	</servlet-mapping>

Adobe ColdFusion 9/8/MX 7 サーバー設定

  1. 適当なディレクトリにディレクトリを作成します（例：foo）。
  2. 作成されたディレクトリ内でwarファイルを展開します（warファイルはzip形式です）。
  3. 展開されたディレクトリ内の WEB-INF/web.xml ファイルを別のファイル名に変更します（例：web.xml.durian）。
  4. [ColdFusionルート]/wwwroot ディレクトリに展開したファイルをコピーします（上書きされるファイルはありません）。
  5. [ColdFusionルート]/wwwroot/WEB-INF/web.xml ファイルをバックアップします（例：web.xml.org）。
  6. [ColdFusionルート]/wwwroot/WEB-INF/web.xml に以下に示す記述を追加します（filterタグ、filter-mappingタグ、servletタグ及びservlet-mappingタグを追加します）。
  7. ColdFusionサーバーを再起動します。

[ColdFusionルート]/wwwroot/WEB-INF/web.xml へ追加する記述

	<filter>
		<filter-name>Durian Filter</filter-name>
		<filter-class>jp.co.symmetric.durian.DurianFilter</filter-class>
	</filter>
	<filter-mapping>
		<filter-name>Durian Filter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

	<servlet>
		<servlet-name>Durian Admin Servlet</servlet-name>
		<servlet-class>jp.co.symmetric.durian.admin.servlet.DurianAdminServlet</servlet-class>
	</servlet>
	<servlet-mapping>
		<servlet-name>Durian Admin Servlet</servlet-name>
		<url-pattern>/durian/admin/*</url-pattern>
	</servlet-mapping>
	<servlet-mapping>
		<servlet-name>FileServlet</servlet-name>
		<url-pattern>/durian/images/*</url-pattern>
	</servlet-mapping>

	<servlet-mapping>
		<servlet-name>FileServlet</servlet-name>
		<url-pattern>*.gif</url-pattern>
	</servlet-mapping>
	<servlet-mapping>
		<servlet-name>FileServlet</servlet-name>
		<url-pattern>*.jpg</url-pattern>
	</servlet-mapping>
	<servlet-mapping>
		<servlet-name>FileServlet</servlet-name>
		<url-pattern>*.css</url-pattern>
	</servlet-mapping>

※使用する全ての静的リソースの拡張子に対してservlet-mappingタグを指定します(上記の例では*.gif、*.jpg、*.cssに対して指定されている部分)。

Apache Tomcat 8/7/6/5/4

  1. warファイル名をコンテキストパスに使用する名前 (例：foo.war) に変更します。
  2. warファイルをTomcatルートディレクトリの下にあるwebappディレクトリにコピーします。
  3. Tomcatを起動します。

Interstage Application Server 11/9/6

  1. warファイル名をコンテキストパスに使用する名前 (例：foo.war) に変更します。
  2. Interstage管理コンソールを起動します。
  3. インストール対象のワークユニットを左側のペインから選択します。
  4. ワークユニットの「操作」の画面で、上部のタブから「配備」を選択します。
  5. 「配備ファイル」の欄に、warファイルとパスを指定します。
  6. 「配備」ボタンをクリックし、配備を実行します。
  7. ページの下部に配備処理が完了した旨のメッセージが出れば完了です。

JBoss Application Server 5/4

  1. warファイル名をコンテキストパスに使用する名前 (例：foo.war) に変更します。
  2. warファイルを[JBossホーム]/server/default/deployディレクトリにコピーします。

HITACHI Cosminexus V7

  1. DurianをインストールするJ2EEサーバを構築します（詳細はCosminexusのマニュアルをご参照ください）。
  2. J2EEサーバにwarファイルをインポートします（例：cjimportres cmx_Durian_unit1_J2EE_01 -type war -f durian-4.1.4-filter-ee.war）。
  3. インポートしたwarファイルをJ2EEアプリケーションに追加します（例：cjaddapp cmx_Durian_unit1_J2EE_01 -type war -name durian_filter -resname "Durian 4.1 Filter"）。
  4. リソースの属性ファイルを作成します（例：cjgetappprop cmx_Durian_unit1_J2EE_01 -name durian_filter -type all -c durian-4.1.4-filter-ee.xml）。
  5. J2EEアプリケーションを開始します（例：cjstartapp cmx_Durian_unit1_J2EE_01 -name durian_filter）。

インストール確認

Webブラウザで管理ツールを表示します。

http://servername:port/foo/durian/admin/

※URL内の servername は、Webサーバのホスト名もしくはIPアドレスです。

※URL内の port はポート番号で、Webサーバやアプリケーションサーバの設定により異なります。

※URL内の /foo はコンテキストパスです。

※初期状態でのログインIDは durian、パスワードは durian です。

以下にアプリケーションサーバの内部HTTPサーバ経由でアクセスする場合のURLを例として示します。

WebSphere 8/7/6 http://servername:9080/foo/durian/admin/
WebSphere 5 http://servername:7080/foo/durian/admin/
WebLogic 12c/10/9/8 http://servername:7001/foo/durian/admin/
JRun 4 http://servername:8100/foo/durian/admin/
ColdFusion 11/10/9/8/MX 7 http://servername:8500/durian/admin/
Tomcat 8/7/6/5/4 http://servername:8080/foo/durian/admin/
Interstage 11/9/6 http://servername:8080/foo/durian/admin/
JBoss 5/4 http://servername:8080/foo/durian/admin/
Cosminexus 7 http://servername:8080/foo/durian/admin/

Durian® is a registered trademark of Symmetric Co., Ltd.

© 2006- All Rights Reserved Symmetric Co., Ltd.