Cosminexus V11 アプリケーションサーバ システム構築・運用ガイド

手引・文法・操作書

3021-3-J02-60

前書き

対象製品

マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の前書きの対象製品の説明を参照してください。

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，Cosminexus，Groupmax，HiRDB，JP1，OpenTP1，ServerConductor，TPBroker，uCosminexus，XDMは，株式会社 日立製作所の商標または登録商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Eclipseは，Eclipse Foundation, Inc.の商標です。

Linuxは，Linus Torvalds氏の米国およびその他の国における登録商標です。

Microsoft，Internet Explorer，Microsoft Edge，SQL Server，Windows，Windows Server は，マイクロソフト 企業グループの商標です。

Oracle(R)，Java ，MySQL及びNetSuite は，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

Red Hat, and Red Hat Enterprise Linux are registered trademarks of Red Hat, Inc. in the United States and other countries. Linux(R) is the registered trademark of Linus Torvalds in the U.S. and other countries.

Red Hat，およびRed Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。Linux(R)は，米国およびその他の国におけるLinus Torvalds氏の登録商標です。

UNIXは，The Open Groupの登録商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

マイクロソフト製品のスクリーンショットの使用について

マイクロソフトの許可を得て使用しています。

発行

2024年 9月 3021-3-J02-60

著作権

All Rights Reserved. Copyright (C) 2020, 2024, Hitachi, Ltd.

変更内容

変更内容(3021-3-J02-60) uCosminexus Application Server 11-50，uCosminexus Client 11-50，uCosminexus Developer 11-50，uCosminexus Service Architect 11-50，uCosminexus Service Platform 11-50

追加・変更内容

変更個所

マニュアル訂正の内容を反映した。

-

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルをお読みになる際の前提情報については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」のはじめにの説明を参照してください。

1　システム構築・運用の概要

アプリケーションサーバでは，オンライン業務およびバッチ業務のアプリケーションが動作するシステムを構築できます。システムを構築する際には，アプリケーションサーバの運用管理機能で提供するツールが使用できます。

この章では，運用管理機能のツールの概要，システムの構築・運用の概要について説明します。ツールを使用しない場合，サーバ管理コマンドや手動に置き換えて参照してください。

1.1　運用管理機能のツールとは

アプリケーションサーバの運用管理機能では，次のツールを提供しています。これらのツールは，使用したい手段（画面，コマンドなど）や，構築したいシステム構成によって選択できます。また，これらのツールは同じ運用管理機能で動作するので，作業のタイミング（構築，運用）や，設定する内容によって使用するツールを使い分けることができます。

セットアップウィザード

構築時に使用するツールです。対話型ウィザードで表示される画面に従って，項目を選択または設定するとシステムが構築できます。

運用管理ポータル

構築時，運用時に使用するツールです。GUI画面の画面項目を選択，またはテキストで値を入力するとシステムが構築できます。

Smart Composer機能

構築時，運用時に使用するツールです。ファイルでパラメタを設定し，コマンドでファイルの内容を反映するとシステムが構築できます。

オンライン業務を実行する，WebサーバとJ2EEサーバを配置するシステムを構築する場合は，システムの構築時にはセットアップウィザード，運用時には運用管理ポータルを使用します。セットアップウィザードを使用すると，製品をインストールしたあとは，対話形式で作業を進めるだけで，アプリケーションサーバがデフォルトで提供する機能を設定したシステムをスムーズに構築できます。運用管理ポータルを使用すると，GUI画面の表示項目やボタンをクリック操作するだけで，システム全体を一括で起動，停止したり，システムの稼働状況を確認したりする運用ができます。詳細設計が済んだシステムを構築する場合は，Smart Composer機能を使用します。

ただし，次の要件を満たす場合は，セットアップウィザードでは構築できません。この場合，運用管理ポータルまたはSmart Composer機能を使用してシステムを構築してください。

バッチ業務のアプリケーション（バッチアプリケーション）を実行するシステムを構築したい

1.1.1　セットアップウィザードとは

セットアップウィザードは，ウィザードに従って対話形式で操作を進めることで，J2EEアプリケーションの実行環境を構築できるツールです。必要な設定を画面で選択しながら作業を進められるので，事前に複雑なパラメタの検討や定義ファイルの編集をしないで済みます。J2EEアプリケーションが動作するWebフロントシステム（WebサーバとJ2EEサーバを配置するシステム）を構築するのに適しています。

アプリケーションサーバのバージョンが11-00以降の場合，セットアップウィザードではJ2EEサーバを構築する際，互換モードを使用することはできません。

また，J2EEアプリケーションを動作させる環境に最小限必要な項目だけを最小限の手順で設定して構築できるので，製品を導入してからシステムを起動するまでに掛かる時間を短縮できます。構築したシステムはチューニングもできます。まずは最小限の設定でシステムの運用を開始して，稼働状況に応じてシステム設定を最適化したり，システム構成を拡大したりするといった運用ができます。

セットアップウィザードによるシステム構築のイメージを次の図に示します。

図1‒1　セットアップウィザードによるシステム構築のイメージ

セットアップウィザードの画面に従って操作すると，次の作業が一括で実行できます。

システムの運用に必要なプロセス（運用管理機能）の構築

システムの実行に必要なプロセス（Webサーバ，J2EEサーバおよびパフォーマンストレーサ）の構築

データベースとの接続に必要なリソースアダプタの設定

運用管理機能，ならびにWebサーバ，J2EEサーバおよびパフォーマンストレーサの起動

なお，業務アプリケーションの設定および開始は，セットアップウィザード実行後に運用管理ポータルを使用して実行します。

セットアップウィザードで提供するセットアップ方法には，次のものがあります。

標準セットアップ

すべての設定項目をデフォルト値で構築するセットアップ方法です。データベースに接続するシステムも，使用するデータベースの設定以外はすべてデフォルト値で構築できます。WebサーバとJ2EEサーバで構成されるシステムをセットアップできます。

カスタムセットアップ

運用管理機能を使用するユーザ，各サーバで使用するポート番号などを任意の値に変更できるセットアップ方法です。設定値を変更しない項目は，デフォルト値のままセットアップできます。WebサーバとJ2EEサーバを配置するシステムと，J2EEサーバだけを配置するシステムをセットアップできます。

セットアップウィザードのデフォルト値については，「付録A　セットアップウィザードで設定されるパラメタ」を参照してください。

1.1.2　運用管理ポータルとは

運用管理ポータルは，Webブラウザ上に表示されるGUI画面を操作するだけで，J2EEアプリケーションまたはバッチアプリケーションの実行環境を構築・運用できるツールです。セットアップウィザードで構築したシステムのアプリケーションを登録して開始したり，システムを起動，停止したりといった運用ができます。システムの起動や停止のほかに，設定済みのサーバの情報を読み込んでほかのサーバに設定したり，ホストやサーバの単位でシステムのチューニングや構成変更をしたり，ホストやサーバの稼働状況を監視したりするといった運用ができます。

また，システム構築に必要な設定項目は画面に表示されるので，どのような設定があるのかを，すべて把握していなくても使えます。セットアップウィザードでは構築できない，ホストごとにプロセスを柔軟に組み合わせるシステムを構築するのに適しています。

運用管理ポータルによるシステム構築のイメージを次の図に示します。

図1‒2　運用管理ポータルによるシステム構築のイメージ

運用管理ポータルのGUI画面では，ホストやサーバの構成を定義し，各サーバの環境を設定して設定情報をホストに配布すると，システムが構築できます。データベースとの接続に必要なリソースアダプタや業務アプリケーションも設定して起動できます。なお，運用管理ポータルを使用する前には，運用管理機能の構築が必要です。

1.1.3　Smart Composer機能とは

Smart Composer機能は，複数のホストやサーバの構成，環境設定をファイルに定義してコマンドを実行するだけで，J2EEアプリケーションまたはバッチアプリケーションの実行環境を一括構築・運用できるツールです。Smart Composer機能で使用するXML形式のファイルは，あらかじめテンプレートが提供されています。さらに詳細設計で決めた設定を追加してシステムを構築できます。同じプロセスや設定を持つパターン化された構成のシステムを構築するのに適しています。

また，ファイルを使用して構築するので，ホストやサーバの数だけ同じ設定操作を繰り返す必要がありません。構築済みのシステムの設定情報をエビデンスとして残すこともできます。システムの起動や停止，一括設定変更，拡大（スケールアウト），縮小（スケールイン）などを各サーバをまとめた単位で一括操作できるので，一部の業務だけを停止したり，業務を実施しながらシステムを拡大（スケールアウト）したりするといった運用ができます。

Smart Composer機能によるシステム構築のイメージを次の図に示します。

図1‒3　Smart Composer機能によるシステム構築のイメージ

Smart Composer機能の定義ファイルで，ホストやサーバの構成，各サーバの環境設定を定義します。その定義ファイルを入力元としてSmart Composer機能のコマンドを実行すると，システムが構築できます。データベースとの接続に必要なリソースアダプタや業務アプリケーションは，Smart Composer機能でシステムを構築したあとに，ほかのコマンド（サーバ管理コマンド）で設定します。なお，Smart Composer機能を使用する前には，運用管理機能の構築が必要です。

1.2　システム構築の概要

ここでは，セットアップウィザードを使用して構築するシステムの概要について説明します。

システム構築では，まずは単一のWebフロントシステム（同一ホストにWebサーバとJ2EEサーバを配置するシステム）を構築します。次に，そのシステムに対して設定変更や構成変更を必要に応じて実施して，システム要件を満たすシステムを完成させます。

システムの構築手順を次に示します。なお，手順1.を実施するだけでも運用を開始できます。手順2および手順3.は，システム要件に合わせて実施してください。

単一のWebフロントシステムを構築します。（1.2.1）

必要に応じて，システムの性能や信頼性などを満たすために，システム環境定義を設定または変更します。

可用性を確保したWebフロントシステムに構成を変更します。（1.2.2）

同一構成のホストを複数配置して可用性を確保します。

マルチテナントに対応したWebフロントシステムに構成を変更します。（1.2.3または1.2.4）

J2EEサーバまたはリソースアダプタを複数配置してマルチテナントに対応します。

1.2.1　単一のWebフロントシステムを構築するには

単一のWebフロントシステムは，同一ホストにWebサーバとJ2EEサーバを配置するシステムです。このシステムは，セットアップウィザードに従って操作すると構築できます。

システム構成例

単一のWebフロントシステムの構成例を次の図に示します。

図1‒4　単一のWebフロントシステムの構成例

実施する作業と作業の要否

単一のWebフロントシステムの構築時に実施する作業と作業の要否を次の表に示します。

表1‒1　単一のWebフロントシステムの構築時に実施する作業と作業の要否

単一のWebフロントシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

○※

データベースに接続する場合

2.1.1

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

○※

データベースに接続する場合

2.2.5

システム環境のセットアップ

○

必ず実施

2.2.6

タイムアウトの設定

△

システム要件に合わせたシステム環境定義に変更する場合

2.2.9

業務アプリケーションの設定と開始

○

必ず実施

2.2.10

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

注※　このマニュアルで説明するシステム構成例では，データベースに接続することを前提としています。このため，この作業は必ず実施します。

1.2.2　同一構成のホストを複数配置して可用性を確保するには

同一構成のホストを複数配置すると，負荷分散機を利用することで，障害が発生したホストだけを停止して縮退運用できるので，システム全体の可用性を確保できます。同一構成のホストを複数配置して可用性を確保したWebフロントシステムは，単一のWebフロントシステムをベースに，負荷分散機を配置し，同じ構成のホストを複製して追加すると構築できます。

システム構成例

同一構成のホストを複数配置して可用性を確保したWebフロントシステムの構成例を次の図に示します。

図1‒5　同一構成のホストを複数配置して可用性を確保したWebフロントシステムの構成例

実施する作業と作業の要否

同一構成のホストを複数配置して可用性を確保したWebフロントシステムの構築時に実施する作業と作業の要否を次の表に示します。

表1‒2　同一構成のホストを複数配置して可用性を確保したWebフロントシステムの構築時に実施する作業と作業の要否

同一構成のホストを複数配置して可用性を確保したWebフロントシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

○※

データベースに接続する場合

2.1.1

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

○※

データベースに接続する場合

2.2.5

システム環境のセットアップ

○

必ず実施

2.2.6

タイムアウトの設定

△

システム要件に合わせたシステム環境定義に変更する場合

2.2.9

業務アプリケーションの設定と開始

○

必ず実施

2.2.10

可用性を確保するための設定

○

必ず実施

2.3.1

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

注※　このマニュアルで説明するシステム構成例では，データベースに接続することを前提としています。このため，この作業は必ず実施します。

1.2.3　J2EEサーバを複数配置してマルチテナント対応するには

J2EEサーバを複数配置すると，ホストのリソースを有効活用して，かつテナントごとに業務処理（アプリケーション）を分離させたマルチテナントの構成に対応できます。J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムは，単一のWebフロントシステムをベースに，J2EEサーバを含む論理サーバのまとまりをホストに追加すると構築できます。

システム構成例

J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムの構成例を次の図に示します。

図1‒6　J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムの構成例

実施する作業と作業の要否

J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否を次の表に示します。

表1‒3　J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否

J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

○※

データベースに接続する場合

2.1.1

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

○※

データベースに接続する場合

2.2.5

システム環境のセットアップ

○

必ず実施

2.2.6

タイムアウトの設定

△

システム要件に合わせたシステム環境定義に変更する場合

2.2.9

業務アプリケーションの設定と開始

○

必ず実施

2.2.10

J2EEサーバの複数配置

○

必ず実施

2.4.1

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

注※　このマニュアルで説明するシステム構成例では，データベースに接続することを前提としています。このため，この作業は必ず実施します。

1.2.4　リソースアダプタを複数配置してマルチテナント対応するには

リソースアダプタを複数配置すると，データベースを共有（データベース数の増加を抑止）して，かつテナントごとにデータを分離させたいマルチテナントの構成に対応できます。リソースアダプタを複数配置してマルチテナント対応するWebフロントシステムは，リソースアダプタをJ2EEサーバに追加し，業務アプリケーションからリソースアダプタを参照するようにすると構築できます。

システム構成例

リソースアダプタを複数配置してマルチテナントに対応したWebフロントシステムの構成例を次の図に示します。

図1‒7　リソースアダプタを複数配置してマルチテナントに対応したWebフロントシステムの構成例

実施する作業と作業の要否

リソースアダプタを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否を次の表に示します。

表1‒4　リソースアダプタを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否

リソースアダプタを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

○※

データベースに接続する場合

2.1.1

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

○※

データベースに接続する場合

2.2.5

システム環境のセットアップ

○

必ず実施

2.2.6

タイムアウトの設定

△

システム要件に合わせたシステム環境定義に変更する場合

2.2.9

業務アプリケーションの設定と開始

○

必ず実施

2.2.10

リソースアダプタの複数配置

○

必ず実施

2.4.2

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

注※　このマニュアルで説明するシステム構成例では，データベースに接続することを前提としています。このため，この作業は必ず実施します。

1.3　システム運用の概要

運用を開始したシステムでは，業務アプリケーションの入れ替え，稼働統計情報を利用したパフォーマンスチューニングなど，システムの保守を目的とした運用が発生します。運用作業は，実施するタイミングや内容によって，通常運用，保守運用，障害運用に分類できます。これらの作業では，運用管理ポータル（GUI）またはSmart Composer機能（CUI）のどちらかのツールを使用します。

●通常運用とは

アプリケーションサーバで実施する通常運用では，運用開始後に日々実施する，次の作業が該当します。システムの起動・停止に加えて，稼働状況の確認は，システムを構成する論理サーバのステータスや稼働状況を適宜確認して，安定した稼働状態を保っていくためにも必要な作業になります。

システムの起動（業務の開始）

システムの稼働状況の確認

システムの停止（業務の終了）

通常運用の手順については，「3.1　アプリケーションサーバの通常運用」を参照してください。

●保守運用とは

アプリケーションサーバで実施する保守運用では，運用状況に合わせて実施する，次の作業が該当します。サービスの提供方法やシステムのメンテナンスに応じて業務アプリケーションの設定を変更して入れ替えたり，稼働状況の資料を分析して動作環境を最適化したり，運用規模を調整したりするなど，運用状況によって必要な作業になります。

業務アプリケーションの入れ替え

パフォーマンスチューニング

IPアドレスの変更

データベース接続環境の変更

システムの構成・定義情報の取得

不要なJ2EEサーバの削除

運用管理機能の管理ユーザアカウントの設定変更

保守運用の手順については，「3.2　アプリケーションサーバの保守運用」を参照してください。

●障害運用とは

アプリケーションサーバでの障害発生時には，障害情報を取得して，業務を再開するためにシステムを回復する作業が必要になります。これを障害運用といいます。運用を再開したあとは，障害時に取得した障害情報を基に，障害の原因を解析する作業も実施します。アプリケーションサーバの機能では，プロセスがダウンしたり，ハングアップ（無応答）したりすると，プロセスを自動再起動して回復する運用も提供しています。障害運用の事前設定や障害情報の取得などについては，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

1.4　運用管理ポータルまたはSmart Composer機能で実現する運用形態の概要

ここでは，運用管理ポータルまたはSmart Composer機能で構築することをお勧めするシステムの構成について説明します。

運用管理ポータルまたはSmart Composer機能を使用すると，次の表に示す運用形態のシステムを構築できます。

表1‒5　運用管理ポータルまたはSmart Composer機能で実現するシステムの運用形態

項番

システムの運用形態

参照先

1

Webサーバを別ホストに配置してマシン性能を向上する運用形態

4.1

2

ホストを増やしてシステムの規模を拡大する運用形態（スケールアウト）

4.2

3

ホストを減らしてシステムの規模を縮小する運用形態（スケールイン）

4.3

4

構成・定義情報を出力してほかのホストにシステム環境を移行する運用形態

4.4

5

論理ユーザサーバを利用する運用形態

4.5

6

バッチアプリケーションを実行する環境を利用する運用形態

4.6

7

運用管理機能から負荷分散機を制御する運用形態

4.7

このほかにも，アプリケーションサーバの機能を利用した，次のようなシステムが構築できます。

運用管理サーバモデル（運用管理機能を別ホストに配置する）

CTMによるスケジューリング機能

MQモデル（TP1/Message Queue連携）

リバースプロキシ

その他の機能を利用する場合は，使用する機能に合わせたシステム構成の検討，パラメタ設計などの詳細設計をしてから，システムを構築します。この場合も運用管理ポータルまたはSmart Composer機能で構築します。その他の機能を利用したシステムについては，「4.8　その他の機能を使用したシステムの構築」を参照してください。なお，その他の機能については，次に示す機能解説のマニュアルを参照してください。

マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」

マニュアル「アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」

マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」

マニュアル「アプリケーションサーバ 機能解説 拡張編」

マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」

マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」

1.5　このマニュアルの例題および画面操作で使用している記号

このマニュアルの例題および画面操作で使用している記号について説明します。

定義例およびコマンドの実行例で使用している記号

このマニュアルの定義例およびコマンドの実行例で使用している記号について次の表に示します。

表1‒6　定義例およびコマンドの実行例で使用している記号

記号

意　味

<　>

この記号で囲まれている項目は，該当する要素やファイルなどを指定したり，該当する要素が表示されたりすることを示します。

（例1）　<プロパティ>

　プロパティを記述します。またはプロパティが表示されます。

（例2）　<ファイル名>

　ファイル名を指定します。

画面操作の説明で使用している記号

このマニュアルの画面操作（CUIおよびGUI）の説明で使用している記号について次に示します。

表1‒7　画面操作の説明で使用している記号

記号

意味

［　］

この記号で囲まれている項目は画面名または画面に表示されている項目であることを表します。

<　>

<　>内の名称がユーザの環境によって異なることを表します。

1.6　Windows使用時の注意事項

ここでは，Windows環境で，アプリケーションサーバを使用したシステムを構築，運用する場合の注意事項について説明します。

1.6.1　管理者特権で実行する必要がある操作

ここでは，Windows環境で，管理者特権で実行する必要がある操作について説明します。なお，システムドライブをCドライブとして説明します。

プログラムのインストール

アプリケーションサーバの製品や構成ソフトウェア，Eclipseなどのプログラムを，C:¥Program Files以下のディレクトリにインストールする場合，管理者特権で実行する必要があります。インストール時に，［UAC］ダイアログが表示される場合は，［UAC］ダイアログで管理者アカウントのパスワードを入力してください。

アプリケーションサーバが提供するコマンドの使用

アプリケーションサーバが提供するコマンドは，管理者特権で実行する必要があります。アプリケーションサーバが提供するコマンドは，「管理者：コマンドプロンプト」で実行してください。

「管理者：コマンドプロンプト」は，Windowsで提供されている機能を使用して起動してください。

アプリケーションサーバが提供する定義ファイルの更新

アプリケーションサーバが提供する定義ファイルは，管理者特権で更新する必要があります。管理者特権のないユーザが定義ファイルを更新しても，C:¥Program Files以下のディレクトリにある定義ファイルは更新されません。管理者特権のないユーザが更新したファイルは，次に示すディレクトリ以下に保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

なお，アプリケーションサーバは管理者特権で起動されるため，管理者特権のないユーザが更新した定義ファイルの内容は無視されます。

Eclipseでの操作

C:¥Program Files以下のディレクトリまたはC:¥windows以下のディレクトリに対する操作には制限があります。これらの制限されたディレクトリに対して，Eclipseのワークスペースを保存すると，リダイレクション機能によって，操作対象のファイルはリダイレクトされ，次の場所に格納されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore¥Program Files

保存したファイルの実体は上記の場所に格納されていますが，Eclipse上からはC:¥Program Files以下に実ファイルがあるかのように，ファイルを読み込んだり，書き込んだりできます。

サンプルプログラムの使用

アプリケーションサーバが提供するサンプルプログラムを実行する場合は，書き込み権限のある別のディレクトリへサンプルプログラムをコピーして使用することをお勧めします。

アプリケーションサーバの製品をデフォルトでインストールした場合，サンプルプログラムは，C:¥Program Files以下のディレクトリに格納されます。管理者特権のないユーザがサンプルプログラムを実行すると，サンプルプログラムで出力されるログファイルなどが，次に示すディレクトリ以下に保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

このため，アプリケーションサーバの製品をデフォルトでインストールしたディレクトリのまま，サンプルプログラムを使用する場合は，管理者特権で実行してください。サンプルプログラムを管理者特権で使用する場合は，「管理者：コマンドプロンプト」で実行する必要があります。エクスプローラからバッチファイルを右クリックして，［管理者として実行］をクリックした場合，正しく動作しません。

なお，アプリケーションサーバが提供するサンプルプログラムについては，「付録L　アプリケーションサーバが提供するサンプルプログラム」を参照してください。

1.6.2　JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

WindowsでサポートされているJIS X0213:2004の第三水準および第四水準の文字の一部には，Unicodeの補助文字が含まれます。Unicodeの補助文字とは，基本多言語面以外の文字（UnicodeのコードポイントがU+10000〜U+10FFFFの範囲の文字）のことです。UTF-16エンコーディングでは，サロゲートペアとして表されます。

Unicodeの補助文字を使用する場合の注意事項を次に示します。

リクエストで使用する場合の注意事項

アプリケーションサーバに対して，Microsoft EdgeなどのクライアントからUnicodeの補助文字を含むリクエストを送信した場合，Unicodeの補助文字は，ログやPRFトレースに正しく出力されません。ただし，その場合も，Unicodeの補助文字以外の文字は，ログやPRFトレースに正しく出力されます。

また，リクエストにUnicodeの補助文字が含まれる場合も，アプリケーションは正しく動作します。

リクエストでのUnicodeの補助文字の使用を制限したい場合には，アプリケーションでの対応などを検討してください。

環境構築／運用時の注意事項

アプリケーションサーバを構築，運用する場合，およびアプリケーションやリソースをデプロイする場合に使用する定義に，Unicodeの補助文字は使用できません。

Unicodeの補助文字を使用できない定義の例を示します。

EAR，WAR，JAR，EJB-JAR，サーブレット，JSP，クラス，メソッド，引数，または変数の名称

DD内の各種定義

システムのインストール先の指定値

そのほか，各種定義ファイルの設定値

2　システムの構築

この章では，単一のWebフロントシステムの構築手順について説明します。さらに，単一のWebフロントシステムから，可用性を確保したシステムやマルチテナントに対応したシステムへ変更する手順についても説明します。

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

2.1　データベースサーバの構築

J2EEサーバでリソース（データベース）を使用するために，データベースサーバを構築します。ここでは，データベースサーバで実施する作業について説明します。

2.1.1　データベースを準備する

データベースサーバに接続して，データベース製品をインストールします。

セットアップウィザードでセットアップするシステムから接続できるデータベースは，次のとおりです。使用する環境に合わせて，どちらかの製品をインストールしてください。各製品のインストール方法については，それぞれの製品のマニュアルを参照してください。

HiRDB（HiRDB/Parallel Server Version 9以降およびHiRDB/Single Server Version 9以降）

インストール方法およびデータベースサーバの初期設定については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

Oracle（Oracle 11g R2以降）

インストール方法およびデータベースサーバの初期設定については，Oracleのマニュアルを参照してください。

アプリケーションサーバの構築時に，データベース接続環境を設定する際には，次の情報を指定します。データベースサーバの構築時にこれらの情報を控えておいてください。

HiRDBの場合

データベースのホスト名

データベースのポート番号

データベースのアクセスユーザ

アクセスユーザのパスワード

Oracleの場合

データベース名（SID）

データベースのホスト名

データベースのポート番号

データベースのアクセスユーザ

アクセスユーザのパスワード

2.2　アプリケーションサーバの構築

ここでは，「1.2.1　単一のWebフロントシステムを構築するには」で説明した，単一のWebフロントシステム（WebサーバおよびJ2EEサーバを同じホストに配置するシステム）のアプリケーションサーバを構築する手順について説明します。なお，例題で使用するJ2EEアプリケーションは，ファイル名を「MyApp1.ear」，表示名を「MyApp」とします。

2.2.1　Application Serverのインストールについて

ここでは，Application Serverのインストール方法の種類について説明します。また，アプリケーションサーバ製品に含まれる構成ソフトウェアの一つである，Component Containerをインストールしたときのユーザ環境の扱いや，製品に対応する構成ソフトウェアの依存関係についても説明します。

(1)　インストール方法の種類

Application Serverをインストールする方法には，次の種類があります。

新規インストール

Application Serverがインストールされていない環境に，Application Serverをインストールすることです。インストールする構成ソフトウェアは，「標準」，「カスタム」から選択できます。「標準」を選択すると，Application Serverで推奨する構成ソフトウェアをすべてインストールします。「カスタム」を選択すると，Application Serverに対応する構成ソフトウェアのうち，選択した構成ソフトウェアをインストールします。詳細は，「2.2.2　Application Serverを新規インストールする（Windowsの場合）」，「2.2.3　Application Serverを新規インストールする（AIXの場合）」，または「2.2.4　Application Serverを新規インストールする（Linuxの場合）」を参照してください。

更新インストール

Application Serverがインストール済みの環境に，Application Server（同一製品）をインストールすることです。インストールする構成ソフトウェアは，「標準」，「カスタム」から選択できます。「標準」を選択すると，Application Serverで推奨する構成ソフトウェアをすべて再インストールします。「カスタム」を選択すると，Application Serverに対応する構成ソフトウェアのうち，選択した構成ソフトウェアを再インストールします。詳細は，「付録F　Application Serverの更新インストール」を参照してください。

更新インストールを行う場合，インストール時のJavaバージョンの環境の選択では，すでにインストールされているCosminexus Developer's Kit for Java (TM)と同じJavaバージョンを選択してください。

すでにインストールされているCosminexus Developer's Kit for Java (TM)と異なるJavaバージョンを選択した場合は，更新インストールを行うことができません。

そのほかのインストール方法として，次のものがあります。

JP1/SC/DPMを使ったディスク複製インストール

JP1/SC/DPMを使用して作成したディスクイメージの複製をインストールすることです。詳細は，「付録G　JP1/SC/DPMを使ったディスク複製インストール」を参照してください。

リモートインストール

JP1/NETM/DMやGroupmax Remote Installationを使用し，ネットワークを介してソフトウェアをクライアントへ配布するインストールのことです。詳細は，「付録H　リモートインストール」を参照してください。

なお，例題で説明するアプリケーションサーバでのインストール方法は，新規インストールとします。

注意事項

Application Serverのインストール時に，使用するJDKのバージョンを選択する必要があります。インストールするJDKによって，アプリケーションサーバで使用できる機能が異なります。目的に合わせて使用するJDKを決定してください。また，インストール時にも次の違いがあります。

JDK11の場合：旧バージョンからの更新インストールおよび新規インストールが可能

JDK17の場合：新規インストールだけが可能

機能の違いについては，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.3.3　アプリケーションサーバ 11-00，11-10，11-20，11-30，または11-40から，11-50までの仕様変更」を参照してください。

(2)　Component Containerインストール時のユーザ環境の扱い

アプリケーションサーバ製品に含まれる構成ソフトウェアの一つである，Component Containerをインストールするとき，インストールの種類によってユーザ環境の扱いが異なります。インストールの種類ごとのユーザ環境の扱いを次の表に示します。

表2‒1　インストールの種類ごとのユーザ環境の扱い

インストールの種類

J2EEサーバまたはバッチサーバのユーザ定義

サーバ管理コマンドのユーザ定義

サーバの作業ディレクトリ※

新規インストール

インストーラが，デフォルトのJ2EEサーバまたはバッチサーバをセットアップし，ユーザ定義を作成します。

インストーラが，デフォルトのユーザ定義を作成します。

J2EEサーバまたはバッチサーバが，初回起動時に作成します。

更新インストール

同一バージョン同士（上書き）で更新

前の設定を引き継ぎます。

デフォルトのサーバ（ホスト名称のサーバ）の定義ディレクトリ（<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<ホスト名称>，または/opt/Cosminexus/CC/server/usrconf/ejb/<ホスト名称>）がない場合には，定義ファイルが自動的にセットアップされます。

前の設定を引き継ぎます。

前の設定を引き継ぎます。

異なるバージョン同士（バージョンアップ）で更新

前の設定を引き継ぎます。

前の設定を引き継ぎます。

インストール後，cjenvupdateコマンド（J2EEサーバまたはバッチサーバの移行コマンド）を実行して移行してください。移行情報は，既存のディレクトリに格納され，そのまま利用されます。

詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.2.2　更新インストールの場合」を参照してください。

注※　サーバの作業ディレクトリは，J2EEサーバとバッチサーバの場合で異なります。J2EEサーバの作業ディレクトリについては，「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。バッチサーバの作業ディレクトリについては，「付録C.2　バッチサーバの作業ディレクトリ」を参照してください。

(3)　製品に対応する構成ソフトウェアについて

各製品に含まれている構成ソフトウェアは，アプリケーションサーバおよびBPM/ESB基盤の機能に対応します。製品に含まれている構成ソフトウェアの種類によって，実現できる機能が異なります。製品と構成ソフトウェアの対応を次の表に示します。なお，各構成ソフトウェアの詳細は，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の「2.2.2　構成ソフトウェアの機能概要」を参照してください。

表2‒2　製品と構成ソフトウェアの対応

構成ソフトウェア名

アプリケーションサーバ

BPM/ESB基盤

オプション製品

Application Server

Developer

Service Platform

Service Architect

Client

Application Development Plug-in

−

○

−

○

−

Component Container

○

○

○

○

−

Component Container - Client

−

−

−

−

○

Component Container - Redirector

○

−

○

−

−

Component Transaction Monitor

○

○

○

○

−

Developer's Kit for Java

○

○

○

○

○

HTTP Server

○

○

○

○

−

Performance Tracer

○

○

○

○

○

Reliable Messaging

○

○

○

○

−

Service Coordinator

−

−

○

○

−

Service Development Plug-in

−

−

−

○

−

TPBroker

○

○

○

○

○

Web Services - Security

○

○

○

○

−

XML Processor

○

○

○

○

○

HiRDB/Single Server Version 10

−

○

−

○

−

（凡例）

○：含まれます。　−：含まれません。

また，構成ソフトウェア間では，次の表に示す依存関係があります。インストールおよびアンインストール時には注意してください。

表2‒3　構成ソフトウェア間の依存関係

操作対象の構成ソフトウェア

前提となる構成ソフトウェア

Application Development Plug-in

Component Container

Developer's Kit for Java

XML Processor

Component Container

Developer's Kit for Java

Performance Tracer

TPBroker

XML Processor

Component Container - Client

Developer's Kit for Java

Performance Tracer

TPBroker

Component Container - Redirector

Performance Tracer

Component Transaction Monitor

Performance Tracer

Developer's Kit for Java

−

HTTP Server

−

Performance Tracer

−

Reliable Messaging

Component Container

Service Coordinator

Component Container

Component Transaction Monitor

Developer's Kit for Java

HTTP Server

Performance Tracer

Reliable Messaging

TPBroker

XML Processor

Service Development Plug-in

Component Container

Developer's Kit for Java

Service Coordinator

XML Processor

TPBroker

Developer's Kit for Java

Web Services - Security

Component Container

Developer's Kit for Java

XML Processor

XML Processor

Component Container※

Developer's Kit for Java

HiRDB/Single Server Version 10

−

HiRDB SQL Executer Version 9

−

（凡例）−：前提となる構成ソフトウェアがないことを示します。

注※　Client以外の場合に，スキーマキャッシュ機能を使用するときには前提となります。Clientの場合は前提となりません。

(4)　製品の提供媒体について

製品の提供媒体がCD-ROMの場合の手順を説明しています。製品の提供媒体がDVD-ROMの場合は，CD-ROMをDVD-ROMに読み替えてください。

2.2.2　Application Serverを新規インストールする（Windowsの場合）

アプリケーションサーバに接続して，Application Serverを新規インストールします。新規インストールでは，製品の提供媒体であるインストーラを使用します。インストーラの使用方法については，製品の提供媒体のドキュメントを参照してください。

新規インストールの手順を次に示します。インストール作業にはAdministrator権限が必要です。インストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を，インストール時のエラーコードについては，「付録I.6　Application Serverのインストールおよびアンインストール時のエラーコード一覧（Windowsの場合）」を参照してください。

手順

製品の提供媒体をCD-ROMドライブにセットします。

［日立総合インストーラ］ダイアログに，「選択されたソフトウェアをインストールします。」と表示されます。

［日立総合インストーラ］ダイアログが表示されない場合，エクスプローラを使用して，CD-ROMディレクトリの「HCD_INST.EXE」をダブルクリックしてください。

Application Serverを選択した状態で，［インストール実行］ボタンをクリックします。

［インストール処理開始の確認 − 日立総合インストーラ］ダイアログに，「インストールを開始します。よろしいですか？」と表示されます。

［OK］ボタンをクリックします。

［uCosminexus Application Serverセットアッププログラムへようこそ］ダイアログが表示されます。

［次へ］ボタンをクリックします。

［インストール先の選択］ダイアログが表示されます。

必要に応じて［インストール先のフォルダ］を選択して，［次へ］ボタンをクリックします。

［機能の選択］ダイアログが表示されます。

注意事項

［インストール先のフォルダ］には，次のパスを指定しないでください。

ネットワークドライブ

2バイトコードを含むパス

¥　/　:　，　;　*　?　"　<　>　|　$　%　^　'　!　(　)　=　+　{　}　@　[　]　&を含むパス※

半角50文字を超えるパス

末尾が¥のパス（C:¥など）

注※　プログラムフォルダ名にも指定できません。「;」と「/」はすべての入力情報にも指定できません。

［標準 - このセットアップを推奨します。］の左にあるボタンをクリックします。

［使用するJavaバージョンの選択］ページが表示されます。

注意事項

使用するJavaバージョンの環境を選択してください。選択したJavaバージョンのCosminexus Developer's Kit for Java (TM)がインストールされます。Javaバージョンの違いにより使用できる機能範囲が異なりますので，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「10.3.3　アプリケーションサーバ 11-00，11-10，11-20，11-30，または11-40から，11-50までの仕様変更」を参照してください。

「JDK17」または「JDK11」のどちらかを選択して，［次へ］ボタンをクリックします。

［ユーザ情報］ダイアログが表示されます。

参考

製品の構成ソフトウェアを選択して新規インストールすることもできます。この場合は，［カスタム - 詳しいユーザやシステム管理者のためのセットアップです。セットアップ可能なすべてのオプションをカスタマイズする事ができます。］の左にあるボタンをクリックし，表示される［プログラムの選択］ダイアログで，インストールする構成ソフトウェア（プログラム）を選択して，［次へ］ボタンをクリックします。

製品に対応している構成ソフトウェアについては，「2.2.1(3)　製品に対応する構成ソフトウェアについて」を参照してください。

［ユーザ名］および［会社名］を入力して［次へ］ボタンをクリックします。

［プログラム フォルダの選択］ダイアログが表示されます。

必要に応じて［プログラムフォルダ］を変更して，［次へ］ボタンをクリックします。

［インストールの開始］ダイアログが表示されます。

設定した内容を確認して，問題がなければ［次へ］ボタンをクリックします。

インストールが開始されます。インストールが完了すると，［セットアップの完了］ダイアログが表示されます。

［完了］ボタンをクリックします。

OSを再起動するかどうかを確認する画面が表示されます。

［はい］ボタンをクリックします。

OSが再起動し，Application Serverの新規インストールが完了します。

修正パッチを適用します。

修正パッチとは，製品リリース後に提供される改良版のことです。

Application Serverのインストールが完了したら，ソフトウェアサポートサービスのWebサイトから最新の修正パッチを入手して，適用してください。

ソフトウェアサポートサービスのWebサイトにアクセスできない環境の場合は，製品に同梱されている修正パッチCDを利用してください。

2.2.3　Application Serverを新規インストールする（AIXの場合）

アプリケーションサーバに接続して，Application Serverを新規インストールします。

新規インストールでは，製品の提供媒体であるPPインストーラを使用します。

新規インストールの手順を次に示します。インストール作業にはroot権限が必要です。新規インストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を参照してください。

インストール前に環境変数PATHに/usr/bin，/binを設定してください。この設定はインストール後も有効となるようにしてください。

構成ソフトウェアのComponent Containerに関する操作権限をスーパーユーザ以外の一般ユーザ（Component Container管理者）に与えることができます。この場合，インストールの前後で作業が必要になります。詳細は，「4.1.3　Component Container管理者を設定する（UNIXの場合）」を参照してください。

手順

アプリケーションサーバにroot権限（スーパーユーザ）でログインします。

PPインストーラ実行時の言語種別と，実行するターミナルの言語が一致しているかどうかを確認し，一致していない場合は一致させます。

製品の提供媒体をCD-ROMドライブにセットします。

製品の提供媒体がCD-ROMの場合は，CD-ROMファイルシステムをマウントします。

コマンドの実行例を次に示します。下線部には，デバイススペシャルファイル名，およびCD-ROMファイルシステムのマウントディレクトリ名を指定します。なお，これらの名称は，OS，ハードウェア，および環境によって異なります。

（実行例）

mount -r -v cdrfs /dev/cd0 /cdrom

セットアッププログラムを起動します。

コマンドの実行例を次に示します。下線部には，CD-ROMファイルシステムのマウントディレクトリ名を指定します。

（実行例）

/cdrom/aix/setup /cdrom

CD-ROMセットアッププログラムによって，PPインストーラと常駐プロセス自動起動プログラムがハードディスク上にインストールされ，PPインストーラが自動的に起動されます。

注意事項

CD-ROMのディレクトリ名やファイル名は，マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

PPインストーラのメインメニューで，［I］キーを押します。

PPインストール画面が表示されます。

プログラムにカーソルを移動させ，［スペース］キーを押します。

すべてのプログラム（Application Serverに対応している構成ソフトウェア，および製品の共通モジュール）を選択します。選択したプログラムの左側には<@>が表示されます。なお，プログラムを選択してインストールすることもできます。

注意事項

製品に対応している構成ソフトウェアについては，「2.2.1(3)　製品に対応する構成ソフトウェアについて」を参照してください。製品の共通モジュールは，製品によって表示されるプログラム名が異なります。

すべてのプログラムの左側に<@>が表示されていることを確認して，［I］キーを押します。

画面の最下行に「Install PP? (y: install, n: cancel)==>」メッセージが表示されます。

［y］キーまたは［Y］キーを押します。

インストールが開始されます。

［n］キーまたは［N］キーを押すと，インストールが中止されてPPインストール画面に戻ります。

インストール終了を示すメッセージが出力されたら，［Q］キーを押します。

PPインストーラのメインメニューに戻ります。

必要に応じて，PPインストーラのメインメニューで［L］キーを押して，インストール済みのプログラムを確認します。

PP一覧表示画面が表示されます。［P］キーを押すと，インストール済みのプログラム一覧が「/tmp/hitachi_PPLIST」に出力されます。［Q］キーを押すと，PPインストーラのメインメニューに戻ります。

PPインストーラのメインメニューで，［Q］キーを押します。

Application Serverの新規インストールが完了します。

修正パッチを適用します。

修正パッチとは，製品リリース後に提供される改良版のことです。

Application Serverのインストールが完了したら，ソフトウェアサポートサービスのWebサイトから最新の修正パッチを入手して，適用してください。

ソフトウェアサポートサービスのWebサイトにアクセスできない環境の場合は，製品に同梱されている修正パッチCDを利用してください。

2.2.4　Application Serverを新規インストールする（Linuxの場合）

アプリケーションサーバに接続して，Application Serverを新規インストールします。

新規インストールでは，製品の提供媒体であるPPインストーラを使用します。Linuxの場合，Reliable MessagingおよびWeb Services - SecurityをインストールするPPインストーラと，それ以外の構成ソフトウェアと製品の共通モジュールをインストールするPPインストーラが異なります。

新規インストールの手順を次に示します。インストール作業にはroot権限が必要です。インストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を参照してください。

インストール前に環境変数PATHに/usr/bin，/binを設定してください。この設定はインストール後も有効となるようにしてください。

構成ソフトウェアのComponent Containerに関する操作権限をスーパーユーザ以外の一般ユーザ（Component Container管理者）に与えることができます。この場合，インストールの前後で作業が必要になります。詳細は，「4.1.3　Component Container管理者を設定する（UNIXの場合）」を参照してください。

手順

アプリケーションサーバにroot権限（スーパーユーザ）でログインします。

次のパッケージがインストールされていることを確認します。

パッケージの中には，ご使用のRed Hat Enterprise Linux Serverのバージョンによってはデフォルトでインストールされないものがあります。

alsa-lib (x86_64)

bash (x86_64)

bzip2-libs (x86_64)

chkconfig (x86_64)

coreutils (x86_64)

cpio (x86_64)

cups-libs (x86_64)

findutils (x86_64)

fontconfig (x86_64)

freetype (x86_64)

gawk (x86_64)

GConf2 (x86_64)※1

gdb (x86_64)

glib2 (x86_64)

glibc (i686)

glibc (x86_64)

graphite2 (x86_64)※2

grep (x86_64)

gtk2 (x86_64)

gtk3 (x86_64)

gzip (x86_64)

harfbuzz(x86_64)※2

krb5-libs (x86_64)

ksh (x86_64)

libbrotli(x86_64)※2

libgcc (i686)

libgcc (x86_64)

libpng (x86_64)

libstdc++ (i686)

libstdc++ (x86_64)

libX11 (x86_64)

libXau (x86_64)

libxcb (x86_64)

libxcrypt (x86_64)※1

libxcrypt-compat (x86_64)※2

libXext (x86_64)

libXi (x86_64)

libXrender (x86_64)

libXtst (x86_64)

lksctp-tools (x86_64)

ncompress (x86_64)※1

ncurses (x86_64)

net-tools (x86_64)

nss (x86_64)

pcre(x86_64)※2

pcsc-lite-libs (x86_64)

procps-ng (x86_64)

rpm (x86_64)

sed (x86_64)

sysstat (x86_64)

tar (x86_64)

tcsh (x86_64)

which (x86_64)

zlib (x86_64)

注※1

Red Hat Enterprise Linux 8（AMD/Intel 64）をご使用の場合だけ必要です。

注※2

Red Hat Enterprise Linux 9（AMD/Intel 64）をご使用の場合だけ必要です。

パッケージがインストールされているかどうかは，rpmコマンドを実行して確認します。コマンドの実行例と実行結果の例を次に示します。

（実行例）

#rpm -q --qf  '%{NAME}-%{ARCH}¥n'  ncurses

（実行結果の例）

ncurses-x86_64

この例では，64ビット版のncursesパッケージがインストールされていることを示します。

「package <パッケージ名> is not installed」メッセージが表示された場合は，パッケージがインストールされていないので，<パッケージ名>に示すパッケージをインストールしてください。なお，インストール時には，関連するパッケージも必要に応じてインストールしてください。

PPインストーラ実行時の言語種別と，実行するターミナルの言語が一致しているかどうかを確認し，一致していない場合は一致させます。

製品の提供媒体をCD-ROMドライブにセットします。

製品の提供媒体がCD-ROMの場合は，CD-ROMファイルシステムをマウントします。

コマンドの実行例を次に示します。下線部には，CD-ROMファイルシステムのマウントディレクトリ名を指定します。なお，マウントディレクトリ名は，OS，ハードウェア，および環境によって異なります。

（実行例）

mount -r -o mode=0544  /dev/cdrom  /mnt/cdrom

Reliable MessagingおよびWeb Services - Securityをインストールするセットアッププログラムを起動します。

コマンドの実行例を次に示します。下線部には，CD-ROMファイルシステムのマウントディレクトリ名を指定します。

（実行例）

/mnt/cdrom/linux/setup  /mnt/cdrom

CD-ROMセットアッププログラムによって，PPインストーラと常駐プロセス自動起動プログラムがハードディスク上にインストールされ，PPインストーラが自動的に起動されます。

注意事項

CD-ROMのディレクトリ名やファイル名は，マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

PPインストーラのメインメニューで，［I］キーを押します。

PPインストール画面が表示されます。

プログラムにカーソルを移動させ，［スペース］キーを押します。

すべてのプログラム（Reliable MessagingおよびWeb Services - Security）を選択します。選択したプログラムの左側には<@>が表示されます。なお，プログラムを選択してインストールすることもできます。

すべてのプログラムの左側に<@>が表示されていることを確認して，［I］キーを押します。

画面の最下行に「Install PP? (y: install, n: cancel)==>」メッセージが表示されます。

［y］キーまたは［Y］キーを押します。

インストールが開始されます。

［n］キーまたは［N］キーを押すと，インストールが中止されてPPインストール画面に戻ります。

インストール終了を示すメッセージが出力されたら，［Q］キーを押します。

PPインストーラのメインメニューに戻ります。

PPインストーラのメインメニューで，［Q］キーを押します。

PPインストーラが終了します。

Reliable MessagingおよびWeb Services - Security以外と共通モジュールをインストールするセットアッププログラムを起動します。

コマンドの実行例を次に示します。下線部には，CD-ROMファイルシステムのマウントディレクトリ名を指定します。

（実行例）

/mnt/cdrom/x64lin/setup /mnt/cdrom

CD-ROMセットアッププログラムによって，PPインストーラと常駐プロセス自動起動プログラムがハードディスク上にインストールされ，PPインストーラが自動的に起動されます。

注意事項

CD-ROMのディレクトリ名やファイル名は，マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

PPインストーラのメインメニューで，［I］キーを押します。

PPインストール画面が表示されます。

プログラムにカーソルを移動させ，［スペース］キーを押します。

すべてのプログラム（Application Serverに対応しているReliable MessagingおよびWeb Services - Security以外の構成ソフトウェア，および製品の共通モジュール）を選択します。選択したプログラムの左側には<@>が表示されます。なお，プログラムを選択してインストールすることもできます。

注意事項

製品に対応している構成ソフトウェアについては，「2.2.1(3)　製品に対応する構成ソフトウェアについて」を参照してください。製品の共通モジュールは，製品によって表示されるプログラム名が異なります。

すべてのプログラムの左側に<@>が表示されていることを確認して，［I］キーを押します。

画面の最下行に「Install PP? (y: install, n: cancel)==>」メッセージが表示されます。

［y］キーまたは［Y］キーを押します。

インストールが開始されます。

［n］キーまたは［N］キーを押すと，インストールが中止されてPPインストール画面に戻ります。

インストール終了を示すメッセージが出力されたら，［Q］キーを押します。

PPインストーラのメインメニューに戻ります。

必要に応じて，PPインストーラのメインメニューで［L］キーを押して，インストール済みのプログラムを確認します。

PP一覧表示画面が表示されます。［P］キーを押すと，インストール済みのプログラム一覧が「/tmp/hitachi_PPLIST」に出力されます。［Q］キーを押すと，PPインストーラのメインメニューに戻ります。

PPインストーラのメインメニューで，［Q］キーを押します。

Application Serverの新規インストールが完了します。

修正パッチを適用します。

修正パッチとは，製品リリース後に提供される改良版のことです。

Application Serverのインストールが完了したら，ソフトウェアサポートサービスのWebサイトから最新の修正パッチを入手して，適用してください。

ソフトウェアサポートサービスのWebサイトにアクセスできない環境の場合は，製品に同梱されている修正パッチCDを利用してください。

2.2.5　データベースに接続するための製品をインストールする

アプリケーションサーバに接続して，データベースに接続するための製品（HiRDB Run TimeまたはOracle JDBC Thin Driver）をインストールします。

インストール方法についてはマニュアル「HiRDB UAP開発ガイド」またはOracleのマニュアルを参照してください。

2.2.6　システム環境をセットアップする（単一のWebフロントシステムを構築する）

単一のWebフロントシステムのシステム環境をセットアップします。

参考

説明で使用するコマンドの参照先，コマンドの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

システム環境のセットアップには，セットアップウィザードを使用します。システム環境のセットアップ時の注意事項については，「2.2.7　システム環境をセットアップするときの注意事項」を参照してください。

注意事項

セットアップウィザードでセットアップしたシステム環境では，次に示す項目は自動設定されます。これらの項目にほかの内容を設定したい場合は，運用管理ポータルまたはSmart Composer機能を使用してシステム環境を構築してください。

ホスト名にはコンピュータ名が設定されます。設定された名称は変更できません。

論理サーバ名には次の名称が設定されます。設定された名称は変更できません。

パフォーマンストレーサ：MyPerformanceTracer

J2EEサーバ：MyJ2EEServer

Webサーバ：MyWebServer

(1)　セットアップウィザードの起動とシステム環境のセットアップ

セットアップウィザードを起動して，システム環境をセットアップします。

コマンドプロンプトでsetupwizardコマンドを実行し，セットアップウィザードを起動します。

コマンドの実行例を次に示します。

setupwizard

［ようこそ］画面で「1」を入力して，Enterキーを押します。

［セットアップ方法の選択］画面で「1」を入力して，Enterキーを押します。

［データベース接続環境の設定］画面で「y」を入力して，Enterキーを押します。

使用するデータベース（HiRDBの場合は「1」，Oracleの場合は「2」）を入力して，Enterキーを押します。

画面の指示に従って，データベースに対する接続情報を入力して，Enterキーを押します。

データベースに対する接続情報として，データベースのホスト名，ポート番号，アクセスユーザ，アクセスユーザのパスワードなどを画面の指示に従って入力します。

入力項目が終了すると，「現在の設定」を確認する画面が表示されます。

「現在の設定」の内容を確認したら「1」を入力して，Enterキーを押します。

［セットアップ情報］画面が表示されます。

参考

「現在の設定」の内容に誤りがある場合は「2」を入力して，手順4.から設定し直してください。

［セットアップ情報］画面で「1」を入力して，Enterキーを押します。

セットアップを開始し，処理ごとにセットアップの実行状態を示すメッセージが表示されます。

すべての処理でセットアップが完了すると，セットアップ情報ファイルおよび簡易構築定義ファイルの保存と，セットアップウィザードの終了を示すメッセージが表示されます。

(2)　OSの起動と同時に運用管理機能を自動起動するための設定

OSを起動すると同時に，運用管理機能を自動的に起動するように設定します。

コマンドプロンプトでmngautorunコマンドを実行し，ホストの起動と同時に運用管理機能（Management Serverおよび運用管理エージェント）を起動するように設定します。

コマンドの実行例を次に示します。

mngautorun both -sync

2.2.7　システム環境をセットアップするときの注意事項

ここでは，システム環境をセットアップするときの注意事項について説明します。

セットアップウィザードを実行できるユーザは次のとおりです。次に示すユーザ以外がセットアップウィザードを実行した場合，エラーとなります。

Windowsの場合

管理者特権でコマンドを実行してください。

UNIXの場合

root権限のあるユーザでコマンドを実行してください。

コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

セットアップ処理の途中でエラーが発生した場合は，セットアップ処理は停止され，セットアップ失敗の画面が表示されます。この場合，セットアップ中のシステムを削除してから再度セットアップを実行してください。セットアップ中のシステムを削除するには，セットアップウィザードでアンセットアップを実行します。アンセットアップについては「3.3.1　システム環境をアンセットアップする」を参照してください。

セットアップウィザード操作時に，設定値の入力を求められている場合に何も入力しないでEnterキーを押すと，設定項目にデフォルト値が適用されます。なお，デフォルト値がない設定項目もあります。デフォルト値がない設定項目でEnterキーを押すとエラーとなり，再度設定値の入力が求められます。

設定値の入力を求められている場合に，設定できない値を入力してEnterキーを押すとエラーとなり，次の画面が表示されます。

図2‒1　設定できない値を入力した場合の画面

設定できる値が「0文字以上」の設定項目について設定値の入力を求められている場合に何も入力しないでEnterキーを押すと，空文字が適用されます。

なお，一度値を設定した項目について値を再入力する場合は次の画面が表示されます。

図2‒2　設定できる値が「0文字以上」の設定項目について値を再入力する場合の画面

この画面が表示された場合に何も入力しないでEnterキーを押すと，設定済みの値は適用されないで，空文字が適用されます。

セットアップウィザードでは，セットアップウィザードを実行するホスト上にだけシステム環境をセットアップできます。ほかのホスト上にはシステム環境をセットアップできません。

標準セットアップでセットアップウィザードを実行すると，次の表に示すポート番号を使用したシステム環境がセットアップされます。

表2‒4　標準セットアップで使用するポート番号

ポート番号

用途

80

Webサーバのポート番号

900

インプロセスのネーミングサービスのポート番号

8008

httpのポート番号

28008

管理用サーバのポート番号

20295

運用管理エージェントのポート番号

23152

RMIレジストリのポート番号

28005

Management Server終了要求受信ポート番号

28009

Management Server内部通信用ポート番号

28080

Management Server接続HTTPポート番号

これらのポート番号をすでに使用している場合は，標準セットアップでは構築できません。［セットアップ方法の選択］画面で「2」（カスタムセットアップ）を入力して，次の画面で重複しないポート番号を設定してください。

［運用管理機能の設定］画面

［システム環境の設定］画面

なお，ポート番号以外を標準セットアップと同じ設定にする場合は，［運用管理ユーザの設定］画面，［J2EEサーバの起動ユーザの設定］画面（UNIXの場合）および［システム構成の選択］画面で「1」（デフォルト）を入力してセットアップしてください。

セットアップに失敗した場合に［セットアップ失敗］画面でyを入力すると，障害に対処するための資料として，snapshotログが自動的に収集されます。

snapshotログの格納先と収集内容を次に示します。

snapshotログの格納先

<セットアップウィザードのログの出力先>/snapshot.zip

snapshotログの収集内容

<Application Serverのインストールディレクトリ>/manager/config/snapshotlog.confで示す範囲

<セットアップウィザードのログの出力先>/setupwizard<ファイル面数>.log

<セットアップウィザードのログの出力先>/maintenance/setupwizard<ファイル面数>.log

<Application Serverのインストールディレクトリ>/manager/setup/config/

<Application Serverのインストールディレクトリ>/manager/setup/tmp/

<セットアップウィザードのログの出力先>は，setup.cfgのsetup.log.dirで指定した出力先です。setup.cfgについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.18　setup.cfg（セットアップウィザード用設定ファイル）」を参照してください。

セットアップウィザードで使用するファイルの一覧を次の表に示します。

表2‒5　セットアップウィザードで使用するファイルの一覧

分類

ファイル名称

概要

出力先

セットアップ情報リスト

setupwizardlist.txt

セットアップ処理完了（成功）後出力されます。

セットアップウィザードで構築した環境を確認するためのファイルです。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥setup¥config

UNIXの場合

/opt/Cosminexus/manager/setup/config

セットアップ情報ファイル

setupwizard.dat

［セットアップ情報］画面で「セットアップ情報を保存する」を選択した場合に出力されます。

一括セットアップで使用できます。

setupwizard_success.dat

セットアップ処理完了（成功）後に自動的に出力されます。

一括セットアップまたはシステムの複製で使用できます。

setupwizard_failed.dat

セットアップ処理完了（失敗）後に自動的に出力されます。

一括セットアップで使用できます。

ただし，このファイルを使用して一括セットアップをする場合は，セットアップ処理失敗の原因を取り除く必要があります。

ログファイル

setupwizard<ファイル面数>.log

セットアップウィザードのログが出力されます。

最大ファイルサイズ，最大ファイル面数などのログファイルの設定は，setup.cfg（セットアップウィザード用設定ファイル）で指定できます。

任意（setup.cfgのsetup.log.dirで指定した出力先）

簡易構築定義ファイル

cmxsetupwz.xml

セットアップ処理完了（成功）後出力されます。

セットアップウィザードで構築した環境の定義内容を確認するためのファイルです。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥setup¥config

UNIXの場合

/opt/Cosminexus/manager/setup/config

DB ConnectorのConnector属性ファイル

DBConnector_HiRDB_Type4_CP_cfg.xml

または

DBConnector_Oracle_CP_cfg.xml

セットアップ処理完了（成功）後出力されます。

セットアップウィザードで構築した環境で使用するDB Connectorの定義内容を確認するためのファイルです。

セットアップウィザード用設定ファイル

setup.cfg

セットアップウィザードのログファイルの出力先，最大ファイルサイズ，最大ファイル面数などを指定するファイルです。

2.2.8　システム環境定義の設定とは

システム環境のセットアップが完了した時点では，各種定義ファイルのパラメタには，デフォルト値が設定されています。システム要件を満たしたシステム環境にするためには，各種定義ファイルのパラメタの設定値を必要に応じて変更します。この作業をシステム環境定義の設定といいます。

システム要件で設定する代表的なパラメタとして，タイムアウトを設定する作業について説明します。

タイムアウトの設定

タイムアウトの設定は，システムのトラブル発生を検知して，リクエストの応答が返らなくなることを防ぎ，適宜リソースを解放することを目的とします。システムのタイムアウト，トランザクションのタイムアウト，データベースのタイムアウトなどが設定できます。タイムアウトに設定する値の考え方については，マニュアル「アプリケーションサーバシステム設計ガイド」の「8.6　タイムアウトを設定する」を参照してください。

2.2.9　タイムアウトを設定する

次に示すタイムアウトを設定する手順について説明します。

J2EEアプリケーションのメソッドタイムアウト

レスポンスデータ待ちの通信タイムアウト

トランザクションのトランザクションタイムアウト時間のデフォルト

データベースのタイムアウト（HiRDBの場合）

参考

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　J2EEアプリケーションのメソッドタイムアウトの設定

Webコンテナ上でのリクエスト処理待ち時間をJ2EEアプリケーションの実行時間監視機能を利用して設定します。

cosminexus.xmlを編集して，<任意のディレクトリ>下のMETA-INFディレクトリに格納します。

cosminexus.xmlでは，<war>タグ内で次の指定をします。

<servlet>−<method-observation-timeout>タグに，J2EEアプリケーションのメソッドタイムアウトの値を指定します。

<war>タグ内に複数の<servlet>タグがある場合は，それぞれに指定します。

コマンドプロンプトで，jarコマンドを実行し，アーカイブ形式のJ2EEアプリケーションに手順1.で編集したcosminexus.xmlを設定します。

コマンドの実行例を次に示します。

jar uvf <MyApp1.earのファイルパス> -C <META-INFディレクトリを置いたディレクトリ> <META-INFディレクトリ下のcosminexus.xmlのファイルパス>

<MyApp1.earのファイルパス>は，J2EEアプリケーション（MyApp1.ear）を格納したディレクトリのパスとファイル名（MyApp1.ear）を指定します。<META-INFディレクトリを置いたディレクトリ>は，cosminexus.xmlの格納先が次のような構造の場合，<任意のディレクトリ>となります。

<任意のディレクトリ>
    └META-INF
        └cosminexus.xml

<META-INFディレクトリ下のcosminexus.xmlのファイルパス>は，手順1.でcosminexus.xmlを格納したMETA-INFディレクトリのパスとファイル名（cosminexus.xml）を指定します。

(2)　レスポンスデータ待ちの通信タイムアウトの設定

Webサーバに登録したリバースプロキシでのWebコンテナからのデータ受信待ち時間を設定します。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

［運用管理ポータル］画面で［論理サーバの環境設定］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理Webサーバ］−［Webサーバ］−［MyWebServer］をクリックし，［リバースプロキシ］タブをクリックします。

［リバースプロキシの設定］画面で［通信タイムアウト］に値を設定して［適用］ボタンをクリックします。

環境設定情報の保存を示すメッセージが表示されます。

［設定情報の配布］アンカーをクリックします。

［設定情報の配布］画面で［全て配布］ボタンをクリックします。

［ステータス］が「空欄」から「配布中」，「配布済」へと遷移します。

参考

［ステータス］が「配布済」の論理サーバがある場合は，［ステータス］が「空欄」の論理サーバだけを選択して配布できます。この場合，［配布］をチェックしてから，［選択して配布］ボタンをクリックしてください。選択した論理サーバの［ステータス］が「配布済」となります。

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括再起動］タブをクリックします。

［一括再起動］画面で［実行］ボタンをクリックします。

一括再起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「稼働中」から「停止中」，「停止」，「起動中」，「稼働中」へと遷移します。

(3)　トランザクションのトランザクションタイムアウト時間のデフォルトの設定

EJBコンテナとデータベースのトランザクションのタイムアウトを設定します。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

［運用管理ポータル］画面で［論理サーバの環境設定］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］をクリックし，［サービス］−［トランザクション］タブをクリックします。

［トランザクションの設定］画面で［タイムアウト時間］に値を設定して［適用］ボタンをクリックします。

環境設定情報の保存を示すメッセージが表示されます。

［設定情報の配布］アンカーをクリックします。

［設定情報の配布］画面で［全て配布］ボタンをクリックします。

［ステータス］が「空欄」から「配布中」，「配布済」へと遷移します。

参考

［ステータス］が「配布済」の論理サーバがある場合は，［ステータス］が「空欄」の論理サーバだけを選択して配布できます。この場合，［配布］をチェックしてから，［選択して配布］ボタンをクリックしてください。選択した論理サーバの［ステータス］が「配布済」となります。

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括再起動］タブをクリックします。

［一括再起動］画面で［実行］ボタンをクリックします。

一括再起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「稼働中」から「停止中」，「停止」，「起動中」，「稼働中」へと遷移します。

(4)　レスポンスタイムアウトおよびリクエスト間隔タイムアウトの設定（HiRDBの場合）

データベースシステムのサーバ側の障害を検知するためのタイムアウト（レスポンスタイムアウト），およびクライアント側の障害を検知するためのタイムアウト（リクエスト間隔タイムアウト）を設定します。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［開始/停止］タブをクリックします。

［リソースアダプタの開始/停止］画面で［ステータス］が「稼働」の場合は［操作］の［停止］アンカーをクリックします。

［リソースアダプタの停止］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから停止し直してください。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［プロパティ設定］タブをクリックします。

［リソースアダプタのプロパティ設定］画面で［操作］の［基本設定］アンカーをクリックします。

［リソースアダプタの基本設定］画面で［HiRDBクライアント環境変数（environmentVariables）］にPDCWAITTIMEとPDSWAITTIMEの値を設定して，［設定］ボタンをクリックします。

レスポンスタイムアウト（PDCWAITTIME）と，リクエスト間隔タイムアウト（PDSWAITTIME）が設定できます。

［リソースアダプタの基本設定］画面で表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからプロパティを設定し直してください。

［戻る］アンカーをクリックします。

［開始/停止］タブをクリックし，［リソースアダプタの開始/停止］画面で［操作］の［開始］アンカーをクリックします。

［リソースアダプタの開始］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

2.2.10　業務アプリケーションを設定して開始する（GUI利用時）

業務を開始するためには，J2EEアプリケーションをManagement Serverにアップロードしたあと，インポート，開始する必要があります。J2EEアプリケーションのアップロード，インポートおよび開始の手順について説明します。これらの作業には，運用管理ポータルを使用します。なお，説明で使用する業務アプリケーションは，cosminexus.xmlを含めたアーカイブ形式のJ2EEアプリケーション（EAR形式またはZIP形式のアプリケーション）です。

参考

説明で使用する画面については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(2)　論理サーバの一括起動」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　論理サーバの一括起動

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックします。

［論理サーバの稼働状況］画面で論理サーバの稼働状況を確認します。

「停止」の場合は［一括起動］タブをクリックします。「稼働中」の場合は「(3)　業務アプリケーションの設定（GUI利用時）」に進みます。

［一括起動］画面で［実行］ボタンをクリックします。

一括起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「停止」から「起動中」，「稼働中」へと遷移します。

(3)　業務アプリケーションの設定（GUI利用時）

アプリケーションサーバの<任意のディレクトリ>に，入手したJ2EEアプリケーション（MyApp1.ear）を格納します。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］をクリックします。

［J2EEアプリケーションのアップロード］画面で［J2EEアプリケーションファイル］に手順1.で<任意のディレクトリ>に格納したJ2EEアプリケーション（MyApp1.ear）を入力して，［アップロード］ボタンをクリックします。

表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからアップロードし直してください。

［アップロードディレクトリファイル一覧］に手順4.でアップロードしたJ2EEアプリケーションのファイル名（MyApp1.ear）が表示されます。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［インポート］タブをクリックします。

［J2EEアプリケーションのインポート］画面で［J2EEアプリケーションファイル］から手順4.でアップロードしたファイル（MyApp1.ear）を選択し，［実行］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてからインポートし直してください。

(4)　業務アプリケーションの開始（GUI利用時）

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［開始/停止］タブをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，「(3)　業務アプリケーションの設定（GUI利用時）」でインポートしたJ2EEアプリケーションの表示名（MyApp）の［操作］の［開始］アンカーをクリックします。

［J2EEアプリケーションの開始］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「稼働」になります。

2.3　可用性を確保したシステムへの変更

ここでは，単一のWebフロントシステムから可用性を確保したシステム環境へ変更する手順について説明します。

2.3.1　同一構成のホストを複数配置して可用性を確保する

ここでは，単一のWebフロントシステムで可用性を確保するために，同一構成のホストを複数配置して負荷分散機で負荷分散するシステム環境に変更する手順について説明します。システム構成については，「1.2.2　同一構成のホストを複数配置して可用性を確保するには」を参照してください。

同一構成のホストは，セットアップウィザードを使用して，ホストを複製して作成します。可用性を確保するために負荷分散機を利用します。同一構成のホストの複数配置時の注意事項については，「2.3.2　同一構成のホストを複数配置するときの注意事項」を参照してください。

参考

説明で使用するコマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　複製情報の出力

複製元のホストで，システムを複製するための情報（簡易構築定義ファイル）を出力します。

複製元のホストのコマンドプロンプトで，setupwizardコマンドに-exportオプションを指定して実行し，簡易構築定義ファイルを<任意のディレクトリ>にエクスポートします。

コマンドの実行例を次に示します。

setupwizard -export -omd <簡易構築定義ファイルのエクスポート先のファイルパス>

<簡易構築定義ファイルのエクスポート先のファイルパス>には，簡易構築定義ファイルを格納するディレクトリのパスとファイル名を指定します。簡易構築定義ファイルはXML形式のファイルです。

(2)　複製情報を使ったセットアップ

システムを複製するための情報（簡易構築定義ファイル）と，セットアップ情報ファイルを使用して，セットアップを実行します。

複製先として新たなホストを用意し，次の製品をインストールします。

Application Server

HiRDB Run TimeまたはOracle JDBC Thin Driver

複製先のホストの<任意のディレクトリ>に，次のファイルをコピーします。

「(1)　複製情報の出力」で出力した簡易構築定義ファイル

複製元のホストのセットアップ情報ファイル（setupwizard_success.dat）

セットアップ情報ファイルの格納先を次に示します。

OS種別

格納先

Windows

<Application Serverのインストールディレクトリ>¥manager¥setup¥config¥

UNIX

/opt/Cosminexus/manager/setup/config/

複製先のホストのコマンドプロンプトで，setupwizardコマンドに手順2.でコピーした簡易構築定義ファイルとセットアップ情報ファイルを指定して実行し，システム環境を複製します。

コマンドの実行例を次に示します。

setupwizard -f <セットアップ情報ファイルのファイルパス> -md <簡易構築定義ファイルのファイルパス>

<セットアップ情報ファイルのファイルパス>，および<簡易構築定義ファイルのファイルパス>には，手順2.でコピーした格納先を指定してください。

［セットアップ情報］画面で「1」を入力して，Enterキーを押します。

複製先のJ2EEサーバに業務アプリケーションを設定して開始します。

2.3.2　同一構成のホストを複数配置するときの注意事項

同一構成のホストを複数配置するときの注意事項を次に示します。

複製元のホストで，複製できないチューニングが実施されている場合，複製元または複製先のホストで次の動作が発生して，複製できないときがあります。

複製元のホストで，簡易構築定義ファイルのエクスポートでエラーが発生します。

複製先のホストが，複製できないチューニング情報を無視して複製されます。この場合，複製先のホストには，複製元のホストのセットアップ時の設定が適用されます。

複製できないチューニング項目とホストの動作を次の表に示します。

表2‒6　複製できないチューニング項目とホストの動作

項番

チューニング項目

ホストの動作

1

Management Serverの設定

Management Serverの設定情報のうち，次の項目に変更があると，エクスポートでエラーが発生します。この場合は，複製できません。

管理ユーザアカウントの設定の「管理ユーザID」および「パスワード」

ネットワークの設定の「Management Server接続HTTPポート番号」

ホストの定義の「運用管理エージェントのポート番号」

なお，上記以外のManagement Serverの設定情報を変更しても，エクスポートではエラーになりません。ただし，複製先のホストには，複製元のホストのセットアップ時の設定が適用されます。

2

Component Container管理者の設定

Component Container管理者の設定を変更しても，エクスポートではエラーになりません。ただし，複製先のシステムには，複製元のホストのセットアップ時の設定が適用されます。

3

Webシステムの設定

Webシステムの設定情報のうち，次の項目以外に変更があると，エクスポートでエラーが発生します。この場合は，複製できません。

Smart Composer機能の簡易構築定義ファイルを使用した，論理サーバのパラメタの設定

運用管理ポータルを使用した，「論理サーバの環境設定」および「論理サーバの起動／停止」の設定

4

データベースの接続設定

データベースの接続設定のうち，JDBCドライバの設定については，複製できます。JDBCドライバ以外の設定項目を変更しても，エクスポートではエラーになりません。ただし，複製先のホストには，複製元のホストのセットアップ時の設定が適用されます。

複製先のホストのプラットフォームは，複製元のホストと同じにしてください。複製先が，複製元と異なるプラットフォームの場合，複製できないときがあります。

複製先のホストでは，setupwizardコマンドを使用してエクスポートした簡易構築定義ファイルを使用してください。setupwizardコマンド以外の方法でエクスポートした簡易構築定義ファイルを使用した場合，複製できないときがあります。

2.4　マルチテナントに対応したシステムへの変更

ここでは，単一のWebフロントシステムからマルチテナントに対応したシステムへ変更する手順について説明します。単一のWebフロントシステムをマルチテナントに対応させる方法には次のものがあります。

J2EEサーバを複数配置する方法

ホストのリソースを有効活用して，かつテナントごとに業務処理（アプリケーション）を分離できます。

リソースアダプタを複数配置する方法

データベースを共有（データベース数の増加を抑止）して，かつテナントごとにデータを分離できます。

2.4.1　J2EEサーバを複数配置してマルチテナントに対応する

ここでは，単一のWebフロントシステムからホストのリソースを有効活用してマルチテナントへ対応するシステムに変更する手順について説明します。システム構成については，「1.2.3　J2EEサーバを複数配置してマルチテナント対応するには」を参照してください。

参考

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

J2EEサーバを複数配置するホストは，Smart Composer機能を使用してWebシステムを複製したあとに論理サーバ（Webサーバ，J2EEサーバおよびパフォーマンストレーサ）を追加して作成します。ここでは，追加するJ2EEサーバ上で動作する業務アプリケーションには，同一のアプリケーションを使用するとします。例題で使用する設定内容を次の表に示します。

表2‒7　例題で使用する設定内容（J2EEサーバを複数配置してマルチテナントに対応するWebフロントシステム）

項目

設定例

Webシステムの名称

MyWebSystem

追加するサービスユニットの名称

unit2

追加する論理Webサーバの名称

MyWebServer2

追加する論理J2EEサーバの名称

MyJ2EEServer2

追加する論理パフォーマンストレーサの名称

MyPerformanceTracer2

構成変更定義ファイルのファイル名称

MyWebSystemAddUnit.xml

(1)　Webシステムの複製

コマンドプロンプトでcmx_export_modelコマンドを実行し，簡易構築定義ファイルを<任意のディレクトリ>にエクスポートします。

コマンドの実行例を次に示します。

cmx_export_model -m localhost:28080 -u admin -o <簡易構築定義ファイルのエクスポート先のファイルパス>

<簡易構築定義ファイルのエクスポート先のファイルパス>には，簡易構築定義ファイルを格納するディレクトリのパスとファイル名を指定します。簡易構築定義ファイルはXML形式のファイルです。

コマンドプロンプトでcmx_delete_systemコマンドを実行し，システムを削除します。

システムを複製するための準備として，ホスト上に構築済みのシステムを削除します。

コマンドの実行例を次に示します。

cmx_delete_system -m localhost:28080 -u admin -s MyWebSystem

コマンドプロンプトでcmx_build_systemコマンドを実行し，手順1.でエクスポートした簡易構築定義ファイルからWebシステムを複製します。

コマンドの実行例を次に示します。

cmx_build_system -m localhost:28080 -u admin -f <簡易構築定義ファイルのファイルパス>

<簡易構築定義ファイルのファイルパス>には，手順1.の簡易構築定義ファイルを格納されているディレクトリのパスとファイル名を指定します。

(2)　論理サーバ（Webサーバ，J2EEサーバおよびパフォーマンストレーサ）の追加

構成変更定義ファイルのテンプレートファイル（cmxaddcombinedmodel.xml）を任意の場所にコピーして，任意の名称を変更します。

サービスユニットやホストを追加する構成変更定義ファイルのテンプレートファイルは，次の場所に提供されています。ここではファイル名を「MyWebSystemAddUnit.xml」に変更します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥templates¥cmxaddcombinedmodel.xml

UNIXの場合

/opt/Cosminexus/manager/config/templates/cmxaddcombinedmodel.xml

テキストエディタなどで，手順1.でコピーした構成変更定義ファイルを編集します。

構成変更定義ファイルには，追加するサービスユニットの定義および論理サーバの定義を指定します。また，追加する論理サーバ名，および次の表に示す論理サーバのコンフィグレーション定義の指定値が重複しないようにしてください。論理サーバごとに重複しないように設定するコンフィグレーション定義を次の表に示します。

表2‒8　論理サーバごとに重複しないように設定するコンフィグレーション定義

論理サーバの種類

項目

param-nameの指定値

パフォーマンストレーサ

PRF識別子

PRFID

J2EEサーバ

JTAリカバリの固定ポート番号

ejbserver.distributedtx.recovery.port

管理用サーバのポート番号

ejbserver.http.port

インプロセスのネーミングサービス用のポート番号

ejbserver.naming.port

RMIレジストリのポート番号

ejbserver.rmi.naming.port

NIO HTTPサーバのポート番号

webserver.connector.nio_http.port

稼働情報取得時のリクエスト受付ポート番号

ejbserver.rmi.remote.listener.port

Webサーバ

httpポート番号

Listen

構成変更定義ファイルの編集例を次に示します。背景色付きの太字の部分が編集する個所です。

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
  <web-system>
    <name>MyWebSystem</name>

    <!--Specify the settings for the Service Unit to add.-->
    <unit>
      <name>unit2</name>
      <allocated-host>
        <host-ref>@myhost</host-ref>
        <hosts-for>combined-tier</hosts-for>
        <define-server>
          <logical-server-name>MyPerformanceTracer2</logical-server-name>
          <logical-server-type>performance-tracer</logical-server-type>
      <configuration>
        <param>
          <param-name>PRFID</param-name>
          <param-value>PRF_ID2</param-value>
        </param>
      </configuration>
        </define-server>
        <define-server>
          <logical-server-name>MyJ2EEServer2</logical-server-name>
          <logical-server-type>j2ee-server</logical-server-type>
          <configuration>
            <param>
              <param-name>ejbserver.distributedtx.recovery.port</param-name>
              <param-value>20303</param-value>
            </param>
            <param>
              <param-name>ejbserver.http.port</param-name>
              <param-value>8081</param-value>
            </param>
            <param>
              <param-name>ejbserver.naming.port</param-name>
              <param-value>901</param-value>
            </param>
            <param>
              <param-name>ejbserver.rmi.naming.port</param-name>
              <param-value>23153</param-value>
            </param>
            <param>
              <param-name>webserver.connector.nio_http.port</param-name>
              <param-value>8008</param-value>
            </param>
            <param>
              <param-name>ejbserver.rmi.remote.listener.port</param-name>
              <param-value>23550</param-value>
            </param>
          </configuration>
        </define-server>
        <define-server>
          <logical-server-name>MyWebServer2</logical-server-name>
          <logical-server-type>web-server</logical-server-type>
         <configuration>
            <param>
              <param-name>Listen</param-name>
              <param-value>81</param-value>
            </param>
          </configuration>
        </define-server>
      </allocated-host>
    </unit>
  </web-system>
</unit-addition>

注　ホストの定義（<host>タグ）は削除してください。

コマンドプロンプトでcmx_change_modelコマンドとcmx_build_systemコマンドを実行し，手順2.で編集した構成変更定義ファイルから論理サーバ（Webサーバ，J2EEサーバおよびパフォーマンストレーサ）を追加します。

コマンドの実行例を次に示します。

cmx_change_model -m localhost:28080 -u admin -f <構成変更定義ファイルのファイルパス>
cmx_build_system -m localhost:28080 -u admin -s MyWebSystem

<構成変更定義ファイルのファイルパス>には，手順1.の構成変更定義ファイル（MyWebSystemAddUnit.xml）が格納されているディレクトリのパスとファイル名を指定します。

(3)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(4)　追加した論理サーバの一括起動」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(4)　追加した論理サーバの一括起動

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括起動］タブをクリックします。

［一括起動］画面で［実行］ボタンをクリックします。

一括起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「稼働中」となります。

(5)　追加したJ2EEサーバ（MyJ2EEServer2）へのリソースアダプタの設定と開始

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer2］−［リソース］−［リソースアダプタ］をクリックし，［インポート］タブをクリックします。

［リソースアダプタのインポート］画面でMyJ2EEServer2にインポートするリソースアダプタの情報を設定して，［実行］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてからインポートし直してください。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［プロパティ設定］タブをクリックします。

［リソースアダプタのプロパティ設定］画面で手順3.でインポートしたリソースアダプタの［操作］の［基本設定］アンカーをクリックします。

［リソースアダプタの基本設定］画面で基本情報やプロパティを設定し，［設定］ボタンをクリックします。

［リソースアダプタの基本設定］画面で表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからプロパティを設定し直してください。

［リソースアダプタの開始/停止］画面で［操作］の［開始］アンカーをクリックします。

［リソースアダプタの開始］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

(6)　追加したJ2EEサーバへ（MyJ2EEServer2）の業務アプリケーションの設定と開始

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer2］−［アプリケーション］をクリックし，［インポート］タブをクリックします。

［J2EEアプリケーションのインポート］画面で［J2EEアプリケーションファイル］から同一のJ2EEアプリケーション（MyApp）を選択し，［実行］ボタンをクリックします。

参考

ここでは，追加したJ2EEサーバ上でも同じ業務アプリケーションを動作させるため，アップロード済みのJ2EEアプリケーションをインポートします。異なる業務アプリケーションを動作させる場合は，J2EEアプリケーションをアップロードしてからインポートしてください。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてからインポートし直してください。

［開始/停止］タグをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，手順3.でインポートしたアプリケーションの［操作］の［開始］アンカーをクリックします。

［J2EEアプリケーションの開始］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「稼働」になります。

2.4.2　リソースアダプタを複数配置してマルチテナントに対応する

ここでは，単一のWebフロントシステムからデータベースを共有してマルチテナントに対応するシステムへ変更する手順について説明します。システム構成については，「1.2.4　リソースアダプタを複数配置してマルチテナント対応するには」を参照してください。

参考

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

リソースアダプタを複数配置するホストは，運用管理ポータルを使用してリソースアダプタを追加して作成します。また，リソースアダプタを利用する業務アプリケーションと関連づけます。例題で使用する設定内容を次の表に示します。

表2‒9　例題で使用する設定内容（リソースアダプタを複数配置してマルチテナントに対応するWebフロントシステム）

項目

設定例

追加するリソースアダプタの名称

DB_Connector_for_HiRDB_Type4_2

インポートするRARファイル

DBConnector_HiRDB_Type4_CP.rar

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(2)　リソースアダプタの追加」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　リソースアダプタの追加

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［インポート］タブをクリックします。

［リソースアダプタのインポート］画面でMyJ2EEServerにインポートするリソースアダプタの情報を設定して，［実行］ボタンをクリックします。

インポートするリソースアダプタの情報として，DB Connectorを選択して，プルダウンメニューからインポートするRARファイル（DBConnector_HiRDB_Type4_CP.rar）を選択し，リソースアダプタ名称を選択して，追加するリソースアダプタの名称（DB_Connector_for_HiRDB_Type4_2）を指定します。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてからインポートし直してください。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［プロパティ設定］タブをクリックします。

［リソースアダプタのプロパティ設定］画面で手順3.でインポートしたリソースアダプタの［操作］の［基本設定］アンカーをクリックします。

［リソースアダプタの基本設定］画面で基本情報やプロパティを設定し，［設定］ボタンをクリックします。

［リソースアダプタの基本設定］画面で表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからプロパティを設定し直してください。

(3)　リソースアダプタの開始

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［開始/停止］タブをクリックします。

［リソースアダプタの開始/停止］画面で［操作］の［開始］アンカーをクリックします。

［リソースアダプタの開始］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

(4)　業務アプリケーションとの関連づけの設定

(a)　java:comp/envでのルックアップ利用時

J2EEアプリケーションでlookupメソッドの引数に「java:comp/env/<<res-ref-name>タグ指定値>」と指定して実装している場合は，運用管理ポータルを使用して，属性を編集したJ2EEアプリケーションを入れ替えてから開始します。

cosminexus.xmlを編集して，<任意のディレクトリ>下のMETA-INFディレクトリに格納します。

アプリケーション開発者にリソース参照の名前解決をするための情報を確認して，cosminexus.xmlで<ejb-jar>タグ，<war>タグ，<entity>タグまたは<message>タグ内に次の指定をします。

EJB-JARの属性（<ejb-jar>タグ内）に指定する場合

<session>−<resource-ref>タグに，リソースの参照（<res-ref-name>タグ）を指定します。

<session>−<resource-ref>−<linked-to>タグに，関連づけるDB Connectorの表示名を指定します。

WARの属性（<war>タグ内）に指定する場合

<resource-ref>タグに，リソースの参照（<res-ref-name>タグ）を指定します。

<resource-ref>−<linked-to>タグに，関連づけるDB Connectorの表示名を指定します。

Entity Bean属性の属性（<entity>タグ内）に指定する場合

<resource-ref>タグに，リソースの参照（<res-ref-name>タグ）を指定します。

<resource-ref>−<linked-to>タグに，関連づけるDB Connectorの表示名を指定します。

Message-driven Bean属性の属性（<message>タグ内）に指定する場合

<resource-ref>タグに，リソースの参照（<res-ref-name>タグ）を指定します。

<resource-ref>−<linked-to>タグに，関連づけるDB Connectorの表示名を指定します。

コマンドプロンプトで，jarコマンドを実行し，アーカイブ形式のJ2EEアプリケーションに手順1.で編集したcosminexus.xmlを設定します。

コマンドの実行例を次に示します。

jar uvf <MyApp1.earのファイルパス> -C <META-INFディレクトリを置いたディレクトリ> <META-INFディレクトリ下のcosminexus.xmlのファイルパス>

<MyApp1.earのファイルパス>は，J2EEアプリケーション（MyApp1.ear）を格納したディレクトリのパスとファイル名（MyApp1.ear）を指定します。<META-INFディレクトリを置いたディレクトリ>は，cosminexus.xmlの格納先が次のような構造の場合，<任意のディレクトリ>となります。

<任意のディレクトリ>
    └META-INF
        └cosminexus.xml

<META-INFディレクトリ下のcosminexus.xmlのファイルパス>は，手順1.でcosminexus.xmlを格納したMETA-INFディレクトリのパスとファイル名（cosminexus.xml）を指定します。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［J2EEアプリケーションの開始/停止］タブをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，アプリケーションの表示名（MyApp）の［操作］の［停止］アンカーをクリックします。

［J2EEアプリケーションの停止］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから停止し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「停止」になります。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［削除］タブをクリックします。

［J2EEアプリケーションの削除］画面で［インポートJ2EEアプリケーション一覧］にある，アプリケーションの表示名（MyApp）の［操作］の［削除］アンカーをクリックします。

［J2EEアプリケーションの削除］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから削除し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの削除］画面の［インポートJ2EEアプリケーション一覧］からアプリケーションが削除されます。

［DefaultDomain］をクリックします。

［J2EEアプリケーションのアップロード］画面で［J2EEアプリケーションファイル］に手順2.で再作成したJ2EEアプリケーション（MyApp1.ear）を入力して，［アップロード］ボタンをクリックします。

表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからアップロードし直してください。

［アップロードディレクトリファイル一覧］に手順13.でアップロードしたJ2EEアプリケーションが表示されます。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［インポート］タブをクリックします。

［J2EEアプリケーションのインポート］画面で［J2EEアプリケーションファイル］から手順13.でアップロードしたファイルを選択し，［実行］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてからインポートし直してください。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［開始/停止］タブをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，手順16.でインポートしたアプリケーションの［操作］の［開始］アンカーをクリックします。

［J2EEアプリケーションの開始］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「稼働」になります。

(b)　ユーザ指定名前空間機能を利用して付与した名称でのルックアップ利用時

J2EEアプリケーションでlookupメソッドの引数に任意の名称を指定して実装している場合は，運用管理ポータルを使用して，リソースアダプタのConnector属性ファイルでリソースの別名を設定します。ここでは，任意の名称として「jdbc/DataSource」を指定している場合の例について説明します。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［プロパティ設定］タブをクリックします。

［リソースアダプタのプロパティ設定］画面で「(2)　リソースアダプタの追加」でインポートしたリソースアダプタの［操作］の［Connector属性ファイル編集］アンカーをクリックします。

［リソースアダプタのConnector属性ファイル編集］画面で<resource-external-property>−<optional-name>タグにリソースの別名を設定し，［設定］ボタンをクリックします。

設定例を次に示します。ここでは，リソースの別名を「jdbc/DataSource」とします。

<connector-runtime>
  <property>
  ：
  </property>
  <resource-external-property>
    <optional-name>jdbc/DataSource</optional-name>
  </resource-external-property>
</connector-runtime>

［リソースアダプタの基本設定］画面で表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからプロパティを設定し直してください。

3　システムの運用

この章では，「2.　システムの構築」で構築したWebフロントシステムを使用した起動や停止などの通常運用のほかに，アプリケーションの入れ替え，パフォーマンスチューニングなどの保守運用の手順について説明します。

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

3.1　アプリケーションサーバの通常運用

ここでは，次に示すアプリケーションサーバで実施する通常運用について説明します。

システムの起動（業務の開始）

システムの稼働状況の確認

システムの停止（業務の終了）

3.1.1　システムを起動して業務を開始する（GUI利用時）

停止中のシステムを起動して，業務（アプリケーション）を開始する手順について説明します。システムの起動とアプリケーションの開始には，運用管理ポータルを使用します。なお，運用管理機能（Management Serverおよび運用管理エージェント）はホストの起動と同時に起動されます。ここでは，ホストは起動済みであるとします。

参考

説明で使用する画面については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は，「(2)　論理サーバの起動」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　論理サーバの起動

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括起動］タブをクリックします。

［一括起動］画面で［実行］ボタンをクリックします。

一括起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「停止」から「起動中」，「稼働中」へと遷移します。

注意事項

論理J2EEサーバを停止する前に，リソースアダプタや業務アプリケーションを停止している場合は，論理サーバを起動したあとにリソースアダプタと業務アプリケーションを開始してください。

3.1.2　システムの稼働状況を確認する（GUI利用時）

システムの運用を開始したあと，J2EEサーバなどの論理サーバが問題なく動作しているかを稼働状況で確認します。システムの稼働状況の確認には，運用管理ポータルを使用します。運用管理ポータルでは，運用管理ドメイン単位，ホスト単位および論理サーバ単位に稼働状況を確認できます。論理サーバ単位の場合は，論理サーバの種類の単位でも稼働状況を確認できます。

参考

説明で使用する画面については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は，「(2)　運用管理ドメイン内の論理サーバの稼働状況の確認」，「(3)　ホスト内の論理サーバの稼働状況の確認」または「(4)　論理サーバごとの稼働状況の確認」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　運用管理ドメイン内の論理サーバの稼働状況の確認

［運用管理ポータル］画面で［論理サーバの運用監視］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックします。

［論理サーバのステータス監視］画面に，運用管理ドメイン内のすべての論理サーバの稼働状況が表示されます。

［論理サーバのステータス監視］画面で［<論理サーバ名>］アンカーをクリックします。

［<サーバの種類>の稼働情報監視］画面に，選択した論理サーバの種類の稼働状況が表示されます。例えば，<論理サーバの種類>に［論理J2EEサーバ］，<サーバの種類>に［J2EEサーバ］を選択すると，［J2EEサーバのステータス監視］画面が表示されます。

(3)　ホスト内の論理サーバの稼働状況の確認

［運用管理ポータル］画面で［論理サーバの運用監視］をクリックします。

［ホストビュー］タブで［ホスト］−［<ホスト名>］をクリックします。

［論理サーバのステータス監視］画面に，ホスト内のすべての論理サーバの稼働状況が表示されます。

(4)　論理サーバごとの稼働状況の確認

［運用管理ポータル］画面で［論理サーバの運用監視］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［<論理サーバの種類>］−［<サーバの種類>］をクリックします。

［<サーバの種類>のステータス監視］画面に，選択した論理サーバの種類の稼働状況が表示されます。例えば，<論理サーバの種類>に［論理J2EEサーバ］，<サーバの種類>に［J2EEサーバ］を選択すると，［J2EEサーバのステータス監視］画面が表示されます。

［<サーバの種類>のステータス監視］画面で［<論理サーバ名>］アンカーをクリックします。

［<サーバの種類>の稼働情報監視］画面に，選択した論理サーバの稼働状況が表示されます。例えば，<論理サーバの種類>に［論理J2EEサーバ］，<サーバの種類>に［J2EEサーバ］，［<論理サーバ名>］に［MyJ2EEServer］を選択すると，［J2EEサーバの稼働情報監視］画面が表示されます。

参考

［<サーバの種類>の稼働情報監視］画面は，［サーバビュー］タブで［DefaultDomain］−［<論理サーバの種類>］−［<サーバの種類>］−［<論理サーバ名>］をクリックしても表示できます。

3.1.3　システムを停止する（GUI利用時）

稼働中の論理サーバおよび運用管理機能を停止して，アプリケーションサーバを停止する手順について説明します。システムの停止には，運用管理ポータルを使用します。なお，リソースアダプタやアプリケーションでは停止操作をしません。論理サーバの停止と同時に停止しておくと，論理サーバの起動と同時に開始できます。

参考

説明で使用する画面，コマンドの参照先，コマンドの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は，「(2)　論理サーバの停止」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　論理サーバの停止

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括停止］タブをクリックします。

［一括停止］画面で［実行］ボタンをクリックします。

一括停止要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「稼働中」から「停止中」，「停止」へと遷移します。

(3)　運用管理機能の停止

運用管理ポータルにログインしている場合は，［ログアウト］アンカーをクリックし，表示されたメッセージを確認して［ログイン画面］をクリックして，Webブラウザを閉じます。

コマンドプロンプトでmngsvrctlコマンドのサブコマンド「stop」を実行し，Management Serverを停止します。

コマンドの実行例を次に示します。

mngsvrctl stop -sync

コマンドプロンプトでadminagentctlコマンドのサブコマンド「stop」を実行し，運用管理エージェントを停止します。

コマンドの実行例を次に示します。

adminagentctl stop -sync

3.2　アプリケーションサーバの保守運用

ここでは，運用を開始したあとに，アプリケーションサーバで実施する次の保守運用について説明します。

業務アプリケーションの入れ替え

パフォーマンスチューニング

IPアドレスの変更

データベース接続環境の変更

システムの構成・定義情報の取得

不要なJ2EEサーバの削除

運用管理機能の管理ユーザアカウントの設定変更

3.2.1　業務アプリケーションを入れ替える

システムの運用を開始したあとで，業務アプリケーションのバージョンアップやメンテナンスを実施するために，「2.2.10　業務アプリケーションを設定して開始する（GUI利用時）」で設定したアーカイブ形式のJ2EEアプリケーションを入れ替える手順について説明します。

参考

説明で使用する画面については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

通常，J2EEアプリケーションを入れ替える場合には，J2EEサーバ上で動作しているJ2EEアプリケーションを停止したあと削除し，新しいJ2EEアプリケーションをインポートして開始する必要があります。これらの作業には，運用管理ポータルを使用します。なお，説明で使用する業務アプリケーションは，cosminexus.xmlを含めたアーカイブ形式のJ2EEアプリケーションです。例題で使用する設定内容を次の表に示します。

表3‒1　例題で使用する設定内容（業務アプリケーションの入れ替え）

項目

設定例

入れ替え前のJ2EEアプリケーションのファイル名

MyApp1.ear

入れ替え後のJ2EEアプリケーションのファイル名

MyApp2.ear

J2EEアプリケーションの表示名

MyApp

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(2)　入れ替え前のJ2EEアプリケーションの停止」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　入れ替え前のJ2EEアプリケーションの停止

J2EEアプリケーションが停止済みの場合は「(3)　入れ替え前のJ2EEアプリケーションの削除」に進みます。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［J2EEアプリケーションの開始/停止］タブをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，入れ替え前のアプリケーションの表示名（MyApp）の［操作］の［停止］アンカーをクリックします。

［J2EEアプリケーションの停止］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから停止し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「停止」になります。

(3)　入れ替え前のJ2EEアプリケーションの削除

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［削除］タブをクリックします。

［J2EEアプリケーションの削除］画面で［インポートJ2EEアプリケーション一覧］にある，入れ替え前のアプリケーションの表示名（MyApp）の［操作］の［削除］アンカーをクリックします。

［J2EEアプリケーションの削除］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから削除し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの削除］画面の［インポートJ2EEアプリケーション一覧］からアプリケーションが削除されます。

(4)　入れ替え後のJ2EEアプリケーションの設定

アプリケーションサーバの<任意のディレクトリ>に，入手した入れ替え後のJ2EEアプリケーション（MyApp2.ear）を格納します。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］をクリックします。

［J2EEアプリケーションのアップロード］画面で［J2EEアプリケーションファイル］に手順1.で<任意のディレクトリ>に格納したJ2EEアプリケーション（MyApp2.ear）を入力して，［アップロード］ボタンをクリックします。

表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからアップロードし直してください。

［アップロードディレクトリファイル一覧］に手順4.でアップロードしたJ2EEアプリケーションのファイル名（MyApp2.ear）が表示されます。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［インポート］タブをクリックします。

［J2EEアプリケーションのインポート］画面で［J2EEアプリケーションファイル］から手順4.でアップロードしたファイル（MyApp2.ear）を選択し，［実行］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてからインポートし直してください。

(5)　入れ替え後のJ2EEアプリケーションの開始

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［開始/停止］タグをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，「(4)　入れ替え後のJ2EEアプリケーションの設定」でインポートしたJ2EEアプリケーションの表示名（MyApp）の［操作］の［開始］アンカーをクリックします。

［J2EEアプリケーションの開始］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「稼働」になります。

(6)　運用管理ポータルからのログアウト

［ログアウト］アンカーをクリックします。

表示されたメッセージを確認して［ログイン画面］をクリックし，Webブラウザを閉じます。

3.2.2　パフォーマンスチューニングとは

パフォーマンスチューニングとは，システムの処理性能や信頼性を高めるために，システムの動作環境を最適化することです。パフォーマンスチューニングを実施することで，システムの性能を最大限に生かし，安定稼働させられるようになります。

ここでは，パフォーマンスチューニングの代表的な次の項目について，パラメタの設定値が妥当であるかを検証し，適切なチューニングを実施して最適化する作業について説明します。

JavaVMのメモリチューニング（JavaヒープおよびExplicitヒープのチューニング）

GCの発生間隔やGCに掛かる時間は，Javaヒープのメモリサイズによって変動するため，この値を適切に見積もることでシステムの処理性能が向上します。また，適切なExplicitヒープのメモリサイズを確保することで，FullGCの発生を防ぐことができます。JavaVMのメモリチューニングの考え方については，マニュアル「アプリケーションサーバシステム設計ガイド」の「7.　JavaVMのメモリチューニング」を参照してください。

同時実行数の最適化

クライアントからのリクエスト数が増加して，システムの処理能力を超えると，安定したサービスを提供できなくなります。クライアントからのアクセス要求や処理要求などのリクエストに対して，処理の同時実行数を制御することで，リクエスト増加時のパフォーマンス低下を防いでシステムを安定稼働させることができます。同時実行数の最適化の考え方については，マニュアル「アプリケーションサーバシステム設計ガイド」の「8.3　同時実行数を最適化する」を参照してください。

3.2.3　JavaVMのメモリチューニングを反映する

次に示す代表的な項目について，JavaVMのメモリサイズを設定する手順について説明します。

Javaヒープ全体のメモリサイズ

Explicitヒープのメモリサイズ

Metaspace領域のメモリサイズ

参考

説明で使用する画面については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(2)　Javaヒープ全体のメモリサイズの設定」，「(3)　Explicitヒープのメモリサイズの設定」または「(4)　Metaspace領域のメモリサイズの設定」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　Javaヒープ全体のメモリサイズの設定

［運用管理ポータル］画面で［論理サーバの環境設定］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］をクリックし，［JVM］−［起動パラメタ］タブをクリックします。

［起動パラメタの設定］画面で［メモリ使用量］に初期サイズと最大サイズを指定します。

［適用］ボタンをクリックします。

環境設定情報の保存を示すメッセージが表示され，Javaヒープ全体のメモリサイズが設定されます。

［設定情報の配布］アンカーをクリックします。

参考

ほかの項目を続けて設定する場合は，［戻る］アンカーをクリックすると，［起動パラメタの設定］画面へ戻れます。

［設定情報の配布］画面で［ステータス］が「空欄」の論理サーバの［配布］をチェックしてから，［選択して配布］ボタンをクリックします。

［ステータス］が「空欄」から「配布中」，「配布済」へと遷移します。

参考

［全て配布］ボタンをクリックすると，［ステータス］が「配布済」の論理サーバにも設定情報が再配布されます。

(3)　Explicitヒープのメモリサイズの設定

［運用管理ポータル］画面で［論理サーバの環境設定］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］をクリックし，［JVM］−［起動パラメタ］タブをクリックします。

［起動パラメタの設定］画面で［明示管理ヒープ機能］のExplicitヒープ領域の最大サイズを指定します。

［適用］ボタンをクリックします。

環境設定情報の保存を示すメッセージが表示され，Explicitヒープのメモリサイズが設定されます。

［設定情報の配布］アンカーをクリックします。

参考

ほかの項目を続けて設定する場合は，［戻る］アンカーをクリックすると，［起動パラメタの設定］画面へ戻れます。

［設定情報の配布］画面で［ステータス］が「空欄」の論理サーバの［配布］をチェックしてから，［選択して配布］ボタンをクリックします。

［ステータス］が「空欄」から「配布中」，「配布済」へと遷移します。

参考

［全て配布］ボタンをクリックすると，［ステータス］が「配布済」の論理サーバにも設定情報が再配布されます。

(4)　Metaspace領域のメモリサイズの設定

［運用管理ポータル］画面で［論理サーバの環境設定］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］をクリックし，［JVM］−［起動パラメタ］タブをクリックします。

［起動パラメタの設定］画面で［拡張起動パラメタ］に次の拡張起動パラメタを設定して［有効］をチェックします。

-XX:MetaspaceSize=<値>

-XX:MaxMetaspaceSize=<値>

［適用］ボタンをクリックします。

環境設定情報の保存を示すメッセージが表示され，Metaspace領域のメモリサイズが設定されます。

［設定情報の配布］アンカーをクリックします。

参考

ほかの項目を続けて設定する場合は，［戻る］アンカーをクリックすると，［起動パラメタの設定］画面へ戻れます。

［設定情報の配布］画面で［ステータス］が「空欄」の論理サーバの［配布］をチェックしてから，［選択して配布］ボタンをクリックします。

［ステータス］が「空欄」から「配布中」，「配布済」へと遷移します。

参考

［全て配布］ボタンをクリックすると，［ステータス］が「配布済」の論理サーバにも設定情報が再配布されます。

(5)　論理サーバの再起動

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括再起動］タブをクリックします。

［一括再起動］画面で［実行］ボタンをクリックします。

一括再起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「稼働中」から「停止中」，「停止」，「起動中」，「稼働中」へと遷移します。

(6)　運用管理ポータルからのログアウト

［ログアウト］アンカーをクリックします。

表示されたメッセージを確認して［ログイン画面］をクリックし，Webブラウザを閉じます。

3.2.4　同時実行数を最適化するためのチューニングを反映する

次に示す代表的な項目について，同時実行数を設定する手順について説明します。

Webコンテナ単位，Webアプリケーション単位の同時実行数

同時に接続できるクライアントの最大数

Webサーバ起動時のサーバプロセス数

Webコンテナがリクエストを処理する同時実行数

デフォルトの実行待ちキューサイズ

Webコンテナ単位での最大同時実行スレッド数

デフォルトの実行待ちキューサイズ

Stateless Session Beanの同時実行数（プールで管理するインスタンスの最小値）

プールの最小値

プールの最大値

URLグループ単位の同時実行数

Webアプリケーション単位での最大同時実行スレッド数

Webアプリケーションの占有スレッド数

Webアプリケーション単位の実行待ちキューサイズ

Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視に関するプロパティ

URLグループ単位の同時実行スレッド数制御の定義名

URLグループ単位での最大同時実行スレッド数

URLグループ単位の占有スレッド数

URLグループ単位の実行待ちキューサイズ

URLグループ単位の制御対象となるURLパターン

URLグループ単位の実行待ちリクエスト数の監視に関するプロパティ

参考

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　WebコンテナまたはWebアプリケーション単位の同時実行数の設定

WebコンテナまたはWebアプリケーション単位の同時実行数を設定しない場合は「(2)　URLグループ単位の同時実行数の設定」に進みます。

cosminexus.xmlを編集して，<任意のディレクトリ>下のMETA-INFディレクトリに格納します。

cosminexus.xmlでは，<ejb-jar>タグ内で次の指定をします。

<session>−<stateless>−<pooled-instance>−<minimum>タグ（Stateless Session Beanの同時実行数（プールで管理するインスタンスの最小値））を指定します。

複数の<session>タグがある場合は，それぞれに指定します。

コマンドプロンプトで，jarコマンドを実行し，アーカイブ形式のJ2EEアプリケーションに手順1.で編集したcosminexus.xmlを上書きします。

コマンドの実行例を次に示します。

jar uvf <MyApp1.earのファイルパス> -C <META-INFディレクトリを置いたディレクトリ> <META-INFディレクトリ下のcosminexus.xmlのファイルパス>

<MyApp1.earのファイルパス>は，J2EEアプリケーション（MyApp1.ear）を格納したディレクトリのパスとファイル名（MyApp1.ear）を指定します。<META-INFディレクトリを置いたディレクトリ>は，cosminexus.xmlの格納先が次のような構造の場合，<任意のディレクトリ>となります。

<任意のディレクトリ>
    └META-INF
        └cosminexus.xml

<META-INFディレクトリ下のcosminexus.xmlのファイルパス>は，手順1.でcosminexus.xmlを格納したMETA-INFディレクトリのパスとファイル名（cosminexus.xml）を指定します。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

［運用管理ポータル］画面で［論理サーバの環境設定］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理Webサーバ］−［Webサーバ］−［MyWebServer］をクリックし，［設定］タブをクリックします。

［Webサーバの設定］画面で次の値を設定して［適用］ボタンをクリックします。

［サーバスレッド数］（Windowsの場合）

［同時接続クライアント数］（UNIXの場合）

［サーバ起動時のサーバプロセス数］（UNIXの場合）

環境設定情報の保存を示すメッセージが表示され，値が設定されます。

［戻る］アンカーをクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］をクリックし，［HTTPサーバ］−［通信・スレッド制御］タブをクリックします。

［通信・スレッド制御に関する設定］画面で次の値を設定して［適用］ボタンをクリックします。

［最大接続数］

［最大スレッド数］

環境設定情報の保存を示すメッセージが表示され，値が設定されます。

KEOS19237-Wメッセージが出力されても無視し，次の手順に進んでください。このメッセージは，「HttpSessionのセッションIDに付加するサーバID」にデフォルト値（J2EEサーバが自動的に付加する値）が使用されることを示します。

参考

［通信・スレッド制御に関する設定］画面で次の値を設定して［適用］ボタンをクリックすると，KEOS19237-Wメッセージは出力されなくなります。

「HttpSessionのセッションIDに付加するサーバID」

［設定情報の配布］アンカーをクリックします。

参考

ほかの項目を続けて設定する場合は，［戻る］アンカーをクリックすると，［通信・スレッド制御に関する設定］画面へ戻れます。

［設定情報の配布］画面で［ステータス］が「空欄」の論理サーバの［配布］をチェックしてから，［選択して配布］ボタンをクリックします。

［ステータス］が「空欄」から「配布中」，「配布済」へと遷移します。

参考

［全て配布］ボタンをクリックすると，［ステータス］が「配布済」の論理サーバにも設定情報が再配布されます。

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括再起動］タブをクリックします。

［一括再起動］画面で［実行］ボタンをクリックします。

一括再起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「稼働中」から「停止中」，「停止」，「起動中」，「稼働中」へと遷移します。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［開始/停止］タブをクリックします。

［リソースアダプタの開始/停止］画面で［ステータス］が「稼働」の場合は［操作］の［停止］アンカーをクリックします。

［リソースアダプタの停止］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから停止し直してください。

［プロパティ設定］タブをクリックし，［操作］の［基本設定］アンカーをクリックします。

［リソースアダプタの基本設定］画面で次の値を設定して，［設定］ボタンをクリックします。

プールの最小値（MinPoolSize）

プールの最大値（MaxPoolSize）

［リソースアダプタの基本設定］画面で表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからプロパティを設定し直してください。

［開始/停止］タブをクリックし，［リソースアダプタの開始/停止］画面で［操作］の［開始］アンカーをクリックします。

［リソースアダプタの開始］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

(2)　URLグループ単位の同時実行数の設定

URLグループ単位の同時実行数を設定しない場合は「(3)　運用管理ポータルの起動とログイン」に進みます。

cosminexus.xmlを編集して，<任意のディレクトリ>下のMETA-INFディレクトリに格納します。

cosminexus.xmlでは，<war>タグ内で次の指定をします。

<thread-control>−<thread-control-max-threads>タグ（Webアプリケーション単位での最大同時実行スレッド数）を指定します。

<thread-control>−<thread-control-exclusive-threads>タグ（Webアプリケーションの占有スレッド数）を指定します。

<thread-control>−<thread-control-queue-size>タグ（Webアプリケーション単位の実行待ちキューサイズ）を指定します。

<thread-control>−<resource-watcher>タグ以下（Webアプリケーション単位のリクエスト実行待ちキュー格納数の監視に関するプロパティ）を指定します。

<thread-control>−<urlgroup-thread-control>−<urlgroup-thread-control-name>タグ（URLグループ単位の同時実行スレッド数制御の定義名）を指定します。

<thread-control>−<urlgroup-thread-control>−<urlgroup-thread-control-max-threads>タグ（URLグループ単位での最大同時実行スレッド数）を指定します。

<thread-control>−<urlgroup-thread-control>−<urlgroup-thread-control-exclusive-threads>タグ（URLグループ単位の占有スレッド数）を指定します。

<thread-control>−<urlgroup-thread-control>−<urlgroup-thread-control-queue-size>タグ（URLグループ単位の実行待ちキューサイズ）を指定します。

<thread-control>−<urlgroup-thread-control>−<urlgroup-thread-control-mapping>タグ（URLグループ単位の制御対象となるURLパターン）を指定します。

<thread-control>−<urlgroup-thread-control>−<stats-monitor>−<waiting-request-count>タグ以下（URLグループ単位の実行待ちリクエスト数の監視に関するプロパティ）を指定します。

コマンドプロンプトで，jarコマンドを実行し，アーカイブ形式のJ2EEアプリケーションに手順1.で編集したcosminexus.xmlを設定します。

コマンドの実行例を次に示します。

jar uvf <MyApp1.earのファイルパス> -C <META-INFディレクトリを置いたディレクトリ> <META-INFディレクトリ下のcosminexus.xmlのファイルパス>

<MyApp1.earのファイルパス>は，J2EEアプリケーション（MyApp1.ear）を格納したディレクトリのパスとファイル名（MyApp1.ear）を指定します。<META-INFディレクトリを置いたディレクトリ>は，cosminexus.xmlの格納先が次のような構造の場合，<任意のディレクトリ>となります。

<任意のディレクトリ>
    └META-INF
        └cosminexus.xml

<META-INFディレクトリ下のcosminexus.xmlのファイルパス>は，手順1.でcosminexus.xmlを格納したMETA-INFディレクトリのパスとファイル名（cosminexus.xml）を指定します。

(3)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(4)　J2EEアプリケーションの設定変更」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(4)　J2EEアプリケーションの設定変更

cosminexus.xmlを編集して再作成したJ2EEアプリケーション（MyApp1.ear）をアップロードしてインポートし直します。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［J2EEアプリケーションの開始/停止］タブをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，入れ替え前のアプリケーションの表示名（MyApp）の［操作］の［停止］アンカーをクリックします。

［J2EEアプリケーションの停止］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから停止し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「停止」になります。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［削除］タブをクリックします。

［J2EEアプリケーションの削除］画面で［インポートJ2EEアプリケーション一覧］にある，入れ替え前のアプリケーションの表示名（MyApp）の［操作］の［削除］アンカーをクリックします。

［J2EEアプリケーションの削除］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから削除し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの削除］画面の［インポートJ2EEアプリケーション一覧］からアプリケーションが削除されます。

［DefaultDomain］をクリックします。

［J2EEアプリケーションのアップロード］画面で［J2EEアプリケーションファイル］に，「(1)　WebコンテナまたはWebアプリケーション単位の同時実行数の設定」または「(2)　URLグループ単位の同時実行数の設定」で再作成したJ2EEアプリケーション（MyApp1.ear）を入力して，［アップロード］ボタンをクリックします。

表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからアップロードし直してください。

［アップロードディレクトリファイル一覧］に手順11.でアップロードしたJ2EEアプリケーションのファイル名（MyApp1.ear）が表示されます。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［インポート］タブをクリックします。

［J2EEアプリケーションのインポート］画面で［J2EEアプリケーションファイル］から手順11.でアップロードしたファイル（MyApp1.ear）を選択し，［実行］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてからインポートし直してください。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックし，［開始/停止］タグをクリックします。

［J2EEアプリケーションの開始/停止］画面で［インポートJ2EEアプリケーション一覧］にある，手順14.でインポートしたJ2EEアプリケーションの表示名（MyApp）の［操作］の［開始］アンカーをクリックします。

［J2EEアプリケーションの開始］画面で［はい］ボタンをクリックします。

［実行結果］を確認して［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

［実行結果］に「成功」が表示された場合は，［J2EEアプリケーションの開始/停止］画面の［ステータス］が「稼働」になります。

(5)　運用管理ポータルからのログアウト

［ログアウト］アンカーをクリックします。

表示されたメッセージを確認して［ログイン画面］をクリックし，Webブラウザを閉じます。

3.2.5　IPアドレスを変更する

システムが稼働しているホストのIPアドレスを変更する手順について説明します。なお，システム稼働中にDHCPなどを用いてIPアドレスを自動変更する運用はサポートしていません。

参考

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(2)　論理サーバの停止」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　論理サーバの停止

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括停止］タブをクリックします。

［一括停止］画面で［実行］ボタンをクリックします。

一括停止要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「稼働中」から「停止中」，「停止」へと遷移します。

(3)　運用管理機能の停止

運用管理ポータルにログインしている場合は，［ログアウト］アンカーをクリックし，表示されたメッセージを確認して［ログイン画面］をクリックして，Webブラウザを閉じます。

コマンドプロンプトでmngautorunコマンドを実行し，Management Serverおよび運用管理エージェントがホストの起動と同時に起動する設定を解除します。

コマンドの実行例を次に示します。

mngautorun -d

コマンドプロンプトでmngsvrctlコマンドのサブコマンド「stop」を実行し，Management Serverを停止します。

コマンドの実行例を次に示します。

mngsvrctl stop -sync

コマンドプロンプトでadminagentctlコマンドのサブコマンド「stop」を実行し，運用管理エージェントを停止します。

コマンドの実行例を次に示します。

adminagentctl stop -sync

(4)　IPアドレスの設定変更

OSの手順に従って，IPアドレスを変更します。再起動が必要な場合は，システムを再起動します。

Managerで使用するファイルでIPアドレスを設定している個所を，変更後のIPアドレスに変更します。

Managerで使用するファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.　Managerで使用するファイル」を参照してください。

次に示すディレクトリ下にあるファイルをすべて削除します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥tmp

<Application Serverのインストールディレクトリ>¥manager¥spool¥lsinfo

UNIXの場合

/opt/Cosminexus/manager/tmp

/opt/Cosminexus/manager/spool/lsinfo

(5)　システムの起動と設定情報の配布

コマンドプロンプトでadminagentctlコマンドのサブコマンド「start」を実行し，運用管理エージェントを起動します。

コマンドの実行例を次に示します。

adminagentctl start -sync

コマンドプロンプトでmngsvrctlコマンドのサブコマンド「start」を実行し，Management Serverを起動します。

コマンドの実行例を次に示します。

mngsvrctl start -sync

コマンドプロンプトでmngautorunコマンドを実行し，ホストの起動と同時にManagement Serverおよび運用管理エージェントを起動するように設定します。

コマンドの実行例を次に示します。

mngautorun both -sync

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

［運用管理ポータル］画面で［論理サーバの環境設定］をクリックします。

［サーバビュー］タブで［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］をクリックし，［設定情報の配布］アンカーをクリックします。

［設定情報の配布］画面で［ステータス］が「空欄」の論理サーバの［配布］をチェックしてから，［選択して配布］ボタンをクリックします。

［ステータス］が「空欄」から「配布中」，「配布済」へと遷移します。

参考

［全て配布］ボタンをクリックすると，［ステータス］が「配布済」の論理サーバにも設定情報が再配布されます。

［運用管理ポータル］画面で［論理サーバの起動／停止］をクリックします。

［サーバビュー］タブで［DefaultDomain］をクリックし，［一括起動］タブをクリックします。

［一括起動］画面で［実行］ボタンをクリックします。

一括起動要求が受け付けられ，［論理サーバの稼働状況］画面の論理サーバの稼働状況が「停止」から「起動中」，「稼働中」へと遷移します。

(6)　運用管理ポータルからのログアウト

［ログアウト］アンカーをクリックします。

表示されたメッセージを確認して［ログイン画面］をクリックし，Webブラウザを閉じます。

3.2.6　データベース接続環境を変更する

システムの運用を開始したあとで，データベースのアクセス方法を最適化するためにデータベース接続環境をチューニングし，設定を変更する手順について説明します。データベース接続環境のチューニングの考え方については，マニュアル「アプリケーションサーバ システム設計ガイド」の「8.5　データベースへのアクセス方法を最適化する」を参照してください。

ここでは，次に示す代表的な項目について，コネクションプーリングのチューニングパラメタを設定する手順について説明します。

コネクションプールにプールするコネクションの最小値

コネクションプールにプールするコネクションの最大値

参考

説明で使用する画面については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(2)　リソースアダプタの停止」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　リソースアダプタの停止

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［開始/停止］タブをクリックします。

［リソースアダプタの開始/停止］画面で［ステータス］が「稼働」の場合は［操作］の［停止］アンカーをクリックします。

［リソースアダプタの停止］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから停止し直してください。

(3)　リソースアダプタのプロパティの設定変更

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［プロパティ設定］タブをクリックします。

［リソースアダプタのプロパティ設定］で［操作］の［基本設定］アンカーをクリックします。

［リソースアダプタの基本設定］画面で次の値を設定して，［設定］ボタンをクリックします。

プールの最小値（MinPoolSize）

プールの最大値（MaxPoolSize）

［リソースアダプタの基本設定］画面で表示されたメッセージを確認して［戻る］アンカーをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてからプロパティを設定し直してください。

［リソースアダプタの基本設定］画面で［戻る］アンカーをクリックします。

［リソースアダプタのプロパティ設定］画面に戻ります。

参考

［リソースアダプタの基本設定］画面の画面項目にないチューニングパラメタを指定する場合は，［Connector属性ファイル編集］アンカーをクリックし，［リソースアダプタのConnector属性ファイル編集］画面でファイルに直接パラメタを設定してください。

(4)　リソースアダプタの開始

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［開始/停止］タブをクリックします。

［リソースアダプタの開始/停止］画面で［操作］の［開始］アンカーをクリックします。

［リソースアダプタの開始］画面で［はい］ボタンをクリックします。

［実行結果］に「成功」が表示されたら［戻る］アンカーをクリックします。

［実行結果］に「失敗」が表示された場合は，［ログの表示］タブをクリックして［ログの表示］画面のメッセージを確認し，障害要因を取り除いてから開始し直してください。

(5)　運用管理ポータルからのログアウト

［ログアウト］アンカーをクリックします。

表示されたメッセージを確認して［ログイン画面］をクリックし，Webブラウザを閉じます。

3.2.7　システムの構成・定義情報とは

システムの構成・定義情報とは，構築したシステムに配置している論理サーバの種類やリソースアダプタなどの構成を記述した定義ファイル，および運用管理機能の動作環境などを設定した定義ファイルのことです。代表的な定義ファイルを次に示します。

システムの構成に関するファイル

簡易構築定義ファイル

Smart Composer機能のコマンドで構築するWebシステムを定義するファイルです。また，リバースプロキシ，Webコンテナ間のリクエスト送受信時や，レスポンス送受信時の通信タイムアウトも設定します。

Connector属性ファイル

リソースアダプタの属性を定義するファイルです。

cosminexus.xml（アプリケーション属性ファイル）

EJB-JAR，Session Bean，Entity Bean，Message-driven Bean，WAR，フィルタ，サーブレット/JSPおよびリソースアダプタに関する，アプリケーションサーバ独自の定義情報を定義するファイルです。

運用管理機能の動作環境に関する定義ファイル

manager.cfg（Manager設定ファイル）

Management Server，運用管理エージェント，およびそれぞれの上で動作するコンポーネントやコマンドに共通なプロパティを指定するファイルです。ログの出力先や面数などの共通な設定で使用します。

adminagent.properties（運用管理エージェントプロパティファイル）

運用管理エージェントのプロパティを指定するファイルです。論理サーバの動作確認レベルやsnapshotログの収集先の設定などで使用します。

mserver.properties（Management Server環境設定ファイル）

Management Serverのプロパティを指定するファイルです。Management Serverの環境設定や障害検知時コマンドの動作の設定などで使用します。

これらのファイルを，システムの構築時や設定変更時などのタイミングでアプリケーションサーバと別のホストに取得しておくと，障害発生時などに，以前の構成や定義情報の設定内容を確認したい場合などに使用できます。

3.2.8　システムの構成・定義情報を取得する

システムの構成・定義情報を取得する手順について説明します。

参考

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　snapshotログによるシステムの定義情報の取得

コマンドプロンプトでmngsvrutilコマンドを実行し，システムの定義情報を取得します。

運用管理機能の動作環境に関する定義ファイルなどが取得できます。

コマンドの実行例を次に示します。

mngsvrutil -m <Management Serverのホスト名> -u admin -t <ホスト名> -k host collect snapshot

<Management Serverのホスト名>にはManagement Serverが稼働しているホスト名を，<ホスト名>にはアプリケーションサーバのホスト名を指定します。

取得されるsnapshotログのファイル名は，表示されるメッセージで確認してください。snapshotログのデフォルトの格納先を次に示します。

OS種別

格納先

Windows

<Managerのログ出力ディレクトリ>※1¥snapshot¥snapshot-<ホスト名>-log-<日付※2>.zip

<Managerのログ出力ディレクトリ>※1¥snapshot¥snapshot-<ホスト名>-log-<日付※2>.2.zip

UNIX

<Managerのログ出力ディレクトリ>※1/snapshot/snapshot-<ホスト名>-log-<日付※2>.zip

<Managerのログ出力ディレクトリ>※1/snapshot/snapshot-<ホスト名>-log-<日付※2>.2.zip

注※1　<Managerのログ出力ディレクトリ>は，manager.cfg（Managerログ設定ファイル）で指定されたディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥manager¥logです。

注※2　日付の形式は，次のどれかになります。

yyyyMMddHHmmss

yyyyMMddHHmmss+hhmm

yyyyMMddHHmmss-hhmm

(2)　簡易構築定義ファイルの取得

コマンドプロンプトでcmx_export_modelコマンドを実行し，簡易構築定義ファイルをエクスポートします。

コマンドの実行例を次に示します。

cmx_export_model -m localhost:28080 -u admin -o <簡易構築定義ファイルのファイルパス>

<簡易構築定義ファイルのファイルパス>には，簡易構築定義ファイルを格納するディレクトリのパスとファイル名を指定します。簡易構築定義ファイルはXML形式のファイルです。

(3)　Connector属性ファイルの取得

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

［運用管理ポータル］画面で［論理サーバのアプリケーション管理］をクリックします。

［DefaultDomain］−［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［リソース］−［リソースアダプタ］をクリックし，［プロパティ設定］タブをクリックします。

［リソースアダプタのプロパティ設定］で［操作］の［Connector属性ファイル編集］アンカーをクリックします。

［リソースアダプタのConnector属性ファイル編集］画面に表示されるファイルの内容をコピーして，<任意のディレクトリ>に<任意のファイル名>で保存します。

Connector属性ファイルはXML形式のファイルです。

［ログアウト］アンカーをクリックします。

表示されたメッセージを確認して［ログイン画面］をクリックし，Webブラウザを閉じます。

(4)　アプリケーション属性ファイル（cosminexus.xml）の取得

<任意のディレクトリ>下のMETA-INFディレクトリに格納してあるcosminexus.xmlを取得し，<任意のディレクトリ>に格納します。

3.2.9　不要になったJ2EEサーバを削除する

システムの運用中に，業務規模を縮小したい場合やテナントを減らしたい場合など，不要になったJ2EEサーバを削除する手順について説明します。

J2EEサーバは，Smart Composer機能を使用して削除します。

参考

説明で使用するコマンドの参照先，コマンドの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　削除対象のシステム環境の内容確認

コマンドプロンプトでcmx_list_modelコマンドを実行し，削除対象の名称を確認します。

コマンドの実行例を次に示します。

cmx_list_model -m localhost:28080 -u admin -modeltype SERVEREX -all

アプリケーションサーバに構築されているWebシステム，論理サーバの一覧が出力されます。

次に示す名称を確認してください。

削除対象のJ2EEサーバが配置されているWebシステムの名称

削除対象のJ2EEサーバが配置されているサービスユニットの名称

削除対象のWebシステム内のWebサーバの論理Webサーバ名

削除対象のJ2EEサーバの論理J2EEサーバ名

（コマンドの実行結果の例）

MyPerformanceTracer,PRF,<ホスト名>,combined-tier,unit1,MyWebSystem
MyJ2EEServer,J2EEServer,<ホスト名>,combined-tier,unit1,MyWebSystem
MyWebServer,Webserver,<ホスト名>,combined-tier,unit1,MyWebSystem
MyPerformanceTracer2,PRF,<ホスト名>,combined-tier,unit2,MyWebSystem
MyJ2EEServer2,J2EEServer,<ホスト名>,combined-tier,unit2,MyWebSystem
MyWebServer2,Webserver,<ホスト名>,combined-tier,unit2,MyWebSystem

削除対象のJ2EEサーバの論理J2EEサーバ名をMyJ2EEServer2とした場合，それぞれの名称は次のとおりです。

項目

名称

削除対象のJ2EEサーバが配置されているWebシステムの名称

MyWebSystem

削除対象のJ2EEサーバが配置されているサービスユニットの名称

unit2

削除対象のWebシステム内のWebサーバの論理Webサーバ名

MyWebServer2

(2)　削除対象のWebサーバ，J2EEサーバおよびパフォーマンストレーサの停止

コマンドプロンプトでcmx_stop_targetコマンドを実行し，削除対象のJ2EEサーバが配置されているサービスユニット（unit2）を停止します。

コマンドの実行例を次に示します。

cmx_stop_target -m localhost:28080 -u admin -s MyWebSystem -unit unit2 -mode ALL

「(1)　削除対象のシステム環境の内容確認」で確認した削除対象のJ2EEサーバが配置されているWebシステムの名称とサービスユニットの名称を指定します。

(3)　Webサーバ，J2EEサーバおよびパフォーマンストレーサの削除

コマンドプロンプトでcmx_delete_systemコマンドを実行し，削除対象のJ2EEサーバが配置されているサービスユニット（unit2）を削除します。

コマンドの実行例を次に示します。

cmx_delete_system -m localhost:28080 -u admin -s MyWebSystem -unit unit2

「(1)　削除対象のシステム環境の内容確認」で確認した削除対象のJ2EEサーバが配置されているWebシステムの名称とサービスユニットの名称を指定します。

コマンドプロンプトでhwsservereditコマンドを実行し，Webサーバの環境を削除します。

コマンドの実行例を次に示します。

hwsserveredit -delete HWS_MyWebServer2

「(1)　削除対象のシステム環境の内容確認」で確認した削除対象のWebシステム内のWebサーバの論理Webサーバ名に「HWS_」を付けた形式で指定します。

コマンドプロンプトでcjsetupコマンドを実行し，J2EEサーバの環境を削除します。

コマンドの実行例を次に示します。

cjsetup -d MyJ2EEServer2

「(1)　削除対象のシステム環境の内容確認」で確認した削除対象のJ2EEサーバの論理J2EEサーバ名を指定します。

3.2.10　運用管理機能の管理ユーザアカウントの設定を変更する

運用管理ポータルにログインする際に入力する管理ユーザアカウントの設定を変更する手順について説明します。Webフロントシステムでは，管理ユーザIDのパスワードは設定されていません。ここでは，管理ユーザIDのパスワード（adminpw）を設定する例を示します。

参考

説明で使用する画面については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

(1)　運用管理ポータルの起動とログイン

運用管理ポータルにログイン済みの場合は「(2)　管理ユーザアカウントの設定変更」に進みます。

Webブラウザを起動し，「http://localhost:28080/mngsvr/index.jsp」に接続して，運用管理ポータルを起動します。

［Management Serverへログイン］画面で管理ユーザIDに「admin」を入力して，［ログイン］ボタンをクリックします。

(2)　管理ユーザアカウントの設定変更

［運用管理ポータル］画面で［Cosminexus Management Serverの設定］をクリックします。

［Cosminexus Management Serverの設定］−［管理ユーザアカウントの設定］をクリックします。

［管理ユーザアカウントの設定］画面で［パスワード］と［パスワードの確認入力］に「adminpw」を指定し，［適用］ボタンをクリックします。

失敗を示すメッセージが表示された場合は，障害要因を取り除いてから管理ユーザアカウントを設定し直してください。

［ログイン画面へ戻る］アンカーをクリックします。

次回から［Management Serverへログイン］画面では，管理ユーザIDに「admin」，パスワードに「adminpw」を入力して，［ログイン］ボタンをクリックします。

3.3　システム環境のアンセットアップとApplication Serverのアンインストール

ここでは，運用中の障害などによってシステム環境を再構築するために，既存のシステム環境をアンセットアップしたり，Application Serverをアンインストールしたりする作業について説明します。

3.3.1　システム環境をアンセットアップする

不要になったシステム環境をアンセットアップする手順について説明します。システム環境のアンセットアップには，セットアップウィザードを使用します。

参考

説明で使用するコマンドの参照先，コマンドの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

アンセットアップを実施すると，次の処理が実行されます。

運用管理機能の停止と削除，および設定情報の初期化

システム環境（論理サーバ）の停止と削除

運用管理ユーザ（Management Serverの管理ユーザアカウント）の設定解除

J2EEサーバの起動ユーザ（Component Container管理者）の設定解除（UNIXの場合）

コマンドプロンプトでsetupwizardコマンドを実行し，不要なシステム環境を削除します。

コマンドの実行例を次に示します。

setupwizard -clean

アンセットアップを実行するかどうかを確認するメッセージが表示されます。

「y」を入力して，Enterキーをクリックします。

アンセットアップ処理の実行中を示すメッセージが表示されたあと，完了を示すメッセージが表示されます。

3.3.2　Application Serverをアンインストールする（Windowsの場合）

アプリケーションサーバに接続して，Application Serverをアンインストールします。

注意事項

Application Server以外に不要な製品があれば，その製品もアンインストールします。

アンインストールの方法には次の2種類があります。

製品のアンインストーラを利用する場合

プログラムのアンインストールまたは変更を利用する場合

製品の構成ソフトウェアすべて，または構成ソフトウェアを選択してアンインストールできます。アンインストール作業にはAdministrator権限が必要です。アンインストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を，アンインストール時のエラーコードについては，「付録I.6　Application Serverのインストールおよびアンインストール時のエラーコード一覧（Windowsの場合）」を参照してください。

注意事項

Windowsのメニュー名の表記は，使用するWindowsのバージョンによって異なります。ご使用のOSに合わせて読み替えて操作してください。

(1)　製品のアンインストーラを利用する場合

製品のアンインストーラを利用する場合の手順を次に示します。ここでは，製品の構成ソフトウェアすべてをアンインストールする手順を説明します。

手順

構成ソフトウェアのすべてのプロセスが実行中でないことを確認します。実行中のプロセスがあれば停止します。

スタートメニューから，［Cosminexus］−［uCosminexus Application Server アンインストール］を選択します。

アンインストールする構成ソフトウェアを確認する画面（「uCosminexus Application Serverをすべてアンインストールしますか？［いいえ］を選択するとアンインストールするプログラムを選択できます。」）が表示されます。

［はい］ボタンをクリックします。

［アンインストールの開始］ダイアログが表示されます。

参考

製品の構成ソフトウェアを選択してアンインストールすることもできます。この場合は，［いいえ］ボタンをクリックし，表示される［プログラムの選択］ダイアログで，アンインストールする構成ソフトウェア（プログラム）を選択して，［次へ］ボタンをクリックします。

製品に対応している構成ソフトウェアについては，「2.2.1(3)　製品に対応する構成ソフトウェアについて」を参照してください。

設定内容を確認して，問題がなければ［次へ］ボタンをクリックします。

アンインストールが開始されます。アンインストールが完了すると，［セットアップの完了］ダイアログが表示されます。

［完了］ボタンをクリックします。

Application Serverのアンインストールが完了します。

(2)　プログラムのアンインストールまたは変更を利用する場合

プログラムのアンインストールまたは変更を利用する場合の手順を次に示します。ここでは，製品の構成ソフトウェアすべてをアンインストールする手順を説明します。

手順

構成ソフトウェアのすべてのプロセスが実行中でないことを確認します。実行中のプロセスがあれば停止します。

スタートメニューから，［コントロールパネル］−［プログラムと機能］を選択します。

［プログラムのアンインストールまたは変更］ダイアログが表示されます。

［uCosminexus Application Server］を選択して，右クリックで表示される［アンインストールと変更］ボタンをクリックします。

アンインストールする構成ソフトウェアを確認する画面（「uCosminexus Application Serverをすべてアンインストールしますか？［いいえ］を選択するとアンインストールするプログラムを選択できます。」）が表示されます。

［はい］ボタンをクリックします。

［アンインストールの開始］ダイアログが表示されます。

参考

製品の構成ソフトウェアを選択してアンインストールすることもできます。この場合は，［いいえ］ボタンをクリックし，表示される［プログラムの選択］ダイアログで，アンインストールする構成ソフトウェア（プログラム）を選択して，［次へ］ボタンをクリックします。

製品に対応している構成ソフトウェアについては，「2.2.1(3)　製品に対応する構成ソフトウェアについて」を参照してください。

設定内容を確認して，問題がなければ［次へ］ボタンをクリックします。

アンインストールが開始されます。アンインストールが完了すると，［セットアップの完了］ダイアログが表示されます。

［完了］ボタンをクリックします。

Application Serverのアンインストールが完了します。

3.3.3　Application Serverをアンインストールする（AIXの場合）

アプリケーションサーバに接続して，Application Serverをアンインストールします。

注意事項

Application Server以外に不要な製品があれば，その製品もアンインストールします。

アンインストールでは，製品の提供媒体であるPPインストーラを使用します。

アンインストールの手順を次に示します。アンインストール作業にはroot権限が必要です。アンインストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を参照してください。

手順

構成ソフトウェアのすべてのプロセスが実行中でないことを確認します。実行中のプロセスがあれば停止します。

アプリケーションサーバにroot権限（スーパーユーザ）でログインします。

次のコマンドを入力して，PPインストーラを起動します。

/etc/hitachi_setup

PPインストーラのメインメニューで，［D］キーを押します。

PP削除画面が表示されます。

プログラムにカーソルを移動させ，［スペース］キーを押します。

すべてのプログラム（Application Serverに対応している構成ソフトウェア，および製品の共通モジュール）を選択します。選択したプログラムの左側には<@>が表示されます。なお，プログラムを選択してアンインストールすることもできます。

すべてのプログラムの左側に<@>が表示されていることを確認して，［D］キーを押します。

画面の最下行に「Delete PP? (y: delete, n: cancel)==>」メッセージが表示されます。

［y］キーまたは［Y］キーを押します。

アンインストールが開始されます。

［n］キーまたは［N］キーを押すと，アンインストールが中止されてPP削除画面に戻ります。

インストール終了を示すメッセージが出力されたら，［Q］キーを押します。

PPインストーラのメインメニューに戻ります。

PPインストーラのメインメニューで，［Q］キーを押します。

Application Serverのアンインストールが完了します。

3.3.4　Application Serverをアンインストールする（Linuxの場合）

アプリケーションサーバに接続して，Application Serverをアンインストールします。

注意事項

Application Server以外に不要な製品があれば，その製品もアンインストールします。

アンインストールでは，製品の提供媒体であるPPインストーラを使用します。

アンインストールの手順を次に示します。アンインストール作業にはroot権限が必要です。アンインストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を参照してください。

手順

構成ソフトウェアのすべてのプロセスが実行中でないことを確認します。実行中のプロセスがあれば停止します。

アプリケーションサーバにroot権限（スーパーユーザ）でログインします。

次のコマンドを入力して，PPインストーラを起動します。

/etc/hitachi_x64setup

PPインストーラのメインメニューで，［D］キーを押します。

PP削除画面が表示されます。

プログラムにカーソルを移動させ，［スペース］キーを押します。

すべてのプログラム（Application Serverに対応している構成ソフトウェア，および製品の共通モジュール）を選択します。選択したプログラムの左側には<@>が表示されます。なお，プログラムを選択してアンインストールすることもできます。

すべてのプログラムの左側に<@>が表示されていることを確認して，［D］キーを押します。

画面の最下行に「Delete PP? (y: delete, n: cancel)==>」メッセージが表示されます。

［y］キーまたは［Y］キーを押します。

アンインストールが開始されます。

［n］キーまたは［N］キーを押すと，アンインストールが中止されてPP削除画面に戻ります。

インストール終了を示すメッセージが出力されたら，［Q］キーを押します。

PPインストーラのメインメニューに戻ります。

PPインストーラのメインメニューで，［Q］キーを押します。

Application Serverのアンインストールが完了します。

3.4　システムの運用時の注意事項

ここでは，システムの運用時に注意することについて説明します。

3.4.1　J2EEサーバを運用管理するときの注意事項

(1)　RMIレジストリに関する注意事項

Management Serverは，J2EEサーバの運用監視に，J2EEサーバ上で動作するRMIレジストリを使用します。そのため，Management Serverが管理しているRMIレジストリの情報と実際に動作しているJ2EEサーバのRMIレジストリの情報が一致していないと，運用監視に失敗する場合があります。Management Serverの管理しているRMIレジストリの情報は，次のタイミングで更新されます。J2EEサーバ上で動作するRMIレジストリと異ならないように注意してください。

運用管理ポータルの「Management Serverの設定」で構成情報の回復を実行した場合

運用管理ポータルの「論理サーバの環境設定」で［適用］ボタンを押した場合

運用管理ポータルの「論理サーバの環境設定」からサーバの設定の読み込みを実行した場合

cmx_build_model.exeコマンドを実行した場合

cmx_change_model.exeコマンドを実行した場合

運用管理ポータルの操作については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の次の個所を参照してください。

8.　Management Serverの設定

10.　論理サーバの環境設定

各コマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の次の個所を参照してください。

cmx_build_model（Webシステムの情報モデルの生成）

cmx_change_model（Webシステムの情報モデルの変更）

3.4.2　コマンドで指定する名称に関する注意事項

運用作業でコマンドを実行する際，コマンドによって次の四つの異なる名称を指定します。各名称の対応を確認するには，コマンドや簡易構築定義ファイルを使用する必要があります。

Webシステム名

Smart Composer機能のコマンドに指定します。

例：cmx_start_target -s <Webシステム名>

サービスユニット名

Smart Composer機能のコマンドに指定します。

例：cmx_start_target -s <Webシステム名> -unit <サービスユニット名>

論理サーバ名

運用管理コマンド（mngsvrutil）に指定します。

例：mngsvrutil start -t <論理サーバ名>

実サーバ名

サーバ管理コマンドに指定します。

例：cjstartsv <実サーバ名>

各名称の対応は，次の方法で確認してください。

cmx_list_modelコマンドを実行することで，次の名称の対応を確認します。

ホスト名

Webシステム名

サービスユニット名

論理サーバ名

実行例

cmx_list_model -m localhost:28080 -u admin -p admin -modeltype SERVEREX
cmx_sample-system_unit1_PRF_01,PerformanceTracer,host1,combined-tier,unit1,sample-system
cmx_sample-system_unit1_J2EE_01,J2EEServer,host1,combined-tier,unit1,sample-system
cmx_sample-system_unit1_HTTP_01,WebServer,host1,combined-tier,unit1,sample-system
cmx_sample-system_unit2_PRF_01,PerformanceTracer,host2,combined-tier,unit2,sample-system
cmx_sample-system_unit2_J2EE_01,J2EEServer,host2,combined-tier,unit2,sample-system
cmx_sample-system_unit2_HTTP_01,WebServer,host2,combined-tier,unit2,sample-system

簡易構築定義ファイルで，次の名称の対応を確認します。

論理サーバ名（logical-server-name）

論理サーバ名が定義されていない場合は，自動生成されます。

実サーバ名（realservername）

実サーバ名が定義されていない場合は，論理サーバ名と同じになります。

3.4.3　ネットワークドライブへアクセスするときの制限事項（Windowsの場合）

Windows の場合，次の表に示す構成ソフトウェアは，ネットワークドライブへアクセスするときに制限が発生します。構成ソフトウェアごとの制限事項を次の表に示します。

また，Windows の仕様によって，サービスから起動するプログラムは，ネットワークドライブへのアクセスに制限がありますので，注意してください。

表3‒2　ネットワークドライブへアクセスするときの制限事項

構成ソフトウェア

制限事項

Component Transaction Monitor

Windowsのサービスを利用してComponent Transaction Monitorを起動する場合は，CTMSPOOL環境変数にネットワークドライブ上のパスを指定しないでください。

HTTP Server

HTTP Serverからネットワークドライブにアクセスできません。

Performance Tracer

Windowsのサービスを利用してPerformance Tracerを起動する場合は，PRFSPOOL環境変数にネットワークドライブ上のパスを指定しないでください。

Reliable Messaging

次に示すReliable Messagingのコンフィグレーションプロパティには，ネットワークドライブ上のファイルやディレクトリを指定しないでください。

QueueConfigFileName

QueueMakeFileName

RMTRTransferControlDir

TPBroker

ORB機能で使用する環境変数やプロパティに，ネットワークドライブまたはネットワークドライブ上のファイルを指定しないでください。

HiRDB/Single Server Version 10

電源入力時は，ネットワークドライブは接続されていないため，Windowsのサービスを利用して起動できません。このため，ネットワークドライブへHiRDB/Single Server Version 10をインストールしたり，データベースの環境を構築したりしないでください。

3.4.4　一時ファイルに関する注意事項

Windowsの場合，Component Containerでは，プログラム動作中に，TMPもしくはTEMP環境変数で指定されたディレクトリ，またはOSがユーザに割り当てた一時ディレクトリに一時ファイルを作成します。

そのため，プログラムを正常に動作させるためには，一時ファイルの作成先に書き込み権限が必要となります。また，プログラム動作中は，一時ファイルの作成先および一時ファイルを削除しないでください。

UNIXの場合，アプリケーションサーバでは，他プロセスとの通信のため，次の一時ファイルを作成して使用します。

/tmp/hsperfdata_<ユーザ名>/<プロセスID>

そのため，アプリケーションサーバを正常に動作させるためには，/tmpに書き込み権限が必要となります。

また，作成された一時ファイルやディレクトリのアクセス権を変更したり，JavaVM起動中に一時ファイルを削除したりする場合の動作は保証しません。

3.4.5　システム時刻を補正するときの注意事項

NTPプログラム（Windowsの場合はWindows Timeサービス，UNIXの場合はntpdコマンド，ntpdateコマンドなど）を使用してシステム時刻を補正する場合は，次の点に注意して運用してください。なお，システム時刻補正については，使用しているOSのマニュアルを参照してください。

時刻飛びが発生しないように時刻のずれを徐々に補正する，slewモードの範囲で製品を使用してください。

一度に数十秒以上の大幅な時刻補正が必要な場合は，製品のプロセスを停止してから時刻補正を実施するようにしてください。

時刻補正によってシステム時刻が戻った場合または進んだ場合，次のような事象が発生することがあります。これらの事象を考慮して，システム設計やタイムアウト設計をしてください。

トランザクションや通信，システム監視などで，タイムアウトが想定より遅くなったり早くなったりする

ログや履歴の時系列が崩れる

一部の構成ソフトウェアでは，機能の性質上，時刻が戻ると動作が不正になることがあります。

4　運用管理ポータルまたはSmart Composer機能で実現する運用形態

この章では，運用管理ポータルまたはSmart Composer機能で実現するシステムを構築および運用する手順について説明します。

説明で使用する画面，コマンドおよびファイルの参照先，コマンドおよびファイルの格納先については，「5.　システムの構築・運用時に使用する画面，コマンドおよびファイル」を参照してください。

4.1　Webサーバを別ホストに配置してマシン性能を向上するシステムの構築

ここでは，Webサーバを配置するホストと，J2EEサーバを配置するホストを分けたシステムを構築する手順について説明します。

4.1.1　Webサーバを別ホストに配置するには

Webサーバを別ホストに配置するシステムでは，HTMLファイルなどの静的なコンテンツを配置するホストと，業務アプリケーションを実行するホストを分けることで，パフォーマンスの向上が図れます。

Smart Composer機能の場合は，Webサーバを配置するホスト（http-tier）およびJ2EEサーバを配置するホスト（j2ee-tier）や論理サーバの環境設定を定義した簡易構築定義ファイルから，コマンドを使用して構築します。また，運用管理ポータルの場合は，［運用管理ポータル］画面の各画面で，それぞれのホストに論理サーバ（WebサーバやJ2EEサーバなど）を配置して，各論理サーバの設定情報をホストに配布して構築します。

システム構成例

Webサーバを別ホストに配置するシステムのシステム構成例を次の図に示します。なお，このシステムでは，運用管理機能であるManagement Serverは，J2EEサーバを配置するホストに配置します。また，この構成例では，ネットワークは単一構成（業務LANと管理LANを分けない構成）とし，各ホストは物理NICを一つ使用するものとします。

図4‒1　Webサーバを別ホストに配置するシステムのシステム構成例

例題で使用する設定内容を次の表に示します。

表4‒1　例題で使用する設定内容（Webサーバを別ホストに配置するシステムの構築）

分類

項目

設定例

Webサーバを配置するホスト

ホストの名称

apsv1

IPアドレス（管理IPアドレス）※1

192.168.100.11

論理Webサーバの名称

MyWebSystem_HTTP01

論理パフォーマンストレーサの名称

MyWebSystem_PRF01

J2EEサーバを配置するホスト※2

ホストの名称

apsv2

IPアドレス（管理IPアドレス）※1

192.168.100.12

論理J2EEサーバの名称

MyWebSystem_J2EE01

論理パフォーマンストレーサの名称

MyWebSystem_PRF02

J2EEアプリケーションのファイル名

MyApp.ear

J2EEアプリケーションの表示名

MyApp

運用管理機能の管理ユーザID

admin

運用管理機能の管理ユーザパスワード

admin

注※1　ネットワークが単一構成の場合，IPアドレスは，業務IPアドレスと管理IPアドレスの両方を兼ねます。

注※2　運用管理機能（Management Server）は，J2EEサーバを配置するホストに配置します。

実施する作業と作業の要否

Webサーバを別ホストに配置するシステムの構築時に実施する作業と作業の要否を，利用する構築ツールごとに次の表に示します。

表4‒2　Webサーバを別ホストに配置するシステムの構築時に実施する作業と作業の要否（運用管理ポータル利用時）

Webサーバを別ホストに配置するシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照先マニュアル

参照個所

データベースの準備

△

データベースに接続する場合

このマニュアル

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベース（Oracle）に接続する場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

運用管理ポータル

2.2

運用管理エージェントの起動

○

必ず実施

4.1.2

Management Serverの起動

○

必ず実施

4.1.2

システム環境の設定

○

必ず実施

3.2

システム環境のセットアップ

○

必ず実施

システムの起動（論理サーバの起動）

○

必ず実施

4.1.2

リソースアダプタの設定

△

リソースアダプタ（DB Connector）によるリソース接続をする場合

3.3

リソースアダプタ（DB Connector以外）によるリソース接続をする場合

リソースアダプタの開始

△

リソースアダプタによるリソース接続をする場合

4.1.2

業務アプリケーションの設定と開始

○

必ず実施

3.4，4.1.2

システム環境定義の変更

△

運用で必要な場合

4.2

業務アプリケーションの設定変更

△

運用で必要な場合

4.2，4.3

リソースアダプタの設定変更

△

運用で必要な場合

4.2

システムの停止（論理サーバの停止）

△

運用で必要な場合

4.1.4

Management Serverの停止

△

運用で必要な場合

4.1.4

運用管理エージェントの停止

△

運用で必要な場合

4.1.4

システム環境の削除

△

運用で必要な場合

3.6

（凡例）

運用管理ポータル：マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を示します。

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

表4‒3　Webサーバを別ホストに配置するシステムの構築時に実施する作業と作業の要否（Smart Composer機能利用時）

Webサーバを別ホストに配置するシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

△

データベースに接続する場合

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベース（Oracle）に接続する場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

4.1.14

運用管理エージェントの起動

○

必ず実施

4.1.17

Management Serverの起動

○

必ず実施

4.1.18

システム環境の設定（簡易構築定義ファイルの設定）

○

必ず実施

4.1.20

システム環境の構築（セットアップ）

○

必ず実施

4.1.23

システムの起動

○

必ず実施

4.1.24

リソースアダプタの設定

△

リソースアダプタ（DB Connector）によるリソース接続をする場合

4.1.26

リソースアダプタ（DB Connector以外）によるリソース接続をする場合

4.1.27

リソースアダプタの開始

△

リソースアダプタによるリソース接続をする場合

4.1.28

業務アプリケーションの設定と開始

○

必ず実施

4.1.29

システム環境定義の変更

△

運用で必要な場合

4.1.31

業務アプリケーションの設定変更

△

運用で必要な場合

4.1.32

リソースアダプタの設定変更

△

運用で必要な場合

4.1.33

システムの停止

△

運用で必要な場合

4.1.34

Management Serverの停止

△

運用で必要な場合

4.1.35

運用管理エージェントの停止

△

運用で必要な場合

4.1.36

システム環境の削除

△

運用で必要な場合

4.1.37

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

4.1.2　データベースの環境を設定する（Oracleの設定）

ここでは，Oracle JDBC Thin Driverを使用する場合に，データベース側で必要な設定について説明します。詳細については，Oracleのマニュアルを参照してください。

トランザクションリカバリを行うために付与する権限

グローバルトランザクションを使用する場合は，トランザクションリカバリを行うために，Oracleの接続ユーザに次の権限を付与する必要があります。

SYS.DBA_PENDING_TRANSACTIONSのSELECT権限

FORCE ANY TRANSACTION権限

SYS.DBMS_SYSTEMをEXECUTEする権限

権限を付与する方法については，Oracleのマニュアルを参照してください。

動的パフォーマンスビューの参照権の設定

Oracleに接続するユーザは，動的パフォーマンスビューの参照権を持っている必要があります。次のどちらかの方法でOracleに接続するユーザに動的パフォーマンスビューの参照権を設定してください。

「GRANT SELECT_CATALOG_ROLE TO <ユーザ名>;」を実行する。

「GRANT SELECT ON V_$INSTANCE TO <ユーザ名>;」，「GRANT SELECT ON V_$PROCESS TO <ユーザ名>;」，および「GRANT SELECT ON V_$SESSION TO <ユーザ名>;」を実行する。

タイムアウトの設定

Oracleのサーバ定義のDISTRIBUTED_LOCK_TIMEOUTパラメタに設定します。

なお，このほかXAOpenStringのSesTmパラメタの設定がタイムアウトに影響しますが，このパラメタはチューニングできません。

詳細については，次の個所またはマニュアルを参照してください。

マニュアル「アプリケーションサーバ システム設計ガイド」の「8.6.6　データベースでのタイムアウトを設定する」

マニュアル「アプリケーションサーバ システム設計ガイド」の「8.6.8　タイムアウトを設定するチューニングパラメタ」

Oracleのマニュアル

4.1.3　Component Container管理者を設定する（UNIXの場合）

UNIXの場合，サーバのセットアップ，起動と停止などはスーパーユーザで実施しますが，スーパーユーザ以外の一般ユーザでも権限を与えることで実施できるようになります。このユーザをComponent Container管理者といいます。これによって，スーパーユーザ以外のユーザでもシステムを構築，運用できるようになります。この設定は，各ホスト（J2EEサーバを配置するホスト）で実施します。

ここでは，Component Container管理者を設定する手順について説明します。Component Container管理者の設定する場合は新規インストールまたは更新インストールの前後で作業が必要になります。Component Container管理者を設定するときの注意事項については，「4.1.4　Component Container管理者を設定するときの注意事項（UNIXの場合）」を参照してください。

アプリケーションサーバにroot権限（スーパーユーザ）でログインします。

Component Container管理者を登録するグループ（Component Container管理者グループ）を登録します。

グループの登録方法については，OSのドキュメントを参照してください。

手順2.で登録したグループに，Component Container管理者を登録します。

管理者の登録方法については，OSのドキュメントを参照してください。

新規インストールまたは更新インストールを実施します。

新規インストールの場合

AIXのときは「2.2.3　Application Serverを新規インストールする（AIXの場合）」を，Linuxのときは「2.2.4　Application Serverを新規インストールする（Linuxの場合）」を参照してください。

更新インストールの場合

「付録F.2　Application Serverを更新インストールする（UNIXの場合）」を参照してください。

Component Containerのインストールディレクトリの所有者とグループを，手順2.および手順3.で登録したComponent Container管理者とComponent Container管理者グループに変更します。

cjenvsetupコマンドを実行して，Component Container管理者をセットアップします。

Component Container管理者の設定が完了します。設定完了後は，Component Container管理者が実施できる操作は，一部の操作を除いてスーパーユーザで操作できなくなります。J2EEサーバやバッチサーバのセットアップ，起動と停止などの操作はComponent Container管理者が実施してください。

4.1.4　Component Container管理者を設定するときの注意事項（UNIXの場合）

Component Container管理者の設定後，Component Container管理者が実施できる操作は，一部の操作を除き，スーパーユーザでは操作できなくなるので注意してください。

Component Container管理者を設定した場合に，スーパーユーザおよびComponent Container管理者が実施できる操作を次の表に示します。

表4‒4　Component Container管理者の設定がある場合に実施できる操作

操作

スーパーユーザ

Component Container管理者

Component Containerのインストール

○

×

Component Container管理者のセットアップ（cjenvsetupコマンド）

○

×

作業ディレクトリおよびユーザ定義ファイルの移行（cjenvupdateコマンド，cjrarupdateコマンド）

×

○

J2EEサーバまたはバッチサーバのセットアップ／アンセットアップ（cjsetupコマンド）

×

○

J2EEサーバまたはバッチサーバの起動／停止

（cjstartsvコマンド，cjstopsvコマンド）

×

○

サーバ管理コマンドの実行

○

○

スレッドダンプの取得（cjdumpsvコマンド）

○

○

OS状態情報の取得（cjgetsysinfoコマンド）

○

○

バッチアプリケーションの実行（cjexecjobコマンド）※

○

○

バッチアプリケーションの強制停止（cjkilljobコマンド）※

○

○

バッチアプリケーション情報の一覧表示（cjlistjobコマンド）※

○

○

（凡例）○：実行できます。　×：実行できません。

注※　バッチアプリケーションの場合に使用できるコマンドです。バッチアプリケーションは，バッチサーバ上で動作するアプリケーションです。

なお，Component Container管理者を設定しない場合は，スーパーユーザが運用管理者となるため，Component Container管理者の操作もスーパーユーザが実施します。

参考

Component Container管理者を設定していても，運用管理コマンドの実行には影響ありません。

Management Serverのセットアップ時に設定した管理ユーザIDで，システム運用時の操作およびコマンドを実行できます。

Component Container管理者の設定，およびComponent Container管理者による運用に関する注意事項を次に示します。

Component Container管理者のアカウント

Component Container管理者のアカウントは，Component Containerをインストールするホストに一つだけしか登録できないため，複数のアカウントをComponent Container管理者として登録できません。なお，Component Container管理者として使用できるアカウントは，OSにログインできるアカウントに限定されます。

Component Container管理者の管理対象のサーバ

cjsetupコマンドでセットアップするJ2EEサーバやバッチサーバだけでなく，インストール時にデフォルトでセットアップされるホスト名のサーバについても，Component Container管理者が所有者となります。サーバごとに異なるComponent Container管理者を設定することはできません。

Component Container管理者で運用する場合のポート番号の変更

Component Container管理者でCORBAネーミングサービスを起動する場合（インプロセスで起動する場合も含みます）には，簡易構築定義ファイルでポート番号の設定を変更します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.naming.portパラメタで，ポート番号に1,024番以上を設定してください。CORBAネーミングサービスをデフォルトのポート番号（900番），または0〜1,023番のポート番号で起動する場合には，スーパーユーザで手動起動してください。

なお，root権限を持たないComponent Container管理者では，0〜1,023番のポート番号を開けません。このため，Component Container管理者を設定して運用する場合には，CORBAネーミングサービス以外のポート番号についても，1,024番以上に変更してください。

Component Containerのインストールディレクトリ属性の変更

Component Containerのインストールディレクトリの属性（所有者／グループ）を変更した場合，Component Container管理者セットアップコマンドの実行が完了するまでサーバを操作（セットアップ／アンセットアップ，および起動・停止）しないでください。

Component Container管理者の変更

Component Container管理者を設定していた場合は，更新インストール後も同じユーザがComponent Container管理者となります。Component Container管理者を変更したい場合には，Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）の所有者およびグループを変更して，Component Container管理者をセットアップしてください。

Component Container管理者をスーパーユーザに戻す場合も，同様の方法で変更できます。

ディレクトリおよびファイルの所有者の変更

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内では，次に示すディレクトリを変更して使用できます。

変更できるディレクトリ

指定方法

製品のJavaVM（以降，JavaVMと呼びます）ログ出力先ディレクトリ

JavaVM起動パラメタを指定します。

JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

-XX:HitachiJavaLog:<ディレクトリ名>

J2EEサーバまたはバッチサーバのログ出力ディレクトリ

ejb.server.log.directoryパラメタで指定します。

JSP用一時ディレクトリ

webserver.work.directoryパラメタで指定します。

TPBrokerのトレース出力先ディレクトリ

vbroker.orb.htc.tracePathパラメタで指定します。

稼働情報ファイルの出力先ディレクトリ

ejbserver.management.stats_file.dirパラメタで指定します。

これらのディレクトリを変更して使用している場合には，Component Container管理者のセットアップ後に，次のどちらかを実行してください。

各ディレクトリおよびファイルの所有者をComponent Container管理者に変更する。

各ディレクトリおよびファイルに，Component Container管理者の書き込み権限を設定する。

Component Container管理者を設定している場合のディレクトリの属性

Component Container管理者を設定した場合，次に示すディレクトリ下のサブディレクトリおよびファイルの属性（所有者/グループ）が「Component Container管理者/Component Container管理者グループ」に変更されます。

/opt/Cosminexus/CC

<作業ディレクトリ>/ejb/

<作業ディレクトリ>/web/

ただし，/opt/Cosminexus/CC下の一部のファイル（/opt/Cosminexus/CC/server/bin/cjenvsetup，/opt/Cosminexus/CC/server/bin/cjgetsysinfoや，インストールログなど）の属性は変更されません。

EJBクライアントアプリケーションのログ出力先ディレクトリのアクセス権の設定

Component Container管理者を設定している場合，Component Containerのインストールディレクトリ（/opt/Cosminexus/CC）以下のファイルおよびディレクトリの属性（所有者／グループ）が「Component Container管理者／Component Container管理者グループ」に変更されます。このため，EJBクライアントアプリケーションのログ出力先にデフォルトの/opt/Cosminexus/CC/client/logsを使用していて，かつComponent Container管理者とEJBクライアントアプリケーションの実行ユーザのアカウントが異なる場合，EJBクライアントアプリケーションのログ出力時にエラーとなることがあります。この場合，ログ出力先ディレクトリに出力されたログファイルのモードを，グループやほかのすべてのユーザに対して書き込みを許可するように設定してください。アクセス権の設定については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(EJBコンテナ)」の「3.8.5　ログ出力先ディレクトリのアクセス権の設定」を参照してください。

運用監視エージェントのログファイルのアクセス権の設定

運用監視エージェントは，「/opt/Cosminexus/manager/log」ディレクトリに，次に示す名称のログファイルを出力します。

mngagent-<ドメイン名>-<Agent名>.[n].log

注　ファイル名の[n]の部分には，1〜指定したログの面数の通し番号が付きます。

Component Container管理者を設定したあとに，次のどちらかを実行してください。

ログファイルの所有者をComponent Container管理者に変更する。

ログファイルに，Component Container管理者の書き込み権限を設定する。

Component Container管理者を設定している場合のメッセージ

Component Container管理者を設定している場合，アプリケーションおよび各種リソースをインポートするときに，インポート対象ファイルの読み取り権限がないために次のメッセージが出力されることがあります。このような場合は，インポート対象ファイルのアクセス権を確認してください。

アクセス権の設定が不正な場合，メッセージに，KDJE37324-Eが出力されます。

Component Container管理者を設定している場合のJ2EEサーバまたはバッチサーバのセットアップ

Component Container管理者を設定している場合，Management Serverのサーバ名と同じ名前でJ2EEサーバやバッチサーバをセットアップしないでください。なお，Component Containerは，インストール時にホスト名でJ2EEサーバやバッチサーバをセットアップしているため，Management Serverのサーバ名をホスト名でセットアップしないでください。

Component Container管理者のセットアップ（cjenvsetupコマンド）の実行情報はメッセージログおよびテキストファイルに出力されます。実行情報の出力内容と出力先を次に示します。

表4‒5　Component Container管理者のセットアップ（cjenvsetupコマンド）の実行情報の出力内容と出力先一覧

コマンド実行情報

出力内容

出力先ファイル名※1

コマンド実行メッセージ

次のメッセージが出力されます。

KDJE40074-I

KDJE40040-I（正常の場合）

KDJE40041-E（異常の場合）

cjenvsetupmessage*.log

変更前ファイル（ディレクトリ）情報

コマンド実施前の所有者変更対象のファイル（ディレクトリ）※2情報の一覧※3。

before_cjenvsetup_files*.txt

変更後ファイル（ディレクトリ）情報

コマンド実施後の所有者変更対象のファイル（ディレクトリ）情報※2の一覧※3。

なお，エラーが発生した場合は，エラー発生時点（コマンド終了時点）の途中結果が出力されます。

after_cjenvsetup_files*.txt

注※1

出力ディレクトリは，<Component Containerのインストールディレクトリ>/logs/です。

注※2

所有者変更対象となるファイル（ディレクトリ）は，<Component Containerのインストールディレクトリ>下，<作業ディレクトリ>/ejb下，および<作業ディレクトリ>/web下の各ファイルです。なお，シンボリックリンクファイルのリンク先がディレクトリの場合は，シンボリックリンク先のディレクトリ下のファイルも対象となります。

注※3

1行目にファイル（ディレクトリ）一覧出力日時，2行目以降にファイル（ディレクトリ）の一覧が出力されます。出力例を次に示します。

Mon Dec 10 12:00:00 JST 2012  ← ファイル(ディレクトリ)一覧出力日時
/opt/Cosminexus/CC:           ← ファイル(ディレクトリ)一覧
 total 16
drwxr-xr-x    2 0        0               256 Dec 10 11:00 adapters
drwxr-xr-x    2 0        0               256 Dec 10 11:00 admin
　　　・
　　　・
　　　・

なお，ファイル（ディレクトリ）の一覧情報の書式はOSのバージョン，設定によって異なります。

4.1.5　アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

UNIXの場合，次のディレクトリのシンボリックリンクをサポートしています。

/opt/Cosminexus/CC

/opt/Cosminexus/CCR

/opt/Cosminexus/manager

/opt/Cosminexus/c4web

ただし，これらのディレクトリより下位のディレクトリのシンボリックリンク，およびこれら以外のディレクトリのシンボリックリンクは未サポートとなります。

展開ディレクトリ形式のJ2EEアプリケーションのアプリケーションディレクトリ，およびその下位ディレクトリのシンボリックリンクは未サポートとなります。

4.1.6　データベース接続環境を設定する（HiRDBの設定）

J2EEサーバ上のJ2EEアプリケーションからデータベースへ接続するためには，リソースアダプタとしてDB Connectorを使用します。また，DB Connectorを使用してデータベースに接続するためには，データベースに対応するJDBCドライバが必要です。

ここでは，DB Connectorを使用してHiRDBに接続する際に必要なデータベース接続環境の設定について説明します。JDBCドライバはHiRDB Type4 JDBC Driverを使用します。この設定は，J2EEサーバを配置するホストで実施します。

なお，データベースを設定するときの注意事項については，「4.1.9　データベースを設定するときの注意事項」を参照してください。

(1)　HiRDB Type4 JDBC Driverの準備

ここでは，HiRDB Type4 JDBC Driverの準備について説明します。

HiRDB Type4 JDBC DriverのJARファイルを用意します。

JARファイルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

簡易構築定義ファイルに，手順1.で用意したHiRDB Type4 JDBC DriverのJARファイルのパスを設定します。

簡易構築定義ファイルを作成するときに，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグに次の設定を追加してください。

<param-name>タグの指定値

<param-value>タグの指定値

add.class.path

<JARファイルのクラスパス>

簡易構築定義ファイルの作成については，「4.1.20　簡易構築定義ファイルを設定する」を参照してください。設定内容の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(2)　HiRDBクライアント環境変数グループ設定ファイルの作成

HiRDBクライアント環境変数グループを使用するには，HiRDBのクライアント環境変数グループの設定ファイルを作成します。この場合，DB Connectorのプロパティ定義内のHiRDBクライアント環境変数グループ名を指定する部分には，ここで作成した設定ファイルのパスを指定してください。設定ファイルの作成方法については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

なお，グローバルトランザクションを使用する場合には，必ずHiRDBクライアント環境変数グループを設定する必要があります。グローバルトランザクションを使用しない場合には，HiRDBクライアント環境変数グループの使用は任意です。

(3)　システムプロパティの設定

HiRDBの設定は，システムプロパティとしても設定できます。プロパティ名は，"HiRDB_for_Java_"で始まります。J2EEサーバでのシステムプロパティは，J2EEサーバ用ユーザプロパティファイル（usrconf.properties）に設定します。

（例）HiRDB_for_Java_UPDATECOUNT_BEHAVIOR=TRUE

HiRDBのシステムプロパティの詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

なお，Connector属性ファイルやHiRDBクライアント環境変数グループ設定ファイルで設定できるプロパティについては，システムプロパティでは設定しないでください。

(4)　タイムアウトの設定

HiRDBのタイムアウトは，次に示すHiRDBのクライアント環境変数を，DB ConnectorのenvironmentVariablesプロパティまたはHiRDBのクライアント環境変数グループの設定ファイルに追加することで設定します。

PDSWAITTIME

PDCWAITTIME

PDNBLOCKWAITTIME

なお，コネクション確立時のタイムアウトは，DB ConnectorのloginTimeoutプロパティに設定します。ただし，HiRDB Type4 JDBC DriverのsetLoginTimeoutメソッドに値を設定した場合でも，ログイン時のタイムアウトができないことがあります。

DB Connectorのプロパティは，システム構築前，またはシステム構築後のリソースアダプタのデプロイ時に設定します。リソースアダプタのデプロイについては，「4.1.26　DB Connectorを設定する（CUI利用時）」または「4.1.27　DB Connector以外のリソースアダプタを設定する（CUI利用時）」を参照してください。

また，タイムアウトの設定の詳細については，マニュアル「アプリケーションサーバ システム設計ガイド」の「8.6.6　データベースでのタイムアウトを設定する」を参照してください。DB Connectorのプロパティの設定については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2.2　DB Connectorのプロパティ定義」を参照してください。

4.1.7　データベース接続環境を設定する（Oracleの設定）

J2EEアプリケーションからデータベースへ接続するためには，リソースアダプタとしてDB Connectorを使用します。また，DB Connectorを使用してデータベースに接続するためには，データベースに対応するJDBCドライバが必要です。

ここでは，DB Connectorを使用してOracleに接続する際に必要なデータベース接続環境の設定について説明します。JDBCドライバはOracle JDBC Thin Driverを使用します。この設定は，J2EEサーバを配置するホストで実施します。

なお，データベースを設定するときの注意事項については，「4.1.9　データベースを設定するときの注意事項」を参照してください。

(1)　Oracle JDBC Thin Driverの準備

ここでは，Oracle JDBC Thin Driverを使用する場合に，J2EEサーバ側で必要な設定について説明します。なお，Oracle JDBC Thin Driverを使用する場合，J2EEサーバに追加する環境変数はありません。

アプリケーションサーバがサポートするバージョンの，Oracle JDBC Thin DriverのJARファイルを入手してください。Oracle JDBC Thin Driverの入手方法の具体例としては，J2EEサーバを動作させるマシンにOracleクライアントをインストールする方法があります。Oracleクライアントのインストール手順の概略を次に示します。

J2EEサーバを動作させるマシンに，アプリケーションサーバがサポートするバージョン番号のOracleクライアントをインストールします。

このとき，Oracle JDBC Thin Driverもインストールされます。

アプリケーションサーバがサポートするパッチレベル（パッチ番号）のパッチを適用します。

簡易構築定義ファイルに，Oracle JDBC Thin DriverのJARファイルのパスを指定します。

簡易構築定義ファイルを作成するときに，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグにOracle JDBC Thin DirverのJARファイルのパスを追加してください。簡易構築定義ファイルの作成については，「4.1.20　簡易構築定義ファイルを設定する」を参照してください。設定内容の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

J2EEサーバに，Oracle JDBC Thin Driver用のDB Connectorをインポートします。

DB Connectorのインポートについては，「4.1.26　DB Connectorを設定する（CUI利用時）」を参照してください。

Oracle JDBC Thin Driver用のDB Connectorは，2種類あります。トランザクションの管理方法によって，次のどちらかのファイルを選択してください。

DBConnector_Oracle_CP.rar

ローカルトランザクション，またはトランザクション管理なしで使用する場合（トランザクションのサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。Oracle JDBC Thin DriverのConnectionPoolDataSourceを使用してデータベースに接続します。

DBConnector_Oracle_XA.rar

グローバルトランザクションを使用する場合（トランザクションのサポートレベルにXATransactionを指定する場合）に選択します。Oracle JDBC Thin DriverのXADataSourceを使用してデータベースに接続します。

トランザクションの管理方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.4　トランザクション管理」を参照してください。

4.1.8　データベース接続環境を設定する（SQL Serverの設定）

J2EEアプリケーションからデータベースへ接続するためには，リソースアダプタとしてDB Connectorを使用します。また，DB Connectorを使用してデータベースに接続するためには，データベースに対応するJDBCドライバが必要です。

ここでは，DB Connectorを使用してSQL Serverに接続する際に必要なデータベース接続環境の設定について説明します。JDBCドライバはSQL ServerのJDBCドライバを使用します。この設定は，J2EEサーバを配置するホストで実施します。

なお，データベースを設定するときの注意事項については，「4.1.9　データベースを設定するときの注意事項」を参照してください。

(1)　データベース側での設定

DB Connectorを使用してSQL Serverに接続する場合は，データベースのマシン上にSQL Serverをインストールして初期設定を済ませておいてください。詳細については，SQL Serverのマニュアルを参照してください。また，SQL Serverに接続するためには，認証モードの設定が必要です。認証モードはインストール時に指定しますが，インストール後の変更もできます。

アプリケーションサーバで設定できるSQL Serverの認証モードは，設定できる認証方法によって，混合モードとWindows認証モードの2種類に分かれています。認証モード，および認証方法についてそれぞれ説明します。

認証モード

混合モード

Windows認証とSQL Server認証の両方の認証方法を使用できる認証モードです。

Windows認証モード

Windows認証を使用できる認証モードです。

認証方法

Windows 認証

SQL Serverのインスタンスへの接続の試行を検証するメカニズムの一つです。ユーザが，接続時にWindowsのユーザまたはグループによって識別されます。

SQL Server認証

SQL Serverのインスタンスへの接続の試行を検証するメカニズムの一つです。接続するには，SQL Server ログインIDおよびパスワードを指定する必要があります。SQL Serverインスタンスでは，ログインIDとパスワードの組み合わせが有効であることを確認してから接続します。

(2)　J2EEサーバ側での設定（SQL Server JDBC Driverの場合）

アプリケーションサーバがサポートするバージョンのSQL Server JDBC DriverのJARファイルを入手して，J2EEサーバのクラスパスに指定してください。JARファイルの入手方法とクラスパスの指定方法について説明します。

Microsoft社のホームページからアプリケーションサーバがサポートするバージョン番号のSQL Server JDBC Driverをダウンロードします。

J2EEサーバを動作させるマシンに，ダウンロードしたSQL Server JDBC Driverをインストールします。

J2EEサーバのユーザクラスパスにJARファイルを指定します。

指定するJARファイルは，<SQL Server JDBC Driverのインストールディレクトリ>¥sqljdbc_<バージョン>¥<language>ディレクトリ下にあるJDBCドライバのJARファイルです。

簡易構築定義ファイルでは，物理ティアの定義（<tier>タグの定義）のJ2EEサーバの定義で，<configuration>タグにJARファイルの設定を追加します。なお，指定内容については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
  <!-- Webシステムの属性定義 -->
  <web-system>
    <name>MyWebSystem</name>
      :
    <!-- 物理ティア(combined-tier)の定義 -->
    <tier>
      <tier-type>combined-tier</tier-type>
      <!-- SQLサーバを使用するための設定 -->
      <configuration>
        <logical-server-type>j2ee-server</logical-server-type>
        <param>
           <param-name>add.class.path</param-name>
           <param-value><SQL Server JDBC DriverのJARファイルのパスを指定></param-value>
      <!-- Windows認証を使用するための設定 -->
           <param-name>add.library.path</param-name>
           <param-value><SQL Server JDBC Driverのdllファイルを格納したディレクトリのパスを指定></param-value>
        </param>
      </configuration>
    </tier>
      :
  </web-system>
  <host>
    :
</model-definition>

注　背景色付きの太字の部分が編集部分です。

Windows認証を使用する場合は，JARファイルの設定に加えて，次の設定も必要となります。

Windows認証を使用する場合に必要となる設定について説明します。

J2EEサーバのコンテナ拡張ライブラリのJNI用ライブラリの検索パスにdllファイルが格納されているディレクトリを指定します。

指定するディレクトリは，<SQL Server JDBC Driverのインストールディレクトリ>¥sqljdbc_<バージョン>¥<language>¥auth¥<x64>ディレクトリです。

J2EEサーバに，SQL Server用のDB Connector（DBConnector_SQLServer_CP.rar）をインポートします。

DB Connectorの詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.6　データベースへの接続」を参照してください。

cjimportresコマンドを使用して，DBConnector_SQLServer_CP.rarをインポートしてください。

(3)　タイムアウトの設定

必要に応じて，SQL Serverのタイムアウトを設定してください。タイムアウトの設定については，マニュアル「アプリケーションサーバ システム設計ガイド」の「8.6.6　データベースでのタイムアウトを設定する」を参照してください。

4.1.9　データベースを設定するときの注意事項

DB Connectorを使用する場合，DB Connectorで使用するJDBCドライバのJARファイルは，コンテナ拡張ライブラリとして設定します。アプリケーション内に含めている場合は，アプリケーション内から削除してください。

4.1.10　環境変数とは

アプリケーションサーバで設定する環境変数には，Application Serverが参照する環境変数と，Management Serverを使用して構築した論理サーバが参照する環境変数があります。Application Serverが参照する環境変数をシステムの環境変数といい，論理サーバが参照する環境変数を論理サーバの環境変数といいます。

4.1.11　システムの環境変数を設定する

Management Serverを使用してシステムを構築する場合には，次に示すシステムの環境変数を設定します。システムの環境変数の設定方法については，OSのドキュメントを参照してください。この設定は，各ホストで実施します。

CJMEMDUMP_PATH（Windowsの場合）

論理J2EEサーバが強制停止された場合に，ユーザダンプを取得するときは，ユーザダンプの出力先ディレクトリを設定します。

ユーザダンプファイル（cjmemdump.dmp）は，この環境変数に設定したディレクトリ下に作成されます。

（例）環境変数CJMEMDUMP_PATHに「C:¥temp」を設定した場合

C:¥temp¥cjmemdump.dmp

この環境変数を設定する場合は，次の点に注意してください。

adminagent.properties（運用管理エージェントプロパティファイル）のadminagent.forcestop.threaddumpキーには，「true」を指定してください。「true」を指定していない場合，環境変数CJMEMDUMP_PATHを設定してもユーザダンプは出力されません。

環境変数CJMEMDUMP_PATHには，存在するディレクトリを設定してください。ディレクトリが存在しない場合，ユーザダンプは出力されません。

cjmemdump.dmpが，環境変数CJMEMDUMP_PATHに設定したディレクトリにある場合，そのファイルは上書きされます。

TZ（OS共通）

タイムゾーンを指定します。通常は，「JST-9」を指定してください。ほかの値も指定できます。

注意事項

（Windowsの場合）

環境変数ComSpecは，Windowsのインストール時に，システム環境変数として設定されます。環境変数ComSpecがない場合，PRFの起動に失敗するなどの問題が発生します。環境変数ComSpecが設定されていることを確認して，存在しない場合には，コマンドラインインタプリタ（cmd.exeなど）のフルパスを設定してください。

4.1.12　論理サーバの環境変数を設定する

Management Serverを使用する場合には，次の定義個所で論理サーバに環境変数が設定できます。この設定は，各ホストで実施します。論理サーバの環境変数の設定時の確認事項については，「4.1.13　論理サーバの環境変数を設定するときの確認事項」を参照してください。

簡易構築定義ファイルもしくは構成変更定義ファイルのuser.env.variableパラメタ，または運用管理ポータルの［環境変数の設定］画面

adminagent.xml（運用管理エージェント設定ファイル）

OSの環境変数（Windowsの場合はシステム環境変数，UNIXの場合は運用管理エージェントを起動するシェルでの環境変数）

同一の環境変数をそれぞれの定義個所で設定している場合は，1.，2.，3.の順序で設定値が優先され，論理サーバに設定されます。

2.（adminagent.xml）には，インストール時点で環境変数が設定されています。3.（OSの環境変数）で，2.（adminagent.xml）に設定されている環境変数を設定しても，設定は有効になりません。このため，論理サーバの環境変数は，1.（簡易構築定義ファイル，構成変更定義ファイル，運用管理ポータル），または2.（adminagent.xml）で設定することをお勧めします。

注意事項

Windowsの場合，論理Webサーバに設定した環境変数はHTTP Serverのサービスプログラム（制御プロセス，サーバプロセス）には引き継がれません。そのため，CGIプログラムなどから参照できません。

4.1.13　論理サーバの環境変数を設定するときの確認事項

インストール時点でadminagent.xml（運用管理エージェント設定ファイル）には，Management Serverが自動で設定する論理サーバの環境変数が設定されます。Management Serverが自動で設定する論理サーバの環境変数をOSごとに次の表に示します。

表4‒6　Management Serverが自動で設定する論理サーバの環境変数（Windowsの場合）

論理サーバ

環境変数

設定値

論理パフォーマンストレーサ

Path

${cosminexus.home}¥PRF¥bin;%{Path}

論理スマートエージェント

Path

${cosminexus.home}¥TPB¥bin;%{Path}

TPDIR

${cosminexus.home}¥TPB

VBROKER_ADM

${cosminexus.home}¥TPB¥adm

論理ネーミングサービス

CLASSPATH

設定されません。

Path

${cosminexus.home}¥jdk¥bin;${cosminexus.home}¥TPB¥bin;%{Path}

TPDIR

${cosminexus.home}¥TPB

VBROKER_ADM

${cosminexus.home}¥TPB¥adm

論理CTMドメインマネジャ

CTMDIR

${cosminexus.home}¥CTM

Path

${cosminexus.home}¥CTM¥bin;${cosminexus.home}¥TPB¥bin;%{Path}

TPDIR

${cosminexus.home}¥TPB

VBROKER_ADM

${cosminexus.home}¥TPB¥adm

論理CTM

CTMDIR

${cosminexus.home}¥CTM

Path

${cosminexus.home}¥CTM¥bin;${cosminexus.home}¥TPB¥bin;%{Path}

TPDIR

${cosminexus.home}¥TPB

VBROKER_ADM

${cosminexus.home}¥TPB¥adm

論理J2EEサーバ

Path

${cosminexus.home}¥CTM¥bin;${cosminexus.home}¥jdk¥bin;{cosminexus.home}¥TPB¥bin;{cosminexus.home}¥PRF¥bin;%{Path}

TPDIR

${cosminexus.home}¥TPB

VBROKER_ADM

${cosminexus.home}¥TPB¥adm

表4‒7　Management Serverが自動で設定する論理サーバの環境変数（UNIXの場合）

論理サーバ

環境変数

設定値

論理パフォーマンストレーサ

PATH

${cosminexus.home}/PRF/bin:${PATH}

ライブラリパス※1

${cosminexus.home}/PRF/lib:%{ライブラリパス※1}

AIXTHREAD_SCOPE※2

S

EXTSHM※2

ON

LDR_CNTRL※2

MAXDATA=0x40000000

NODISCLAIM※2

true

PSALLOC※2

early

論理スマートエージェント

PATH

${cosminexus.home}/TPB/bin:/bin:/usr/bin:${PATH}

TPDIR

${cosminexus.home}/TPB

VBROKER_ADM

${cosminexus.home}/TPB/adm

ライブラリパス※1

${cosminexus.home}/TPB/lib:/opt/hitachi/common/lib:%{ライブラリパス※1}

AIXTHREAD_COND_DEBUG※2

設定されません。

AIXTHREAD_MUTEX_DEBUG※2

設定されません。

AIXTHREAD_RWLOCK_DEBUG※2

設定されません。

AIXTHREAD_SCOPE※2

S

NODISCLAIM※2

true

PSALLOC※2

early

論理ネーミングサービス

CLASSPATH

設定されません。

PATH

AIXの場合

${cosminexus.home}/jdk/bin:${cosminexus.home}/TPB/bin:/usr/bin:${PATH}

Linuxの場合

${cosminexus.home}/jdk/bin:${cosminexus.home}/TPB/bin:/bin:/usr/bin:${PATH}

TPDIR

${cosminexus.home}/TPB

VBROKER_ADM

${cosminexus.home}/TPB/adm

ライブラリパス※1

${cosminexus.home}/TPB/lib:${ライブラリパス※1}

AIXTHREAD_SCOPE※2

S

NODISCLAIM※2

true

PSALLOC※2

early

論理CTMドメインマネジャ

CTMDIR

${cosminexus.home}/CTM

PATH

${cosminexus.home}/CTM/bin:${cosminexus.home}/TPB/bin:%{PATH}

TPDIR

${cosminexus.home}/TPB

VBROKER_ADM

${cosminexus.home}/TPB/adm

ライブラリパス※1

${cosminexus.home}/CTM/lib:${cosminexus.home}/TPB/lib:${ライブラリパス※1}

AIXTHREAD_SCOPE※2

S

EXTSHM※2

ON

LDR_CNTRL※2

MAXDATA=0x40000000

PSALLOC※2

early

NODISCLAIM※2

true

論理CTM

CTMDIR

${cosminexus.home}/CTM

PATH

${cosminexus.home}/CTM/bin:${cosminexus.home}/TPB/bin:%{PATH}

TPDIR

${cosminexus.home}/TPB

VBROKER_ADM

${cosminexus.home}/TPB/adm

ライブラリパス※1

${cosminexus.home}/CTM/lib:${cosminexus.home}/TPB/lib:${ライブラリパス※1}

AIXTHREAD_SCOPE※2

S

EXTSHM※2

ON

LDR_CNTRL※2

MAXDATA=0x40000000

PSALLOC※2

early

NODISCLAIM※2

true

論理J2EEサーバ

CSCCFJ_SERVER_HOME

${cosminexus.home}/CC

PATH

${cosminexus.home}/jdk/bin:${cosminexus.home}/TPB/bin:${cosminexus.home}/PRF/bin:/bin:/usr/bin:${PATH}

TPDIR

${cosminexus.home}/TPB

VBROKER_ADM

${cosminexus.home}/TPB/adm

ライブラリパス※1

${cosminexus.home}/TPB/lib: ${cosminexus.home}/PRF/lib:${cosminexus.home}/CTM/lib:/opt/hitachi/common/lib:${ライブラリパス※1}

AIXTHREAD_COND_DEBUG※2

OFF

AIXTHREAD_MUTEX_DEBUG※2

OFF

AIXTHREAD_RWLOCK_DEBUG※2

OFF

AIXTHREAD_SCOPE※2

S

EXTSHM※2

ON

NODISCLAIM※2

true

PSALLOC※2

early

論理Webサーバ

PATH

${cosminexus.home}/PRF/bin:${PATH}

ライブラリパス※1

${cosminexus.home}/PRF/lib:${ライブラリパス※1}

NODISCLAIM※2

true

PSALLOC※2

early

注※1　ライブラリパスに指定する環境変数名は，OSごとに異なります。

AIXの場合：LIBPATH

Linuxの場合：LD_LIBRARY_PATH

注※2　AIX固有の環境変数です。AIX以外のOSには該当しません。

4.1.14　運用管理機能を構築する

Management Serverをセットアップして，運用管理機能を構築する手順について説明します。運用管理機能の構築時に使用する情報については，「4.1.15　Management Serverを使用するために設定する情報」および「4.1.16　運用管理エージェントを使用するために設定する情報」を参照してください。この設定は，Management Serverを配置するホストで実施します。ここでは，Management Serverは，J2EEサーバを配置するホストに配置しています。また，ホストの起動と同時にManagement Serverおよび運用管理エージェントを起動するように設定しています。

J2EEサーバを配置するホストでコマンドプロンプトを起動します。

mngsvrctlコマンドのサブコマンド「setup」を実行し，Management Serverをセットアップします。

コマンドの実行例を次に示します。ここでは，管理ユーザIDに「admin」，管理ユーザパスワードに「admin」を設定するとします。

mngsvrctl setup -u admin -p admin

mngautorunコマンドを実行し，ホストの起動と同時にManagement Serverおよび運用管理エージェントを起動するように設定します。

コマンドの実行例を次に示します。

mngautorun both -sync

参考

Management Serverおよび運用管理エージェントを障害発生時に自動再起動させる設定もできます。また，UNIXの場合は，ホストの停止と同時にManagement Serverおよび運用管理エージェントを停止するように設定できます。Management Serverおよび運用管理エージェントの自動再起動および自動停止の設定については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の次の個所を参照してください。

2.6.4　自動再起動の設定

2.6.5　自動停止の設定

Management Serverの環境を設定します。

Management Serverを使用するために設定する情報には，次のようなものがあります。「4.1.15　Management Serverを使用するために設定する情報」を参照して，設定します。

Management Serverが使用するポート番号

Management Serverへのアクセスを許可するホスト

Management Serverを使用するユーザアカウント

Management Serverが出力するログに関する情報

運用管理エージェントの環境を設定します。

運用管理エージェントを使用するために設定する情報には，次のようなものがあります。「4.1.16　運用管理エージェントを使用するために設定する情報」を参照して，設定します。

運用管理エージェントが使用するポート番号

運用管理エージェントによる論理サーバの監視に関する情報（動作確認レベルや，動作確認間隔など）

HTTP Serverの動作確認に関する情報

4.1.15　Management Serverを使用するために設定する情報

Management Serverを使用するために設定する情報について説明します。なお，Management Serverを使用する際には，管理ユーザアカウントを設定しない運用もできます。

(1)　Management Serverのプロパティの設定

Management Serverのプロパティファイル（mserver.properties）で，Management Serverが使用するポート番号や，Management Serverへのアクセスを許可するホストなどを指定できます。

mserver.propertiesに指定するキーを次に示します。キーの詳細，およびここで説明していないキーについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.6　mserver.properties（Management Server環境設定ファイル）」を参照してください。

adminagent.connector.comm.state.cache_max_time

運用管理エージェントとの通信状態をキャッシュする最大時間を指定します。

webserver.connector.ajp13.port

Management Server内部通信用ポート番号を指定します。

webserver.connector.http.port

Management Server接続HTTPポート番号を指定します。

webserver.shutdown.port

Management Server終了要求受信ポート番号を指定します。

webserver.connector.http.permitted.hosts

Management Serverへのアクセスを許可するホストおよび運用管理エージェント稼働ホストの，IPアドレスまたはホスト名を指定します。

mngsvr.myhost.name

運用管理機能（Management Server）を配置するホストに，論理サーバを配置するホスト（アプリケーションサーバ）からアクセス可能なIPアドレス，またはそのIPアドレスを示すホスト名を指定します。運用管理機能（Management Server）を配置するホストが複数個のIPアドレスを持っていて，ホスト名が意図するIPアドレスに変換されないおそれがある場合に，このキーを指定します。

これらのキーのほかに，mserver.propertiesでは次の設定ができます。

snapshotログ収集や障害検知時コマンドによる資料取得のためのキーを設定できます。snapshotログ収集の設定，および障害検知時コマンドによる資料取得のための設定については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の次の個所を参照してください。

3.3.1　障害検知時コマンドによる資料取得の設定（J2EEアプリケーションを実行するシステム）

3.3.2　障害検知時コマンドによる資料取得の設定（バッチアプリケーションを実行するシステム）

3.3.3　snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）

3.3.4　snapshotログ収集の設定（バッチアプリケーションを実行するシステム）

管理ユーザアカウントを設定しないでManagement Serverにログインすることもできます。この場合，管理ユーザアカウントの省略機能を有効にします。機能の設定については，「(3)　管理ユーザアカウントを設定しない場合の設定」を参照してください。

また，必要に応じて，cmxserver.properties（サーバ設定プロパティファイル）で，Smart Composer機能で使用するコマンドの実行環境を設定します。

cmxserver.propertiesに指定するキーを次に示します。

cmx.max_wait_time

共通オプション-waitを指定して実行したコマンドに有効で，すでに実行しているコマンドの完了を待つときの最大待ち時間を指定します。デフォルトで，180秒が設定されています。

(2)　Management Serverの動作環境の設定

mngsvrctlコマンドやManagement Serverのプロパティで，Management Serverを利用するユーザのアカウント情報，Management Serverが出力するログ情報など，Management Serverの動作環境を設定してください。

Management Serverの動作環境の設定内容を次の表に示します。

表4‒8　Management Serverの動作環境の設定内容

設定項目

設定内容

設定の要否

管理ユーザアカウントの設定

Management Serverのセットアップ時に管理ユーザアカウントを設定していない場合は，mngsvrctlコマンドに引数「setup」を指定して実行するか，または運用管理ポータルの［管理ユーザアカウントの設定］画面で設定します。

○※

ログの設定

mserver.propertiesまたは運用管理ポータルの［ログの設定］画面で，Management Serverが出力するログのログレベル，ファイル数，サイズなどを設定します。

次のキーを指定します。

com.cosminexus.mngsvr.log.levelキーに，Management Serverのログの出力レベルを指定します。

com.cosminexus.mngsvr.log.rotateキーに，Management Serverのログのファイル面数を指定します。

com.cosminexus.mngsvr.log.sizeキーに，Management Serverのログのファイルサイズを指定します。

△

開始時の設定

mserver.propertiesまたは運用管理ポータルの［開始時の設定］画面で，Management Serverを起動するときに，論理サーバを一括起動するかどうかを設定します。一括起動する場合には，この設定が必要です。

△

性能解析トレース収集の設定

mserver.propertiesまたは運用管理ポータルの［性能解析トレース収集の設定］画面で，com.cosminexus.mngsvr.traceキーに，Management Serverで保持する性能解析トレースファイルの面数を設定します。

△

JP1連携の設定

mserver.propertiesまたは運用管理ポータルの［JP1連携の設定］画面で，com.cosminexus.mngsvr.jp1event.enabledキーに，Management Serverの障害情報（検知した障害や論理サーバの起動の通知など）をJP1イベントとして発行するかどうかを指定します。このほかに，com.cosminexus.mngsvr.jp1eventから始まるキーで，Management Serverの障害情報をJP1へ通知するための設定をします。JP1と連携する機能を利用する場合には，この設定が必要です。JP1との連携については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「12.　JP1と連携したシステムの運用」を参照してください。

△

（凡例）

○：設定します。

△：デフォルトの設定を変更する場合，特定の機能を使用する場合に設定します。

注※

Management Serverのセットアップ時に，管理ユーザアカウントを設定している場合は，設定不要です。ただし，セットアップ時に設定した管理ユーザアカウントを変更したい場合は，mngsvrctlコマンドを使用して再設定してください。

(3)　管理ユーザアカウントを設定しない場合の設定

管理ユーザアカウントとは，運用管理ポータルにログインしたり，Management Serverに対してコマンド（例：mngsvrutilコマンド）を実行したりするときに使用するユーザ権限です。管理ユーザアカウントの設定はManagement Serverのセットアップ時などに実施しますが，管理ユーザアカウントを設定しないでManagement Serverを使用することもできます。管理ユーザアカウントを設定しない場合，運用管理ポータルの操作およびManagement Serverに対してコマンドを実行するときには次のようになります。

運用管理ポータルの［ログイン］画面が表示されません。URLを指定するとログインなしで運用管理ポータルを使用できます。

Management Serverに対するコマンドの実行時に，-u（管理ユーザID）および-p（管理ユーザパスワード）の指定が不要になります。これらのオプションを指定しなくても，コマンドを実行できます。

管理ユーザアカウントを設定しない場合は，mserver.propertiesのcom.cosminexus.mngsvr.management_user_account.enabledキーにfalseを設定します。ただし，管理ユーザアカウントを設定していないと，だれでも運用管理ポータルやコマンドの実行を通してManagement Serverを操作できます。複数人でManagement Serverを操作するような運用環境の場合は，管理ユーザアカウントを設定することをお勧めします。

4.1.16　運用管理エージェントを使用するために設定する情報

運用管理エージェントを使用するために設定する情報について説明します。

(1)　運用管理エージェントのプロパティの設定

運用管理エージェントのプロパティファイル（adminagent.properties）で，運用管理エージェントが使用するポート番号などを指定できます。

adminagent.adapter.port

運用管理エージェントがManagement Serverとの通信に使用するポート番号を指定します。

また，このほかにsnapshotログの収集先も設定できます。snapshotログの収集先の設定については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の次の個所を参照してください。

3.3.3　snapshotログ収集の設定（J2EEアプリケーションを実行するシステム）

3.3.4　snapshotログ収集の設定（バッチアプリケーションを実行するシステム）

(2)　運用管理エージェントによる論理サーバの監視に関する設定

システムを運用する場合には，Management Serverの運用管理コマンド（mngsvrutil）を使用して論理サーバのステータスを確認することで，論理サーバの起動／停止状態がわかります。Management Serverで論理サーバを管理する場合には，運用管理エージェントが定期的に論理サーバのプロセス監視および動作確認を実施し，論理サーバのステータスをManagement Serverに通知します。運用管理エージェントが論理サーバの動作確認をするときのレベルや間隔の設定は変更できます。必要に応じて，論理サーバの動作確認に関する項目をadminagent.propertiesで設定してください。なお，障害発生時の論理サーバの自動再起動については，マニュアル「アプリケーションサーバ機能解説 運用／監視／連携編」の「2.4.3　論理サーバの自動再起動」を参照してください。

参考

Management ServerでWebサーバの動作確認をする場合，動作確認用のログを通常のログ（エラーログ，アクセスログ，リクエストログなど）と別に出力できます。設定方法については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「3.3.8　Webサーバのログ取得の設定」を参照してください。

論理サーバの動作確認レベルの設定

運用管理エージェントでは，論理サーバが正常に動作しているかどうかを，プロセスの存在を確認したり，論理サーバにアクセスしたりすることで判断します。論理サーバの動作確認レベルは，adminagent.<論理サーバの種類>.watch.levelキーに指定します。必要に応じて，論理サーバの動作確認レベルを変更してください。指定できる値は「1」または「2」です。「1」はプロセスの存在を確認するだけで論理サーバの動作を確認します。また，「2」はプロセスの存在を確認し，実際に論理サーバにアクセスして動作を確認します。指定できる値は論理サーバの種類によって異なります。なお，WebサーバでSSL通信だけを有効にしている場合，論理Webサーバの動作確認レベルはプロセスの存在を確認するだけに変更（adminagent.hws.watch.level=1を設定）してください。

論理サーバの動作確認間隔の設定

論理サーバの動作確認の間隔（秒）は，adminagent.<論理サーバの種類>.watch.intervalキーに指定します。デフォルトは10秒です。必要に応じて，論理サーバの動作確認間隔を変更してください。

論理サーバの動作確認間隔を変更する場合は，論理サーバの動作確認間隔（秒）が停止監視時間（分）または強制停止監視時間（分）よりも短くなるようにしてください。動作確認の間隔が論理サーバの監視時間以上の場合は，論理サーバの停止または強制停止に失敗することがあります。

論理サーバの動作確認タイムアウトの設定

論理サーバの動作確認のタイムアウト時間（秒）は，adminagent.<論理サーバの種類>.watch.timeoutキーに指定します。デフォルトは60秒です。必要に応じて，論理サーバの動作を確認するときのタイムアウト時間を変更してください。

論理サーバの動作確認リトライの設定

論理サーバの動作確認のリトライ回数は，adminagent.<論理サーバの種類>.watch.retry_countキーに指定します。デフォルトは1回です。

また，adminagent.watch.retry_timeout.enabledキーでは，タイムアウトの発生をリトライの対象にするかどうかを指定できます。デフォルトはfalse（リトライの対象にしない）です。なお，新規インストール時はtrue（リトライの対象にする）が指定されています。

必要に応じて，論理サーバの動作を確認するときのリトライの設定を変更してください。

論理サーバの動作確認の開始時間の設定

論理サーバを起動してから動作確認（動作確認レベル2）を開始するまでの時間（秒）は，adminagent.<論理サーバの種類>.watch.start_timeキーに指定します。デフォルト値は論理サーバの種類によって異なります。必要に応じて，論理サーバの動作確認の開始時間を変更してください。

なお，論理サーバの動作確認の開始時間を変更する場合は，「論理サーバの動作確認の開始時間（秒） ＜ 論理サーバの起動監視時間（分）」となるように注意してください。論理サーバの起動監視時間は，運用管理ポータルの「論理サーバの起動／停止」の［起動／停止の設定］画面で設定できます。起動監視時間が動作確認の開始時間よりも小さい場合は，論理サーバの起動に失敗します。

(3)　HTTP Serverの動作確認の設定

Management Serverでは，WebサーバとしてHTTP Serverを管理できます。HTTP Serverの動作確認は，Webサーバ定義ファイル（httpsd.conf）の最後のListenディレクティブのポート番号に対して，httpでリクエストを送信することで実施します。そのため，最後のListenディレクティブでSSLが有効になっている場合は動作確認できません。最後のListenディレクティブはSSLを無効にしてください。また，Webサーバ定義ファイル（httpsd.conf）内のすべてのListenディレクティブでSSLが有効になっている場合は，HTTP ServerへのアクセスでHTTP Serverの動作確認を実施しないで，プロセスの存在確認だけを実施します。WebサーバがSSL有効・無効を判定できなかった場合，Webサーバの起動監視はしないで，タイムアウトによって停止処理をします。タイムアウトするまでの間，Webサーバは稼働状態の可能性があります。

ここでは，動作確認用HTTPメソッドの設定，およびHTTP Serverの動作確認用URLの設定について説明します。ただし，HTTP Server動作確認用URLは，動作確認用HTTPメソッドの設定で「HEAD」を指定している場合にだけ設定できます。

動作確認用HTTPメソッドの設定

論理サーバの動作確認レベル（adminagent.<論理サーバの種類>.watch.levelキー）で，「2」を指定（プロセスの存在を確認し，実際に論理サーバにアクセスして動作を確認する）した場合のHTTP Serverの動作確認用HTTPメソッドを指定します。指定できる値は「HEAD」または「OPTIONS」です。「HEAD」を指定した場合は，HTTP Server動作確認用URL（adminagent.hws.watch.urlキー）で指定されたURLにアクセスして応答が返ることを確認します。また，「OPTIONS」を指定した場合は，WebサーバがHTTPメソッドを受け付け可能な状態であるかを確認します。

なお，「OPTIONS」を指定した場合，HTTP Serverの設定で，ルートディレクトリに対してすべてのホストからのアクセスを禁止していると，運用管理エージェントからの動作確認アクセスも拒否されてしまうため，正しく稼働判定できなくなり，HTTP Serverの起動に失敗します。その場合，ループバックアドレス（ホストの固定をしている場合は固定したIPアドレス）からのアクセスを許可する必要があります。Basic認証の設定をしている場合など，アクセスを制限している場合も正しく稼働判定できなくなるので注意してください。

HTTP Server動作確認用URLの設定

運用管理エージェントは，HTTP Serverが正常に動作しているかどうかを，設定したURLに対して定期的にダミーアクセスをすることで判断します。ダミーアクセスのレスポンスが返らないような状態（無応答の状態）になると，HTTP Serverが異常と判断し，障害を検出します。このため，Webサーバを使用する場合には，動作確認用URLとして実際にアクセスできるURLを設定してください。HTTP Server動作確認用URLは，adminagent.hws.watch.urlキーに指定します。

URLには，httpで始まる絶対パス，またはルートコンテキストからの相対パスを指定してください。デフォルト値は，ルートコンテキスト（http://localhost:<ポート番号>/）です。同一のホストに複数のWebサーバを構築する場合は相対パスで指定してください。

（例）

動作確認用URLに「http://HostA:80/index.html」を指定する場合の例を次に示します。

adminagent.hws.watch.url=http://HostA:80/index.html

動作確認用URLに「http://localhost:<ポート番号>/index.html」を指定する場合（複数Webサーバ対応）の例を次に示します。

adminagent.hws.watch.url=index.html

4.1.17　運用管理エージェントを起動する

アプリケーションサーバごとにコマンドプロンプトを起動し，adminagentctlコマンドを実行して，運用管理エージェントを起動します。Windowsの場合はサービスからも起動できます。

コマンドの実行例を次に示します。

adminagentctl start -sync

4.1.18　Management Serverを起動する

Management Serverをセットアップしたホスト（J2EEサーバを配置するホスト）でコマンドプロンプトを起動し，mngsvrctlコマンドを実行して，Management Serverを起動します。Windowsの場合はサービスからも起動できます。

コマンドの実行例を次に示します。

mngsvrctl start -sync

4.1.19　簡易構築定義ファイルとは（J2EEアプリケーション使用時）

簡易構築定義ファイルとは，Smart Composer機能のコマンドで構築するWebシステムを定義するXML形式のファイルです。

(1)　簡易構築定義ファイルの構成

簡易構築定義ファイルでは，Webシステムの次の構成について設定します。

Webシステムの属性定義（<web-system>タグの定義）

負荷分散機の定義（<load-balancer>タグの定義）※1

cookieスイッチングの定義（<load-balancer>タグの<cookie-switching>タグの定義）※2

仮想サーバの定義（<load-balancer>タグの<virtual-server>タグの定義）

物理ティアの定義（<tier>タグの定義）

物理ティアに属する論理サーバの種類ごとの定義（<tier>タグの<configuration>タグの定義）

データベースを使用するための定義（<tier>タグの<configuration>タグの定義）※3

サービスユニットの定義（<unit>タグの定義）

サービスユニットを構成するホストの定義（<unit>タグの<allocation-host>タグの定義）

ホストが属する物理ティアの論理サーバごとの定義（<unit>タグの<allocation-host>タグの<define-server>タグの定義）

ホストの定義（<host>タグの定義）

注※1　

Smart Composer機能で負荷分散機の設定，および実サーバポートの開始・閉塞をしない場合は，負荷分散機の定義（<load-balancer>タグの定義）を記述する必要はありません。

注※2　

負荷分散機のCookieスイッチング機能を使用する場合に必要です。この設定によって，一連のHTTPリクエストが一つのWebサーバまたはJ2EEサーバで処理されます。また，負荷分散機のCookieスイッチング機能を使用する場合は，物理ティアの定義（<tier>タグ）で，J2EEサーバのWebコンテナの設定に「webserver.container.server_id.enabled=true」を指定してください。

注※3　

データベースを使用するための定義については，「4.1.6　データベース接続環境を設定する（HiRDBの設定）」，「4.1.7　データベース接続環境を設定する（Oracleの設定）」，または「4.1.8　データベース接続環境を設定する（SQL Serverの設定）」を参照してください。

J2EEアプリケーションを実行するシステムの構成情報と簡易構築定義ファイルの定義との対応を次の図に示します。

図4‒2　J2EEアプリケーションを実行するシステムの構成情報と簡易構築定義ファイルの定義との対応

この図に示すように，簡易構築定義ファイルでは，論理サーバの構成や環境設定だけでなく，負荷分散機やホストも定義できます。なお，構築済みのWebシステムなどで使用しているホストを使用する場合には，ホストの定義を省略することもできます。

簡易構築定義ファイルのタグおよびパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(2)　コンフィグレーション定義で使用するタグと適用範囲

論理サーバの動作設定や，機能を使用するための設定などは，論理サーバのコンフィグレーションで定義します。論理サーバのコンフィグレーションは，論理サーバ全体，および論理サーバごとに定義できます。論理サーバ全体で共通の定義を設定する場合は物理ティアで，論理サーバごとの定義を設定する場合はサービスユニットで定義します。物理ティアで定義すると，その物理ティアに属するホストに配置する論理サーバ全体で共通のコンフィグレーションが設定されます。物理ティアおよびサービスユニットのコンフィグレーション定義で，同じパラメタを指定した場合は，サービスユニットの定義，物理ティアの定義の順に優先して適用されます。なお，Management Serverが自動設定する内容については，「付録E　Management Serverが自動で設定する内容」を参照してください。

論理サーバのコンフィグレーション定義の適用範囲を次の図に示します。

図4‒3　論理サーバのコンフィグレーション定義の適用範囲

コンフィグレーション定義時に使用する簡易構築定義ファイルの主なタグを次の表に示します。

表4‒9　論理サーバのコンフィグレーション定義時に使用する簡易構築定義ファイルの主なタグ

タグ名称

説明

<configuration>

論理サーバの動作環境を設定します。動作環境を設定する論理サーバの種類は，<logical-server-type>タグで指定します。

<configuration>タグは，物理ティアの定義（<tier>タグ内），およびサービスユニットの定義（<unit>タグ内）に設定できます。<tier>タグ内または<unit>タグ内のどちらの<configuration>タグに設定するかによって，設定内容を適用する論理サーバの範囲が異なります。論理サーバ全体で共通の設定を変更したい場合は，<tier>タグ内の<configuration>タグを編集し，特定の論理サーバの設定を変更したい場合は，<unit>タグ内の<configuration>タグを編集します。

<logical-server-type>

<configuration>タグで動作環境を設定する論理サーバの種類を定義します。論理サーバの種類を次に示します。

論理Webサーバ：web-server

論理J2EEサーバ：j2ee-server

論理パフォーマンストレーサ：performance-tracer

論理CTMドメインマネジャ：ctm-domain-manager

論理CTM：component-transaction-monitor

論理スマートエージェント：smart-agent

論理ユーザサーバ：user-server（<tier>タグ内には定義できません）

<param>

論理サーバの動作環境を設定するパラメタ（パラメタ名と値の組み合わせ）を定義します。1種類のパラメタごとに<param>タグで囲んで定義します。

<param-name>

論理サーバの動作環境を設定するパラメタの名称を定義します。

<param-value>

<param-name>タグで指定したパラメタの設定値を定義します。

注　各論理サーバの<configuration>タグ内で，パラメタ名（<param-name>タグ）と値（<param-value>タグ）の設定を省略すると，論理サーバの動作環境にはデフォルトの値が設定されます。デフォルトの設定のままで利用する場合は，定義不要です。デフォルトで設定されている動作を変更したい場合や，アプリケーションサーバの機能を有効にしたい場合は，パラメタと値の設定を追加または変更してください。

4.1.20　簡易構築定義ファイルを設定する

簡易構築定義ファイルを設定する手順について説明します。簡易構築定義ファイル設定時の注意事項については，「4.1.21　簡易構築定義ファイルを設定するときの注意事項（J2EEアプリケーション使用時）」を参照してください。

簡易構築定義ファイルのテンプレートファイル（cmxdefcombinedmodel.xml）を任意の場所にコピーします。

簡易構築定義ファイルのテンプレートファイルは，次の場所に提供されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥templates¥cmxdefcombinedmodel.xml

UNIXの場合

/opt/Cosminexus/manager/config/templates/cmxdefcombinedmodel.xml

注意事項

互換モードを使用する場合は，「cmxdefcombinedmodel.xml」を「cmxdefcombinedmodel_V9.xml」に読み替えてください。

参考

テンプレートファイルの文字エンコーディングは，UTF-8です。テンプレートファイルの内容は，セットアップウィザードで「標準セットアップ」を選択して，データベース接続環境を設定しない状態でセットアップした場合と同じシステム構成です。

手順1.のテンプレートファイルを任意の名称に変更します。

テキストエディタなどを利用して，簡易構築定義ファイルに手順3.〜手順7.の情報を定義します。

Management Serverで運用するWebシステム名，Webシステムの表示名などを定義します。

1Webシステムは，<web-system>タグから</web-system>タグまでの範囲に定義します。

負荷分散機を使用する場合は，<load-balancer>タグを追加して，使用する負荷分散機の種類や，管理用のIPアドレスなどを定義します。

負荷分散機を使用しないシステムの場合，負荷分散機の定義は不要です。

システム構成やJ2EEアプリケーションで使用する機能に応じて，物理ティアを定義します。必要に応じて，論理サーバ全体で共通のコンフィグレーションを定義します。

システム構成やJ2EEアプリケーションで使用する機能に応じて，その機能を実現するために必要な論理サーバが決定されます。Smart Composer機能では，同一のデプロイメント（論理サーバの配置，定義設定など）を適用するホスト（サーバマシン）の集合を物理ティアという単位で定義します。物理ティアは，<tier>タグから</tier>タグまでの範囲に，物理ティアの種類や，論理サーバ全体で共通のコンフィグレーションなどを定義します。

論理サーバ（サービスユニット）を配置するホストを定義します。必要に応じて，論理サーバごとのコンフィグレーションを定義します。

Smart Composer機能では，論理サーバの集合をサービスユニットという単位で定義します。サービスユニットは，<unit>タグから</unit>タグまでの範囲に，サービスユニットを配置するホストや，そのホストが属する物理ティア，論理サーバごとのコンフィグレーションなどを定義します。

ホストを定義します。

物理ティアに属するホストのホスト名や，運用管理エージェントのホスト名などを定義します。ホストは，Webシステムに依存しません。Management Serverで定義済みのホストを利用する場合は，ホストの定義を省略できます。ホストは，<host>タグから</host>タグまでの範囲に定義します。

手順3.〜手順7.で定義した情報を保存します。

4.1.21　簡易構築定義ファイルを設定するときの注意事項（J2EEアプリケーション使用時）

簡易構築定義ファイルを設定するときの注意事項について説明します。

(1)　アプリケーションサーバの機能を有効にするための設定

簡易構築定義ファイルのコンフィグレーション定義では，デフォルトが設定されています。使用するアプリケーションサーバの機能によっては，デフォルトの設定では無効なものもあります。この場合は，簡易構築定義ファイルのパラメタと値を追加または変更して，機能を有効にする設定をします。なお，機能を使用するために設定する項目のうち，一部の設定項目は，簡易構築定義ファイルで定義できません。簡易構築定義ファイルで設定できない項目は，ほかのユーザ定義ファイルを使用して定義します。

例えば，J2EEサーバが使用するネーミングサービス，トランザクション，コネクション，コンテナ，ログ，セキュリティの設定を変更したい場合，J2EEサーバのJavaVMの起動オプションなどを変更したい場合などには，簡易構築定義ファイルで設定を変更します。簡易構築定義ファイルに，テキストエディタなどを使用して，変更対象のパラメタ名と変更後の値を設定します。ただし，J2EEサーバのセキュリティポリシーとWebアプリケーションのプロパティを変更したい場合には，Management Serverでは設定できません。簡易構築定義ファイル以外のユーザ定義ファイル（server.policy，hitachi_web.properties）をテキストエディタなどで編集して，動作設定を変更してください。

注意事項

server.policyまたはhitachi_web.propertiesを編集する場合は，編集対象のJ2EEサーバのセットアップが完了していることが前提になります。また，UNIXの場合，動作設定を変更するときには，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

(2)　AllTextパラメタでのhttpsd.confの直接設定

簡易構築定義ファイル作成時に，論理Webサーバ（web-server）の<configuration>タグ内のSetByパラメタで「text」を指定した場合に，AllTextパラメタでhttpsd.confを直接設定するときの注意事項について説明します。

Management Serverは，httpsd.confの最後に記述されたListenディレクティブの値で，Webサーバの動作確認をします。AllTextパラメタ内にListenディレクティブを複数記述するときには，動作確認で使用する値を最後に記述してください。

HWSGracefulStopTimeoutディレクティブの設定が必要になる場合があります。「4.8.4　HWSGracefulStopTimeoutディレクティブとManagerの停止監視時間の設定に関する注意点」を参照してください。

Webサーバのsnapshotログの収集対象を変更するときは，AllTextパラメタではなく，snapshotログ収集対象定義ファイルで編集してください。なお，デフォルトの収集対象は，<HTTP Serverのインストールディレクトリ>/servers/HWS_<論理Webサーバの実サーバ名>/logsです。

AllTextパラメタ内に次のIncludeディレクティブの指定があると，Webシステムの構築時に警告メッセージが出力されます。SetByパラメタで「text」を指定した場合には，次のIncludeディレクティブを指定しないでください。

Include <HTTP Serverのインストールディレクトリ>/servers/HWS_<論理Webサーバの実サーバ名>/conf/httpsd_manager.conf

(3)　一つのホストを複数のネットワークセグメントに接続する場合の環境設定での注意

ここでは，一つのホストを複数のネットワークセグメントに接続する場合に，環境設定で注意することについて説明します。

次の図に示すように，ホストが複数のネットワークセグメントに接続されていて，複数個のIPアドレスを持つ場合は，IPアドレスおよびホスト名の設定に注意が必要です。

図4‒4　一つのホストを複数のネットワークセグメントに接続している例

この図のようなシステム構成の場合，簡易構築定義ファイルのホストの定義では，次のように設定してください。

<host-name>タグには，次のどちらかを設定してください。

サーバ間，または負荷分散機とサーバ間の通信に使用するネットワークのIPアドレス

サーバ間，または負荷分散機とサーバ間の通信に使用するネットワークのホスト名

<agent-host>タグには，次のどちらかを設定してください。

Management Serverとサーバ間の通信に使用するネットワークのIPアドレス

Management Serverとサーバ間の通信に使用するネットワークのホスト名

次の表に示すパラメタでホスト名またはIPアドレスを指定して，使用するネットワークセグメントを特定してください。各論理サーバで固定にするパラメタを次の表に示します。

表4‒10　固定にするパラメタ

対象になる論理サーバ

パラメタ

対象になるホスト※

Webサーバ

Listen

運用ホスト

J2EEサーバ

mngagent.connector.host

管理ホスト

vbroker.se.iiop_tp.host

運用ホスト

webserver.connector.http.bind_host

運用ホスト

webserver.connector.nio_http.bind_host

運用ホスト

ネーミングサービス

ns.bind.host

運用ホストまたは管理ホスト（ユーザが選択）

CTM

ctm.NsBindHost

運用ホスト

注※　運用ホストとは，簡易構築定義ファイルの<host-name>タグに指定したホストです。管理ホストとは，簡易構築定義ファイルの<agent-host>タグに指定したホストです。

4.1.22　簡易構築定義ファイルの作成例

Webサーバを別ホストに配置するシステムを構築する場合の簡易構築定義ファイルの作成例について説明します。例題で使用する設定内容を次の表に示します。

表4‒11　例題で使用する設定内容（簡易構築定義ファイルの作成例）

分類

項目

設定例

システム全体

簡易構築定義ファイルの名称

MyWebSystemDef.xml

Webシステムの名称

MyWebSystem

サービスユニットの名称

unit1

Webサーバを配置するホスト

ホストの名称

apsv1

IPアドレス（管理IPアドレス）※

192.168.100.11

論理Webサーバの名称

MyWebSystem_HTTP01

論理パフォーマンストレーサの名称

MyWebSystem_PRF01

J2EEサーバを配置するホスト

ホストの名称

apsv2

IPアドレス（管理IPアドレス）※

192.168.100.12

論理J2EEサーバの名称

MyWebSystem_J2EE01

論理パフォーマンストレーサの名称

MyWebSystem_PRF02

注※　ネットワークが単一構成の場合，IPアドレスは，業務IPアドレスと管理IPアドレスの両方を兼ねます。

MyWebSystemDef.xmlの作成例

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
  <web-system>
    <name>MyWebSystem</name>
    <display-name>MyWebSystem</display-name>
    <description>This is a sample.</description>

    <!--Specify the configurations for the Tier.-->
    <tier>
      <tier-type>http-tier</tier-type>
    </tier>
    <tier>
      <tier-type>j2ee-tier</tier-type>
    </tier>

    <!--Specify the hosts for each Service Unit.-->
    <unit>
      <name>unit1</name>
      <allocated-host>
        <host-ref>apsv1</host-ref>
        <hosts-for>http-tier</hosts-for>
        <define-server>
          <logical-server-name>MyWebSystem_HTTP01</logical-server-name>
          <logical-server-type>web-server</logical-server-type>
        </define-server>
        <define-server>
          <logical-server-name>MyWebSystem_PRF01</logical-server-name>
          <logical-server-type>performance-tracer</logical-server-type>
        </define-server>
      </allocated-host>
      <allocated-host>
        <host-ref>apsv2</host-ref>
        <hosts-for>j2ee-tier</hosts-for>
        <define-server>
          <logical-server-name>MyWebSystem_J2EE01</logical-server-name>
          <logical-server-type>j2ee-server</logical-server-type>
        </define-server>
        <define-server>
          <logical-server-name>MyWebSystem_PRF02</logical-server-name>
          <logical-server-type>performance-tracer</logical-server-type>
        </define-server>
      </allocated-host>
    </unit>
  </web-system>

  <!--Specify the settings for the host.-->
  <host>
    <host-name>apsv1</host-name>※
    <agent-host>apsv1</agent-host>※
  </host>
  <host>
    <host-name>apsv2</host-name>※
    <agent-host>apsv2</agent-host>※
  </host>
</model-definition>

注※　IPアドレスの変更による影響を軽減できるように，<host-name>タグおよび<agent-host>タグは，IPアドレスではなくホスト名で指定することをお勧めします。ただし，ホスト名の変更が発生する場合は，<host-name>タグおよび<agent-host>タグにはIPアドレスを指定してください。Smart Composer機能を使用して，ホスト名を指定して構築したシステムでホスト名を変更する場合は，システムを再構築する必要があります。

4.1.23　システム環境を構築する

システムの一括構築では，情報モデルの生成，その情報モデルを基にしたWebサーバおよびJ2EEサーバのセットアップ，および各論理サーバの環境設定を一つのコマンドを使用して一括で実施します。

運用管理機能（Management Server）を配置するホスト（apsv2（192.168.100.12））でコマンドプロンプトを起動し，cmx_build_systemコマンドを実行して，システムを一括構築します。cmx_build_systemコマンドの-fオプションには，簡易構築定義ファイルを指定します。

コマンドの実行例を次に示します。ここでは，簡易構築定義ファイルの名称をMyWebSystemDef.xmlとします。

cmx_build_system -m 192.168.100.12 -u admin -p admin -f <MyWebSystemDef.xmlのファイルパス>

<MyWebSystemDef.xmlのファイルパス>には，MyWebSystemDef.xmlを格納したディレクトリのパスとファイル名（MyWebSystemDef.xml）を指定します。

4.1.24　システムを起動する（CUI利用時）

システムが稼働状態になると，サービスユニット内の論理サーバが起動されて，リクエストの受け付けや処理が実施されるようになります。

参考

論理サーバの起動順序は，デフォルトの設定を使用することをお勧めします。なお，論理サーバの起動順序は，簡易構築定義ファイルで各論理サーバの<configuration>タグ内にmstartup.noパラメタで設定できます。

運用管理機能（Management Server）を配置するホスト（apsv2（192.168.100.12））でコマンドプロンプトを起動し，cmx_start_targetコマンドを実行して，Webシステム内のすべてのサービスユニットを稼働状態で起動します。稼働状態にするには，-modeオプションに「ALL」を指定します。

コマンドの実行例を次に示します。ここでは，Webシステムの名称をMyWebSystemとします。

cmx_start_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode ALL -strict

cmx_start_targetコマンドの-sオプションには，簡易構築定義ファイル（MyWebSystemDef.xml）の<web-system>タグの<name>タグで指定したWebシステム名を指定します。

4.1.25　リソースアダプタの設定とは

J2EEサーバ上のJ2EEアプリケーションからデータベースに接続するためには，リソースアダプタを使用します。J2EEサーバでは，データベースのほかに，OpenTP1，SMTPサーバ，JavaBeansリソースなどのリソースが利用できます。リソースの種類によっては，接続にリソースアダプタを使用するものと，リソースアダプタを使用しないものがあります。リソースの種類と接続方法については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「3.3.1　リソースへの接続方法」を参照してください。

また，リソースの接続にDB Connectorを使用する場合と，ほかのリソースアダプタを使用する場合で，Connector属性ファイルの取得方法が異なります。DB Connectorを使用する場合は，システムを起動する前にConnector属性ファイルのテンプレートを利用して編集できます。DB Connector以外のリソースアダプタを使用する場合は，システムを起動したあと，Connector属性ファイルを取得し，編集します。また，リソースアダプタのインポートと開始には，サーバ管理コマンドを使用します。サーバ管理コマンドでのリソースアダプタの操作については，マニュアル「アプリケーションサーバアプリケーション設定操作ガイド」の「4.　リソースアダプタの設定」を参照してください。

4.1.26　DB Connectorを設定する（CUI利用時）

リソースアダプタとしてDB Connectorを使用する場合の設定手順について説明します。この設定は，J2EEサーバを配置するホストで実施します。例題で使用する設定内容を次の表に示します。

表4‒12　例題で使用する設定内容（DB Connectorの設定）

項目

設定例

リソースアダプタのファイル名

DBConnector_HiRDB_Type4_CP.rar※

リソースアダプタの表示名

DB_Connector_for_HiRDB_Type4

Connector属性ファイルのファイル名

MyDBConnectorAttr.xml

リソースアダプタをインポートするJ2EEサーバの名称

MyWebSystem_J2EE01

注※　HiRDB Type4 JDBC Driverを使用して，ローカルトランザクションまたはトランザクション管理なしでHiRDBに接続する場合に使用するRARファイルです。

なお，提供されるRARファイルの種類や使い分けについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.6.4　DB Connector（RARファイル）の種類」を参照してください。

(1)　Connector属性ファイルの取得と編集

Connector属性ファイルを取得します。

アプリケーションサーバでは，DB ConnectorのConnector属性ファイルのテンプレートファイルを提供しています。テンプレートファイルの格納先を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥templates

UNIXの場合

/opt/Cosminexus/CC/admin/templates

DBConnector_HiRDB_Type4_CP.rarを使用する場合，DBConnector_HiRDB_Type4_CP_cfg.xmlを取得します。

Connector属性ファイルのテンプレート，およびテンプレートファイルに関する注意事項については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

Connector属性ファイルを編集します。

取得したConnector属性ファイルを任意の場所に保存します。ここでは，Connector属性ファイルの名称をMyDBConnectorAttr.xmlとして保存します。

保存したConnector属性ファイルにデータベースへの接続の設定などの必要な項目を定義してください。

(2)　リソースアダプタの設定

J2EEサーバを配置するホストでコマンドプロンプトを起動します。

cjimportresコマンドを実行し，リソースアダプタをJ2EEサーバへインポートします。

コマンドの実行例を次に示します。

cjimportres MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -type rar -f <DBConnector_HiRDB_Type4_CP.rarのファイルパス>

<DBConnector_HiRDB_Type4_CP.rarのファイルパス>は，Windowsの場合は「<Application Serverのインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar」，UNIXの場合は「/opt/Cosminexus/CC/DBConnector/DBConnector_HiRDB_Type4_CP.rar」です。

cjdeployrarコマンドを実行し，J2EEサーバにリソースアダプタをデプロイします。

コマンドの実行例を次に示します。

cjdeployrar MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname DB_Connector_for_HiRDB_Type4

cjsetrarpropコマンドを実行し，「(1)　Connector属性ファイルの取得と編集」で編集したConnector属性ファイルをリソースアダプタに反映します。

コマンドの実行例を次に示します。

cjsetrarprop MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname DB_Connector_for_HiRDB_Type4 -c <MyDBConnectorAttr.xmlのファイルパス>

<MyDBConnectorAttr.xmlのファイルパス>には，「(1)　Connector属性ファイルの取得と編集」でMyDBConnectorAttr.xmlを格納したディレクトリのパスとファイル名（MyDBConnectorAttr.xml）を指定します。

(3)　リソースアダプタの接続テスト

cjtestresコマンドを実行し，リソースアダプタの接続を確認します。

コマンドの実行例を次に示します。

cjtestres MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname DB_Connector_for_HiRDB_Type4

4.1.27　DB Connector以外のリソースアダプタを設定する（CUI利用時）

リソースアダプタとしてDB Connector以外を使用する場合の設定手順について説明します。この設定は，J2EEサーバを配置するホストで実施します。例題で使用する設定内容を次の表に示します。

表4‒13　例題で使用する設定内容（DB Connector以外のリソースアダプタの設定）

項目

設定例

リソースアダプタのファイル名

MyResourceAdapter.rar

リソースアダプタの表示名

MyResourceAdapter

Connector属性ファイルのファイル名

MyResourceAdapter.xml

リソースアダプタをインポートするJ2EEサーバの名称

MyWebSystem_J2EE01

なお，提供されるRARファイルの種類や使い分けについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.3.2　リソースアダプタの種類」を参照してください。

(1)　リソースアダプタの設定

J2EEサーバを配置するホストでコマンドプロンプトを起動します。

cjimportresコマンドを実行し，リソースアダプタをJ2EEサーバへインポートします。

コマンドの実行例を次に示します。

cjimportres MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -type rar -f <MyResourceAdapter.rarのファイルパス>

<MyResourceAdapter.rarのファイルパス>には，MyResourceAdapter.rarを格納したディレクトリのパスとファイル名（MyResourceAdapter.rar）を指定します。

cjdeployrarコマンドを実行し，J2EEサーバにリソースアダプタをデプロイします。

コマンドの実行例を次に示します。

cjdeployrar MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname MyResourceAdapter

(2)　Connector属性ファイルの取得と編集

J2EEサーバを配置するホストでコマンドプロンプトを起動します。

cjgetrarpropコマンドを実行し，Connector属性ファイルを取得します。

コマンドの実行例を次に示します。

cjgetrarprop MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname MyResourceAdapter -c <Connector属性ファイルの取得先のファイルパス>

<Connector属性ファイルの取得先のファイルパス>には，Connector属性ファイルを格納するディレクトリのパスとファイル名（MyResourceAdapter.xml）を指定します。

Connector属性ファイルを編集します。

取得したConnector属性ファイルで，データベースへの接続の設定など必要な項目を編集してください。

cjsetrarpropコマンドを実行し，編集したConnector属性ファイルをリソースアダプタに反映します。

コマンドの実行例を次に示します。

cjsetrarprop MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname MyResourceAdapter -c <Connector属性ファイルの取得先のファイルパス>

<Connector属性ファイルの取得先のファイルパス>には，手順3.で編集したConnector属性ファイルが格納されているディレクトリのパスとファイル名（MyResourceAdapter.xml）を指定します。

(3)　リソースアダプタの接続テスト

cjtestresコマンドを実行し，リソースアダプタの接続を確認します。

コマンドの実行例を次に示します。

cjtestres MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname MyResourceAdapter

4.1.28　リソースアダプタを開始する（CUI利用時）

設定したリソースアダプタを開始する手順について説明します。リソースアダプタを設定した，J2EEサーバが稼働しているアプリケーションサーバで開始します。

アプリケーションサーバのコマンドプロンプトで，cjstartrarコマンドを実行し，リソースアダプタを開始します。ここでは，リソースアダプタとしてDB Connector（DB_Connector_for_HiRDB_Type4）を開始するとします。

コマンドの実行例を次に示します。

cjstartrar MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname DB_Connector_for_HiRDB_Type4

4.1.29　業務アプリケーションを設定して開始する（CUI利用時）

業務を開始するためには，J2EEアプリケーションをインポートして開始する必要があります。J2EEアプリケーションのインポートと開始には，サーバ管理コマンドを使用します。J2EEアプリケーションを設定する，J2EEサーバが稼働しているアプリケーションサーバで設定します。サーバ管理コマンドでのJ2EEアプリケーションの操作の詳細については，マニュアル「アプリケーションサーバアプリケーション設定操作ガイド」の次の個所を参照してください。

8.1　J2EEアプリケーションのインポート

10.2.1　J2EEアプリケーションの開始

ここで説明するJ2EEアプリケーションは，cosminexus.xmlを含むアプリケーションとして作成済みであることを前提としています。例題で使用する設定内容を次の表に示します。

表4‒14　例題で使用する設定内容（J2EEアプリケーションの設定と開始）

項目

設定内容

J2EEアプリケーションのファイル名

MyApp.ear

J2EEアプリケーションの表示名

MyApp

J2EEアプリケーションをインポートするJ2EEサーバの名称

MyWebSystem_J2EE01

J2EEサーバを配置するホストでコマンドプロンプトを起動します。

cjimportappコマンドを実行し，J2EEアプリケーションをJ2EEサーバへインポートします。

コマンドの実行例を次に示します。

cjimportapp MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -f MyApp.ear

cjstartappコマンドを実行し，J2EEアプリケーションを開始します。

コマンドの実行例を次に示します。

cjstartapp MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -name MyApp

4.1.30　リソースアダプタまたは業務アプリケーションを操作するときの確認事項（CUI利用時）

(1)　サーバ管理コマンド実行時に設定する情報

リソースアダプタまたは業務アプリケーションを設定したり開始したりする場合，サーバ管理コマンドを使用します。サーバ管理コマンドで引数にサーバ名を指定する場合は，実サーバ名を指定します。簡易構築定義ファイル作成時に実サーバ名を設定していない場合，実サーバ名は論理サーバ名と同じです。なお，論理サーバ名の設定を省略している場合，論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」の形式で定義されます。論理サーバの種類と<種別>との対応を次の表に示します。

表4‒15　論理サーバの種類と<種別>との対応

論理サーバの種類

<種別>

論理Webサーバ

HTTP

論理J2EEサーバ

J2EE

論理パフォーマンストレーサ

PRF

論理CTMドメインマネジャ

CTMDM

論理CTM

CTM

論理スマートエージェント

SA

論理ユーザサーバ

USER

なお，<通番>は，基本的に「01」が設定されます。ただし，CTMを使用するシステムのように論理サーバを複数配置する場合は，重複しない番号が割り振られます。<通番>は，cmx_list_modelコマンドで確認してください。

(2)　サーバ管理コマンドを使用する操作

サーバ管理コマンドを使用する操作は，サービスユニットごとに実行します。

このマニュアルで説明しているシステムは，サービスユニットが一つの例です。複数のサービスユニットを設定している場合は，コマンド実行例中のJ2EEサーバ名および-nameserver指定値の値を，それぞれのサービスユニットごとに変更して，サーバ管理コマンドを実行してください。

(3)　J2EEアプリケーションのプロパティについて

このマニュアルで説明しているJ2EEアプリケーションでは，プロパティの設定にcosminexus.xmlを使用します。このため，あらかじめ作成したcosminexus.xmlを，EJB-JAR，WARなどと一緒にJ2EEアプリケーションに含めて使用してください。

次に示す場合，J2EEアプリケーションのプロパティは，属性ファイル（アプリケーション統合属性ファイル）で設定できます。

インポート済みのJ2EEアプリケーションのプロパティを編集する場合

cosminexus.xmlを含まないアプリケーションの場合

設定方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「9.2　アプリケーション統合属性ファイルによるプロパティ設定」を参照してください。

4.1.31　システム環境定義（簡易構築定義ファイルのパラメタ）を変更する（CUI利用時）

簡易構築定義ファイルのパラメタだけを編集する場合のチューニングの手順について説明します。例題で使用する設定内容を次の表に示します。

表4‒16　例題で使用する設定内容（システム環境定義の変更）

項目

設定例

Webシステムの名称

MyWebSystem

簡易構築定義ファイルの名称

MyWebSystemDef.xml

運用管理機能（Management Server）を配置するホスト

apsv2（192.168.100.12）

簡易構築定義ファイルのパラメタだけを編集する場合のチューニングの流れを次の図に示します。

図4‒5　簡易構築定義ファイルのパラメタだけを編集する場合のチューニングの流れ

(1)　パラメタの編集

簡易構築定義ファイル（MyWebSystemDef.xml）のパラメタ（<param>タグで指定する論理サーバのパラメタ）の値を編集して，チューニングを実施します。チューニングできる項目，およびパフォーマンスチューニングの詳細については，マニュアル「アプリケーションサーバシステム設計ガイド」の次の個所を参照してください。

8.1.3　アプリケーションの種類ごとにチューニングできる項目

8.2　チューニングの方法

(2)　システムの設定変更

運用管理機能（Management Server）を配置するホストでcmx_build_systemコマンドを実行し，Management Server上のシステムの情報モデルを変更します。変更した情報モデルを実システムに適用します。

運用管理機能（Management Server）を配置するホストでコマンドプロンプトを起動します。

システムが稼働している場合は，cmx_stop_targetコマンドを実行し，システムを停止します。

システム内のすべてのサービスユニットを停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

コマンドの実行例を次に示します。

cmx_stop_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode ALL

cmx_build_systemコマンドを実行し，システムの情報モデルを変更して実システムに展開します。

Management Server上のシステムの情報モデルを変更し，変更した情報モデルからシステムを構築します。-fオプションには，パフォーマンスチューニングを実施した簡易構築定義ファイルを指定します。-fオプションで指定したファイルの内容をシステムに反映するには，-changeオプションを指定します。

コマンドの実行例を次に示します。

cmx_build_system -f <MyWebSystemDef.xmlのファイルパス> -change -m 192.168.100.12 -u admin -p admin -s MyWebSystem

<MyWebSystemDef.xmlのファイルパス>には，「(1)　パラメタの編集」で編集した簡易構築定義ファイルの格納先ディレクトリのパスとファイル名（MyWebSystemDef.xml）を指定します。

cmx_start_targetコマンドを実行し，構成を変更したシステムを起動します。

システム内のすべてのサービスユニットを稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

コマンドの実行例を次に示します。

cmx_start_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode ALL -strict

4.1.32　業務アプリケーションの設定を変更する（CUI利用時）

J2EEアプリケーションの設定を変更する場合のチューニングの手順について説明します。例題で使用する設定内容を次の表に示します。

表4‒17　例題で使用する設定内容（業務アプリケーションの設定変更）

項目

設定例

Webシステムの名称

MyWebSystem

J2EEアプリケーションのファイル名

MyApp.ear

J2EEアプリケーションの表示名

MyApp

J2EEアプリケーションの設定を変更する，J2EEサーバが稼働しているアプリケーションサーバで実施します。

cosminexus.xmlでJ2EEアプリケーションのプロパティを編集して，<任意のディレクトリ>下のMETA-INFディレクトリに格納します。

コマンドプロンプトで，jarコマンドを実行し，アーカイブ形式のJ2EEアプリケーションに手順1.で編集したcosminexus.xmlを上書きします。

コマンドの実行例を次に示します。

jar uvf <MyApp.earのファイルパス> -C <META-INFディレクトリを置いたディレクトリ> <META-INFディレクトリ下のcosminexus.xmlのファイルパス>

<MyApp.earのファイルパス>は，J2EEアプリケーション（MyApp.ear）を格納したディレクトリのパスとファイル名（MyApp.ear）を指定します。<META-INFディレクトリを置いたディレクトリ>は，cosminexus.xmlの格納先が次のような構造の場合，<任意のディレクトリ>となります。

<任意のディレクトリ>
    └META-INF
        └cosminexus.xml

<META-INFディレクトリ下のcosminexus.xmlのファイルパス>は，手順1.でcosminexus.xmlを格納したMETA-INFディレクトリのパスとファイル名（cosminexus.xml）を指定します。

システムが停止している場合は，運用管理機能（Management Server）を配置するホスト（192.168.100.12）でコマンドプロンプトを起動して，cmx_start_targetコマンドを実行し，システムを起動します。

システム内のすべてのサービスユニットを準備状態にします。準備状態にするには，-modeオプションに「READY」を指定します。

コマンドの実行例を次に示します。

cmx_start_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode READY

J2EEサーバを配置するホストでコマンドプロンプトを起動します。

cjreplaceappコマンドを実行し，再作成したJ2EEアプリケーションをリデプロイします。

コマンドの実行例を次に示します。

cjreplaceapp MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -name MyApp -f <再作成したJ2EEアプリケーションのファイルパス>

<再作成したJ2EEアプリケーションのファイルパス>には，再作成したMyApp.earを格納したディレクトリのパスとファイル名（MyApp.ear）を指定します。

cjstartappコマンドを実行し，J2EEアプリケーションを開始します。

コマンドの実行例を次に示します。

cjstartapp MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -name MyApp

参考

インポート済みのJ2EEアプリケーションのプロパティは，属性ファイル（アプリケーション統合属性ファイル）でも変更できます。変更方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「9.2　アプリケーション統合属性ファイルによるプロパティ設定」を参照してください。

運用管理機能（Management Server）を配置するホスト（192.168.100.12）でコマンドプロンプトを起動して，cmx_start_targetコマンドを実行し，システムを起動します。

システム内のすべてのサービスユニットを稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

コマンドの実行例を次に示します。

cmx_start_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode ALL -strict

4.1.33　リソースアダプタの設定（データベースの接続環境）を変更する（CUI利用時）

リソースアダプタの設定を変更する場合のチューニングの手順について説明します。例題で使用する設定内容を次の表に示します。

表4‒18　例題で使用する設定内容（リソースアダプタの設定変更）

項目

設定例

Webシステムの名称

MyWebSystem

リソースアダプタの表示名

DB_Connector_for_HiRDB_Type4

Connector属性ファイルのファイル名

MyDBConnectorAttr.xml

リソースアダプタをインポートするJ2EEサーバの名称

MyWebSystem_J2EE01

リソースアダプタの設定を変更する，J2EEサーバが稼働しているアプリケーションサーバで実施します。

システムが停止している場合は，運用管理機能（Management Server）を配置するホスト（192.168.100.12）でコマンドプロンプトを起動して，cmx_start_targetコマンドを実行し，システムを起動します。

システム内のすべてのサービスユニットを準備状態にします。準備状態にするには，-modeオプションに「READY」を指定します。

コマンドの実行例を次に示します。

cmx_start_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode READY

J2EEサーバを配置するホストでコマンドプロンプトを起動します。

cjgetrarpropコマンドを実行し，Connector属性ファイルを取得します。

コマンドの実行例を次に示します。

cjgetrarprop MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname DB_Connector_for_HiRDB_Type4 -c <Connector属性ファイルの取得先のファイルパス>

<Connector属性ファイルの取得先のファイルパス>には，Connector属性ファイルを格納するディレクトリのパスとファイル名（MyDBConnectorAttr.xml）を指定します。

Connector属性ファイルを編集します。

取得したConnector属性ファイルで，データベースへの接続の設定など必要な項目を編集してください。

cjsetrarpropコマンドを実行し，編集したConnector属性ファイルをリソースアダプタに反映します。

コマンドの実行例を次に示します。

cjsetrarprop MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname DB_Connector_for_HiRDB_Type4 -c <Connector属性ファイルの取得先のファイルパス>

<Connector属性ファイルの取得先のファイルパス>には，手順4.で編集したConnector属性ファイルが格納されているディレクトリのパスとファイル名（MyDBConnectorAttr.xml）を指定します。

cjstartrarコマンドを実行し，リソースアダプタを開始します。

コマンドの実行例を次に示します。

cjstartrar MyWebSystem_J2EE01 -nameserver corbaname::192.168.100.12:900 -resname DB_Connector_for_HiRDB_Type4

運用管理機能（Management Server）を配置するホスト（192.168.100.12）でコマンドプロンプトを起動して，cmx_start_targetコマンドを実行し，システムを起動します。

システム内のすべてのサービスユニットを稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

コマンドの実行例を次に示します。

cmx_start_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode ALL -strict

4.1.34　システムを停止する（CUI利用時）

業務が実行中の場合は，すべてのリクエストの処理が完了したあと，サービスユニット内の論理サーバを停止します。

運用管理機能（Management Server）を配置するホスト（apsv2（192.168.100.12））でコマンドプロンプトを起動し，cmx_stop_targetコマンドを実行して，Webシステム内のすべてのサービスユニットを停止状態で停止します。停止状態にするには-modeオプションに「ALL」を指定します。

運用管理機能（Management Server）を配置するホストでコマンドプロンプトを起動します。

実行中のリクエストの処理が完了したら，cmx_stop_targetコマンドを実行し，システム内のすべてのサービスユニットを一括停止します。

システム内のすべてのサービスユニットを停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

コマンドの実行例を次に示します。

cmx_stop_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode ALL

サービスユニット内のすべての論理サーバが停止されます。

4.1.35　Management Serverを停止する

Management Serverをセットアップしたホスト（運用管理機能を配置するホスト）でコマンドプロンプトを起動し，mngsvrctlコマンドを実行して，Management Serverを停止します。なお，Windowsの場合はサービスからも停止できます。

コマンドの実行例を次に示します。

mngsvrctl stop -sync

4.1.36　運用管理エージェントを停止する

アプリケーションサーバごとにコマンドプロンプトを起動し，adminagentctlコマンドを実行して，運用管理エージェントを停止します。なお，Windowsの場合はサービスからも停止できます。

コマンドの実行例を次に示します。

adminagentctl stop -sync

4.1.37　システム環境を削除する

不要になったシステムを削除する手順について説明します。

J2EEアプリケーションやリソースアダプタを停止します。

J2EEアプリケーションやリソースアダプタは，サーバ管理コマンドを使用して停止します。

コマンドプロンプトを起動します。

手順2.〜手順6.は，Webサーバを配置するホストと，J2EEサーバを配置するホストの両方で実施します。なお，ホストの実施順序は順不同です。

次のプロセスが起動している場合，これらのプロセスを停止します。

Management Serverを使用しないで起動されたCTMおよびOTM（TPBroker Object Transaction Monitor）のプロセス

UNIXの場合，運用管理エージェントおよびManagement Serverで自動再起動を設定しているときはmngautorunコマンドを実行し，自動再起動の設定を解除してからOSを再起動します。

コマンドの実行例を次に示します。

mngautorun -d

mngunsetupコマンドを実行し，表示されたメッセージを確認して「y」を入力します。

アンセットアップを実行するかどうかを確認するメッセージが表示されます。

「y」を入力すると，次の処理が実行されます。

運用管理エージェント停止，およびManagement Serverの停止と削除

運用管理エージェントおよびManagement Serverの自動起動および自動再起動の解除

論理サーバの停止

論理パフォーマンストレーサ，論理スマートエージェント，論理ネーミングサービス，論理CTMドメインマネジャ，論理CTM（同時に起動されるネーミングサービスも含む），論理J2EEサーバ，論理Webサーバ，および論理ユーザサーバ※を停止します。停止監視時間を経過しても停止しない論理サーバは，Management Serverが強制停止します。なお，各論理サーバの停止監視時間（簡易構築定義ファイルのmstartup.watchtimeパラメタ）は，論理サーバを起動したときに設定されている値が有効になります。

注※　論理ユーザサーバは監視対象プロセスを停止します。停止用コマンドが指定されている場合は，停止用コマンドでプロセスを停止し，指定されていない場合は，起動種別が直接起動のときは起動用コマンドのプロセス，間接起動のときは論理ユーザサーバに定義されたプロセスID取得用コマンドで取得されるプロセスを停止します。

論理サーバの強制停止

論理パフォーマンストレーサ，論理スマートエージェント，論理ネーミングサービス，論理CTMドメインマネジャ，論理CTM（同時に起動されるネーミングサービスも含む），論理J2EEサーバ，論理Webサーバ，および論理ユーザサーバ※を強制停止します。強制停止監視時間を経過しても停止しない論理サーバは，Management Serverがそのプロセスを強制停止します。なお，各論理サーバの強制停止監視時間（簡易構築定義ファイルのmstartup.force.watchtimeパラメタ）は，論理サーバを起動したときに設定されている値が有効になります。

注※　論理ユーザサーバは監視対象プロセスを強制停止します。強制停止用コマンドが指定されている場合は，強制停止用コマンドでプロセスを停止し，指定されていない場合は，起動種別が直接起動のときは起動用コマンドのプロセス，間接起動のときは論理ユーザサーバに定義されたプロセスID取得用コマンドで取得されるプロセスを停止します。

論理J2EEサーバ，および論理Webサーバの環境（実サーバ）削除，論理CTMドメインマネジャの情報削除

Management Serverが管理している情報（論理サーバの構成情報や設定情報，および管理ユーザアカウントの情報）の初期化

Component Container管理者の設定解除（UNIXの場合）

設定が解除され，スーパーユーザのユーザ（オーナー）/グループが設定されます。設定値をOSごとに示します。

AIXの場合：root/system

Linuxの場合：root/root

UNIXの場合，必要に応じて，mngenvsetupコマンドを実行し，Management Server管理グループの設定を解除します。

コマンドの実行例を次に示します。

mngenvsetup -mng -d

注意事項

アンセットアップに成功しても，システム環境によってはApplication Serverで起動されたプロセスが残ることがあります。この場合，Application Serverのアンインストールに失敗することがあります。アンセットアップ後にアンインストールを実施して失敗したときは，「付録I.6　Application Serverのインストールおよびアンインストール時のエラーコード一覧（Windowsの場合）」，または「付録I.7　Component Containerおよびリダイレクタ機能のインストールおよびアンインストール時のログ（UNIXの場合）」を参照してエラーの対処を実施したあと，再度アンインストールを実施してください。

参考

mngunsetupコマンドを実行すると，Management Serverおよび運用管理エージェントもアンセットアップされます。構築したシステム環境（論理サーバやホスト）だけを削除したい場合は，J2EEアプリケーションやリソースを停止したあと，次の手順を実施してください。ここでは，Webシステムの名称をMyWebSystem，運用管理機能（Management Server）を配置するホストをapsv2（192.168.100.12）とします。

運用管理機能（Management Server）を配置するホストでコマンドプロンプトを起動します。

cmx_stop_targetコマンドを実行し，システムを停止します。

削除対象となるシステムを停止します。

コマンドの実行例を次に示します。

cmx_stop_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -mode ALL

cmx_delete_systemコマンドを使用してManagement Server上からシステムを削除します。

Management Serverで管理されているシステムの情報モデルを削除します。

コマンドの実行例を次に示します。

cmx_delete_system -m 192.168.100.12 -u admin -p admin -s MyWebSystem

WebサーバやJ2EEサーバの環境をアンセットアップします。

cmx_delete_systemコマンドでは，サーバの環境はアンセットアップされません。ホスト上のWebサーバやJ2EEサーバの環境は，それぞれ次の方法でアンセットアップします。

Webサーバの環境のアンセットアップ

HTTP Serverのhwsservereditコマンドを使用して，Webサーバをアンセットアップします。HTTP Serverのhwsservereditコマンドには，「HWS_」を付加したWebサーバの論理サーバ名※を指定します。

J2EEサーバの環境のアンセットアップ

cjsetupコマンドを使用して，J2EEサーバをアンセットアップします。cjsetupコマンドには，J2EEサーバの論理サーバ名※を指定します。

注※

論理サーバ名はcmx_list_modelコマンドを使用して確認できます。cmx_delete_systemコマンドを実行する前に論理サーバ名を確認してください。

ただし，システム構築時に，WebサーバやJ2EEサーバの実サーバ名を指定している場合は，アンセットアップ時には実サーバ名を指定してください。実サーバ名の指定は，簡易構築定義ファイルの物理ティアのrealservernameパラメタに指定します。

アンセットアップ時に指定するサーバ名の詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjsetup（J2EEサーバのセットアップとアンセットアップ）」を参照してください。

実サーバ名を指定していないJ2EEサーバをアンセットアップする場合の，コマンドの実行例を次に示します。

cjsetup -d MyWebSystem_J2EE01

4.2　ホストを増やしてシステムの規模を拡大するシステムの運用（スケールアウト）

スケールアウトとは，システム全体の処理性能を向上させることを目的として，ホストの台数を増やすことをいいます。システムをスケールアウトすると，業務全体を停止することなく，システムの規模を拡張して構成を変更できます。

4.2.1　ホストを増やしてシステムの規模を拡大（スケールアウト）するには

スケールアウトでは，ホストの台数を増やし，システムの規模を拡大することで，システム全体の処理性能の向上が図れます。

Smart Composer機能の場合は，サービスユニット単位にホストおよび論理サーバを一括で増やせます。また，運用管理ポータルの場合は，［運用管理ポータル］画面の各画面で個々にホストや論理サーバを増やせます。

システム運用例

ホストを増やしてシステムの規模を拡大するシステム運用例を次の図に示します。ここでは，「4.1　Webサーバを別ホストに配置してマシン性能を向上するシステムの構築」で構築したシステムを使用します。

図4‒6　ホストを増やしてシステムの規模を拡大するシステム運用例

例題で使用する設定内容を次の表に示します。

表4‒19　例題で使用する設定内容（システムのスケールアウト）

分類

項目

設定例

システム全体

構成変更定義ファイルの名称

MyWebSystemAdd.xml

Webシステムの名称

MyWebSystem

追加するサービスユニットの名称

unit2

追加するWebサーバを配置するホスト

ホストの名称

apsv3

IPアドレス（管理IPアドレス）※

192.168.100.13

論理Webサーバの名称

MyWebSystem_HTTP02

論理パフォーマンストレーサの名称

MyWebSystem_PRF03

追加するJ2EEサーバを配置するホスト

ホストの名称

apsv4

IPアドレス（管理IPアドレス）※

192.168.100.14

論理J2EEサーバの名称

MyWebSystem_J2EE02

論理パフォーマンストレーサの名称

MyWebSystem_PRF04

リソースアダプタのファイル名

DBConnector_HiRDB_Type4_CP.rar

リソースアダプタの表示名

DB_Connector_for_HiRDB_Type4

Connector属性ファイルのファイル名

MyDBConnectorAttr.xml

J2EEアプリケーションのファイル名

MyApp.ear

J2EEアプリケーションの表示名

MyApp

注※　ネットワークが単一構成の場合，IPアドレスは，業務IPアドレスと管理IPアドレスの両方を兼ねます。

実施する作業と作業の要否

システムをスケールアウトする時に実施する作業と作業の要否を次の表に示します。システムのスケールアウトは，Smart Composer機能を使用して実施します。

表4‒20　システムをスケールアウトする時に実施する作業と作業の要否（Smart Composer機能利用時）

システムをスケールアウトする時に実施する作業

作業の要否

作業の実施条件

参照個所

システムの構築

○

必ず実施

4.1

追加するホストの準備

○

必ず実施

4.2.2(1)

構成変更定義ファイルの作成

○

必ず実施

4.2.2(2)

システムの情報モデルの変更

○

必ず実施

4.2.2(3)

サービスユニットの追加

○

必ず実施

4.2.2(4)

（凡例）

○：必ず実施する作業です。

4.2.2　システム環境をスケールアウトする（CUI利用時）

ここでは，Smart Composer機能を使用して，サービスユニット（unit2）を追加してスケールアウトする手順について説明します。

(1)　追加するホストの準備

システムをスケールアウトする前に，あらかじめ追加するアプリケーションサーバのOSやアプリケーションをセットアップしてください。追加するホストで実施する作業と作業の要否を次の表に示します。

表4‒21　追加するホストで実施する作業と作業の要否

追加するホストで実施する作業

作業の要否

作業の実施条件

参照個所

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理エージェントの起動

○

必ず実施

4.1.17

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

また，Webシステムの構成を変更するとWebシステムが動作するために必要なリソースも変更する必要があります。Webシステムが動作するために必要なリソースの見積もりについては，マニュアル「アプリケーションサーバ システム設計ガイド」の「5.　使用するリソースの見積もり（J2EEアプリケーション実行基盤）」を参照してください。

(2)　構成変更定義ファイルの作成

サービスユニット・ホスト追加用の構成変更定義ファイルを任意の場所にコピーして，ファイルの内容を編集します。

構成変更定義ファイルのテンプレートファイル（cmxaddcombinedmodel.xml）を任意の場所にコピーします。

サービスユニットやホストを追加する構成変更定義ファイルのテンプレートファイルは，次の場所に提供されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥templates¥cmxaddcombinedmodel.xml

UNIXの場合

/opt/Cosminexus/manager/config/templates/cmxaddcombinedmodel.xml

手順1のテンプレートファイルを任意の名称を変更します。

ここではファイル名を「MyWebSystemAdd.xml」に変更します。

テキストエディタなどを利用して，構成変更定義ファイルに追加するサービスユニットおよびホストを定義します。

MyWebSystemAdd.xmlの作成例

<?xml version="1.0" encoding="UTF-8"?>
<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
  <web-system>
    <name>MyWebSystem</name>

    <!--Specify the settings for the Service Unit to add.-->
    <unit>
      <name>unit2</name>
      <allocated-host>
        <host-ref>apsv3</host-ref>
        <hosts-for>http-tier</hosts-for>
      </allocated-host>
      <allocated-host>
        <host-ref>apsv4</host-ref>
        <hosts-for>j2ee-tier</hosts-for>
      </allocated-host>
    </unit>
  </web-system>

  <!--Specify the settings for the host to add.-->
  <host>
    <host-name>apsv3</host-name>
    <agent-host>apsv3</agent-host>
  </host>
  <host>
    <host-name>apsv4</host-name>
    <agent-host>apsv4</agent-host>
  </host>
</unit-addition>

注　背景色付きの太字の部分が編集部分です。

(3)　システムの情報モデルの変更

作成した構成変更定義ファイルの内容を，Management Serverに登録されているシステムの情報モデルに反映します。

運用管理機能（Management Server）を配置するホストでコマンドプロンプトを起動します。

cmx_change_modelコマンドを実行し，Management Serverに登録されているシステムの情報モデルを変更します。

コマンドの実行例を次に示します。

cmx_change_model -m 192.168.100.12 -u admin -p admin -f <MyWebSystemAdd.xmlのファイルパス>

＜MyWebSystemAdd.xmlのファイルパス＞には，MyWebSystemAdd.xmlを格納したディレクトリのパスとファイル名（MyWebSystemAdd.xml）を指定します。

(4)　サービスユニットの追加

変更したシステムの情報モデルを実システムに適用して，サービスユニットを追加します。

運用管理機能（Management Server）を配置するホストでコマンドプロンプトを起動します。

cmx_build_systemコマンドを実行し，変更したシステムの情報モデルを実システムに展開します。

コマンドの実行例を次に示します。

cmx_build_system -m 192.168.100.12 -u admin -p admin -s MyWebSystem

cmx_start_targetコマンドを実行し，追加したサービスユニットを起動します。

追加したサービスユニット「unit2」を稼働状態にします。稼働状態にするには，-modeオプションに「ALL」を指定します。

cmx_start_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -unit unit2 -mode ALL -strict

追加したサービスユニットにあるJ2EEサーバを配置するホストでコマンドプロンプトを起動します。

リソースアダプタを設定して開始します。

コマンドの実行例を次に示します。

cjimportres MyWebSystem_J2EE02 -nameserver corbaname::192.168.100.14:900 -type rar -f <DBConnector_HiRDB_Type4_CP.rarのファイルパス>

cjdeployrar MyWebSystem_J2EE02 -nameserver corbaname::192.168.100.14:900 -resname DB_Connector_for_HiRDB_Type4

cjsetrarprop MyWebSystem_J2EE02 -nameserver corbaname::192.168.100.14:900 -resname DB_Connector_for_HiRDB_Type4 -c <MyDBConnectorAttr.xml※のファイルパス>

cjtestres MyWebSystem_J2EE02 -nameserver corbaname::192.168.100.14:900 -resname DB_Connector_for_HiRDB_Type4

cjstartrar MyWebSystem_J2EE02 -nameserver corbaname::192.168.100.14:900 -resname DB_Connector_for_HiRDB_Type4

注※　スケールアウトの対象とするサービスユニットのリソースアダプタに反映したConnector属性ファイルを使用します。Connector属性ファイルを保管していない場合は，スケールアウトの対象とするサービスユニットにデプロイしたリソースアダプタからサーバ管理コマンド（cjgetrarprop）を使用して取得します。取得したConnector属性ファイルは必要に応じて編集します。

J2EEアプリケーションを設定して開始します。

コマンドの実行例を次に示します。

cjimportapp MyWebSystem_J2EE02 -nameserver corbaname::192.168.100.14:900 -f MyApp.ear

cjstartapp MyWebSystem_J2EE02 -nameserver corbaname::192.168.100.14:900 -name MyApp

4.3　ホストを減らしてシステムの規模を縮小するシステムの運用（スケールイン）

スケールインとは，システムの規模を縮小する場合などに，ホストの台数を減らすことをいいます。システムをスケールインすると，業務全体を停止することなく，システムの規模を縮小して構成を変更できます。

4.3.1　ホストを減らしてシステムの規模を縮小（スケールイン）するには

スケールインでは，ホストの台数を減らし，システムの規模を縮小することで，不要なホストを減らし，メンテナンスなどに掛かる作業コストの削減が図れます。

Smart Composer機能の場合は，サービスユニット単位にホストおよび論理サーバを一括で減らせます。また，運用管理ポータルの場合は，［運用管理ポータル］画面の各画面で個々にホストや論理サーバを減らせます。

システム運用例

ホストを減らしてシステムの規模を縮小するシステム運用例を次の図に示します。ここでは，「4.2　ホストを増やしてシステムの規模を拡大するシステムの運用（スケールアウト）」で構築したシステムを使用します。

図4‒7　ホストを減らしてシステムの規模を縮小するシステム運用例

例題で使用する設定内容を次の表に示します。

表4‒22　例題で使用する設定内容（システムのスケールイン）

分類

項目

設定例

システム全体

Webシステムの名称

MyWebSystem

削除するサービスユニットの名称

unit2

削除するWebサーバを配置するホスト

ホストの名称

apsv3

IPアドレス（管理IPアドレス）※

192.168.100.13

論理Webサーバの名称

MyWebSystem_HTTP02

論理パフォーマンストレーサの名称

MyWebSystem_PRF03

削除するJ2EEサーバを配置するホスト

ホストの名称

apsv4

IPアドレス（管理IPアドレス）※

192.168.100.14

論理J2EEサーバの名称

MyWebSystem_J2EE02

論理パフォーマンストレーサの名称

MyWebSystem_PRF04

注※　ネットワークが単一構成の場合，IPアドレスは，業務IPアドレスと管理IPアドレスの両方を兼ねます。

実施する作業と作業の要否

システムをスケールインする時に実施する作業と作業の要否を次の表に示します。システムのスケールインは，Smart Composer機能を使用して実施します。

表4‒23　システムをスケールインする時に実施する作業と作業の要否（Smart Composer機能利用時）

システムをスケールインする時に実施する作業

作業の要否

作業の実施条件

参照個所

サービスユニットの停止

○

必ず実施

4.3.2(1)

サービスユニットの削除と論理サーバの環境のアンセットアップ

○

必ず実施

4.3.2(2)

（凡例）

○：必ず実施する作業です。

4.3.2　システム環境をスケールインする（CUI利用時）

ここでは，Smart Composer機能を使用して，サービスユニット（unit2）を削除してスケールインする手順について説明します。

システムをスケールインする前に，必要に応じて，Webシステムが動作するために必要なリソースも変更します。Webシステムが動作するために必要なリソースの見積もりについては，マニュアル「アプリケーションサーバ システム設計ガイド」の「5.　使用するリソースの見積もり（J2EEアプリケーション実行基盤）」を参照してください。

(1)　サービスユニットの停止

運用管理機能（Management Server）を配置するホストでコマンドプロンプトを起動します。

cmx_stop_targetコマンドを実行し，削除するサービスユニット「unit2」を停止します。

サービスユニットを停止状態にします。停止状態にするには，-modeオプションに「ALL」を指定します。

コマンドの実行例を次に示します。

cmx_stop_target -m 192.168.100.12 -u admin -p admin -s MyWebSystem -unit unit2 -mode ALL

(2)　サービスユニットの削除と論理サーバの環境のアンセットアップ

cmx_delete_systemコマンドを実行し，サービスユニットを削除します。

削除するサービスユニットを停止して，Management Serverに登録されているシステムの情報モデルから削除します。

cmx_delete_system -m 192.168.100.12 -u admin -p admin -s MyWebSystem -unit unit2

WebサーバやJ2EEサーバの環境をアンセットアップします。

cmx_delete_systemコマンドでは，サーバの環境はアンセットアップされません。WebサーバやJ2EEサーバの環境は，それぞれ次の方法でアンセットアップします。

Webサーバの環境のアンセットアップ

HTTP Serverのhwsservereditコマンドを使用して，Webサーバをアンセットアップします。HTTP Serverのhwsservereditコマンドには，「HWS_」を付加したWebサーバの論理サーバ名※を指定します。

J2EEサーバの環境のアンセットアップ

cjsetupコマンドを使用して，J2EEサーバをアンセットアップします。cjsetupコマンドには，J2EEサーバの論理サーバ名※を指定します。

注※

システム構築時に，WebサーバやJ2EEサーバの実サーバ名を指定している場合は，アンセットアップ時には実サーバ名を指定してください。

4.4　構成・定義情報を出力してほかのホストにシステム環境を移行するシステムの運用

システム環境の移行とは，テスト環境で構築したシステムを本番環境に移行する場合などに，構築済みのシステムの設定内容をほかの環境に移行することをいいます。

4.4.1　ほかのホストにシステム環境を移行するには

システム環境の移行を利用すると，ほかの環境でシステムを構築して稼働するまでに掛かる時間を短縮できます。

システム運用例

構成・定義情報を出力してほかのホストにシステム環境を移行するシステム運用例を次の図に示します。ここでは，移行元の環境として，「4.1　Webサーバを別ホストに配置してマシン性能を向上するシステムの構築」で構築したシステムを使用します。

図4‒8　構成・定義情報を出力してほかのホストにシステム環境を移行するシステム運用例

例題で使用する設定内容を次の表に示します。

表4‒24　例題で使用する設定内容（システム環境の移行）

分類

項目

設定例

システム全体

移行情報を出力する簡易構築定義ファイルの名称

MyWebSystemexport.xml

移行元の環境

Webサーバを配置するホスト

ホストの名称

apsv1

IPアドレス（管理IPアドレス）※1

192.168.100.11

J2EEサーバを配置するホスト※2

ホストの名称

apsv2

IPアドレス（管理IPアドレス）※1

192.168.100.12

移行先の環境

Webサーバを配置するホスト

ホストの名称

apsva

IPアドレス（管理IPアドレス）※1

192.168.100.21

J2EEサーバを配置するホスト※2

ホストの名称

apsvb

IPアドレス（管理IPアドレス）※1

192.168.100.22

注※1　ネットワークが単一構成の場合，IPアドレスは，業務IPアドレスと管理IPアドレスの両方を兼ねます。

注※2　運用管理機能（Management Server）は，J2EEサーバを配置するホストに配置します。

実施する作業と作業の要否

システム環境を移行する時に実施する作業と作業の要否を次の表に示します。システム環境の移行は，Smart Composer機能を使用して実施します。

表4‒25　システム環境を移行する時に実施する作業と作業の要否（Smart Composer機能利用時）

システム環境を移行する時に実施する作業

作業の要否

作業の実施条件

参照個所

移行元のシステム環境の構築

○

必ず実施

4.1

移行先の環境でのホストの準備

○

必ず実施

4.4.2(1)

構成・定義情報の出力

○

必ず実施

4.4.2(2)

移行先のシステム環境の構築

○

必ず実施

4.4.2(3)

（凡例）

○：必ず実施する作業です。

4.4.2　構成・定義情報を出力してシステム環境を移行する

ここでは，Smart Composer機能を使用して，構築済みのシステムをほかの環境に移行する手順について説明します。システム環境の移行時に使用する構成・定義情報の内容については，「4.4.3　移行時に使用する構成・定義情報の内容」を参照してください。また，システム環境の移行時の注意事項については，「4.4.4　構成・定義情報を出力してシステムを移行するときの注意事項」を参照してください。

(1)　移行先の環境でのホストの準備

移行先の環境でホストを用意して，製品のインストールと初期設定，運用管理機能の構築をします。

移行先のシステムでManagement Serverが動作している必要があります。インストールと初期設定を済ませておいてください。

移行先のホストで実施する作業と作業の要否を次の表に示します。

表4‒26　移行先のホストで実施する作業と作業の要否

移行先のホストで実施する作業

作業の要否

作業の実施条件

参照個所

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

4.1.14

運用管理エージェントの起動

○

必ず実施

4.1.17

Management Serverの起動

○

必ず実施

4.1.18

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

(2)　構成・定義情報の出力

移行元の環境の運用管理機能（Management Server）を配置するホスト（apsv2（192.168.100.12））でコマンドプロンプトを起動します。

cmx_export_modelコマンドを実行し，構築済みのシステムの設定内容を簡易構築定義ファイルに出力します。

コマンドの実行例を次に示します。ここでは，出力する簡易構築定義ファイルの名称をMyWebSystemexport.xmlとします。

cmx_export_model -m 192.168.100.12 -u admin -p admin -o <MyWebSystemexport.xmlのファイルパス>

<MyWebSystemexport.xmlのファイルパス>には，MyWebSystemexport.xmlを格納するディレクトリのパスとファイル名（MyWebSystemexport.xml）を指定します。

(3)　移行先のシステム環境の構築

移行先の環境の運用管理機能（Management Server）を配置するホスト（apsvb（192.168.100.22））でコマンドプロンプトを起動します。

cmx_build_systemコマンドを実行し，移行先の環境に構築済みのシステムと同じシステムを構築します。

コマンドの実行例を次に示します。cmx_build_systemコマンドの-fオプションには，「(2)　構成・定義情報の出力」で出力した簡易構築定義ファイルを指定します。

cmx_build_system -m 192.168.100.22 -u admin -p admin -f <MyWebSystemexport.xmlのファイルパス>

4.4.3　移行時に使用する構成・定義情報の内容

ここでは，cmx_export_modelコマンドを使用して構築済みのシステムの設定内容を出力した場合の出力内容について説明します。

(1)　XMLスキーマのバージョン

XMLスキーマのバージョンは，最新のバージョンで出力されます。旧バージョンの簡易構築定義ファイルを使用して構築したシステムに対して設定内容を出力した場合，最新のXMLスキーマのバージョンに従って，タグ名称が最新の名称に変換されます。

(2)　物理ティアの構成

Smart Composer機能を使用して構築している場合は，簡易構築定義ファイルで定義した物理ティア（combined-tier，http-tier，j2ee-tier，またはctm-tier）で出力されます。Smart Composer機能を使用しないで構築したシステムの場合は，free-tierで出力されます。例えば，運用管理ポータルを使用して構築したシステムはfree-tierで出力されます。free-tierでは，システムの構成に応じて，次に示す論理サーバが出力されます。

論理Webサーバ

論理J2EEサーバ

論理パフォーマンストレーサ

論理CTMドメインマネジャ

論理CTM

論理スマートエージェント

論理ユーザサーバ

論理ネーミングサービス

出力される論理サーバのパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.8.1　J2EEアプリケーションを実行するシステムを構築する場合」を参照してください。

(3)　論理サーバのコンフィグレーションに設定しているパラメタ

出力規則

非推奨のパラメタは，推奨のパラメタに変換されます。

値を指定しているパラメタは出力されます。値を省略しているパラメタは出力されません。

簡易構築定義ファイルでパラメタにデフォルト値を設定している場合，または運用管理ポータルでキーにデフォルト値を設定している場合，そのパラメタは出力されます。

出力順序

論理サーバの種類ごとに，パラメタの種類によって出力順序があります。また，同じパラメタの種類の中でのパラメタの出力順序は，パラメタ名称の昇順です。パラメタの出力順序を，次の表に示します。

表4‒27　パラメタの出力順序

パラメタを設定するサーバ

出力順序

パラメタの種類

J2EEサーバ

1

各論理サーバ共通で指定できるパラメタ

2

J2EEサーバ用オプション定義のパラメタ

3

J2EEサーバ用ユーザプロパティのパラメタ

Webサーバ

1

各論理サーバ共通で指定できるパラメタ

2

HTTP Server定義のパラメタ

そのほかの論理サーバ

1

各論理サーバ共通で指定できるパラメタ

2

該当する論理サーバのパラメタ

設定先

構築済みのシステムの論理サーバによってパラメタの設定先が異なります。パラメタの設定先を，次の表に示します。なお，free-tierでは，物理ティアの定義にパラメタを設定できないため，サービスユニットの定義にすべてのパラメタが設定されます。

表4‒28　パラメタの設定先

同じ種類の論理サーバの数

パラメタに指定している値

パラメタの設定先

1

−

物理ティアの定義

2〜n

すべての論理サーバで同じ

物理ティアの定義

論理サーバごとに異なる

サービスユニットの定義

（凡例）　−：なし

システムの中に同じ種類の論理サーバが一つしかない場合，すべてのパラメタが物理ティアの定義に設定されます。

システムの中に同じ種類の論理サーバが複数ある場合に，同じ種類の論理サーバで，同じパラメタに同じ値をそれぞれ指定していると，パラメタの値は，物理ティアの定義にそれぞれ設定されます。

システムの中に同じ種類の論理サーバが複数ある場合に，同じ種類の論理サーバで，同じパラメタに異なる値をそれぞれ指定していると，パラメタはサービスユニットの定義にそれぞれ設定されます。

(4)　出力例

簡易構築定義ファイルの出力例を次に示します。

ここでは，簡易構築定義ファイルを使用して構築したcombined-tier構成のシステムに，運用管理ポータルでホスト（host1），論理J2EEサーバ（j2ee01），および論理パフォーマンストレーサ（prf01）を追加したシステムの設定内容の出力例を示します。

簡易構築定義ファイルの出力例

<?xml version="1.0" encoding="UTF-8" ?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
  <web-system>
    <name>sample-system</name>
    <tier>
      <tier-type>combined-tier</tier-type>
      <configuration>
        <logical-server-type>j2ee-server</logical-server-type>
        <param>
          <param-name>ejbserver.http.port</param-name>
          <param-value>8085</param-value>
        </param>
      </configuration>
    </tier>
    <unit>
      <name>unit1</name>
      <allocated-host>
        <host-ref>apsv1</host-ref>
        <hosts-for>combined-tier</hosts-for>
      </allocated-host>
    </unit>
  </web-system>
  <web-system>※1
    <tier>
      <tier-type>free-tier※2</tier-type>
    </tier>
    <unit>※1
      <allocated-host>
        <host-ref>host1</host-ref>
        <hosts-for>free-tier</hosts-for>
        <define-server>
          <logical-server-name>prf01</logical-server-name>
          <logical-server-type>performance-tracer</logical-server-type>
        </define-server>
        <define-server>
          <logical-server-name>j2ee01</logical-server-name>
          <logical-server-type>j2ee-server</logical-server-type>
          <configuration>
            <param>※3
              <param-name>ejbserver.server.prf.PRFID</param-name>
              <param-value>PRF_ID</param-value>
            </param>
          </configuration>
        </define-server>
      </allocated-host>
    </unit>
  </web-system>
  <host>
    <host-name>apsv1</host-name>
  </host>
  <host>
    <host-name>host1</host-name>
  </host>
</model-definition>

注※1　

free-tierには，Webシステム名，およびサービスユニット名がありません。

注※2　

ほかのどの物理ティアの構成にも当てはまらない構成が含まれていると，その構成がfree-tierとして出力されます。

注※3　

free-tierでは，ティアの定義にパラメタを設定できないため，サービスユニットの定義にパラメタが設定されます。

4.4.4　構成・定義情報を出力してシステムを移行するときの注意事項

構成・定義情報を出力して，構築済みのシステムを移行するときの注意事項を次に示します。

移行後のシステム環境に，free-tierが含まれている場合，Smart Composer機能のコマンドで実施できる運用作業は次のとおりです。

システムの起動・停止

システム中の論理サーバのステータス監視

システム中の論理サーバのcmx_build_systemの実行状態の表示

free-tierを含むシステムについてほかの運用作業をする場合は，運用管理ポータル，またはサーバ管理コマンドを使用してください。

Smart Composer機能のコマンドで簡易構築定義ファイルに出力できるのは，システム環境の内容のうち，簡易構築定義ファイルで定義できる情報だけです。簡易構築定義ファイル以外のファイルを直接編集している場合，その編集内容は反映されません。

Webシステムに関連づいていない論理サーバを含むシステムを構築する場合は，次に示す手順で，移行先の環境に，構築済みのシステムと同じシステムを構築してください。

移行元の環境で，cmx_export_modelコマンドを実行し，構築済みのシステムの設定内容を簡易構築定義ファイルに出力します。

コマンドの実行例を次に示します。ここでは，出力する簡易構築定義ファイルの名称をMyWebSystemexport.xmlとします。

cmx_export_model -m 192.168.100.12 -u admin -p admin -o <MyWebSystemexport.xmlのファイルパス>

移行先の環境で，cmx_build_modelコマンドを実行し，手順1.で出力した簡易構築定義ファイルからシステムの情報モデルを構築します。

コマンドの実行例を次に示します。

cmx_build_model -m 192.168.100.22 -u admin -p admin -f <MyWebSystemexport.xmlのファイルパス>

移行先の環境で，cmx_build_systemコマンドを実行し，システムの情報モデルを基に，Webシステムに関連づいていない論理サーバを含むシステムを構築します。

コマンドの実行例を次に示します。なお，構築するシステムにWebシステムに関連づいている論理サーバが含まれる場合，-sオプションにWebシステム名を指定して，再度cmx_build_systemコマンドを実行します。ここでは，WebシステムをMyWebSystemとします。

構築するシステムにWebシステムに関連づいていない論理サーバだけ含まれる場合

cmx_build_system -m 192.168.100.22 -u admin -p admin -ns

構築するシステムにWebシステムに関連づいていない論理サーバおよびWebシステムに関連づいている論理サーバが含まれる場合

cmx_build_system -m 192.168.100.22 -u admin -p admin -s MyWebSystem

cmx_build_system -m 192.168.100.22 -u admin -p admin -ns

4.5　論理ユーザサーバを配置するシステムの構築

論理ユーザサーバは，ユーザが定義する任意のプロセス（ユーザサーバ）を論理サーバとして定義するものです。特定のサービスやプロセスを論理ユーザサーバとして定義しておくことで，そのサービスやプロセスがManagement Serverの管理対象となり，ほかの論理サーバと同様に一括管理できるようになります。

ユーザサーバは，アプリケーションサーバ上で動作します。アプリケーションサーバ以外にも，アプリケーションサーバをインストールしているホストであれば，ユーザサーバを配置できます。その場合，これらのホストには，運用管理エージェントも配置する必要があります。

4.5.1　論理ユーザサーバを配置するには

論理ユーザサーバを使用すると，ユーザが定義する任意のプロセスをManagement Serverで運用管理できるようになります。

Smart Composer機能の場合は，論理ユーザサーバを簡易構築定義ファイルで定義します。また，運用管理ポータルでは論理ユーザサーバを定義できませんが，定義された論理ユーザサーバに対して起動，停止および運用監視の操作ができます。運用管理ポータルで論理ユーザサーバを使用する場合は，論理ユーザサーバをファイルで定義したあと，運用管理コマンドでそのファイルを基に論理ユーザサーバを設定します。

システム構成例

論理ユーザサーバを配置するシステムの構成例を次の図に示します。ここでは，「4.1　Webサーバを別ホストに配置してマシン性能を向上するシステムの構築」で構築したシステムに論理ユーザサーバを配置します。

図4‒9　論理ユーザサーバを配置するシステムの構成例

例題で使用する設定内容を次の表に示します。

表4‒29　例題で使用する設定内容（論理ユーザサーバの配置）

分類

項目

設定例

システム全体

簡易構築定義ファイルの名称

MyWebSystemDef.xml

Webシステムの名称

MyWebSystem

サービスユニットの名称

unit1

Webサーバを配置するホスト

ホストの名称

apsv1

IPアドレス（管理IPアドレス）※

192.168.100.11

論理ユーザサーバの名称

UserServer1

J2EEサーバを配置するホスト

ホストの名称

apsv2

IPアドレス（管理IPアドレス）※

192.168.100.12

論理ユーザサーバの名称

UserServer2

注※　ネットワークが単一構成の場合，IPアドレスは，業務IPアドレスと管理IPアドレスの両方を兼ねます。

実施する作業と作業の要否

論理ユーザサーバに配置するシステムの構築時に実施する作業と作業の要否を，利用する構築ツールごとに次の表に示します。

表4‒30　論理ユーザサーバを配置するシステムの構築時に実施する作業と作業の要否（運用管理ポータル利用時）

論理ユーザサーバを配置するシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照先マニュアル

参照個所

データベースの準備

△

データベースに接続する場合

このマニュアル

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベース（Oracle）に接続する場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

運用管理ポータル

2.2

運用管理エージェントの起動

○

必ず実施

4.1.2

Management Serverの起動

○

必ず実施

4.1.2

システム環境の設定

○

必ず実施

3.2

システム環境のセットアップ

○

必ず実施

論理ユーザサーバの設定

○

必ず実施

3.2.4

システムの起動（論理サーバの起動）

○

必ず実施

4.1.2

リソースアダプタの設定

△

リソースアダプタ（DB Connector）によるリソース接続をする場合

3.3

リソースアダプタ（DB Connector以外）によるリソース接続をする場合

リソースアダプタの開始

△

リソースアダプタによるリソース接続をする場合

4.1.2

業務アプリケーションの設定と開始

○

必ず実施

3.4，4.1.2

（凡例）

運用管理ポータル：マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を示します。

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

表4‒31　論理ユーザサーバを配置するシステムの構築時に実施する作業と作業の要否（Smart Composer機能利用時）

論理ユーザサーバを配置するシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

△

データベースに接続する場合

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベースがOracleの場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベースがHiRDBの場合

4.1.6

データベースがOracleの場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

4.1.14

運用管理エージェントの起動

○

必ず実施

4.1.17

Management Serverの起動

○

必ず実施

4.1.18

システム環境の設定（簡易構築定義ファイルの設定）

○

必ず実施

4.1.20，4.5.2

システム環境の構築（セットアップ）

○

必ず実施

4.1.23

システムの起動

○

必ず実施

4.1.24

リソースアダプタの設定

△

DB Connectorによる接続の場合

4.1.26

DB Connector以外による接続の場合

4.1.27

リソースアダプタの開始

△

リソースと接続する場合

4.1.28

業務アプリケーションの設定と開始

○

必ず実施

4.1.29

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

4.5.2　論理ユーザサーバを簡易構築定義ファイルで設定する（CUI利用時）

ここでは，Smart Composer機能を使用して，次に示す論理ユーザサーバを追加する場合の簡易構築定義ファイルの作成例について説明します。

論理ユーザサーバは，特定のサービスユニットに関連づけると，サービスユニットの起動／停止と同時に，ユーザサーバも起動したり，停止したりできます。複数のユーザサーバを，一つのサービスユニットに関連づけることができますが，一つのユーザサーバを，複数のサービスユニットに関連づけることはできません。

MyWebSystemDef.xmlの作成例

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
  <web-system>
    <name>MyWebSystem</name>
    <display-name>MyWebSystem</display-name>
    <description>This is a sample.</description>

    <!--Specify the configurations for the Tier.-->
    <tier>
      <tier-type>http-tier</tier-type>
    </tier>
    <tier>
      <tier-type>j2ee-tier</tier-type>
    </tier>

    <!--Specify the hosts for each Service Unit.-->
    <unit>
      <name>unit1</name>
      <allocated-host>
        <host-ref>apsv1</host-ref>
        <hosts-for>http-tier</hosts-for>
        <define-server>
          <logical-server-name>UserServer1</logical-server-name>
          <logical-server-type>user-server</logical-server-type>
            <configuration>
            <param>
            <!-- サーバ起動用コマンド -->
              <param-name>start.arg</param-name>
              <param-value>c:/test/start.exe</param-value>
            </param>
            </configuration>
        </define-server>
      </allocated-host>
      <allocated-host>
        <host-ref>apsv2</host-ref>
        <hosts-for>j2ee-tier</hosts-for>
        <define-server>
          <logical-server-name>UserServer2</logical-server-name>
          <logical-server-type>user-server</logical-server-type>
            <configuration>
            <param>
            <!-- サーバ起動用コマンド -->
              <param-name>start.arg</param-name>
              <param-value>c:/test/start.exe</param-value>
            </param>
            </configuration>
        </define-server>
      </allocated-host>
    </unit>
  </web-system>

  <!--Specify the settings for the host.-->
  <host>
    <host-name>apsv1</host-name>
    <agent-host>apsv1</agent-host>
  </host>
  <host>
    <host-name>apsv2</host-name>
    <agent-host>apsv2</agent-host>
  </host>
</model-definition>

注　論理ユーザサーバのパラメタは，物理ティアの定義には設定できません。論理ユーザサーバのパラメタを設定する場合は，サービスユニットの定義に設定してください。この定義例では，サービスユニットの起動と同時にユーザサーバを起動するように，サーバ起動用コマンドを指定しています。

4.6　バッチアプリケーションを実行するシステムの構築

バッチアプリケーションを実行するシステムは，定型的または定期的な作業をまとめて処理するバッチ業務を実行できるシステムです。バッチアプリケーションは，バッチ業務を実行するためのアプリケーションで，バッチサーバ上で動作します。このシステムは，セットアップウィザードでは構築できません。Smart Composer機能または運用管理ポータルで構築してください。

4.6.1　バッチアプリケーションを実行するには

バッチアプリケーションを実行するシステムでは，バッチサーバを配置したアプリケーションサーバを中心に構築します。また，業務の用途に合わせて，バッチジョブを自動実行するための関連プログラムを配置したり，バッチアプリケーションの実行をスケジュールするためのアプリケーションサーバの機能を設定したりします。

Smart Composer機能の場合は，バッチサーバを配置するホスト（j2ee-tier）や論理サーバの環境設定を定義した簡易構築定義ファイルから，コマンドを使用して構築します。また，運用管理ポータルの場合は，［運用管理ポータル］画面の各画面で，それぞれのホストに論理サーバ（バッチサーバなど）を配置して，各論理サーバの設定情報をホストに配布して構築します。

システム構成例

バッチアプリケーションを実行するシステムの構成例を次の図に示します。バッチアプリケーションを実行するシステムの場合，運用管理機能（Management Server）はバッチサーバを配置するホストに設定します。また，この構成例では，ネットワークは単一構成（業務LANと管理LANを分けない構成）とし，各ホストは物理NICを一つ使用するものとします。

図4‒10　バッチアプリケーションを実行するシステムの構成例

実施する作業と作業の要否

バッチアプリケーションを実行するシステムの構築時に実施する作業と作業の要否を，利用する構築ツールごとに次の表に示します。なお，参照先の記述にある「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

表4‒32　バッチアプリケーションを実行するシステムの構築時に実施する作業と作業の要否（運用管理ポータル利用時）

バッチアプリケーションを実行するシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照先マニュアル

参照個所

データベースの準備

△

データベースに接続する場合

このマニュアル

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベース（Oracle）に接続する場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

運用管理ポータル

2.2

運用管理エージェントの起動

○

必ず実施

4.1.2

Management Serverの起動

○

必ず実施

4.1.2

システム環境の設定

○

必ず実施

5.2

システム環境のセットアップ

○

必ず実施

システムの起動（論理サーバの起動）

○

必ず実施

6.1.2

リソースアダプタの設定

△

リソースアダプタ（DB Connector）によるリソース接続をする場合

5.3

リソースアダプタ（DB Connector以外）によるリソース接続をする場合

リソースアダプタの開始

△

リソースアダプタによるリソース接続をする場合

6.1.2

システム環境定義の変更

△

運用で必要な場合

6.2

リソースアダプタの設定変更

△

運用で必要な場合

6.2

システムの停止（論理サーバの停止）

△

運用で必要な場合

6.1.4

Management Serverの停止

△

運用で必要な場合

4.1.4

運用管理エージェントの停止

△

運用で必要な場合

4.1.4

システム環境の削除

△

運用で必要な場合

5.4

（凡例）

運用管理ポータル：マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

表4‒33　バッチアプリケーションを実行するシステムの構築時に実施する作業と作業の要否（Smart Composer機能利用時）

バッチアプリケーションを実行するシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

△

データベースに接続する場合

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベースがOracleの場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

Application Serverのインストール

○

必ず実施

2.2.1

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベースがHiRDBの場合

4.1.6

データベースがOracleの場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

4.1.14

運用管理エージェントの起動

○

必ず実施

4.1.17

Management Serverの起動

○

必ず実施

4.1.18

システム環境の設定（簡易構築定義ファイルの設定）

○

必ず実施

4.1.20，4.6.2

システム環境の構築（セットアップ）

○

必ず実施

4.1.23

システムの起動

○

必ず実施

4.1.24

リソースアダプタの設定

△

DB Connectorによる接続の場合

4.1.26

DB Connector以外による接続の場合

4.1.27

リソースアダプタの開始

△

リソースと接続する場合

4.1.28

システム環境定義の変更

△

運用で必要な場合

4.1.31

リソースアダプタの設定変更

△

運用で必要な場合

4.1.33

システムの停止

△

運用で必要な場合

4.1.34

Management Serverの停止

△

運用で必要な場合

4.1.35

運用管理エージェントの停止

△

運用で必要な場合

4.1.36

システム環境の削除

△

運用で必要な場合

4.1.37

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

注　バッチサーバを実行するシステムの運用時の注意事項については，「4.6.3　バッチアプリケーションを実行するシステムを運用するときの注意事項」を参照してください。

4.6.2　簡易構築定義ファイルを設定するときの注意事項（バッチアプリケーション使用時）

ここでは，バッチアプリケーションを実行するシステムを構築する場合に，簡易構築定義ファイルを設定するときの注意事項について説明します。

バッチサーバとして動作するための設定

サーバプロセスをバッチサーバとして構築し，動作させるためには設定が必要です。バッチサーバは論理J2EEサーバとして定義します。バッチサーバの設定は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定します。

バッチサーバに関する定義を次の表に示します。

表4‒34　バッチサーバに関する定義

項目

パラメタ

設定内容

必須または任意

バッチサーバとしてサーバを構築するための設定

batch.service.enabled

バッチサーバとして構築するかどうかを指定します。パラメタの値は必ずtrueを指定してください。

必須

SecurityManagerを使用しない設定

use.security

バッチサーバの起動時にSecurityManagerを使用するかどうかを指定します。パラメタの値は必ずfalseを指定してください。

必須

ライトトランザクション機能を有効にするための設定

ejbserver.distributedtx.XATransaction.enabled

グローバルトランザクションを使用するかどうかを指定します。バッチサーバの場合，グローバルトランザクションは使用できません。ローカルトランザクションを使用します。このため，ローカルトランザクションに最適化された環境を提供する，ライトトランザクション機能を使用します。パラメタの値は必ずfalseを指定してください。なお，このパラメタはデフォルトの設定がfalseのため，変更しないでください。

任意

明示管理ヒープ機能を無効にする設定

add.jvm.arg

このパラメタはJDK11を使用する場合だけ指定できます。

明示管理ヒープ機能を使用するかどうかを指定します。

バッチサーバの場合，明示管理ヒープ機能を使用しないときは，明示管理ヒープ機能を無効にすることをお勧めします。明示管理ヒープ機能を無効にするには，パラメタの値に-XX:-HitachiUseExplicitMemoryを指定してください。デフォルトの設定の場合，明示管理ヒープ機能は有効（-XX:+HitachiUseExplicitMemory）です。

任意

実サーバ名の設定

realservername

バッチサーバの実サーバ名を指定します。実サーバ名は，同一ホスト内でユニークになるように指定してください。省略した場合は，論理サーバ名が設定されます。

任意

JavaVM終了メソッド呼び出し時のJavaVMの動作設定

ejbserver.batch.application.exit.enabled

次のJavaVM終了メソッドをバッチアプリケーションで呼び出した時に，JavaVMを終了するかどうかを指定します。

java.lang.System.exit(int)

java.lang.Runtime.exit(int)

java.lang.Runtime.halt(int)

デフォルトは「true」（JavaVMを終了しないでバッチアプリケーションのスレッドを終了する）です。「false」を指定すると，JavaVM終了メソッドの呼び出し時に，バッチサーバごとJavaVMが終了されます。詳細については，マニュアル「アプリケーションサーバ機能解説 拡張編」の「2.3.7　バッチアプリケーションの実装（バッチアプリケーションの作成規則）」を参照してください。

任意

（凡例）必須：必ず指定してください。　任意：必要に応じて設定してください。

バッチアプリケーションのスケジューリング機能を使用するための設定

バッチアプリケーションのスケジューリング機能を使用する場合，物理ティアの種類にctm-tierを定義します。この場合，バッチサーバとして動作するための設定に加えて，バッチアプリケーションのスケジューリング機能の設定が必要です。これらの設定は，各論理サーバの<configuration>タグ内に指定します。

バッチサーバとバッチアプリケーションのスケジューリング機能に関する定義を次の表に示します。

表4‒35　バッチサーバとバッチアプリケーションのスケジューリング機能に関する定義

論理サーバの種類

項目

パラメタ

設定内容

必須または任意

論理CTM（component-transaction-monitor）

ORBゲートウェイ機能を使用する設定

ctm.Agent

CTMレギュレータのORBゲートウェイ機能を使用するかどうかを指定します。

スケジューリング機能を使用する場合，CTMレギュレータのORBゲートウェイ機能を使用します。パラメタの値は必ず1を指定してください。

必須

CTMを識別するための設定

ctmid

CTM識別子を指定します。運用管理ドメイン内でユニークな値を設定する必要があります。CTM識別子の設定は省略できます。

任意

論理J2EEサーバ（j2ee-server）

バッチサーバとしてサーバを構築するための設定

batch.service.enabled

バッチサーバとして構築するかどうかを指定します。パラメタの値は必ずtrueを指定してください。

必須

SecurityManagerを使用しない設定

use.security

バッチサーバの起動時にSecurityManagerを使用するかどうかを指定します。パラメタの値は必ずfalseを指定してください。

必須

ライトトランザクション機能を有効にするための設定

ejbserver.distributedtx.XATransaction.enabled

グローバルトランザクションを使用するかどうかを指定します。バッチサーバの場合，グローバルトランザクションは使用できません。ローカルトランザクションを使用します。このため，ローカルトランザクションに最適化された環境を提供する，ライトトランザクション機能を使用します。パラメタの値は必ずfalseを指定してください。なお，このプロパティはデフォルトの設定がfalseのため，変更しないでください。

必須

スマートエージェントを使用する設定

vbroker.agent.enableLocator

スマートエージェントを使用するかどうかを指定します。

スケジューリング機能を使用する場合，スマートエージェントを使用します。パラメタの値は必ずtrueを指定してください。

必須

明示管理ヒープ機能を無効にする設定

add.jvm.arg

このパラメタはJDK11を使用する場合だけ指定できます。

明示管理ヒープ機能を使用するかどうかを指定します。

バッチサーバの場合，明示管理ヒープ機能を使用しないときは，明示管理ヒープ機能を無効にすることをお勧めします。明示管理ヒープ機能を無効にするには，パラメタの値に-XX:-HitachiUseExplicitMemoryを指定してください。デフォルトの設定の場合，明示管理ヒープ機能は有効（-XX:+HitachiUseExplicitMemory）です。

任意

実サーバ名の設定

realservername

バッチサーバの実サーバ名を指定します。

実サーバ名は，同一ホスト内でユニークになるように指定してください。省略した場合は，論理サーバ名が設定されます。

任意

JavaVM終了メソッド呼び出し時のJavaVMの動作設定

ejbserver.batch.application.exit.enabled

次のJavaVM終了メソッドをバッチアプリケーションで呼び出した時に，JavaVMを終了するかどうかを指定します。

java.lang.System.exit(int)

java.lang.Runtime.exit(int)

java.lang.Runtime.halt(int)

デフォルトは「true」（JavaVMを終了しないでバッチアプリケーションのスレッドを終了する）です。「false」を指定すると，JavaVM終了メソッドの呼び出し時に，バッチサーバごとJavaVMが終了されます。詳細については，マニュアル「アプリケーションサーバ機能解説 拡張編」の「2.3.7　バッチアプリケーションの実装（バッチアプリケーションの作成規則）」を参照してください。

任意

スケジュールグループ名の設定

ejbserver.batch.schedule.group.name

CTMによって管理されるバッチサーバ群のスケジュールグループ名を指定します。デフォルトではJOBGROUPが設定されます。

CTMは，スケジュールグループごとにバッチアプリケーションの実行をスケジューリングします。

複数のスケジュールグループを使用してスケジュールキューを分ける場合には，バッチサーバごとにスケジュールグループ名を設定してください。

任意

スケジュールキューの長さの設定

ejbserver.batch.queue.length

CTMで作成されるスケジュールキューの長さを指定します。デフォルトでは50が設定されます。

任意

（凡例）必須：必ず指定してください。　任意：必要に応じて設定してください。

バッチサーバを複数配置するときの注意事項

バッチアプリケーションのスケジューリング機能を使用する場合に，複数のバッチサーバを配置するときは，物理ティアの定義で，1ホストに配置するバッチサーバの数を設定します。

複数のバッチサーバを配置する場合も，物理ティアおよびサービスユニットの定義で，コンフィグレーションを定義できます。バッチサーバのコンフィグレーション定義の適用範囲を次の図に示します。

図4‒11　バッチサーバのコンフィグレーション定義の適用範囲

この図の場合に，各サービスユニットのバッチサーバごとに適用されるコンフィグレーション定義を次の表に示します。

表4‒36　各サービスユニットのバッチサーバごとに適用されるコンフィグレーション定義

サービスユニット

バッチサーバ

適用されるコンフィグレーション定義

unit1

バッチサーバ（1A）

サービスユニットの定義（特定のバッチサーバの定義）

物理ティアの定義（バッチサーバ全体で共通の定義）

バッチサーバ（1B）

物理ティアの定義（バッチサーバ全体で共通の定義）

この表のように，バッチサーバごとに適用されるコンフィグレーション定義が複数ある場合，各定義で同じパラメタを指定したときは，次の1.，2.の順に優先して適用されます。

サービスユニットの定義（特定のバッチサーバの定義）

物理ティアの定義（バッチサーバ全体で共通の定義）

バッチサーバで使用しない定義

バッチサーバでは負荷分散機（<load-balancer>タグ）を使用しません。

4.6.3　バッチアプリケーションを実行するシステムを運用するときの注意事項

バッチアプリケーションを実行するシステムでは，J2EEアプリケーションを実行するシステムと同様の運用ができますが，次の点に注意してください。参照先の記述にある「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

1ホストに配置するバッチサーバの数は，Webシステムの構成変更時に変更できません。

バッチアプリケーションのスケジューリング機能を使用するシステム（ctm-tier）では，スケールアウトおよびスケールインを実施できません。

バッチアプリケーションを実行するシステムの設定を変更する場合，次のパラメタの値は変更しないでください。

batch.service.enabled（バッチサーバの拡張パラメタ）

use.security（SecurityManagerの使用を設定するパラメタ）

グローバルトランザクションは使用できないため，DB ConnectorのRARファイルには，グローバルトランザクション用のRARファイルは使用できません。

リソースに接続するバッチアプリケーションの場合，ユーザ指定名前空間機能を使用してリソースアダプタに別名を設定します。バッチアプリケーションからリソースアダプタをルックアップするには，ユーザ指定名前空間機能で設定した別名を使用してください。ユーザ指定名前空間機能での任意のルックアップ名称は，Connector属性ファイルで設定します。

4.7　運用管理機能から負荷分散機を制御するシステムの構築

負荷分散機は，Webブラウザなどからのリクエストを一元的に受け付けて，同等の機能を持つ複数のサーバに転送して各サーバの負荷を分散させるための装置です。負荷分散機を使用すると，トラフィックを効率的に分散し，処理性能を向上できます。アプリケーションサーバでは，運用管理機能から負荷分散機を制御できます。運用管理機能から負荷分散機を制御するシステムは，Smart Composer機能の場合にだけ構築できます。運用管理ポータルの場合，このシステムは構築できません。

4.7.1　運用管理機能から負荷分散機を制御するには

Smart Composer機能を使用したシステムで運用管理機能から負荷分散機を制御する場合，負荷分散機を準備する以外に，運用管理機能を配置するホストで負荷分散機へ接続する環境を設定する必要があります。

システム構成例

運用管理機能から負荷分散機を制御するシステムの構成例を次の図に示します。ここでは，「4.1　Webサーバを別ホストに配置してマシン性能を向上するシステムの構築」で構築したシステムに負荷分散機を配置して運用管理機能から制御するように設定します。

図4‒12　運用管理機能から負荷分散機を制御するシステムの構成例

例題で使用する設定内容を次の表に示します。

表4‒37　例題で使用する設定内容（運用管理機能からの負荷分散機の制御）

分類

項目

設定例

システム全体

簡易構築定義ファイルの名称

MyWebSystemDef.xml

Webシステムの名称

MyWebSystem

サービスユニットの名称

unit1

負荷分散機

負荷分散機の名称

MyAX2000

負荷分散機の種類

ACOS

負荷分散機の管理IPアドレス

192.168.100.10

仮想サーバの名称

www.sample.com

仮想サーバのIPアドレス

192.168.1.10

仮想サーバのポート番号

80

Webサーバを配置するホスト

ホストの名称

apsv1

IPアドレス（管理IPアドレス）※

192.168.100.11

J2EEサーバを配置するホスト

ホストの名称

apsv2

IPアドレス（管理IPアドレス）※

192.168.100.12

注※　ネットワークが単一構成の場合，IPアドレスは，業務IPアドレスと管理IPアドレスの両方を兼ねます。

実施する作業と作業の要否

運用管理機能から負荷分散機を制御するシステムの構築時に実施する作業と作業の要否を次の表に示します。運用管理機能からの負荷分散機の制御は，Smart Composer機能を使用して実施します。

表4‒38　運用管理機能から負荷分散機を制御するシステムの構築時に実施する作業と作業の要否（Smart Composer機能利用時）

運用管理機能から負荷分散機を制御するシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照個所

データベースの準備

△

データベースに接続する場合

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベース（Oracle）に接続する場合

4.1.2

負荷分散機の準備

○

必ず実施する

4.7.3

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

4.1.14

運用管理エージェントの起動

○

必ず実施

4.1.17

Management Serverの起動

○

必ず実施

4.1.18

負荷分散機への接続の設定

○

必ず実施

4.7.5(1)

システム環境の設定（簡易構築定義ファイルの設定）

○

必ず実施

4.1.20，4.7.5(2)

システム環境の構築（セットアップ）

○

必ず実施

4.1.23

システムの起動

○

必ず実施

4.1.24

リソースアダプタの設定

△

リソースアダプタ（DB Connector）によるリソース接続をする場合

4.1.26

リソースアダプタ（DB Connector以外）によるリソース接続をする場合

4.1.27

リソースアダプタの開始

△

リソースアダプタによるリソース接続をする場合

4.1.28

業務アプリケーションの設定と開始

○

必ず実施

4.1.29

（凡例）

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

注　

運用管理機能からの負荷分散機制御時の注意事項については，「4.7.6　負荷分散機を制御するときの注意事項」を参照してください。

4.7.2　負荷分散機とは

負荷分散機を使用すると，一つの仮想IPアドレスで複数のサーバを管理するロードバランシング機能によって，トラフィックを効率的に分散し，処理性能を向上できます。負荷分散機としてBIG-IP（BIG-IP v9，BIG-IP v10.1，BIG-IP v10.2，BIG-IP v11）またはACOS（AX2000，AX2500，BS320）が使用できます。

Smart Composer機能で構築したシステムは，負荷分散機のCookieスイッチング機能を使用して運用することもできます。Cookieスイッチング機能とは，Cookieを利用してセッションを維持する機能です。プロキシ経由などで要求元IPアドレスからクライアントが特定できない場合でも，同じクライアントからの一連のHTTPリクエストを同じサービスユニットに振り分けることができます。

参考

スイッチングモードについて

08-53以降では，BIG-IPのCookieスイッチング機能のうち，Smart Composer機能で対応しているスイッチングモードはインサートモードだけです。

ACOSの場合，サーバからのレスポンスに対してACOSがcookieを設定します。設定するcookieの形式は次のとおりです。

Set-Cookie:<cookie名>-<仮想ポート>=<実サーバIPアドレス>_<実ポート>

また，Smart Composer機能で構築したシステムでは，異なるWebシステム間や，異なる運用管理ドメインの同じWebシステム間で負荷分散機を共有したり，一つのWebシステム内で負荷分散機を冗長化構成で配置したりできます。

注意事項

Webサーバ連携を使用しないパターン（j2ee-tier），およびfree-tierの場合，負荷分散機を配置できません。

(1)　負荷分散機の制御方法

アプリケーションサーバから負荷分散機を制御するには，CLIコマンドまたはAPIを使用します。この場合，lb.properties（負荷分散機定義プロパティファイル）で，負荷分散機への接続情報を設定します。設定方法については，「4.7.5　負荷分散機へ接続する環境を設定する」を参照してください。

(2)　Webシステム間での負荷分散機の共有

Smart Composer機能で構築するWebシステムでは，異なるWebシステム間で，同じ（1台の）負荷分散機を共有できます。なお，1ホスト内の異なるWebシステムで，1台の負荷分散機を共有する場合は，それぞれのWebシステムで使用する負荷分散機の仮想サーバを分ける必要があります。

負荷分散機を共有する場合の注意事項については，「4.7.6　負荷分散機を制御するときの注意事項」を参照してください。

(3)　負荷分散機の冗長化

Smart Composer機能で構築するWebシステムでは，一つのWebシステム内に，負荷分散機を冗長化構成（アクティブ・スタンバイ構成）で配置できます。配置できる負荷分散機の台数は，2台です。負荷分散機を冗長化構成で配置すると，実行系（アクティブ）の負荷分散機で障害が発生した場合に，リクエストの振り分け処理が自動的に待機系（スタンバイ）の負荷分散機に切り替わって，業務を続行できます。負荷分散機を冗長化する場合の注意事項については，「4.7.6　負荷分散機を制御するときの注意事項」を参照してください。

参考

既存のWebシステムの負荷分散機を冗長化構成に変更したい場合は，既存のWebシステムを削除してから，負荷分散機を冗長化したWebシステムを再構築してください。

4.7.3　負荷分散機を準備する

Smart Composer機能では，負荷分散機としてBIG-IPまたはACOSが使用できます。BIG-IPの場合はBIG-IP v9，BIG-IP v10.1，BIG-IP v10.2，またはBIG-IP v11，ACOSの場合はAX2000，AX2500，またはBS320が使用できます。

アプリケーションサーバは，使用する負荷分散機によって接続方法が異なります。

BIG-IP（BIG-IP v9，BIG-IP v10.1，BIG-IP v10.2，またはBIG-IP v11）の場合

接続方法は，API（SOAPアーキテクチャ）を使用した直接接続です。APIを使用する場合の注意事項については，「4.7.4　接続方法にAPIを使用するときの注意事項」を参照してください。

参考

BIG-IP v9，BIG-IP v10.1，およびBIG-IP v10.2の場合，sshプロトコルを使用した直接接続も使用できます。接続方式にsshプロトコルを使用した直接接続を選択した場合は，Management Serverを配置するホストで事前設定が必要です。設定方法については，「付録J.2(2)　BIG-IP v9，BIG-IP v10.1，またはBIG-IP v10.2の場合」を参照してください。また，Red Hat Enterprise Linux 9.1（AMD/Intel 64）以降を使用する場合はsshプロトコルを使用した直接接続を使用できません。APIを使用してください。

ACOS（AX2000またはBS320）の場合

接続方法は，telnetプロトコルを使用した直接接続です。

ACOS（AX2500）の場合

接続方法は，API（RESTアーキテクチャ）を使用した直接接続です。APIを使用する場合の注意事項については，「4.7.4　接続方法にAPIを使用するときの注意事項」を参照してください。

4.7.4　接続方法にAPIを使用するときの注意事項

負荷分散機の接続方法にAPIを使用する場合は，Management Serverを配置するホストで事前に負荷分散機の接続環境の設定が必要です。設定方法については，マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」の「8.4　負荷分散機の接続環境の設定」を参照してください。

4.7.5　負荷分散機へ接続する環境を設定する

Smart Composer機能から負荷分散機を制御する場合は，負荷分散機への接続の設定をする必要があります。また，簡易構築定義ファイルで負荷分散機の定義（<load-balancer>タグの定義）を設定する必要があります。

(1)　負荷分散機への接続の設定

使用する負荷分散機の種類，接続方式など，負荷分散機へのアクセスに必要な接続情報をSmart Composer機能で定義します。運用管理機能を配置するホストで，lb.properties（負荷分散機定義プロパティファイル）に負荷分散機への接続情報を設定します。設定する情報には，負荷分散機独自のものと，共通のものがあります。

telnetを使用した直接接続を使用する負荷分散機（AX2000，BS320）のlb.propertiesの設定例を次に示します。APIを使用した直接接続を使用する負荷分散機の設定例については，マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」の「8.5　Management Server（Smart Composer機能）での負荷分散機の接続情報の設定」を参照してください。

lb.list=192.168.100.10
lb.enable_passwd.192.168.100.10=adminpw

lb.connect_type.192.168.100.10=telnet
#lb.telnet.port.192.168.100.10=23
lb.telnet.user.192.168.100.10=user01
lb.telnet.passwd.192.168.100.10=user01pw
lb.telnet.user_prompt.192.168.100.10="AX login: "
lb.telnet.passwd_prompt.192.168.100.10="Password: "
lb.telnet.login_prompt.192.168.100.10=>
#lb.telnet.login_timeout.192.168.100.10=10
#lb.telnet.command_timeout.1192.168.100.10=10

lb.propertiesには，負荷分散機の接続ユーザ名，および接続ユーザのパスワードを記述するため，これらの情報が漏洩しないように適切にファイルのアクセス権を設定してください。

(2)　簡易構築定義ファイルの設定

簡易構築定義ファイルの負荷分散機の定義（<load-balancer>タグの定義）で，次のタグを定義します。

cookieスイッチングの定義（<load-balancer>タグの<cookie-switching>タグの定義）※

仮想サーバの定義（<load-balancer>タグの<virtual-server>タグの定義）

注※

負荷分散機のCookieスイッチング機能を使用する場合に必要です。この設定によって，一連のHTTPリクエストが一つのWebサーバまたはJ2EEサーバで処理されます。また，負荷分散機のCookieスイッチング機能を使用する場合は，物理ティアの定義（<tier>タグ）で，J2EEサーバのWebコンテナの設定に「webserver.container.server_id.enabled=true」を指定してください。

簡易構築定義ファイルの作成例を次に示します。ここでは，負荷分散機を定義する<load-balancer>タグ内の定義について説明します。

簡易構築定義ファイルの<load-balancer>タグの定義例

<!--Spacify the settings of load balancer.-->
<load-balancer>
  <name>MyAX2000</name>
  <load-balancer-type>ACOS</load-balancer-type>
  <management-host>192.168.100.10</management-host>
  <virtual-server>
    <virtual-server-name>www.sample.com</virtual-server-name>
    <ip-address>192.168.1.10</ip-address>
    <http-port>80</http-port>
  </virtual-server>
</load-balancer>

4.7.6　負荷分散機を制御するときの注意事項

システムを一括構築するときの注意事項（負荷分散機制御をする場合）

Smart Composer機能では，負荷分散機の基本的な情報（仮想サーバや実サーバの定義，仮想サーバポートと実サーバポートとのバインドなど）だけ設定します。この設定を基にシステム構築時に負荷分散機に仮想サーバや実サーバを作成します。特定のネットワーク構成をサポートするためなどの設定はシステムの一括構築後，手動で設定してください。

Smart Composer機能が実行する負荷分散機のCLIコマンドおよびAPIについては，「付録J　Smart Composer機能が実行する負荷分散機のCLIコマンドまたはAPI」を参照してください。

負荷分散機を共有するときの注意事項

異なるWebシステム間で1台の負荷分散機を共有する場合は，それぞれのWebシステムで使用する負荷分散機の仮想サーバを分ける必要があります。

簡易構築定義ファイルでは，次の定義で注意が必要です。

負荷分散機の定義

各Webシステムの負荷分散機のIPアドレスに，同じ値を設定してください。

仮想サーバの定義（負荷分散機の定義）

各Webシステムの仮想サーバ名，仮想サーバのIPアドレスおよびポート番号が重複しないように設定してください。

また，ACOSの場合は，次の1.または2.の条件を満たす構成のとき，自動的にポート変換する設定（オートトランスレーション機能の使用）が必要です。

仮想サーバまたは実サーバに設定したポート番号が1023より大きいとき（well-knownでないとき）

実サーバのポート番号とそれに対応する仮想サーバのポート番号が異なるとき

（例）仮想サーバのポート番号は80だが，振り分け先のポート番号は8081にしたいとき

オートトランスレーション機能の設定は，あらかじめ負荷分散機に対して実施しておいてください。設定の詳細については，ACOSのドキュメントを参照してください。

負荷分散機を冗長化するときの注意事項

負荷分散機を冗長化する場合は，それぞれの負荷分散機への接続の設定をする必要があります。lb.propertiesには，2台分の負荷分散機へのアクセスに必要な接続情報を設定します。この場合，それぞれの負荷分散機の接続方式（lb.connect_type）には，同じ値を設定してください。

telnetを使用した直接接続を使用する負荷分散機（AX2000，BS320）を冗長化する場合のlb.propertiesの設定例を次に示します。ここでは，負荷分散機LB1とLB2を配置した場合で，LB1の管理IPアドレスを「192.168.1.100」，LB2の管理IPアドレスを「192.168.1.101」として説明します。

lb.list=192.168.1.100,192.168.1.101

#冗長構成の負荷分散機LB1の設定
lb.enable_passwd.192.168.1.100=adminpw
lb.connect_type.192.168.1.100=telnet
lb.telnet.user.192.168.1.100=user01
lb.telnet.passwd.192.168.1.100=user01pw
lb.telnet.user_prompt.192.168.1.100="AX login: "
lb.telnet.passwd_prompt.192.168.1.100="Password: "
lb.telnet.login_prompt.192.168.1.100=>

#冗長構成の負荷分散機LB2の設定
lb.enable_passwd.192.168.1.101=adminpw
lb.connect_type.192.168.1.101=telnet
lb.telnet.user.192.168.1.101=user01
lb.telnet.passwd.192.168.1.101=user01pw
lb.telnet.user_prompt.192.168.1.101="AX login: "
lb.telnet.passwd_prompt.192.168.1.101="Password: "
lb.telnet.login_prompt.192.168.1.101=>

注　背景色付きの太字の部分は同じ値を設定してください。

参考

冗長化した負荷分散機を複数のWebシステムで共有する場合は，各Webシステムの負荷分散機の定義で，<management-host>タグおよび<redundant-management-host>タグに同じIPアドレスを設定してください。

4.8　その他の機能を使用したシステムの構築

その他の機能とは，前節までで説明していないアプリケーションサーバの機能のことです。ここでは，その他の機能を使用したシステムを構築する手順について説明します。

4.8.1　その他の機能を使用するには

その他の機能を使用したシステムを構築する場合，まず，使用する機能に合わせて必要な論理サーバを検討してシステム構成を決定します。使用する機能を決定する際には，次に示す機能解説のマニュアルを参照してください。

マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」

マニュアル「アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」

マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」

マニュアル「アプリケーションサーバ 機能解説 拡張編」

マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」

マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」

次に，使用する機能に合わせて各論理サーバの環境を設定してシステムを構築します。デフォルトの設定で有効な機能と無効な機能がありますので，必要に応じて論理サーバの環境設定を変更してください。

その他の機能を使用したシステムの構築時に実施する作業と作業の要否を，利用する構築ツールごとに次の表に示します。

表4‒39　その他の機能を使用したシステムの構築時に実施する作業と作業の要否（運用管理ポータル利用時）

その他の機能を使用したシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照先マニュアル

参照個所

システム設計の準備

○

必ず実施

設計

2章

システム構成の検討

○

必ず実施

3章

使用するリソースの見積もり

○

必ず実施

5章

データベースの準備

△

データベースに接続する場合

このマニュアル

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベース（Oracle）に接続する場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

運用管理ポータル

2.2

運用管理エージェントの起動

○

必ず実施

4.1.2

Management Serverの起動

○

必ず実施

4.1.2

システム環境の設定

○

必ず実施

3.2

システム環境のセットアップ

○

必ず実施

システムの起動（論理サーバの起動）

○

必ず実施

4.1.2

リソースアダプタの設定

△

リソースアダプタ（DB Connector）によるリソース接続をする場合

3.3

リソースアダプタ（DB Connector以外）によるリソース接続をする場合

リソースアダプタの開始

△

リソースアダプタによるリソース接続をする場合

4.1.2

業務アプリケーションの設定と開始

△

オンライン業務（J2EEアプリケーション）を実行する場合

3.4，4.1.2

（凡例）

設計：マニュアル「アプリケーションサーバ システム設計ガイド」を示します。

運用管理ポータル：マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を示します。

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

表4‒40　その他の機能を使用したシステムの構築時に実施する作業と作業の要否（Smart Composer機能利用時）

その他の機能を使用したシステムの構築時に実施する作業

作業の要否

作業の実施条件

参照先マニュアル

参照個所

システム設計の準備

○

必ず実施

設計

2章

システム構成の検討

○

必ず実施

3章

使用するリソースの見積もり

○

必ず実施

5章

データベースの準備

△

データベースに接続する場合

このマニュアル

2.1.1

データベースの環境の設定（Oracleの設定）

△

データベース（Oracle）に接続する場合

4.1.2

Component Container管理者の設定（UNIXの場合）

△

OSがUNIXの場合で一般ユーザに操作権限を与えるとき

4.1.3

Application Serverのインストール

○

必ず実施（OSがWindowsの場合）

2.2.2

必ず実施（OSがAIXの場合）

2.2.3

必ず実施（OSがLinuxの場合）

2.2.4

データベースに接続するための製品のインストール

△

データベースに接続する場合

2.2.5

アプリケーションサーバでサポートしているシンボリックリンク（UNIXの場合）

△

OSがUNIXの場合

4.1.5

データベース接続環境の設定

△

データベース（HiRDB）に接続する場合

4.1.6

データベース（Oracle）に接続する場合

4.1.7

データベース（SQL Server）に接続する場合

4.1.8

システムの環境変数の設定

○

必ず実施

4.1.11

論理サーバの環境変数の設定

△

インストール時の環境変数を変更する場合

4.1.12

運用管理機能の構築

○

必ず実施

4.1.14

運用管理エージェントの起動

○

必ず実施

4.1.17

Management Serverの起動

○

必ず実施

4.1.18

システム環境の設定（簡易構築定義ファイルの設定）

○

必ず実施

4.1.20，4.8.2※

システム環境の構築（セットアップ）

○

必ず実施

4.1.23

システムの起動

○

必ず実施

4.1.24

リソースアダプタの設定

△

リソースアダプタ（DB Connector）によるリソース接続をする場合

4.1.26

リソースアダプタ（DB Connector以外）によるリソース接続をする場合

4.1.27

リソースアダプタの開始

△

リソースアダプタによるリソース接続をする場合

4.1.28

業務アプリケーションの設定と開始

△

オンライン業務（J2EEアプリケーション）を実行する場合

4.1.29

（凡例）

設計：マニュアル「アプリケーションサーバ システム設計ガイド」を示します。

○：必ず実施する作業です。

△：作業の実施条件を満たす場合に実施する作業です。

注※　次の機能を使用するシステムを構築する場合に参照してください。

CTMを使用したスケジューリング機能

NIO HTTPサーバ機能（Webサーバ連携を行わない場合）

4.8.2　簡易構築定義ファイルを設定するときの注意事項（その他の機能使用時）

ここでは，次のアプリケーションサーバの機能を使用するシステムを，Smart Composer機能を使用して，簡易構築定義ファイルで設定するときの注意事項について説明します。

CTMを使用したスケジューリング機能

NIO HTTPサーバ機能（Webサーバ連携を行わない場合）

(1)　J2EEアプリケーションを実行するシステムでCTMを使用したスケジューリング機能を使用する場合

CTMを使用するシステムでは，CTMにリクエストを送信するクライアントの定義が必要です。クライアントとして，Smart Composer機能や運用管理ポータルを使用して構築したWebフロントシステム以外にも，EJBクライアントやユーザが独自に定義するWebフロントシステムが利用できます。

統合ネーミングスケジューラサーバ（グローバルCORBAネーミングサービスを配置したホスト）を使用した，統合ネーミングスケジューラサーバモデルで構築する場合，簡易構築定義ファイルでは，統合ネーミングスケジューラサーバと，アプリケーションサーバを定義する必要があります。統合ネーミングスケジューラサーバとアプリケーションサーバは，それぞれ別のWebシステムで定義します。また，CTMにリクエストを送信するシステムとして，Smart Composer機能で構築するWebフロントシステムを使用する場合は，スケジューリング機能で使用するWebシステムとは別にWebシステムを定義してください。

Webシステムごとに，簡易構築定義ファイルで必要な定義について説明します。

(a)　アプリケーションサーバ（CTM）用のWebシステム

このWebシステムでは，アプリケーションサーバを定義します。

Webシステムの属性定義

アプリケーションサーバを構築するWebシステムを定義します。

負荷分散機の定義

負荷分散機は定義できません。負荷分散機を定義した場合は，エラーとなります。

物理ティアの定義

物理ティアの種類にはctm-tierを定義します。

アプリケーションサーバでは，複数のJ2EEサーバが配置できます。複数のJ2EEサーバを配置する場合は，物理ティアの定義で，1ホストに配置するJ2EEサーバの数を設定します。なお，1ホストに配置するJ2EEサーバの数は，Webシステムの構成変更時に変更できません。

ctm-tierでは，CTMドメインマネジャ，CTM，スマートエージェントおよびパフォーマンストレーサのコンフィグレーションと，J2EEサーバ全体で共通のコンフィグレーションを設定できます。複数のJ2EEサーバを配置する場合は，同じ番号（<server-no>タグ）を持つJ2EEサーバで共通のコンフィグレーションも設定できます。

J2EEサーバごとに適用されるコンフィグレーション定義が複数ある場合，各定義で同じパラメタを指定したときは，次の1.，2.，3.の順に優先して適用されます。

サービスユニットの定義（特定のJ2EEサーバの定義）

物理ティアの定義（同じ番号を持つJ2EEサーバで共通の定義）

物理ティアの定義（J2EEサーバ全体で共通の定義）

統合ネーミングスケジューラサーバとの関係を定義するため，次に示すパラメタは，統合ネーミングスケジューラサーバと同じ値を設定してください。

CTMドメインマネジャが属するCTMドメイン名（論理CTMドメインマネジャのctmdomname）

CTMドメインマネジャで使用するポート番号（論理CTMドメインマネジャのcdm.port）

スマートエージェントで使用するポート番号（論理スマートエージェントのsmartagent.port）

サービスユニットの定義

CTM関連のプロセス，J2EEサーバを配置するサービスユニットを定義します。

サービスユニットごとに，CTMドメインマネジャ，CTM，スマートエージェントおよびパフォーマンストレーサのコンフィグレーションと，特定のJ2EEサーバのコンフィグレーションを設定できます。複数のJ2EEサーバを配置する場合，サービスユニット内のJ2EEサーバは，番号（<server-no>タグ）で特定します。

CTMを識別するCTM識別子（ctmid）は，運用管理ドメイン内でユニークな値を設定する必要があります。CTM識別子（ctmid）の設定は省略できます。

ホストの定義

CTM関連のプロセス，J2EEサーバを配置するアプリケーションサーバを定義します。

(b)　統合ネーミングスケジューラサーバ用のWebシステム

統合ネーミングスケジューラサーバモデルで構築する場合に，このWebシステムが必要になります。このWebシステムでは，統合ネーミングスケジューラサーバ（グローバルCORBAネーミングサービスを配置したマシン）を定義します。

Webシステムの属性定義

統合ネーミングスケジューラサーバを構築するWebシステムを定義します。

負荷分散機の定義

負荷分散機は定義できません。負荷分散機を定義した場合は，エラーとなります。

物理ティアの定義

物理ティアの種類にはctm-tierを定義します。

統合ネーミングスケジューラサーバではJ2EEサーバを配置しないため，ctm-tierで，J2EEサーバの数に0を設定します。

ctm-tierでは，CTMドメインマネジャ，CTM，スマートエージェントおよびパフォーマンストレーサのコンフィグレーションを設定できます。

サービスユニットの定義

CTM関連のプロセスを配置するサービスユニットを定義します。

ホストの定義

統合ネーミングスケジューラサーバを定義します。

(2)　NIO HTTPサーバ機能（Webサーバ連携を行わない場合）を使用する場合

簡易構築定義ファイルでは，次の定義が必要になります。なお，j2ee-tierでは負荷分散機が使用できないため，負荷分散機の定義は削除します。負荷分散機を使用する場合は，運用管理ポータルを使用して構築してください。

物理ティアの定義

物理ティアの種類にはj2ee-tierを定義します。また，j2ee-tierで，NIO HTTPサーバ機能を使用するための設定を定義します。

サービスユニットの定義

J2EEサーバを配置するサービスユニットを定義します。NIO HTTPサーバが使用するポート番号を定義します。

(3)　各機能で共通の注意事項

各機能を使用する場合に，1ホストに複数のサービスユニットを配置できます。ただし，同じCTMドメインのサービスユニットは，1ホスト内に複数配置できません。1ホスト内に複数のサービスユニットを配置するときの注意事項を次に示します。

(a)　論理サーバの設定に関する注意事項

1ホストに複数のサービスユニットをすると，同じホスト内に同じ種類の論理サーバが複数存在することになります。このため，簡易構築定義ファイルを作成する際には，各論理サーバのコンフィグレーションで，次に示す項目の指定値を重複しないようにしてください。

表4‒41　論理サーバごとに重複しないように設定する項目

論理サーバの種類

項目

param-nameの指定値

Webサーバ

httpポート番号

Listen

J2EEサーバ

NIO HTTPサーバのポート番号

webserver.connector.nio_http.port※1

ajp13のポート番号

webserver.connector.ajp13.port※2

インプロセスのネーミングサービス用のポート番号

ejbserver.naming.port

インプロセスのHTTPサーバのポート番号

webserver.connector.inprocess_http.port※2

JTAリカバリの固定ポート番号

ejbserver.distributedtx.recovery.port

RMIレジストリのポート番号

ejbserver.rmi.naming.port

管理用サーバのポート番号

ejbserver.http.port

稼働情報取得時のリクエスト受付ポート番号

ejbserver.rmi.remote.listener.port

パフォーマンストレーサ

PRF識別子

PRFID

スマートエージェント

スマートエージェントが監視するポート番号

smartagent.port

CTMドメインマネジャ

CTMドメインマネジャが属するCTMドメイン名

ctmdomname

CTM実行環境ディレクトリ

ctmspool

CTMドメインマネジャがCTMドメイン構成情報を交換するために使用するポート番号

cdm.port

CTM

CTMの識別子

ctmid※3

CTMが使用するポート番号

ctm.port

CTMと対となるネーミングサービスのポート番号

ctm.ns.port

注※1　推奨モードで使用されます。推奨モードを使用しない場合はManagement Serverで無視されます。

注※2　V9互換モードで使用されます。V9互換モードを使用しない場合はManagement Serverで無視されます。

注※3　ctmidの設定は省略できます。省略時は，ホスト間で一意になるようにManagement Serverで自動的に設定されます。

参考

1ホスト内にある複数のサービスユニットを同時に起動しない運用をする場合は，各サービスユニットの同じ種類の論理サーバに同じ値を設定できます。

ホストに配置するサービスユニットが属するWebシステムによって，これらの設定項目をどの定義のコンフィグレーションで指定するかが異なります。

同じWebシステムのサービスユニットを同じホストに配置する場合

各サービスユニットの論理サーバ定義（<define-server>タグ）内の<configuration>タグで指定します。

異なるWebシステムのサービスユニットを同じホストに配置する場合

各Webシステムの物理ティア定義（<tier>タグ）内の<configuration>タグで指定します。

(b)　Webサーバのポート番号に関する注意事項

サーバマシン内に複数のサービスユニットを配置する場合に，Webサーバのポート番号を変更するときは，次に示す制限事項があります。なお，複数のサービスユニットが，同一のWebシステム内にある場合も，異なるWebシステムにある場合も，この制限事項の対象となります。

複数のサービスユニットのWebサーバで同じポート番号を設定している場合

1台のサーバマシン内で，複数のサービスユニットを同時に起動しない運用をする場合は，各サービスユニットのWebサーバに同じポート番号を設定できます。

この場合は，次のどちらかの手順で変更してください。

すべてのサービスユニットのWebサーバのポート番号を同時に変更します。

一部のサービスユニットのWebサーバのポート番号を変更します。そのあと，ほかのサービスユニットのWebサーバのポート番号を変更します。

注意事項

一部のサービスユニットのWebサーバのポート番号を変更した場合，ほかのサービスユニットのWebサーバのポート番号は削除され，ポート番号を削除されたWebサーバは使用できなくなります。このため，必ず，あとからほかのサービスユニットのWebサーバのポート番号も変更してください。

複数のサービスユニットのWebサーバで異なるポート番号を設定している場合

ここでは，サービスユニット１（unit1）のWebサーバでポート番号に80，サービスユニット2（unit2）のWebサーバでポート番号に81を設定している場合を例に説明します。ポート番号の設定変更の方法と変更可否を次の表に示します。

表4‒42　ポート番号の変更方法と変更可否

ポート番号の変更方法

論理サーバのパラメタ変更用の構成変更定義ファイルの設定方法

変更後のWebサーバのポート番号

変更可否

unit1

unit2

各サービスユニットのWebサーバのポート番号を同じ番号へ変更

サービスユニット1のWebサーバにポート番号81を設定します。

81

81

○

サービスユニット2のWebサーバにポート番号80を設定します。

80

80

○

各サービスユニットのWebサーバのポート番号の入れ替え

サービスユニット1のWebサーバにポート番号81を，サービスユニット2のWebサーバにポート番号80を設定します。

81

80

×

一方のサービスユニットのWebサーバを他方で設定済みのポート番号に変更して，他方のサービスユニットのWebサーバを未使用のポート番号（82とする）へ変更

サービスユニット1のWebサーバにポート番号81を，サービスユニット2のWebサーバにポート番号82を設定します。

81

82

×

サービスユニット1のWebサーバにポート番号82を，サービスユニット2のWebサーバにポート番号80を設定します。

82

80

×

一方のサービスユニットのWebサーバを未使用のポート番号（82とする）へ変更

サービスユニット1のWebサーバにポート番号82を設定します。

82

81

○

サービスユニット2のWebサーバにポート番号82を設定します。

80

82

○

（凡例）○：変更できます。　×：変更できません。

参考

設定済みのポート番号に変更する場合に，1回の操作で変更できない変更方法は，いったん未使用のポート番号を設定してから入れ替えたり，複数回に分けて変更したりするなどの，設定変更操作を実施すれば変更できます。

4.8.3　WebSocketを使用する場合の設定

(1)　WebSocketのログを出力する場合の設定

論理WebサーバのJ2EEサーバとの連携方法がリバースプロキシの環境で，WebSocketを使用したアプリケーションを実行する場合，論理WebサーバにHWSWebSocketLogディレクティブを設定してください。HWSWebSocketLogディレクティブの設定例を次の表に示します。

表4‒43　HWSWebSocketLogディレクティブの設定例

対象OS

設定例

Windows

HWSWebSocketLog "|¥"¥"<Application Serverのインストールディレクトリ※>/httpsd/sbin/rotatelogs.exe¥" ¥"<Application Serverのインストールディレクトリ※>/httpsd/servers/HWS_<論理Webサーバの実サーバ名>/logs/hws_websocket_log¥" <分割時間間隔> -fnum <ファイル数> -diff <分割基準時間差分>¥""

UNIX

HWSWebSocketLog "|/opt/hitachi/httpsd/sbin/rotatelogs /opt/hitachi/httpsd/servers/HWS_<論理Webサーバの実サーバ名>/logs/hws_websocket_log <分割時間間隔> -fnum <ファイル数> -diff <分割基準時間差分>"

注※　ファイルおよびディレクトリのパスは，絶対パスで設定してください。

HWSWebSocketLogディレクティブの詳細は，マニュアル「HTTP Server」を参照してください。

運用管理ポータルで設定する場合は，追加ディレクティブで設定してください。追加ディレクティブについては，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.1　Webサーバの設定」を参照してください。

Smart Composerで設定する場合は，AppendDirectivesパラメタ（追加ディレクティブ）で設定してください。AppendDirectivesパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.10.2　Webサーバ用定義を設定するパラメタ」を参照してください。

4.8.4　HWSGracefulStopTimeoutディレクティブとManagerの停止監視時間の設定に関する注意点

次の表に示す条件に応じて，論理WebサーバにHWSGracefulStopTimeoutディレクティブを設定してください。

表4‒44　HWSGracefulStopTimeoutディレクティブの設定に関する注意点

Cosminexus Component Containerのバージョン

WebSocket使用有無

注意点

11-00-01より前

−

設定不要※1

11-00-01以降

使用しない

停止監視時間を，HWSGracefulStopTimeoutディレクティブのデフォルト値以上の値に変更する場合，HWSGracefulStopTimeoutディレクティブには，0，または停止監視時間より大きな値を設定してください。※2 ※3 ※5

使用する

HWSGracefulStopTimeoutディレクティブには，1以上，かつ停止監視時間より小さな値を設定してください。※2 ※4 ※5

（凡例）−：該当しません。

注※1　ManagerがHWSGracefulStopTimeoutディレクティブに自動で0を設定します。

注※2　停止監視時間とHWSGracefulStopTimeoutディレクティブの両方に0を設定すると，Cosminexus HTTP Serverが正常停止できなかった場合に，無限に待ち続けてしまうため，停止監視時間の0（監視しない）と，HWSGracefulStopTimeoutディレクティブの0を，同時に設定しないでください。

注※3　Managerから停止した場合に停止監視時間より先にCosminexus HTTP Serverがタイムアウトするのを防ぐためです。

注※4　Managerから停止した場合に停止監視時間より先にCosminexus HTTP Serverがタイムアウトしないことによって，ManagerがCosminexus HTTP Serverを強制停止するのを防ぐためです。

注※5　KeepAliveTimeoutディレクティブには，停止監視時間より小さい値を設定してください。

HWSGracefulStopTimeoutディレクティブを運用管理ポータルで設定する場合は，追加ディレクティブで設定してください。追加ディレクティブについては，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.1　Webサーバの設定」を参照してください。Smart Composerで設定する場合は，AppendDirectivesパラメタ（追加ディレクティブ）で設定してください。AppendDirectivesパラメタについては，マニュアル「アプリケーションサーバ リファレンス定義編(サーバ定義)」の「4.10.2　Webサーバ用定義を設定するパラメタ」を参照してください。

KeepAliveTimeoutディレクティブを運用管理ポータルで設定する場合は，KeepAlive接続時の要求待ち時間で設定してください。KeepAlive接続時の要求待ち時間については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.1　Webサーバの設定」を参照してください。Smart Composerで設定する場合は，KeepAliveTimeoutパラメタで設定してください。KeepAliveTimeoutパラメタについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.10.2　Webサーバ用定義を設定するパラメタ」を参照してください。

4.9　運用上の注意事項

Managerを日本語ロケール以外のロケールで使用する場合に，次の条件がすべて重なるときは，ログファイルに出力されるメッセージが文字化けします。

運用管理ポータルの設定項目の値に日本語が指定され，その値がログに出力される

簡易構築定義ファイルおよび構成変更定義ファイルで論理サーバのコンフィグレーションのパラメタに日本語の値が指定され，その値がログに出力される

UNIXの場合，Management Server，運用管理エージェント，および次に示すコマンドのロケールを統一してください。

mngsvrutilコマンド

snapshotlogコマンド

Smart Composer機能で使用するコマンド（cmx_から始まるコマンド）

運用管理エージェントまたはManagement Serverの起動に続けて，運用管理コマンド（mngsvrutil）またはSmart Composer機能などでManagement Serverにアクセスする場合，事前に次のどちらかの対策をしてください。

運用管理エージェントまたはManagement Serverの起動時に同期実行を有効にし，起動に続けてコマンドを実行する。

mngsvrutil checkまたはadminagentcheckコマンドで，運用管理エージェントまたはManagement Serverが起動済みであることを確認する。

5　システムの構築・運用時に使用する画面，コマンドおよびファイル

この章では，システムの構築・運用で使用する運用管理ポータルの画面，コマンドおよびファイルについて説明します。

5.1　システムの構築・運用時に使用する画面

ここでは，システムの構築・運用時に使用する運用管理ポータルの画面について説明します。

表5‒1　システムの構築・運用時に使用する運用管理ポータルの画面

画面名

画面の説明

「運用管理ポータル操作ガイド」の参照個所※

［Cosminexus Management Serverの設定］画面

Management Serverに関する設定のルートです。

8.1

［J2EEアプリケーションのアップロード］画面

J2EEアプリケーションをManagement Server稼働ホストにアップロードします。

12.2.1

［J2EEアプリケーションのインポート］画面

論理J2EEサーバにアーカイブ形式のJ2EEアプリケーションをインポートします。

12.3.3

［J2EEアプリケーションの開始／停止］画面

論理J2EEサーバにインポートしたJ2EEアプリケーションを開始します。

12.3.1

［J2EEアプリケーションの開始］画面

［J2EEアプリケーションの削除］画面

インポート済みの停止しているJ2EEアプリケーションを削除します。

12.3.5

［JP1連携の設定］画面

Application Serverの障害情報をJP1イベントとして発行できます。

8.2.7

［Management Serverへログイン］画面

運用管理ポータルにログインするかどうかを設定します。

7.1.2

［Webコンテナの設定］画面

Webコンテナが起動するときのオプションを設定します。

10.8.4

［Webサーバの設定］画面

Webサーバを稼働させるために必要な情報を設定します。

10.9.1

［一括起動］画面

運用管理ドメイン内のすべての論理サーバを一括起動できます。

11.3.2

［一括再起動］画面

運用管理ドメイン内のすべての論理サーバを一括で再起動できます。

11.3.4

［一括停止］画面

運用管理ドメイン内のすべての論理サーバを一括停止できます。

11.3.3

［運用管理ポータル］画面

運用管理ポータルのトップページです。

7.2

［開始時の設定］画面

Management Serverを起動するときに，論理サーバを一括起動するかどうかを設定します。

8.2.5

［環境変数の設定］画面

サーバ起動時の環境変数の情報を設定します。

10.8.27

［管理ユーザアカウントの設定］画面

Management Serverへログインするための管理ユーザアカウントを設定します。

8.2.1

［<サーバの種類>の稼働情報監視］画面

J2EEサーバ内の，J2EEコンテナやJavaVMの稼働情報を監視できます。

13.3

［<サーバの種類>のステータス監視］画面

選択した論理サーバのステータスを監視できます。

13.2.3

［性能解析トレース収集の設定］画面

性能解析トレースファイルを圧縮するZIP形式のファイルの面数を指定します。

8.2.6

［設定情報の配布］画面

設定した情報を各サーバに配布します。

10.10.1

［トランザクションの設定］画面

トランザクションの情報を設定します。

10.8.6

［リソースアダプタのConnector属性ファイル編集］画面

Connector属性ファイルの内容を表示または設定します。

12.4.5

［リソースアダプタのインポート］画面

該当論理J2EEサーバにリソースアダプタをインポートします。

12.4.4

［リソースアダプタの開始］画面

論理J2EEサーバにインポートしたリソースアダプタを開始します。

12.4.1

［リソースアダプタの開始／停止］画面

［リソースアダプタの基本設定］画面

リソースアダプタのプロパティの基本的な設定を表示または設定します。

12.4.5

［リソースアダプタの停止］画面

稼働中のリソースアダプタを停止します。

12.4.2

［リソースアダプタのプロパティ設定］画面

論理J2EEサーバにインポートしたリソースアダプタから，データベースに接続するためのプロパティを表示または設定します。

12.4.5

［ログの設定］画面

Management Serverが出力するログ情報について設定します。

8.2.3

［ログの表示］画面

運用管理ドメイン内の論理サーバ，J2EEアプリケーションおよびリソースアダプタにかかわる実行結果を，ログとして一覧で参照できます。

10.10.2，11.3.6，12.3.6，12.4.7

［論理サーバの稼働状況］画面

運用管理ドメイン内のすべての論理サーバの稼働状況を，一覧で確認できます。

11.3.1

［論理サーバのステータス監視］画面

運用管理ドメイン内にあるすべての論理サーバのステータスを監視できます。

13.2.2

注※　マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の参照先を示します。

5.2　システムの構築・運用時に使用するコマンド

ここでは，システムの構築・運用時に使用するコマンドの種類，OSごとのコマンドの格納先について説明します。

表5‒2　システムの構築・運用時に使用するコマンド

コマンド名

コマンドの説明

コマンドの格納先

「コマンド編」の参照個所※1

adminagentctl

運用管理エージェントの起動と停止

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

7.2

cjdeployrar

リソースアダプタのデプロイ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

2.4

cjgetrarprop

RARファイルの属性の取得

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

cjimportapp

J2EEアプリケーションのインポート

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

2.3

cjimportres

リソースのインポート

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

2.4

cjreplaceapp

アプリケーションの入れ替え

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

2.3

cjsetrarprop

RAR属性設定

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

2.4

cjsetup

J2EEサーバのセットアップとアンセットアップ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥bin¥

UNIXの場合

/opt/Cosminexus/CC/server/bin/

2.2

cjstartapp

J2EEアプリケーションの開始

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

2.3

cjstartrar

リソースアダプタの開始

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

2.4

cjtestres

リソースの接続テスト

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

cmx_build_model

Webシステムの情報モデルの生成

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

8.3

cmx_build_system

Webシステムの構築

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

cmx_change_model

Webシステムの情報モデルの変更

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

cmx_delete_system

Webシステムの削除

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

cmx_export_model

簡易構築定義ファイルの出力

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

cmx_list_model

Webシステムの情報モデルの取得

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

cmx_start_target

Webシステムまたはサービスユニットの開始

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

cmx_stop_target

Webシステムまたはサービスユニットの停止

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

hwsserveredit

複数のWebサーバ環境の生成

Windowsの場合

<Application Serverのインストールディレクトリ>¥httpsd¥admin¥bin¥

UNIXの場合

/opt/hitachi/httpsd/admin/bin/

−※2

jar

アプリケーションへのアプリケーション属性ファイルの設定

Windowsの場合

<Application Serverのインストールディレクトリ>¥jdk¥bin¥

UNIXの場合

/opt/Cosminexus/jdk/bin/

−

mngautorun

自動起動および自動再起動の設定／設定解除

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

7.2

mngenvsetup

管理グループの設定

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

mngsvrctl

Management Serverの起動／停止／セットアップ

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

mngsvrutil

Management Serverの運用管理コマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

setupwizard

システムのセットアップ，アンセットアップと複製

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥setup¥bin¥

UNIXの場合

/opt/Cosminexus/manager/setup/bin/

（凡例）

−：該当しません。

注※1　マニュアル「アプリケーションサーバ リファレンス コマンド編」の参照先を示します。

注※2　hwsservereditコマンドについては，マニュアル「HTTP Server」の「4.12.1　複数のWebサーバ環境の生成（hwsservereditコマンド）」を参照してください。

5.3　システムの構築・運用時に使用するファイル

ここでは，システムの構築・運用時に使用するファイルの種類，テンプレートファイルや，OSごとの格納場所について説明します。

表5‒3　システムの運用環境の構築・運用時に使用するファイル

ファイル名

ファイルの説明

ファイルの格納先

「定義編(サーバ定義)」の参照個所※1

adminagent.properties

運用管理エージェントプロパティファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

8.2.1

adminagent.xml

運用管理エージェント設定ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

8.2.4

Connector属性ファイル

リソースの設定で使用する属性ファイル

−

−※2

cosminexus.xml

アプリケーション属性ファイル

<EARのルート>/META-INF/cosminexus.xml

−※3

lb.properties

負荷分散機定義プロパティファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

4.2.4

manager.cfg

Manager設定ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

8.2.9

mngagent.<実サーバ名>.properties

運用監視エージェントプロパティファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

8.2.5

mserver.properties

Management Server環境設定ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

8.2.6

mevent.<論理サーバ名>.properties

Managementイベント発行用プロパティファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

8.2.11

.mngsvrutilrc

mngsvrutilコマンドのクライアント側定義ファイル

各OSユーザのホームディレクトリ

8.2.14

mngsvrutilcl.properties

mngsvrutilコマンドのクライアント側共通定義ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

8.2.16

setupwizard_success.dat

セットアップ情報ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥setup¥config¥

UNIXの場合

/opt/Cosminexus/manager/setup/config/

−※4

簡易構築定義ファイル

Smart Composer機能で使用するファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥templates¥cmxdefcombinedmodel.xml※5

UNIXの場合

/opt/Cosminexus/manager/config/templates/cmxdefcombinedmodel.xml※5

4.3

構成変更定義ファイル

Smart Composer機能で使用するファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥templates¥cmxmodcombinedmodel.xml※5

<Application Serverのインストールディレクトリ>¥manager¥config¥templates¥cmxaddcombinedmodel.xml※5

UNIXの場合

/opt/Cosminexus/manager/config/templates/cmxmodcombinedmodel.xml※5

/opt/Cosminexus/manager/config/templates/cmxaddcombinedmodel.xml※5

4.4

（凡例）

−：該当しません。

注※1　マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の参照先を示します。

注※2　Connector属性ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

注※3　cosminexus.xmlについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「2.　アプリケーション属性ファイル（cosminexus.xml）」を参照してください。

注※4　setupwizard_success.datについては，「2.2.7　システム環境をセットアップするときの注意事項」を参照してください。

注※5　テンプレートファイルです。

付録

付録A　セットアップウィザードで設定されるパラメタ

セットアップウィザードでシステムをセットアップした場合，システムの各パラメタには，次の値が使用されます。

画面で値を設定したパラメタ

設定した値が使用されます。

画面で値を設定していないパラメタ

簡易構築定義ファイルに指定できるパラメタの省略値が使用されます。

簡易構築定義ファイルに指定できるパラメタ，およびパラメタの省略値については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

ただし，2.のパラメタについては省略値と異なる値が設定されるものがあります。

ここでは，2.のパラメタのうち，省略値と異なる値が設定されるパラメタについて，設定される論理サーバごとに説明します。

付録A.1　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理Webサーバ）

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタのうち，論理Webサーバに設定されるパラメタについて次の表に示します。パラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.10　論理Webサーバで指定できるパラメタ」を参照してください。

表A‒1　パラメタの省略値と異なる値が設定されるパラメタ（論理Webサーバ）

パラメタ名

パラメタの省略値

セットアップウィザードで設定される値

説明

HWSKeepStartServers※1

Off

On

サーバプロセス稼働数が維持されます。

KeepAliveTimeout

15

3

KeepAlive接続時の要求待ち時間として3（単位：秒）を指定します。

Listen

−

80

リクエストを受け付けるポート番号として80を指定します。

カスタムセットアップの［システム環境の設定］画面でWebサーバのポート番号を設定した場合，設定した値が有効になります。

MaxClients.worker※1

400

20

同時に接続できるクライアントの最大数として20を指定します。

StartServers.worker※1

2

1

Webサーバ起動時のサーバプロセス数として1を指定します。

ThreadsPerChild※2

50

20

サーバとして起動するスレッド数として20を指定します。なお，指定したスレッド数はサーバの最大同時接続数を示します。

HttpsdErrorMethod

Div

Wrap

HTTP Serverのエラーログをラップアラウンド方式で出力します。

ThreadsPerChild.worker※1

40

20

一つのサーバプロセスに生成するサーバスレッド数として20を指定します。

（凡例）−：なし

注※1　使用するOSがUNIXの場合にだけ指定値が有効になります。

注※2　使用するOSがWindowsの場合にだけ指定値が有効になります。

付録A.2　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理J2EEサーバ）

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタのうち，論理J2EEサーバに設定されるパラメタについて次の表に示します。パラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.11　論理J2EEサーバで指定できるパラメタ」を参照してください。

表A‒2　パラメタの省略値と異なる値が設定されるパラメタ（論理J2EEサーバ）

パラメタ名

パラメタの省略値

セットアップウィザードで設定される値

説明

ejbserver.connectionpool.applicationAuthentication.disabled

false

true

コンテナ管理のサインオンの最適化機能を有効にします。

ejbserver.ext.method_observation.interval

0

10

J2EEアプリケーション実行時間監視機能を使用します。また，タイムアウトとメソッドキャンセルを異なるスレッドで実行する時間間隔として10（単位：秒）を指定します。

ejbserver.jta.TransactionManager.defaultTimeOut

180

60

J2EEサーバ上で開始されるトランザクションのトランザクションタイムアウトの値として60（単位：秒）を指定します。

ejbserver.logger.channels.define.WebServletLogFile.filesize

4194304

16777216

Webサーブレットログのファイルサイズとして16777216（単位：バイト）を指定します。

add.jvm.arg

−

-Xms512m

Javaヒープメモリ領域の初期サイズとして512（単位：メガバイト）を指定します。

−

-Xmx512m

Javaヒープメモリ領域の最大サイズとして512（単位：メガバイト）を指定します。

−

-XX:MetaspaceSize=128m

Metaspace領域のFullGCのしきい値を変更する計算に使用する値であり，しきい値の最低値となる値を指定します。初期サイズとして128（単位：メガバイト）を指定します。

−

-XX:MaxMetaspaceSize=128m

Metaspace領域の最大サイズとして128（単位：メガバイト）を指定します。

−

-XX:+HitachiVerboseGC

拡張verbosegc情報を出力します。

−

-XX:HitachiVerboseGCIntervalTime=0

拡張verbosegc情報を出力する時間の間隔として0（単位：秒）を指定します。

−

-XX:+HitachiVerboseGCPrintCause

GCの要因内容を，拡張verbosegc情報の行末に出力します。

−

-XX:+HitachiOutputMilliTime

JavaVMログファイルに出力する日時に，ミリ秒まで出力します。

−

-XX:+HitachiCommaVerboseGC

拡張verbosegc情報の出力を，CSVファイルで取得できるようにコンマ形式で出力します。

−

-XX:HitachiJavaLogFileSize=4096k

JavaVMの作成するログファイルの最大サイズとして4096（単位：キロバイト）を指定します。

−

-XX:HitachiJavaLogNumberOfFile=4

JavaVMの作成するログファイルの最大数として4を指定します。

webserver.connector.nio_http.port

8080

80

システム構成の選択時，J2EEサーバだけを配置するシステム（j2ee-tier）を選択した場合に設定されます。NIO HTTPサーバのポート番号を標準のポート番号に指定します。

cpp.library.version

Linux（64ビット版）の場合

6

それ以外の場合

5

6

C++ライブラリのバージョンを指定します。

このパラメタはLinux（64ビット版を除く）だけで設定されます。

use.security

true

false

SecurityManagerを使用しません。

（凡例）−：なし

注※　Shift_JIS互換オプションを指定すると，エンコーディング名「Shift_JIS」が「MS932」の代替名として使用されます。

付録A.3　セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理パフォーマンストレーサ）

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタのうち，論理パフォーマンストレーサに設定されるパラメタについて次の表に示します。パラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.12　論理パフォーマンストレーサで指定できるパラメタ」を参照してください。

表A‒3　パラメタの省略値と異なる値が設定されるパラメタ（論理パフォーマンストレーサ）

パラメタ名

パラメタの省略値

セットアップウィザードで設定される値

説明

mstartup.retrywait

0

60

自動再起動リトライ間隔として60（単位：秒）を指定します。

PrfTraceLevel

STANDARD

00140000

パフォーマンストレーサのトレース取得レベルを次のように指定します。

JCA/DB Connector

詳細

他機能レイヤ

標準

付録B　インストール後のディレクトリ構成

ここでは，Application Serverのインストール後のディレクトリ構成について説明します。また，Application Serverの構成ソフトウェアのうち，Component Containerのディレクトリ構成について説明します。

インストールディレクトリを次に示します。

Windowsのインストールディレクトリ（デフォルト）

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus

UNIXのインストールディレクトリ

/opt/Cosminexus

付録B.1　Application Serverのディレクトリ構成

Application Serverのディレクトリ構成をOSごとに説明します。

Windowsの場合

Windowsの場合のApplication Serverのディレクトリ構成を次の図に示します。

図B‒1　Application Serverのディレクトリ構成（Windowsの場合）

UNIXの場合

UNIXの場合のApplication Serverのディレクトリ構成を次の図に示します。

図B‒2　Application Serverのディレクトリ構成（UNIXの場合）

注意事項

インストールディレクトリについて

Application Serverをインストールすると，/optまたは/opt/Cosminexusのディレクトリ属性が変更されることがあります。

付録B.2　Component Containerのディレクトリ構成

付録B.1の図中にある，Component Containerのディレクトリの下位のディレクトリ構成をディレクトリごとに表に示します。

CCディレクトリ

Component Containerの提供する機能のうち，コンテナなどの基盤部分の機能を提供するディレクトリです。<Application Serverのインストールディレクトリ>¥CC（Windowsの場合），または/opt/Cosminexus/CC（UNIXの場合）です。

表B‒1　Component Containerのディレクトリ構成（CCディレクトリ）

ディレクトリ

説明

adapters

−

アダプタを格納するディレクトリです。

OpenTP1

TP1インバウンドアダプタ格納用ディレクトリです。

admin

−

J2EEサーバ管理用ディレクトリです。

bin

サーバ管理コマンド格納用ディレクトリです。

dtds

CUI用のDTDファイル格納用ディレクトリです。

logs

サーバ管理コマンドのログ格納用ディレクトリです。

sysconf

サーバ管理コマンドのシステム定義ファイル格納用ディレクトリです。ただし，修正禁止です。

templates

属性ファイルのテンプレート格納用ディレクトリです。

usrconf

サーバ管理コマンドのユーザ定義ファイル格納用ディレクトリです（カスタマイズ用）。

batch

−

バッチアプリケーション用のディレクトリです。

bin

バッチアプリケーションの実行ファイル格納用ディレクトリです。

logs

バッチアプリケーションのログ出力用ディレクトリです。

sysconf

バッチアプリケーションのシステム定義ファイル格納用ディレクトリです。ただし，修正禁止です。

templates

バッチアプリケーションのユーザ定義ファイルのひな型格納用ディレクトリです。

cjmsp

−

CJMSプロバイダ用のディレクトリです。

bin

CJMSプロバイダのコマンド格納用ディレクトリです。

lib

−

CJMSプロバイダのライブラリファイルおよびRARファイル格納用ディレクトリです。

props

−

CJMSプロバイダのプロパティファイル格納用ディレクトリです。

broker

CJMSプロバイダのブローカプロパティファイル格納用ディレクトリです。

templates

CJMSPリソースアダプタのConnector属性ファイルのテンプレート格納用ディレクトリです。

var

−

CJMSプロバイダのデフォルトディレクトリです。

admin

−

CJMSプロバイダの管理コマンド用ディレクトリです。

config

CJMSプロバイダの管理コマンドのプロパティ格納用ディレクトリです。

instances

CJMSプロバイダのインスタンス格納用ディレクトリです。

client

−

EJBクライアントアプリケーション用のディレクトリです。

bin

EJBクライアントアプリケーションの実行ファイル格納用ディレクトリです。

lib

EJBクライアントアプリケーションのJARファイル格納用ディレクトリです。

logs

EJBクライアントアプリケーションのログ出力用ディレクトリです。

sysconf

EJBクライアントアプリケーションのシステム定義ファイル格納用ディレクトリです。ただし，修正禁止です。

templates

EJBクライアントアプリケーションのユーザ定義ファイルのひな型格納用ディレクトリです。

DBConnector

−

DB ConnectorのRARファイル格納用ディレクトリです。

ReliableMessaging

DB Connector for Reliable MessagingのRARファイル格納用ディレクトリです。

ClusterPool

クラスタコネクションプール機能（互換機能）を使用する場合のRARファイル格納用ディレクトリです。

examples

サンプルプログラム格納用ディレクトリです。

lib

Component Container用クラスライブラリファイル格納用ディレクトリです。

logs

インストール時のログ格納用ディレクトリです。

server

−

−

bin

J2EEサーバ用コマンドツール格納用ディレクトリです。

lib

−

J2EEサーバ用ライブラリファイル格納用ディレクトリです。

dtds

Component Containerで使用するDTDファイル格納用ディレクトリです。ただし，修正禁止です。

schemas

DD用スキーマ定義ファイル格納用ディレクトリです。

public

J2EEサーバのデフォルトの作業用ディレクトリです。

repository

一時作業用ディレクトリです。

sysconf

システム定義用ファイル格納用ディレクトリです。ただし，修正禁止です。

templates

コンフィグレーションファイルやプロパティファイルなどのひな型格納用ディレクトリです。

usrconf

−

−

ejb

−

−

<ローカルホスト名>

J2EEサーバのユーザ定義ファイルの格納用ディレクトリです（カスタマイズ用）。

spool

−

一時ディレクトリです。

web

−

−

redirector

−

リダイレクタ（互換機能）本体／定義ファイル格納用ディレクトリです。

logs

リダイレクタ（互換機能）のログ出力用ディレクトリです。

（凡例）−：該当しません。

managerディレクトリ

Component Containerの提供する機能のうち，アプリケーションサーバの運用管理機能を提供するディレクトリです。

表B‒2　Component Containerのディレクトリ構成（managerディレクトリ）

ディレクトリ

説明

bin

運用管理機能で使用するコマンドなどの格納用ディレクトリです。

config

−

運用管理機能で使用するコマンドなどの格納用ディレクトリです。

templates

運用管理機能で使用する定義ファイルなどの格納用ディレクトリです。

containers

−

−

m

−

−

usrconf

ユーザ認証情報定義ファイル格納用ディレクトリです。

webapps

−

−

mngsvr

Management Serverの動作ファイル格納用ディレクトリです。

WEB-INF

web.xml格納用ディレクトリです。

vmxsvr

−

仮想サーバマネージャGUIログインJSPファイル格納用ディレクトリです。

image

仮想サーバマネージャのヘッダタイトルのロゴ格納用ディレクトリです。

WEB-INF

URLとサーブレットクラスの対応付けを行うファイルなどの格納用ディレクトリです。

examples

ユーザ管理のサンプル格納用ディレクトリです。

lib

ライブラリファイル格納用ディレクトリです。

log

ログ出力先ディレクトリです。

modules

統合ユーザ管理フレームワークのカスタムログインモジュール格納用ディレクトリです。

spool

−

ログ収集先ディレクトリです。

mibs

MIB格納用ディレクトリです。

tmp

一時的なワークディレクトリです。

apps

デフォルトのアプリケーション登録用ディレクトリです。

externals

−

−

jp1

−

JP1連携用ファイル格納用ディレクトリです。

なお，このディレクトリはWindows用です。

ajs3_custom_jobs

カスタムジョブ格納用ディレクトリです。

なお，このディレクトリはWindows用です。

mngsvrmonitor

モニタ起動コマンド格納用ディレクトリです。

なお，このディレクトリはWindows用です。

ScenarioTemplate

シナリオテンプレート格納用ディレクトリです。

compat3

−

旧バージョンのManagement Serverの動作ファイル格納用ディレクトリです。

なお，このディレクトリはWindows，AIX用です。

bin

運用管理機能で使用するコマンドなどの格納用ディレクトリです。

config

−

運用管理機能で使用する定義ファイルなどの格納用ディレクトリです。

Administrator

ユーザパスワードやユーザ登録情報などの格納用ディレクトリです。

fwj

業務ごとのプロパティファイル格納用ディレクトリです。

log

トレースファイル格納用ディレクトリです。

tmp

一時的なワークディレクトリです。

setup

−

セットアップウィザードディレクトリです。

bin

−

config

セットアップウィザード用設定ファイルやセットアップ情報を保持するファイルなどを格納するディレクトリです。

lib

−

log

セットアップウィザードのトレースファイル用ディレクトリです。

tmp

セットアップウィザードの一時的なワークディレクトリです。

vmx※

−

08-50モードの仮想サーバマネージャで使用するファイル格納用ディレクトリです。

また，直下には，仮想サーバマネージャGUIへのログインURLのファイルも格納されています。

bin

08-50モードの仮想サーバマネージャで使用するコマンドなどの格納用ディレクトリです。

config

08-50モードの仮想サーバマネージャで使用する定義ファイルなどの格納用ディレクトリです。

log

08-50モードの仮想サーバマネージャのトレースファイル格納用ディレクトリです。

spool

08-50モードの仮想サーバマネージャの処理データ格納用ディレクトリです。

templates

08-50モードの仮想サーバマネージャで使用する定義ファイルのテンプレート格納用ディレクトリです。

vmi

−

仮想サーバマネージャで使用するファイル格納用ディレクトリです。

bin

仮想サーバマネージャで使用するコマンドなどの格納用ディレクトリです。

config

−

仮想サーバマネージャで使用する定義ファイルなどの格納用ディレクトリです。

lb

仮想サーバマネージャで使用する負荷分散機接続設定プロパティファイルの格納用ディレクトリです。

spool

仮想サーバマネージャの処理データ格納用ディレクトリです。

templates

仮想サーバマネージャで使用する定義ファイルのテンプレート格納用ディレクトリです。

（凡例）−：該当しません。

注※　このディレクトリ配下のファイルは，このバージョンでは使用できません。

c4webディレクトリ

Component Containerの提供する機能のうち，SOAPアプリケーション実行基盤の機能を提供するディレクトリです。

jaxrsディレクトリ

Component Containerの提供する機能のうち，JAX-RS 1.1仕様に対応した機能を提供するディレクトリです。

jaxwsディレクトリ

Component Containerの提供する機能のうち，JAX-WSエンジンの機能を提供するディレクトリです。

sinagentディレクトリ

Component Containerの提供する機能のうち，サーバ通信エージェントの機能を提供するディレクトリです。

付録C　作業ディレクトリ

作業ディレクトリとは，usrconf.cfg（J2EEサーバ用オプション定義ファイル），またはusrconf.cfg（バッチサーバ用オプション定義ファイル）のejb.public.directoryキーに指定したディレクトリです。

付録C.1　J2EEサーバの作業ディレクトリ

J2EEサーバは作業ディレクトリ中にサーバ名やアプリケーションの表示名，EARファイル中のファイルなどを用いてディレクトリやファイルを生成します。ディレクトリ名やファイル名，パス全体の長さには上限があり，作業ディレクトリ全体がパス全体の上限に収まらないとJ2EEサーバは正常に動作できません。ここでは，作業ディレクトリの構成と作業ディレクトリのパス長の見積もり式について説明します。

(1)　J2EEサーバの作業ディレクトリの構成

J2EEサーバの作業ディレクトリは，J2EEサーバが動作する上で必要な作業領域です。この領域には，ユーザのパスワード情報，インポートされたリソースアダプタ，EARファイル，EJB-JARファイル，WARファイル，作成されたJ2EEアプリケーションなどの情報が格納されます。

J2EEサーバは，作業ディレクトリ以下にJ2EEサーバごとの専用ディレクトリ構造を持ちます。このため，複数のJ2EEサーバで共通のディレクトリを指定できます。

作業ディレクトリを変更してJ2EEサーバを開始すると，既存のJ2EEアプリケーションなどは利用できません。

作業ディレクトリを別のマシンに移動した場合，別のマシン上のJ2EEサーバでは認識できません。

作業ディレクトリでは，2バイトコードを含むパス名称を利用できません。

作業ディレクトリのデフォルトを次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥public

UNIXの場合

/opt/Cosminexus/CC/server/public

作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで変更できます。

J2EEサーバには，次の作業ディレクトリがあります。

J2EEアプリケーション（コンフィグレーション関連）

J2EEアプリケーション（デプロイ関連）

J2EEリソース

J2EEリソースアダプタ（コンフィグレーション関連）

J2EEリソースアダプタ（デプロイ関連）

Webアプリケーション（JSP関連）

Webアプリケーション（その他）

上記の作業ディレクトリの構成についてそれぞれ説明します。また，移行コマンド実行後のディレクトリ構成についても説明します。

ディレクトリ構成を図で示したあと，各ディレクトリを説明します。なお，図中の番号と説明の番号は対応しています。また，図中では，同一ディレクトリに複数の種類のファイルが入る場合は，いちばん長いファイル名だけを記載しています。

(a)　J2EEアプリケーション（コンフィグレーション関連）

J2EEアプリケーション（コンフィグレーション関連）のディレクトリ構成を次の図に示します。

図C‒1　J2EEアプリケーション（コンフィグレーション関連）のディレクトリ構成

J2EEアプリケーションごとに作られるディレクトリです。

EARファイルをインポートした場合に作られるディレクトリです。ディレクトリ名はEARファイル名を基に付けられます。

EARファイルは，17けたの数字.earの名前でここに格納されます。

EJB-JARファイルごとに作られるディレクトリです。ディレクトリ名はEJB-JARファイル名を基に付けられます。

EJB-JARファイルは，17けたの数字.jarの名前でここに格納されます。

ライブラリJARファイルごとに作られるディレクトリです。ディレクトリ名はライブラリJARファイル名を基に付けられます。

ライブラリJARファイルは，17けたの数字.jarの名前でここに格納されます。

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

WARファイルごとに作られるディレクトリです。ディレクトリ名はWARファイル名を基に付けられます。

WARファイルは，17けたの数字.jarの名前でここに格納されます。

(b)　J2EEアプリケーション（デプロイ関連）

J2EEアプリケーション（デプロイ関連）のディレクトリ構成を次の図に示します。

図C‒2　J2EEアプリケーション（デプロイ関連）のディレクトリ構成

J2EEアプリケーションごとに作られるディレクトリです。

J2EEアプリケーションの開始時に作られるファイルです。J2EEアプリケーション中にホーム，リモートインタフェース，java.rmi.Remoteを実装したインタフェースがあると，それらのパッケージ名やクラス名を基にファイルが作られます。

J2EEアプリケーションの開始時に作られるファイルです。J2EEアプリケーション中にホーム，リモート，ローカル，ローカルホームインタフェースがあると，それらのパッケージ名やクラス名を基にファイルが作られます。

(c)　J2EEリソース

J2EEリソースのディレクトリ構成を次の図に示します。

図C‒3　J2EEリソースのディレクトリ構成

EJB-JARファイルごとに作られるディレクトリです。ディレクトリ名はEJB-JARファイル名を基に付けられます。

EJB-JARファイルは，17けたの数字.jarの名前でここに格納されます。

データソースごとに作られるディレクトリです。ディレクトリ名はJDBCドライバのファイル名を基に付けられます。

JDBCドライバのファイルは，17けたの数字.jarの名前でここに格納されます。

JavaMailの設定ごとに作られるディレクトリです。ディレクトリ名はejbmailを基に付けられます。

JavaMailの設定を保存したファイルがここに保存されます。

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

WARファイルごとに作られるディレクトリです。ディレクトリ名はWARファイル名を基に付けられます。

WARファイルは，17けたの数字.jarの名前でここに格納されます。

(d)　J2EEリソースアダプタ（コンフィグレーション関連）

J2EEリソースアダプタ（コンフィグレーション関連）のディレクトリ構成を次の図に示します。

図C‒4　J2EEリソースアダプタ（コンフィグレーション関連）のディレクトリ構成

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

(e)　J2EEリソースアダプタ（デプロイ関連）

J2EEリソースアダプタ（デプロイ関連）のディレクトリ構成を次の図に示します。なお，図中では，同一ディレクトリに複数の種類のファイルが入る場合は，いちばん長いファイル名だけを記載しています。

図C‒5　J2EEリソースアダプタ（デプロイ関連）のディレクトリ構成

RARファイル内のJARファイルは，17けたの数字.jarの名前でここに格納されます。

RARファイル内のネイティブライブラリファイルは，ここに格納されます。

(f)　Webアプリケーション（JSP関連）

Webアプリケーション（JSP関連）のディレクトリ構成を次の図に示します。

図C‒6　Webアプリケーション（JSP関連）のディレクトリ構成

コンテキストルートに指定した名前でディレクトリが作られます。/が含まれている場合は3文字の文字列に置き換えられます。

JSPをコンパイルしてできたクラスファイルが格納されます。JSPのファイル名に英数字以外の文字が含まれている場合は，それぞれ6文字の文字列に置き換えられます。また，ファイル名が数字で始まる場合は1文字付加されます。

(g)　Webアプリケーション（その他）

Webアプリケーション（その他）のディレクトリ構成を次の図に示します。

図C‒7　Webアプリケーション（その他）のディレクトリ構成

コンテキストルートに指定した名前でディレクトリが作られます。/が含まれている場合は3文字の文字列に置き換えられます。

WARファイルに含まれているファイルがここに解凍されます。

(h)　J2EEサーバ，またはWebコンテナサーバ（互換機能）の移行コマンド実行後のディレクトリ構成

J2EEサーバ，またはWebコンテナサーバの移行コマンド実行時，作業ディレクトリの下に作業ディレクトリ_oldの名前でディレクトリを作成し，そこに旧バージョンの作業ディレクトリ下のファイルを退避します。将来，アップグレードインストールをするためには，パス長に作業ディレクトリ_old分の余裕が必要です。J2EEサーバ，またはWebコンテナサーバの移行コマンド実行後のディレクトリ構成を次の図に示します。

図C‒8　J2EEサーバ，またはWebコンテナサーバの移行コマンド実行後のディレクトリ構成

(i)　リソースアダプタの移行コマンド実行後のディレクトリ構成

リソースアダプタの移行コマンド実行時，rarupdate_bkの名前でディレクトリを作成し，各J2EEサーバのリソースアダプタのファイルを退避します。作業ディレクトリが「・・・¥<ディレクトリ名>，または・・・/<ディレクトリ名>」の場合，バックアップRARディレクトリは，「・・・¥<ディレクトリ名>¥rarupdate_bk，または・・・/<ディレクトリ名>/rarupdate_bk」になります。リソースアダプタの移行コマンド実行後のディレクトリ構成を次の図に示します。

図C‒9　リソースアダプタの移行コマンド実行後のディレクトリ構成

作業ディレクトリの下にrarupdate_bkのパス長を追加する余裕がない場合は，移行コマンド実行時に-backuptoオプションでバックアップ先ディレクトリを指定し，パス長に余裕がある領域にファイルを退避できます。-backuptoオプションを使用する場合のリソースアダプタの移行コマンド実行後のディレクトリ構成を次の図に示します。

図C‒10　リソースアダプタの移行コマンド実行後のディレクトリ構成（-backuptoオプションでバックアップ先ディレクトリを指定する場合）

(2)　作業ディレクトリのパス長の見積もり式

作業ディレクトリのパス長の見積もり式は次のようになります（単位：バイト）。これらの式がすべて満たされるように，各種パラメタを調整してください。なお，見積もり式中の「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。なお，Windowsの場合，最大パス長は259バイトです。

A+2×B+C+D+E+58≦最大パス長

A+2×B+C+E'+61≦最大パス長

A+2×B+C+E''+50≦最大パス長

A+2×B+C+D+（F+37またはM+68のどちらか大きい方の値）+23≦最大パス長（F≦35の場合は35で換算）

A+2×B+C+G+22≦最大パス長（G≦18の場合は18で換算）

A+B+C+H+I+8≦最大パス長

A+2×B+C+J+34≦最大パス長

J+K+18≦最大パス長

A+2×B+C+L+43≦最大パス長（Reliable Messaging使用時）

K+L+27≦最大パス長（Reliable Messaging使用時）

A+2×B+C+H+L+I+N+22≦最大パス長

A+2×B+C+H+L+O+N+39≦最大パス長

P+H+I+N+3≦最大パス長

O+H+M+N+20≦最大パス長

（凡例）

A：作業ディレクトリまでのパスの長さ

B：作業ディレクトリ名の長さ

C：最も長いサーバ名の長さ

D：最も長いJ2EEアプリケーション名の長さ

E：インポートしたときのEJB-JARファイル，WARファイル，RARファイル，ライブラリJAR，EARのファイル名のうち，最も長いファイル名（EARファイルに含まれているファイルも含む）の長さ

E'：インポートしたときのEJB-JARファイル，WARファイル，RARファイル，JDBCドライバ，メールのファイル名のうち，最も長いファイル名（EARファイルに含まれているファイルも含む）の長さ（メールは7で換算）

E''：インポートしたときのRARファイル名のうち，最も長いファイル名の長さ

F：J2EEアプリケーションに含まれるEJBのインタフェースクラス，java.rmi.Remoteを実装したインタフェースやクラス，EJBのコンポーネントクラスのうち，最も長いファイル名（パッケージ名も含む）の長さ

G：ネイティブライブラリファイルのうち，最も長いファイル名の長さ

H：最も長いコンテキストルートの長さ（/を含む場合は/×3で換算）

I：WARファイル内で最も長いパスの長さ

J：最も長いリソースアダプタ表示名の長さ

K：ログファイル出力先ディレクトリのパスの長さ（簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定する値）

L：最も長いReliable Messagingの表示名の長さ

M：J2EEアプリケーションに含まれるEJBのBeanクラスのうち，最も長いクラス名（パッケージ名を含まない）の長さ

N：最も長いJSP／タグファイルコンパイル結果のクラス名の長さ

O：最も長いタグファイルのパッケージ名の長さ

P：JSP用テンポラリディレクトリまでのパスの長さ

付録C.2　バッチサーバの作業ディレクトリ

バッチサーバは作業ディレクトリ中にサーバ名などを用いてディレクトリやファイルを生成します。ディレクトリ名やファイル名，パス全体の長さには上限があり，作業ディレクトリ全体がパス全体の上限に収まらないとバッチサーバは正常に動作できません。ここでは，作業ディレクトリの構成と作業ディレクトリのパス長の見積もり式について説明します。

(1)　バッチサーバの作業ディレクトリの構成

バッチサーバの作業ディレクトリは，バッチサーバが動作する上で必要な作業領域です。この領域には，ユーザのパスワード情報，インポートされたリソースアダプタなどの情報が格納されます。

バッチサーバは，作業ディレクトリ以下にバッチサーバごとの専用ディレクトリ構造を持ちます。このため，複数のバッチサーバで共通のディレクトリを指定できます。

作業ディレクトリを別のマシンに移動した場合，別のマシン上のバッチサーバでは認識できません。

作業ディレクトリでは，2バイトコードを含むパス名称を利用できません。

作業ディレクトリのデフォルトを次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥public

UNIXの場合

/opt/Cosminexus/CC/server/public

作業ディレクトリは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.public.directoryパラメタで変更できます。

バッチサーバには，次の作業ディレクトリがあります。

J2EEリソース

J2EEリソースアダプタ（コンフィグレーション関連）

J2EEリソースアダプタ（デプロイ関連）

なお，2.および3.はJ2EEサーバの場合と同じです。詳細は，「付録C.1(1)(d)　J2EEリソースアダプタ（コンフィグレーション関連）」および「付録C.1(1)(e)　J2EEリソースアダプタ（デプロイ関連）」を参照してください。

ここでは，J2EEリソースの作業ディレクトリの構成について説明します。また，移行コマンド実行後のディレクトリ構成についても説明します。

(a)　J2EEリソース

J2EEリソースのディレクトリ構成を図で示したあと，各ディレクトリを説明します。なお，図中の番号と説明の番号は対応しています。また，図中では，同一ディレクトリに複数の種類のファイルが入る場合は，いちばん長いファイル名だけを記載しています。

図C‒11　J2EEリソースのディレクトリ構成

RARファイルごとに作られるディレクトリです。ディレクトリ名はRARファイル名を基に付けられます。

RARファイルは，17けたの数字.rarの名前でここに格納されます。

(b)　バッチサーバの移行コマンド実行後のディレクトリ構成

バッチサーバの移行コマンド実行時，作業ディレクトリの下に作業ディレクトリ_oldの名前でディレクトリを作成し，そこに旧バージョンの作業ディレクトリ下のファイルを退避します。バッチサーバの移行コマンド実行後のディレクトリ構成は，J2EEサーバの場合と同じです。詳細は，「付録C.1(1)(h)　J2EEサーバ，またはWebコンテナサーバ（互換機能）の移行コマンド実行後のディレクトリ構成」を参照してください。この際，「J2EEサーバ」を「バッチサーバ」に置き換えてお読みください。

(c)　リソースアダプタの移行コマンド実行後のディレクトリ構成

リソースアダプタの移行コマンド実行時，rarupdate_bkの名前でディレクトリを作成し，各バッチサーバのリソースアダプタのファイルを退避します。リソースアダプタの移行コマンド実行後のディレクトリ構成については，「付録C.1(1)(i)　リソースアダプタの移行コマンド実行後のディレクトリ構成」を参照してください。

(2)　作業ディレクトリのパス長の見積もり式

作業ディレクトリのパス長の見積もり式は次のようになります（単位：バイト）。これらの式がすべて満たされるように，各種パラメタを調整してください。なお，見積もり式中の「最大パス長」とは，OSで規定されているパス長の制限のことです。OSのパス長の制限については，ご使用のOSのドキュメントなどで確認してください。なお，Windowsの場合，最大パス長は259バイトです。

A+2×B+C+D+61≦最大パス長

A+2×B+C+E+34≦最大パス長

E+F+18≦最大パス長

（凡例）

A：作業ディレクトリまでのパスの長さ

B：作業ディレクトリ名の長さ

C：最も長いサーバ名の長さ

D：インポートしたときのRARファイル名のうち，最も長いファイル名の長さ

E：最も長いリソースアダプタ表示名の長さ

F：ログファイル出力先ディレクトリのパスの長さ（簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定する値）

付録C.3　作業ディレクトリに関する注意事項

作業ディレクトリの運用では，次の点に注意してください。

J2EEアプリケーションやクライアントアプリケーションで，作業ディレクトリ以下の製品が使用するディレクトリおよびファイルを使用しないでください。また，作業ディレクトリ以下のディレクトリおよびファイル構成を変更しないでください。

J2EEサーバまたはバッチサーバを起動した場合に，例外が発生することがあります。

J2EEサーバまたはバッチサーバのカレントディレクトリ※には，J2EEアプリケーションで独自ファイルの入出力はできます。ただし，製品で使用するディレクトリ，ファイルと名称が同じにならないようにしてください。

注※　J2EEサーバのカレントディレクトリは「＜作業ディレクトリ＞/ejb/＜J2EEサーバ名＞」，バッチサーバのカレントディレクトリは「＜作業ディレクトリ＞/ejb/＜バッチサーバ名＞」です。

付録D　運用管理ポータルの操作で失敗したときの対処方法

運用管理ポータルの操作で失敗を示すメッセージやログが画面に表示された場合は，メッセージを確認して障害要因を取り除いてから，操作を再実行する必要があります。運用管理ポータルの操作で失敗したときの対処手順を次に示します。

［ログの表示］タブをクリックして，［ログの表示］画面に出力されるエラーメッセージの時刻を確認します。

次のログファイルを参照して，手順1.で確認した時刻に対応するエラーメッセージの内容を確認して障害要因を特定します。

確認対象のログファイルを次の表に示します。なお，ログファイル内のメッセージは，時刻の古い順に出力されます。メッセージについは，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照してください。

表D‒1　確認対象のログファイル

分類

確認対象

ファイル名

サーバ管理コマンド

稼働ログ

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥cjmessage[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/cjmessage[n].log

障害発生時の例外情報

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥cjexception[n].log

UNIXの場合

/opt/Cosminexus/CC/admin/logs/cjexception[n].log

J2EEサーバ

稼働ログ

Windowsの場合

<ejb.server.log.directory>※1¥cjmessage[n].log

UNIXの場合

<ejb.server.log.directory>※1/cjmessage[n].log

障害発生時の例外情報

Windowsの場合

<ejb.server.log.directory>※1¥cjexception[n].log

UNIXの場合

<ejb.server.log.directory>※1/cjexception[n].log

Webサーブレットログ

Windowsの場合

<ejb.server.log.directory>※1¥web_servlet[n].log

UNIXの場合

<ejb.server.log.directory>※1/web_servlet[n].log

ユーザ出力ログ

Windowsの場合

<ejb.server.log.directory>※1¥user_out[n].log

UNIXの場合

<ejb.server.log.directory>※1/user_out[n].log

ユーザエラーログ

Windowsの場合

<ejb.server.log.directory>※1¥user_err[n].log

UNIXの場合

<ejb.server.log.directory>※1/user_err[n].log

JavaVMの保守情報およびGCのログ

Windowsの場合

<ejb.server.log.directory>※1¥javalog[nn].log

UNIXの場合

<ejb.server.log.directory>※1/javalog[nn].log

エラーリポートファイル（Windowsの場合）※2

<作業ディレクトリ>¥ejb¥<サーバ名>¥hs_err_pid<サーバプロセスのプロセスID>.log

注※1　<ejb.server.log.directory>は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejb.server.log.directoryパラメタで指定したディレクトリを指します。デフォルト値は，<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥logsです。

注※2　保守員に送付する資料です。

手順2.で特定した障害要因を取り除いて，障害を回復します。

付録E　Management Serverが自動で設定する内容

Management Serverの機能を使用して，論理サーバのコンフィグレーション定義または環境設定で設定した内容は，自動的にCTMデーモンの起動コマンドのオプション，またはユーザ定義ファイルに反映されます。

付録E.1　Management Serverが自動で生成するユーザ定義ファイル

Management Serverの機能を使用して，論理サーバのコンフィグレーション定義または環境設定で設定した内容から生成されるユーザ定義ファイルについて，J2EEアプリケーションを実行するシステムの場合とバッチアプリケーションを実行するシステムの場合に分けて説明します。なお，ユーザ定義ファイルは，システムを構築する対象のホストに生成されます。

注意事項

システムの一貫性を保つため，細かい設定を変更する場合でも，構築時に使用したManagement Serverの機能（Smart Composer機能，運用管理ポータルなど）から実行するようにしてください。テキストエディタなどで個別にファイルを直接編集する場合には，スペルミスなどに十分注意してください。

J2EEアプリケーションを実行するシステムの場合

論理サーバのコンフィグレーション定義または環境設定で設定した内容から生成されるユーザ定義ファイルを次の表に示します。

表E‒1　論理サーバのコンフィグレーション定義または環境設定で設定した内容から生成されるユーザ定義ファイル（J2EEアプリケーションを実行するシステムの場合）

論理

サーバ

生成されるユーザ定義ファイル名

ファイルの概要

ファイルの格納先

J2EEサーバ

auto_explicit_memory.cfg

明示管理ヒープ機能の自動配置機能で使用する自動配置設定ファイル。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名>/

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名>/

userprf.cfg

ユーザ拡張性能解析トレースで使用するユーザ拡張性能解析トレース設定ファイル。

usrconf.cfg

J2EEサーバの起動オプションが定義されたファイル。

このファイルでJavaVMの起動オプションも定義します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名>¥

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名>/

usrconf.properties

J2EEサーバを実行するために必要なJavaVMのシステムプロパティを指定するファイル。

mngagent.<実サーバ名>.properties

J2EEサーバで運用監視するために必要な運用監視エージェントを設定するファイル。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

mevent.<実サーバ名>.properties

J2EEサーバでManagementイベントを発行するために必要なプロパティを指定するファイル。

manager.<実サーバ名>.properties

J2EEサーバでJP1イベントを発行するために必要なプロパティを指定するファイル。

Webサーバ

httpsd.conf

Webサーバを稼働させるために必要な情報が定義されているファイル。

Windowsの場合

<HTTP Serverのインストールディレクトリ>¥servers¥HWS_<サーバ名>¥conf¥または<HTTP Serverのインストールディレクトリ>¥conf¥

UNIXの場合

/opt/hitachi/httpsd/servers/HWS_<サーバ名>/conf/または/opt/hitachi/httpsd/conf/

mod_jk.conf

V9互換モードのJ2EEサーバと連携する場合に，HTTP Server用のリダイレクタ定義（ログレベルなど）やURLマッピングを定義するファイル。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥web¥redirector¥servers¥<サーバ名>¥または<Application Serverのインストールディレクトリ>¥CC¥web¥redirector¥

UNIXの場合

/opt/Cosminexus/CC/web/redirector/servers/<サーバ名>/または/opt/Cosminexus/CC/web/redirector/

workers.properties

V9互換モードのJ2EEサーバと連携する場合に，ワーカの定義およびワーカごとの各パラメタを定義するファイル。

バッチアプリケーションを実行するシステムの場合

論理サーバのコンフィグレーション定義または環境設定で設定した内容から生成されるユーザ定義ファイルを次の表に示します。

表E‒2　論理サーバのコンフィグレーション定義または環境設定で設定した内容から生成されるユーザ定義ファイル（バッチアプリケーションを実行するシステムの場合）

論理

サーバ

生成されるユーザ定義ファイル名

ファイルの概要

ファイルの格納先

バッチサーバ

auto_explicit_memory.cfg

明示管理ヒープ機能の自動配置機能で使用する自動配置設定ファイル。

Windowsの場合

<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<サーバ名>/

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名>/

userprf.cfg

ユーザ拡張性能解析トレースで使用するユーザ拡張性能解析トレース設定ファイル。

usrconf.cfg

バッチサーバの起動オプションが定義されたファイル。

このファイルでJavaVMの起動オプションも定義します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名>¥

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名>/

usrconf.properties

バッチサーバを実行するために必要なJavaVMのシステムプロパティを指定するファイル。

mngagent.<実サーバ名>.properties

バッチサーバで運用監視するために必要な運用監視エージェントを設定するファイル。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥

UNIXの場合

/opt/Cosminexus/manager/config/

mevent.<実サーバ名>.properties

バッチサーバでManagementイベントを発行するために必要なプロパティを指定するファイル。

manager.<実サーバ名>.properties

バッチサーバでJP1イベントを発行するために必要なプロパティを指定するファイル。

付録E.2　Management ServerがCTMドメインマネジャに自動で設定する内容

CTMデーモンの起動コマンド（ctmdmstart）の，CTMドメインマネジャの設定に関するオプションに，Management Serverが自動的に設定する内容を次の表に示します。

表E‒3　Management Serverが自動的に設定する内容（CTMドメインマネジャの場合）

起動コマンド

オプション

ctmdmstart

-CTMMyHost <「論理サーバの構成定義」でCTMドメインマネジャを定義したホストのIPアドレス>

-CTMAutoForce

-Dvbroker.orb.isNTService=true※

注※

Windowsの場合に設定されます。

付録E.3　Management ServerがCTMに自動で設定する内容

CTMデーモンの起動コマンド（ctmstart）の，CTMの設定に関するオプションに，Management Serverが自動的に設定する内容を次の表に示します。

表E‒4　Management Serverが自動的に設定する内容（CTMの場合）

起動コマンド

オプション

ctmstart

-CTMMyHost <「論理サーバの構成定義」でCTMを定義したホストのIPアドレス>

-CTMClientConnectCount<CTMレギュレータプロセス数＋OTMゲートウェイプロセス数>※1

-Dvbroker.orb.isNTService= true※2

注※1

CTMレギュレータプロセス数とOTMゲートウェイプロセス数の合計が256未満の場合には，-CTMClientConnectCountオプションの設定値は256になります。

注※2

Windowsの場合に設定されます。

付録E.4　Management ServerがJ2EEサーバに自動で設定する内容

J2EEサーバに関連するユーザ定義ファイルに，Management Serverが自動的に設定する内容を次の表に示します。

表E‒5　Management Serverが自動的に設定する内容（J2EEサーバの場合）

ユーザ定義ファイル

設定される内容

usrconf.properties

ejbserver.manager.agent.Agent.conf=<環境設定で作成されるmngagent.<実サーバ名>.propertiesファイルの位置>

ejbserver.manager.agent.Agent.enabled=true

ejbserver.ctm.CTMMyHost=<「運用管理ドメインの構成定義」で定義したホスト名>

manager.j2ee.compat=<J2EEサーバの互換モードの使用有無>

usrconf.cfg

add.jvm.arg=-XX:HitachiAutoExplicitMemoryFile:<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<実サーバ名>/auto_explicit_memory.cfg※1

add.jvm.arg=-Djvm.userprf.File=<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<実サーバ名>/userprf.cfg※2

mngagent.<実サーバ名>.properties

mngagent.domain_name=<運用管理ドメイン名（内部名）>

mngagent.agent_name=<該当ノードの論理サーバ名>

mevent.<実サーバ名>.properties

manager.mevent.send.host=<Management Serverのホスト名またはIPアドレス>

manager.mevent.send.port=<Management ServerのHTTPポート番号>

manager.mevent.logical_server_name=<論理サーバ名>

manager.<実サーバ名>.properties

manager.jp1event.logical_server_name=<論理サーバ名>

manager.jp1event.domain_name=<運用管理ドメイン名>

注※1　運用管理ポータルまたはSmart Composer機能で，明示管理ヒープ機能の自動配置機能で使用する自動配置設定ファイルの内容を指定している場合に設定します。

注※2　運用管理ポータルまたはSmart Composer機能で，ユーザ拡張性能解析トレースのユーザ拡張性能解析トレース設定ファイルの内容を指定している場合に設定します。

付録E.5　Management Serverがバッチサーバに自動で設定する内容

バッチサーバに関連するユーザ定義ファイルに，Management Serverが自動的に設定する内容を次の表に示します。

表E‒6　Management Serverが自動的に設定する内容（バッチサーバの場合）

ユーザ定義ファイル

設定される内容

usrconf.properties

ejbserver.manager.agent.Agent.conf=<環境設定で作成されるmngagent.<実サーバ名>.propertiesファイルの位置>

ejbserver.manager.agent.Agent.enabled=true

ejbserver.ctm.CTMMyHost=<「運用管理ドメインの構成定義」で定義したホスト名>

mngagent.<実サーバ名>.properties

mngagent.domain_name=<運用管理ドメイン名（内部名）>

mngagent.agent_name=<該当ノードの論理サーバ名>

mevent.<実サーバ名>.properties

manager.mevent.send.host=<Management Serverのホスト名またはIPアドレス>

manager.mevent.send.port=<Management ServerのHTTPポート番号>

manager.mevent.logical_server_name=<論理サーバ名>

manager.<実サーバ名>.properties

manager.jp1event.logical_server_name=<論理サーバ名>

manager.jp1event.domain_name=<運用管理ドメイン名>

付録E.6　Management ServerがWebサーバに自動で設定する内容

Webサーバに関連するユーザ定義ファイルに，Management Serverが自動的に設定する内容を次の表に示します。

表E‒7　Management Serverが自動的に設定する内容（Webサーバの場合）

ユーザ定義ファイル

設定される内容

httpsd.conf※1

Windowsの場合

Include <Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<論理サーバ名>/mod_jk.conf※4

Include <HTTP Serverのインストールディレクトリ>/servers/HWS_<論理Webサーバの実サーバ名>/conf/httpsd_manager.conf※2

ThreadLimit <ThreadsPerChildと同じ値>

PidFile <HTTP Serverのインストールディレクトリ>/servers/HWS_<論理Webサーバの実サーバ名>/logs/httpd.pid

UNIXの場合

Include <Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<論理サーバ名>/mod_jk.conf※4

Include <HTTP Serverのインストールディレクトリ>/servers/HWS_<論理Webサーバの実サーバ名>/conf/httpsd_manager.conf※2

ThreadLimit <ThreadsPerChildと同じ値>※5

ServerLimit <MaxClientsの値>÷<ThreadsPerChildの値>※5

MinSpareServers 5 ※6

PidFile <HTTP Serverのインストールディレクトリ>/servers/HWS_<論理Webサーバの実サーバ名>/logs/httpd.pid

mod_jk.conf※4

Windowsの場合

LoadModule jk_module <Application Serverのインストールディレクトリ>/CC/web/redirector/<mod_jkファイル名>※3

JkWorkersFile <Application Serverのインストールディレクトリ>/CC/web/redirector/servers/<論理サーバ名>/workers.properties

UNIXの場合

LoadModule jk_module /opt/Cosminexus/CC/web/redirector/<mod_jkファイル名>※3

JkWorkersFile /opt/Cosminexus/CC/web/redirector/servers/<論理サーバ名>/workers.properties

注※1

Webサーバの運用時には，httpsd.confファイルの内容を運用環境に合わせて適切に設定する必要があります。設定する内容や方法については，マニュアル「HTTP Server」を参照してください。

注※2

簡易構築定義ファイルで論理Webサーバ（web-server）のAppendDirectivesパラメタ，または運用管理ポータルの［Webサーバの設定］画面で「項目ごとに設定します。」の「追加ディレクティブ」に値を指定した場合に設定されます。

注※3

<mod_jkファイル名>は，OSによって異なります。

注※4

V9互換モードのJ2EEサーバと連携する場合，またはV11以降でリダイレクタを使用する場合に設定されます。

注※5

J2EEサーバとの連携方法がリバースプロキシの場合だけ設定されます。値が小数になる場合は，小数点以下が切り捨てされ，整数値が出力されます。なお，小数点以下を切り捨てたときの値が0のときには1が設定されます。

注※6

J2EEサーバとの連携方法がリダイレクタの場合，かつhttpsd.confにMinSpareServersが設定されていない場合だけ設定されます。

付録F　Application Serverの更新インストール

Application Serverを更新インストールする手順について説明します。更新インストールとは，Application Serverがインストール済みの環境に，Application Server（同一製品）をインストールすることです。

更新インストールでは，インストールする製品とインストール済みの製品のバージョンによって，更新処理のしかたが異なります。製品が同一バージョン同士であれば上書きされ，製品が異なるバージョン同士（例えば，09-00をインストール済みの環境に11-00をインストールする場合など）であればバージョンアップされます。

また，Component Containerがインストールされている場合，Component Containerの更新インストール時に，インストーラによってユーザ環境の移行が実行されます。更新インストールでのユーザ環境の扱いについては，「2.2.1(2)　Component Containerインストール時のユーザ環境の扱い」を参照してください。

付録F.1　Application Serverを更新インストールする（Windowsの場合）

更新インストールでは，製品の提供媒体であるインストーラを使用します。

更新インストールの手順を次に示します。インストール作業にはAdministrator権限が必要です。更新インストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を，更新インストール時のエラーコードについては，「付録I.6　Application Serverのインストールおよびアンインストール時のエラーコード一覧（Windowsの場合）」を参照してください。なお，インストーラの使用方法については，製品の提供媒体のドキュメントを参照してください。

手順

構成ソフトウェアのすべてのプロセスが実行中でないことを確認します。実行中のプロセスがあれば停止します。

製品の提供媒体をCD-ROMドライブにセットします。

［日立総合インストーラ］ダイアログに，「選択されたソフトウェアをインストールします。」と表示されます。

［日立総合インストーラ］ダイアログが表示されない場合，エクスプローラを使用して，CD-ROMディレクトリの「HCD_INST.EXE」をダブルクリックしてください。

Application Serverを選択した状態で，［インストール実行］ボタンをクリックします。

［機能の選択］ダイアログが表示されます。

［標準 - このセットアップを推奨します。すべてのプログラム機能を再インストールします。］の左にあるボタンをクリックします。

［インストールの開始］ダイアログが表示されます。

設定した内容を確認して，問題がなければ［次へ］ボタンをクリックします。

インストールが開始されます。インストールが完了すると，［セットアップの完了］ダイアログが表示されます。

［完了］ボタンをクリックします。

OSを再起動するかどうかを確認する画面が表示されます。

［はい］ボタンをクリックします。

OSが再起動し，Application Serverの更新インストールが完了します。

更新インストール後の作業については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.2.2　更新インストールの場合」を参照してください。

付録F.2　Application Serverを更新インストールする（UNIXの場合）

更新インストールでは，製品の提供媒体であるPPインストーラを使用します。

更新インストールの手順を次に示します。インストール作業にはroot権限が必要です。更新インストールするときの注意事項については，「付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項」を参照してください。

なお，更新インストールの操作は，Component Container管理者の設定の有無によって異なります。詳細は，「4.1.4　Component Container管理者を設定するときの注意事項（UNIXの場合）」を参照してください。

手順

アプリケーションサーバにroot権限（スーパーユーザ）でログインします。

構成ソフトウェアのすべてのプロセスが実行中でないことを確認します。実行中のプロセスがあれば停止します。

製品の提供媒体をCD-ROMドライブにセットします。

製品の提供媒体がCD-ROMの場合は，CD-ROMファイルシステムをマウントします。

コマンドの実行例を次に示します。下線部には，デバイススペシャルファイル名，およびCD-ROMファイルシステムのマウントディレクトリ名を指定します。なお，これらの名称は，OS，ハードウェア，および環境によって異なります。

（AIXの実行例）

mount -r -v cdrfs /dev/cd0 /cdrom

（Linuxの実行例）

mount -r -o mode=0544  /dev/cdrom  /mnt/cdrom

セットアッププログラムを起動します。

コマンドの実行例を次に示します。下線部には，CD-ROMファイルシステムのマウントディレクトリ名を指定します。Linuxの場合，Reliable MessagingおよびWeb Services - SecurityをインストールするPPインストーラと，それ以外の構成ソフトウェアと製品の共通モジュールをインストールするPPインストーラが異なります。

（AIXの実行例）

/cdrom/aix/setup /cdrom

（Linuxの実行例）

/mnt/cdrom/x64lin/setup /mnt/cdrom

CD-ROMセットアッププログラムによって，PPインストーラと常駐プロセス自動起動プログラムがハードディスク上にインストールされ，PPインストーラが自動的に起動されます。

注意事項

CD-ROMのディレクトリ名やファイル名は，マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

PPインストーラのメインメニューで，［I］キーを押します。

PPインストール画面が表示されます。

プログラムにカーソルを移動させ，［スペース］キーを押します。

すべてのプログラム（Application Serverに対応している構成ソフトウェア，および製品の共通モジュール）を選択します。選択したプログラムの左側には<@>が表示されます。なお，プログラムを選択してインストールすることもできます。

注意事項

製品に対応している構成ソフトウェアについては，「2.2.1(3)　製品に対応する構成ソフトウェアについて」を参照してください。製品の共通モジュールは，製品によって表示されるプログラム名が異なります。

また，JDK11からJDK17以降への更新インストールはサポートしていません。

詳細は「2.2.1　Application Serverのインストールについて」を参照してください。

すべてのプログラムの左側に<@>が表示されていることを確認して，［I］キーを押します。

画面の最下行に「Install PP? (y: install, n: cancel)==>」メッセージが表示されます。

［y］キーまたは［Y］キーを押します。

インストールが開始されます。

［n］キーまたは［N］キーを押すと，インストールが中止されてPPインストール画面に戻ります。

インストール終了を示すメッセージが出力されたら，［Q］キーを押します。

PPインストーラのメインメニューに戻ります。

PPインストーラのメインメニューで，［Q］キーを押します。

Application Serverの更新インストールが完了します。

更新インストール後の作業については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.2.2　更新インストールの場合」を参照してください。

付録G　JP1/SC/DPMを使ったディスク複製インストール

JP1/SC/DPMを使ったディスク複製インストールを利用する場合の手順について説明します。JP1/SC/DPMを使ったディスク複製インストールとは，JP1/SC/DPMを使用して作成したディスクイメージの複製をインストールすることです。JP1/SC/DPMを使ったディスク複製インストールを利用できるかどうかは，アプリケーションサーバおよびBPM/ESB基盤の製品によって異なります。

注意事項

AIXの場合，Application ServerおよびService Platformでは，JP1/SC/DPMを使ったディスク複製インストールに対応していません。ディスク複製インストールを利用する手順を次に示します。

手順

インストール済みの製品（Application ServerまたはService Platform）をアンインストールします。

製品のアンインストール手順については，「3.3.3　Application Serverをアンインストールする（AIXの場合）」を参照してください。

ディスク複製インストールを実施します。

ディスク複製インストールの操作・運用方法については，JP1/ServerConductor/Deployment Managerのマニュアルを参照してください。

製品（Application ServerまたはService Platform）をインストールします。

製品のインストール手順については，「2.2.3　Application Serverを新規インストールする（AIXの場合）」を参照してください。

付録G.1　Application Serverをディスク複製インストールする（Windowsの場合）

アプリケーションサーバおよびBPM/ESB基盤の製品ごとに，ディスク複製インストールを利用する場合の手順について説明します。

(1)　Application ServerおよびService Platformの場合

Application ServerおよびService Platformは，JP1/SC/DPMを使ったディスク複製インストールに対応しています。JP1/SC/DPMのディスク複製インストール機能，および仮想化環境が提供するイメージファイル化による複製機能が使用できます。

なお，次の構成ソフトウェアには，JP1/SC/DPMを使ったディスク複製インストールの利用に前提条件があるので，利用前に確認してください。

Component Container（J2EEアプリケーションを実行するシステム（J2EEサーバ）使用時）

EJBクライアントアプリケーションが稼働するマシンは，ディスク複製インストールに対応していません。

TPBroker

JP1/SC/DPMとの連携方法については，マニュアル「TPBroker 運用ガイド」を参照してください。

ディスク複製インストールを利用する手順を次に示します。

手順

ディスク複製インストール元のマシンでアプリケーションサーバを構築します。

製品をインストールしたディスク複製インストール元のマシンに，システム環境をセットアップしたあと，各種設定をカスタマイズしたり，業務アプリケーションを設定したりします。

Application ServerおよびService Platformの構成ソフトウェアごとに，ディスク複製インストールを実施する前に必要な作業を実施します。

実施する作業については，「付録I.3　ディスク複製インストールおよび仮想化プラットフォームが提供する複製機能を使用するときの注意事項（Windowsの場合）」の構成ソフトウェアごとの「複製を実施する前にすること」を参照してください。

JP1/SC/DPMを使用したディスク複製インストールを実施します。

JP1/SC/DPMを使ったディスク複製インストールの操作・運用方法については，JP1/ServerConductor/Deployment Managerのマニュアルを参照してください。仮想化環境が提供するイメージファイル化による複製機能については，仮想化ソフトウェアのドキュメントを参照してください。

Application ServerおよびService Platformの構成ソフトウェアごとに，ディスク複製インストールを実施したあとに必要な作業を実施します。

実施する作業については，「付録I.3　ディスク複製インストールおよび仮想化プラットフォームが提供する複製機能を使用するときの注意事項（Windowsの場合）」の構成ソフトウェアごとの「複製を実施したあとにすること」を参照してください。

ディスク複製インストール先のマシンに接続するマシンでシステムの要件に合わせて各種設定をカスタマイズします。

各種設定には，例えば，次のようなものがあります。システムの要件に合わせて変更してください。

システム構成上でフロントエンドに配置される負荷分散機の設定

DBMSに関する設定

システム構成上でバックエンドに配置されるJ2EEサーバ，またはWebコンテナサーバに関する設定

(2)　Developer，Service Architect，およびClientの場合

Developer，Service ArchitectおよびClientは，JP1/SC/DPMを使ったディスク複製インストールに対応していません。ディスク複製インストールを利用する手順を次に示します。

手順

インストール済みの製品（Developer，Service ArchitectまたはClient）をアンインストールします。

製品のアンインストール手順については，「3.3.2　Application Serverをアンインストールする（Windowsの場合）」を参照してください。

ディスク複製インストールを実施します。

ディスク複製インストールの操作・運用方法については，JP1/ServerConductor/Deployment Managerのマニュアルを参照してください。

製品（Developer，Service ArchitectまたはClient）をインストールします。

製品のインストール手順については，「2.2.2　Application Serverを新規インストールする（Windowsの場合）」を参照してください。

付録G.2　Application Serverをディスク複製インストールする（Linuxの場合）

Application ServerおよびService Platformは，JP1/SC/DPMを使ったディスク複製インストールに対応しています。JP1/SC/DPMのディスク複製インストール機能，および仮想化環境が提供するイメージファイル化による複製機能が使用できます。

なお，次の構成ソフトウェアには，JP1/SC/DPMを使ったディスク複製インストールの利用に前提条件があるので，利用前に確認してください。

Component Container（J2EEアプリケーションを実行するシステム（J2EEサーバ）使用時）

EJBクライアントアプリケーションが稼働するマシンは，ディスク複製インストールに対応していません。

TPBroker

JP1/SC/DPMとの連携方法については，マニュアル「TPBroker 運用ガイド」を参照してください。

ディスク複製インストールを利用する手順を次に示します。

手順

ディスク複製インストール元のマシンでアプリケーションサーバを構築します。

製品をインストールしたディスク複製インストール元のマシンに，システム環境をセットアップしたあと，各種設定をカスタマイズしたり，業務アプリケーションを設定したりします。

Application ServerおよびService Platformの構成ソフトウェアごとに，ディスク複製インストールを実施する前に必要な作業を実施します。

実施する作業については，「付録I.4　ディスク複製インストールおよび仮想化プラットフォームが提供する複製機能を使用するときの注意事項（Linuxの場合）」の構成ソフトウェアごとの「複製を実施する前にすること」を参照してください。

JP1/SC/DPMを使用したディスク複製インストールを実施します。

JP1/SC/DPMを使ったディスク複製インストールの操作・運用方法については，JP1/ServerConductor/Deployment Managerのマニュアルを参照してください。仮想化環境が提供するイメージファイル化による複製機能については，仮想化ソフトウェアのドキュメントを参照してください。

Application ServerおよびService Platformの構成ソフトウェアごとに，ディスク複製インストールを実施したあとに必要な作業を実施します。

実施する作業については，「付録I.4　ディスク複製インストールおよび仮想化プラットフォームが提供する複製機能を使用するときの注意事項（Linuxの場合）」の構成ソフトウェアごとの「複製を実施したあとにすること」を参照してください。

ディスク複製インストール先のマシンに接続するマシンでシステムの要件に合わせて各種設定をカスタマイズします。

各種設定には，例えば，次のようなものがあります。システムの要件に合わせて変更してください。

システム構成上でフロントエンドに配置される負荷分散機の設定

DBMSに関する設定

システム構成上でバックエンドに配置されるJ2EEサーバ，またはWebコンテナサーバに関する設定

付録H　リモートインストール

リモートインストールを利用する場合の手順について説明します。リモートインストールとは，JP1/NETM/DMやGroupmax Remote Installationを使用し，ネットワークを介してソフトウェアをクライアントへ配布するインストールのことです。

付録H.1　Application Serverをリモートインストールする（Windowsの場合）

アプリケーションサーバおよびBPM/ESB基盤のすべての製品は，JP1/NETM/DMおよびGroupmax Remote Installationを使ったリモートインストール（ソフトウェア配布）に対応しています。各製品を運用するサーバでJP1/NETM/DMやGroupmax Remote Installationを運用することによって，製品の新規インストールおよび更新インストールができます。なお，JP1/NETM/DMを使った実際のリモートインストール方法については，JP1/NETM/DMのマニュアルを参照してください。また，Groupmax Remote Installationを使ったリモートインストール方法については，Groupmax Remote Installationのマニュアルを参照してください。

リモートインストールをするときの注意事項については，「付録I.5　リモートインストールをするときの注意事項」を参照してください。

付録H.2　Application Serverをリモートインストールする（UNIXの場合）

Application ServerおよびService Platformは，JP1/NETM/DMを使ったリモートインストール（ソフトウェア配布）に対応しています。各製品を運用するサーバでJP1/NETM/DMを運用することによって，製品の新規インストールおよび更新インストールができます。なお，JP1/NETM/DMを使った実際のリモートインストール方法については，JP1/NETM/DMのマニュアルを参照してください。

付録I　インストールおよびアンインストールするときの注意事項

ここでは，Application Serverおよび構成ソフトウェアを，インストールおよびアンインストールするときの注意事項について説明します。

付録I.1　Application Serverをインストールおよびアンインストールするときの注意事項

Application Serverをインストールおよびアンインストールするときの注意事項を作業のタイミングに分けて説明します。

(1)　作業前に確認する注意事項

分類

注意事項

新規インストール

更新インストール

アンインストール

OS共通

ユーザ定義ファイルなど，カスタマイズ用のファイルが格納されたディレクトリ以外は，すべて削除されます。このため，製品のディレクトリ下に必要なファイルを格納しないでください。

削除対象となっているディレクトリは無条件に削除されます。このため，これらのディレクトリにユーザ固有のファイルなどを格納しないでください。

−

−

○

このバージョンの製品または評価版をインストールしてアンインストールしたあとに古いバージョンの製品をインストールする場合は，インストール先にこのバージョンで作成された環境（<Application Serverのインストールディレクトリ>¥CC，または/opt/Cosminexus/CC）が残っていないことを確認してください。このバージョンで作成された環境が残っていると，古いバージョンへ移行されないため，製品の動作やそのあとの更新インストールなどが保証されません。このバージョンで作成された環境が残っている場合は，インストール先を変更するか，このバージョンで作成された環境を削除または移動してからインストールしてください。

○

−

−

この製品のインストーラでは，旧バージョンのアプリケーションからの移行（更新インストール）および上書きインストールを実施すると，この製品が提供しているファイルは初期化されます。そのため，<Application Server のインストールディレクトリ>¥jdk下の必要なファイルは，インストーラ実行前に退避しておくことを推奨します。

ただし，<Application Server のインストールディレクトリ>¥jdk下の，この製品が提供していないファイルは削除されずに残ります。これらのファイルについては，ファイル削除やファイル移動など，必要に応じた操作をしてください。

旧バージョンとこのバージョンのインストーラの変更点について，または，その他の更新インストールおよび上書きインストールの詳細については，マニュアル「Cosminexus V11 アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

−

○

−

製品を更新インストールする場合，構築済みの環境にインストールされているJavaバージョンと同じCosminexus Developer's Kit for Java (TM)を選択してください。

−

○

−

Windows共通

この製品は，後継製品とする旧製品のアプリケーションサーバがインストール済みの環境にはインストールできません。この場合は，インストール済みの旧製品をアンインストールしたあとに，インストールしてください。

○

−

−

製品をインストールする前に，インストール先ディスクの空き容量を確認し，インストールに必要な空き容量が十分確保されていることを確認してください。

○

−

−

製品を更新インストールする場合は，必ずインストール前に，ユーザ作成ファイルなどの必要なファイルをバックアップしてください。

また，異なるバージョンへの更新インストール（バージョンアップ）をする場合，製品で提供しているファイルをほかのディレクトリにコピーして運用しているときは，更新インストール後に新しくインストールされたファイルをコピーし直してから運用してください。

−

○

−

製品をインストールおよびアンインストールする前に，起動中のアプリケーションは終了させてください。常駐プログラムも終了させてください。

○

○

○

この製品が提供するプログラムやサービスを実行中の状態で，インストールまたはアンインストールすると障害が発生することがあります。製品が提供するプログラムやサービス，および不要なプログラムやサービスは停止した状態にしてから，インストールまたはアンインストールしてください。

○

○

○

この製品が提供するファイルを使用中の状態で，インストールまたはアンインストールすると障害が発生することがあります。製品が提供するファイルは使用しない状態にしてから，インストールまたはアンインストールしてください。

○

○

○

「Hitachi Web Server」サービスが登録されている環境では，同一バージョンの更新インストール（上書き）をする前に，「Hitachi Web Server」サービスを停止してください。

−

○

−

製品および構成ソフトウェアのインストールおよびアンインストール開始時に，セットアップの準備を示すダイアログが表示されます。このダイアログ内のキャンセルボタンは押さないでください。

○

○

○

バージョンダウンとなるような更新インストールは実行しないでください。

−

○

−

Management Serverおよび運用管理エージェントのサービスのログオンアカウントには，デフォルトであるローカルシステムアカウント以外は指定しないでください。ただし，J2EEアプリケーションからネットワークリソースへアクセスする場合には，運用管理エージェントのサービスのログオンアカウントをローカルホストのAdministratorsグループに所属するように設定してください。

○

○

−

単体版のWeb Serverがインストール済みの環境に，HTTP Serverはインストールできません。単体版のWeb Serverをアンインストールしてから，インストールしてください。

−

○

−

単体版のWeb Serverをアンインストールする前に，必要なファイルをバックアップしてください。

−

−

○

単体版のWeb Serverがインストール済みの環境に製品をインストールする場合は，単体版のWeb Serverで使用していたファイル（httpsd.confなどのコンフィグファイルやユーザが作成したコンテンツ）を移行し，新しいインストールディレクトリに対応するように，必要な修正をしてください。

○

−

−

インストール先に<システムドライブ>:¥Windows¥System32 ディレクトリ下は指定しないでください。

○

−

−

UNIX共通

次の製品を使用する場合には，製品の共通モジュールを必ずインストールしてください。

Application Server

Service Platform

また，アプリケーションサーバ Version 6以前のCommon Libraryがすでにインストールされている場合は，Common Libraryをアンインストールしたあとに，製品の共通モジュールをインストールしてください。

○

−

−

製品のインストールおよびアンインストールでは，PPインストーラを使用します。インストールおよびアンインストールにはroot権限が必要です。

○

○

○

トレース共通ライブラリは，製品の構成ソフトウェアをアンインストールしたときに，必要に応じてアンインストールされます。ただし，トレース共通ライブラリのアンインストールに失敗してメッセージが表示された場合には，コマンドを実行してトレース共通ライブラリ単体でアンインストールすることもできます。

アンインストールするには，次のコマンドを実行します。

/opt/hitachi/HNTRLib2/etc/hntr2setup

メニューが表示されるので，通常アンインストールは「9」を，強制アンインストールは「0」を選択してください。

−

−

○

OSインストール後のデフォルトの設定では，/etc/hostsファイルに127.0.0.1のIPアドレスに対して自ホスト名が設定されます。TPBrokerを使って通信する場合には，ネットワークインタフェースに割り当てられたIPアドレスに対して自ホスト名が設定されている必要があります。そのため，/etc/hostsファイルには，自ホスト名に対してネットワークインタフェースに割り当てられた適切なIPアドレスを設定してください。

○

−

−

OSインストール後のデフォルトの設定では，/etc/hostsファイルに127.0.0.1のIPアドレスに対して自ホスト名が設定されます。Performance Tracerを使う場合には，ネットワークインタフェースに割り当てられたIPアドレスに対して自ホスト名が設定されている必要があります。そのため，/etc/hostsファイルには，自ホスト名に対してネットワークインタフェースに割り当てられた適切なIPアドレスを設定してください。

○

−

−

Application ServerおよびService Platformの場合，インストール先に，ディスク占有量分の空きがあることを確認してください。ディスク占有量については，「リリースノート」でご確認ください。

○

−

−

Application ServerおよびService Platformの場合，一時ディレクトリ（/tmp）に，ディスク占有量分の空きがあることを確認してください。ディスク占有量については，「リリースノート」でご確認ください。 /tmpに空きがない場合は，容量に空きがあるディレクトリを環境変数TMPDIRに設定してからインストールしてください。

○

−

−

（凡例）○：該当します。　−：該当しません。

(2)　作業中に確認する注意事項

分類

注意事項

新規インストール

更新インストール

アンインストール

Windows共通

「Hitachi Web Server」サービスが登録されている環境では，同一バージョンの更新インストール（上書き）時にエラー（レジストリアクセスエラーなど）が発生した場合は，アンインストールしたあと，再度インストールしてください。

−

○

−

インストーラを使用してインストールしているときは，絶対に，製品の提供媒体をCD-ROMドライブから外したり，インストーラを強制終了させたりしないでください。これらの操作をすると，インストール情報に不整合が発生し，以降，インストールおよびアンインストールが実行できなくなるおそれがあります。

○

○

−

インストールの処理を完了するためにインストール終了後，必ずOSを再起動してください。なお，インストール後，アンインストールする場合もインストールを完了させるためにOSを再起動してから，アンインストールしてください。

○

○

○

製品をアンインストールした場合，または製品に含まれる構成ソフトウェアをアンインストールした場合は，アンインストールを完了させるために必ずOSを再起動させてください。

−

−

○

製品および製品に含まれる構成ソフトウェアでは，インストール終了処理に時間が掛かることがあります。インストールが完了し，次の画面に移るまで待ってください。

○

○

−

インストール中にキャンセルした場合は，キャンセルした構成ソフトウェアからあとのインストール処理がキャンセルされます。キャンセルした構成ソフトウェアより前に処理が完了した構成ソフトウェアはインストールされた状態になります。

また，アンインストール中にキャンセルした場合も，キャンセルした構成ソフトウェアからあとのアンインストール処理がキャンセルされます。キャンセルした構成ソフトウェアより前に処理が完了した構成ソフトウェアはアンインストールされた状態になります。

○

○

○

途中で一度もアンインストールしないで，同一バージョンの更新インストールを複数回実行したあとにアンインストールをすると，エラーが発生して失敗することがあります。この場合は，再度アンインストールを実行してください。一部のディレクトリおよびファイルが削除されないことがありますが，次回のインストールの実行には影響ありません。

−

−

○

インストールの途中でインストーラから呼び出しているconime.exeプロセスが終了しないまま，インストール処理がハングアップすることがあります。conime.exeプロセスが存在している状態でインストール処理がハングアップした場合は，タスクマネージャ（Taskmgr.exe）などから起動中のconime.exeを終了させてください。

○

○

−

（凡例）○：該当します。　−：該当しません。

(3)　作業後に確認する注意事項

分類

注意事項

新規インストール

更新インストール

アンインストール

OS共通

インストールに失敗した場合は，次の点を確認してください。

起動しているサービスやアクセス中のファイル，ディレクトリがないか

ファイル，ディレクトリのアクセス権が拒否されていないか

○

○

−

異なるバージョンへの更新インストール（バージョンアップ）をして環境を移行した場合，作業ディレクトリは旧バージョンで使用していたディレクトリを引き続き使用します。旧バージョンの作業ディレクトリを誤って削除しないようにしてください。

−

○

−

運用管理エージェントの設定ファイルであるadminagent.xmlは，インストール時に上書きされ，既存のファイルはadminagent.xml.bakとして退避されます。adminagent.xmlを編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

−

○

−

snapshotログ収集先対象リストファイルであるsnapshotlog.conf，およびsnapshotlog.2.confは，インストール時に上書きされ，既存のファイルはsnapshotlog.conf.bak，およびsnapshotlog.2.conf.bakとして退避されます。snapshotログの収集対象を編集して運用している場合は，新たにインストールされたファイルに，以前に編集した項目を再編集してください。

−

○

−

Windows共通

「Hitachi Web Server」サービスが登録されている環境では，同一バージョンの更新インストール（上書き）をしたあと，「Hitachi Web Server」サービスがそのまま残ります。「Cosminexus HTTP Server」サービスは登録されません。

−

○

−

「Hitachi Web Server」サービスが登録されている環境では，Web Serverから異なるバージョンへの更新インストール（バージョンアップ）をする場合，HTMLマニュアル，GUIサーバ管理機能に関するファイル，ディレクトリ，ユティリティなどが削除されないで残ることがあります。これらのファイルは更新後のバージョンでは使用できません。

−

○

−

UNIX共通

インストール先のディレクトリおよびファイルは，root権限のあるユーザだけが更新できます。このため，Component Container管理者を設定している場合は，次に示すディレクトリおよびファイルに，Component Container管理者の書き込み権限を設定してください。

/opt/Cosminexus/c4web/attachmentsディレクトリ

/opt/Cosminexus/c4web/confディレクトリ以下のファイル

/opt/Cosminexus/c4web/logsディレクトリ

また，添付ファイルの退避先ディレクトリや，トレースファイルの出力先ディレクトリを指定している場合は，そのディレクトリの属性も設定してください。

なお，同一バージョンの更新インストール（上書き）をした場合，各ディレクトリおよびファイルの属性はデフォルトの状態に戻ります。この場合，運用に合わせて，各ディレクトリおよびファイルの属性を変更してください。

○

○

−

（凡例）○：該当します。　−：該当しません。

付録I.2　構成ソフトウェアをインストールおよびアンインストールするときの注意事項

構成ソフトウェアをインストールおよびアンインストールするときの注意事項を作業のタイミングに分けて説明します。

(1)　作業前に確認する注意事項

分類

構成ソフトウェア

注意事項

新規インストール

更新インストール

アンインストール

OS共通

Component Container

Component Containerを新規インストールする場合にインストールディレクトリが作成されているときは，インストールディレクトリにファイルがないことを確認してください。

製品がインストールするファイルまたはディレクトリと同名のまたはディレクトリがあると，ファイルまたはディレクトリが上書きされます。必要に応じて，ディレクトリやファイルの移動，バックアップの作成，またはインストール先の変更をしてください。

Windowsの場合（デフォルト）

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥CC

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥manager

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥c4web

<OSインストールドライブ>:¥Program Files¥Hitachi¥Cosminexus¥plugins

UNIXの場合（固定）

/opt/Cosminexus/CC

○

−

−

Component Containerで異なるバージョンへの更新インストール（バージョンアップ）をする場合，次のディレクトリが削除されます。必要なファイルがある場合は，更新インストール前に退避してください。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥help

<Application Serverのインストールディレクトリ>¥CC¥examples

<Application Serverのインストールディレクトリ>¥CC¥gui

UNIXの場合

/opt/Cosminexus/CC/admin/help

/opt/Cosminexus/CC/examples

/opt/Cosminexus/CC/gui

−

○

−

Component Containerで異なるバージョンへの更新インストール（バージョンアップ）をする場合，作業ディレクトリのディスク使用量の2倍以上の空き容量を確保してください。

−

○

−

Component Containerをインストールまたはアンインストールする場合，HTTP Serverを停止してください。停止しないでインストールまたはアンインストールすると，リダイレクタおよびPerformance Tracerを正常に更新またはアンインストールできません。

○

○

○

Component Containerをインストールまたはアンインストールする場合，J2EEサーバ，Webコンテナサーバ，およびCORBAネーミングサービスを停止してください。

○

○

○

Component Containerで異なるバージョンへの更新インストール（バージョンアップ）をする場合，次の構成ソフトウェアがインストールされていたときはアンインストールしてください。ただし，環境を引き継ぐため，アンインストールした構成ソフトウェアのディレクトリは削除しないでください。

Component Library

Manager

Web Services - Base

−

○

−

Component Container - Redirector

リダイレクタ機能をインストールまたはアンインストールする場合，HTTP Serverを停止してください。停止しないでインストールまたはアンインストールすると，リダイレクタおよびPerformance Tracerを正常に更新またはアンインストールできません。

○

○

○

Windows共通

Component Container

Component Containerをインストールする場合，Application Serverのインストール先ディレクトリ名に"#"を含むパスを指定しないでください。

○

○

−

Component Transaction Monitor

Component Transaction Monitorをインストールするためには，ディスク占有量に記載した容量が必要です。この容量には，インストール作業に必要な一時的な領域を含んでいます。この容量が確保されていないディスクへComponent Transaction Monitorをインストールしようとした場合，ディスクの空き容量が5%以下になったときにインストール処理が中断します。この際，ディスクの空き領域を確保するか，またはインストール作業を中止することができます。ディスクの空き領域を確保した場合は，インストールは正常に終了します。インストール作業を中止した場合は，部分的にインストールされたすべてのファイルを削除してください。インストール作業の進行状況によっては，Component Transaction Monitorをアンインストールするか，Component Transaction Monitorのインストールディレクトリ以下をすべて手作業で削除する必要があります。

○

−

−

Developer's Kit for Java

Developer's Kit for Javaを更新インストールすると，<Application Serverのインストールディレクトリ>¥jdk¥下にあるファイルは初期化されます。必要なファイルは退避しておいてください。

ただし，次に示すファイルは，更新インストール前のファイルが，同じディレクトリに別名（ファイル名_バージョン番号_日付時刻）で保存されるため，退避不要です。

<Application Serverのインストールディレクトリ>¥jdk¥lib¥security¥cacerts

<Application Serverのインストールディレクトリ>¥jdk¥conf¥logging.properties

<Application Serverのインストールディレクトリ>¥jdk¥conf¥net.properties

<Application Serverのインストールディレクトリ>¥jdk¥conf¥sound.properties

<Application Serverのインストールディレクトリ>¥jdk¥conf¥management¥jmxremote.access

<Application Serverのインストールディレクトリ>¥jdk¥conf¥management¥management.properties

<Application Serverのインストールディレクトリ>¥jdk¥conf¥security¥java.policy

<Application Serverのインストールディレクトリ>¥jdk¥conf¥security¥java.security

更新インストール後に，ファイルの内容を戻したい場合は，別名で保存されたファイルを元のファイル名に戻すか，別名で保存されたファイルの内容を初期化されたファイルに取り込んでください。

−

○

−

HTTP Server

HTTP Serverの次に示す作業の前に，「Cosminexus HTTP Server」サービスを停止してください。

同一バージョンの更新インストール（上書き）前

アンインストール前

−

○

○

HTTP Serverのアンインストール前に，httpsdコマンドで登録したサービスを削除してください。

−

−

○

HTTP Serverのアンインストールでは，ファイルに読み取り専用属性が付与されている場合も削除されます。

−

−

○

Performance Tracer

Performance Tracerをインストールするためには，ディスク占有量に記載した容量が必要です。この容量には，インストール作業に必要な一時的な領域を含んでいます。この容量が確保されていないディスクへPerformance Tracerをインストールしようとした場合，ディスクの空き容量が5%以下になったときにインストール処理が中断します。この際，ディスクの空き領域を確保するか，またはインストール作業を中止することができます。ディスクの空き領域を確保した場合は，インストールは正常に終了します。インストール作業を中止した場合は，部分的にインストールされたすべてのファイルを削除してください。インストール作業の進行状況によっては，Performance Tracerをアンインストールするか，Performance Tracerのインストールディレクトリ以下をすべて手作業で削除する必要があります。

○

−

−

UNIX共通

Component Container

Component Containerのインストールディレクトリは，「/opt/Cosminexus/CC」固定です。

○

−

−

Component Containerをインストールする場合，umaskの影響を受けるファイルがあります。適切なumaskを設定してください。

○

−

−

Component Containerを更新インストールする場合に，インストールディレクトリが変更されたときは，新規インストールになります。

−

○

−

Component Container - Redirector

リダイレクタ機能のインストールディレクトリは，「/opt/Cosminexus/CCR」固定です。

○

−

−

リダイレクタ機能をインストールする場合，umaskの影響を受けるファイルがあります。適切なumaskを設定してください。

○

−

−

Developer's Kit for Java

Developer's Kit for Javaを更新インストールすると，opt/Cosminexus/jdkにあるファイルはすべて削除されます。必要なファイルは退避しておいてください。

ただし，次に示すファイルは，更新インストール前のファイルが，同じディレクトリに別名（ファイル名_バージョン番号_日付時刻）で保存されるため，退避不要です。

/opt/Cosminexus/jdk/lib/security/cacerts

/opt/Cosminexus/jdk/conf/logging.properties

/opt/Cosminexus/jdk/conf/net.properties

/opt/Cosminexus/jdk/conf/sound.properties

/opt/Cosminexus/jdk/conf/management/jmxremote.access

/opt/Cosminexus/jdk/conf/management/management.properties

/opt/Cosminexus/jdk/conf/security/java.policy

/opt/Cosminexus/jdk/conf/security/java.security

更新インストール後に，ファイルの内容を戻したい場合は，別名で保存されたファイルを元のファイル名に戻すか，別名で保存されたファイルの内容を初期化されたファイルに取り込んでください。

−

○

−

HTTP Server

すでにHTTP Serverがインストールされているシステムに再インストールする場合，同一バーションの更新インストール（上書き）ができます。このとき，HTTP Serverをインストールする前に，HTTP Serverの全プログラムおよび関連ファイルへの操作をすべて終了してください。

−

○

−

HTTP Serverをインストールする場合，コンフィグファイルがすでにあるときは，バージョン番号を付与した別名称でインストールされます。

○

○

−

HTTP Serverをインストールする場合，/opt/hitachi/httpsd/htdocs/index.htmlがすでにあるときは上書きされません。

○

○

−

HTTP Serverで同一バーションの更新インストール（上書き）をする場合，再インストール後も使用するファイル（httpsd.conf,sslc.cnfなどのコンフィグファイルやユーザが作成したコンテンツ）は，あらかじめ退避しておくことをお勧めします。

−

○

−

PPインストーラを使ったHTTP Serverのインストールに失敗した場合は，HTTP Serverの全プログラムおよび関連ファイルへの操作がすべて終了していることを確認してから，再度インストールしてください。また，HTTP Serverで提供しているディレクトリと同一名称のファイルがあった場合，インストールに失敗することがあります。/opt/hitachi/httpsd以下に同名のファイルがないことを確認してから，再度インストールしてください。

○

−

−

Web ServerからHTTP Serverへ異なるバージョンへの更新インストール（バージョンアップ）をする場合，以前のバージョンのHTMLマニュアル，GUIサーバ管理機能に関するファイル，ディレクトリ，一部のユティリティは削除されないで残ります。これらのファイルの使用はサポートしていません。

−

○

−

HTTP Serverのアンインストール時，/opt/hitachi/httpsd以下のファイルはすべて削除されます。必要なファイルはあらかじめ退避してください。

−

−

○

Web Services - Security

Web Services - Securityをインストールする環境に，バージョン6以前のXML Securityがすでにインストールされている場合は，XML Securityをアンインストールしたあとに，Web Services - Securityをインストールしてください。

○

−

−

XML Processor

XML Processorで同一バージョンの更新インストール（上書き）をする場合，/opt/Cosminexus/jaxpにあるすべてのファイルをいったん削除します。そのため，上書きインストール後に必要なファイルは，あらかじめ退避しておいてください。

−

○

−

（凡例）○：該当します。　−：該当しません。

(2)　作業中に確認する注意事項

分類

構成ソフトウェア

注意事項

新規インストール

更新インストール

アンインストール

Windows共通

HTTP Server

HTTP Serverの同一バージョンの更新インストール（上書き）で，エラー（レジストリアクセスエラーなど）が発生した場合は，アンインストールしたあとに，再度インストールしてください。

−

○

−

（凡例）○：該当します。　−：該当しません。

(3)　作業後に確認する注意事項

分類

構成ソフトウェア

注意事項

新規インストール

更新インストール

アンインストール

OS共通

Component Container

Component Containerで異なるバージョンへの更新インストール（バージョンアップ）をして環境を移行した場合，作業ディレクトリは旧バージョンで使用していたディレクトリを引き続き使用します。旧バージョンの作業ディレクトリを誤って削除しないようにしてください。

−

○

−

Management Server上で論理Webサーバを削除しないで，HTTP Serverをアンインストールして再インストールした場合，Management Serverで管理されている論理Webサーバは削除されませんが，実サーバ（Webサーバ（HTTP Server））は削除されます。このため，再インストール後，Management Serverで該当する論理Webサーバを再セットアップする必要があります。この場合は，運用管理ポータルで再度論理Webサーバのセットアップと配布を実行してください。

また，httpsd.confファイルは，運用管理ポータルで論理Webサーバの設定情報を配布した時に新規作成または上書きされます。このため，手動でhttpsd.confファイルを修正していた場合は，運用管理ポータルで論理Webサーバの設定情報を配布したあとに，必要に応じて，再度httpsd.confファイルを修正してください。なお，運用管理ポータルの［Webサーバの設定］画面で，httpsd.confファイルの内容を編集して配布している場合は，修正不要です。

○

−

−

Component Containerで同一バージョンの更新インストール（上書き）をしても，アプリケーションサーバにインポート，デプロイ済みのDB Connectorはアップデートされません。インポート，デプロイ済みのDB Connectorをアップデートするためには，cjrarupdateコマンドを実行してください。cjrarupdateコマンドの実行形式を次に示します。

/opt/Cosminexus/CC/server/bin/cjrarupdate -type dbconnector

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjrarupdate（リソースアダプタのバージョンアップ）」を参照してください。

−

○

−

cjrarupdateコマンド実行時，DB Connectorに変更がない場合はKDJE42249-Wメッセージが出力されます。メッセージが出力されても問題はありません。

−

○

−

Component Containerをインストールした場合，古いバージョンで取得したJ2EEアプリケーションのRMI-IIOPスタブおよびインタフェースは使用できません。cjstartappコマンド実行後，cjgetstubsjarコマンドを実行してJ2EEアプリケーションのRMI-IIOPスタブおよびインタフェースを取得し直してください。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjgetstubsjar（アプリケーションのRMI-IIOPスタブおよびインタフェースの取得）」を参照してください。

○

○

−

Reliable Messaging

Reliable Messagingを更新インストールすると，Reliable Messagingが提供するコマンドのリクエストタイムアウト値はデフォルト値（0）に戻ります。<Application Serverのインストールディレクトリ>/RM/binディレクトリ下にある，バッチファイルまたはシェルスクリプトを編集して，リクエストタイムアウト値を変更している場合は，再度，値を設定してください。

−

○

−

Reliable Messagingのコマンドを実行すると，<Application Serverのインストールディレクトリ>/RM/logsにコマンド実行時のログが出力されます。アンインストール時，このディレクトリ下にあるログディレクトリやファイルが残ることがあります。

−

−

○

Windows共通

Developer's Kit for Java

Developer's Kit for Javaをアンインストールしても一部のファイルやディレクトリが削除されないで，<Application Serverのインストールディレクトリ>¥jdk以下に残ることがあります。削除されなかったファイルやディレクトリは手動で削除してください。

−

−

○

Developer's Kit for Javaの更新インストール時に，インストーラが別名で保存したファイルは，アンインストールしても削除されません。また，更新インストールを繰り返し実施すると，実施した回数分，別名で保存したファイルが作成されます。必要に応じて不要なファイルやディレクトリは削除してください。

−

○

○

HTTP Server

HTTP Serverの新規インストールでは，「Cosminexus HTTP Server」サービスのスタートアップの種類は「手動」で登録されます。

○

−

−

HTTP Serverのアンインストールでは，インストール後に作成されるファイル，コンフィグファイルは削除されません。また，そのほかのファイルやディレクトリが削除されないで残ることがあります。

−

−

○

UNIX共通

Component Container

Component Containerをアンインストールしても/opt/Cosminexus/CC/spoolディレクトリは削除されません。アンインストール後に，手動で削除してください。

−

−

○

（凡例）○：該当します。　−：該当しません。

付録I.3　ディスク複製インストールおよび仮想化プラットフォームが提供する複製機能を使用するときの注意事項（Windowsの場合）

構成ソフトウェアごとに，複製をするときの注意事項を説明します。

(1)　Component Containerでの注意事項

Component Containerでの注意事項を次に示します。Component Containerでは，構築するシステム構成によって実施する作業などが異なります。

(a)　J2EEアプリケーションを実行するシステム（J2EEサーバ）使用時

J2EEアプリケーションを実行するシステム（J2EEサーバ）使用時，Component Containerでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。Management Serverを使用しているときは手順3.も実施してください。

手順

複製元のマシンで，次に示すプログラムを終了します。

・J2EEサーバ（グローバルトランザクションを使用している場合は，開始済みのトランザクションを決着させてから終了してください）

・Webコンテナサーバ

・運用管理エージェント

・Management Server

・HTTP Server，またはMicrosoft IIS

複製元のマシンで，次のディレクトリ下にファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥comtrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥mdltrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥system¥ejbcl¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥system¥ejbcl¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥system¥TPB¥logj¥comtrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥system¥TPB¥logj¥mdltrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥system¥TPB¥logj¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥TPB¥logj¥comtrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥TPB¥logj¥mdltrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥TPB¥logj¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥redirector¥servers¥<サーバ名>¥logs¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥redirector¥servers¥<サーバ名>¥logs¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥redirector¥logs¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥redirector¥logs¥mmap¥*

・<Application Serverのインストールディレクトリ>¥manager¥spool¥default¥*

・<Application Serverのインストールディレクトリ>¥manager¥spool¥lsinfo¥*

・<Application Serverのインストールディレクトリ>¥manager¥tmp¥*

・<Application Serverのインストールディレクトリ>¥manager¥setup¥log¥*

・<Application Serverのインストールディレクトリ>¥manager¥setup¥log¥maintenance¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥watch¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥CC¥maintenance¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥CC¥rmi¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥connectors¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥connectors¥<アプリケーション表示名>¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥connectors¥TEST#<アプリケーション表示名>¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥TPB¥logj¥mdltrc¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥TPB¥logj¥comtrc¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥TPB¥logj¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥http¥comm¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥http¥thr¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥http¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥*

・<Managerログ出力ディレクトリ>¥maintenance¥*

・<Managerログ出力ディレクトリ>¥maintenance¥mmap¥*

・<Managerログ出力ディレクトリ>¥message¥*

・<Managerログ出力ディレクトリ>¥message¥mmap¥*

・<Managerログ出力ディレクトリ>¥trace¥*

・<Managerログ出力ディレクトリ>¥trace¥mmap¥*

・<Managerログ出力ディレクトリ>¥*

・<Managerログ出力ディレクトリ>¥<snapshotログの出力先ディレクトリ>¥*

・<監査ログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥mmap¥*

・<監査ログの例外情報出力ディレクトリ>¥*

・<監査ログの例外情報出力ディレクトリ>¥mmap¥*

参考

各ディレクトリのデフォルトを次に示します。

<作業ディレクトリ>：<Application Serverのインストールディレクトリ>¥CC¥server¥public

<Managerログ出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥manager¥log

<snapshotログの出力先ディレクトリ>：<Managerログ出力ディレクトリ>¥snapshot

<監査ログ出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥auditlog

<監査ログのメッセージログ出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥auditlog

<監査ログの例外情報出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥auditlog

Management Serverを使用している場合は，複製元のマシンでプロパティファイルの設定を変更します。

複製元のマシンでManagement Serverが動作しているかどうかで作業が異なります。

複製元のマシンでManagement Serverが動作していないとき

複製先のマシンがマルチホームドホストのときは，あらかじめ，複製元のマシンの運用管理エージェントプロパティファイル（adminagent.properties）に，「adminagent.adapter.bind_host=<複製先の管理IPアドレスと一致する正規表現>」を設定してください。

複製元のマシンでManagement Serverが動作しているとき

次の表に示すプロパティを設定してください。

ファイル名

プロパティ

値

.cmxrcおよびcmxclient.properties

cmx.lb

keepvs

adminagent.properties

adminagent.adapter.allowedHosts

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されているときは，同じ値を指定してください。

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されていないときは，ホスト用管理IPアドレスと一致する正規表現を設定してください。

mserver.properties

mngsvr.myhost.name

複製先のマシンがマルチホームドホストのときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

webserver.connector.http.bind_host

adminagent.properties

adminagent.adapter.bind_host

.mngsvrutilrcおよびmngsvrutilcl.properties

mngsvrutil.connect.host

ループバックアドレス以外を設定するときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

mngsvrutil.target_name

.cmxrcおよびcmxclient.properties

cmx.connect.host

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.〜手順3.を実施してください。Management Serverを使用しているときは手順4.も実施してください。

手順

次に示すプロパティをJ2EEサーバ用ユーザプロパティファイル（usrconf.properties），およびサーバ管理コマンド用ユーザプロパティファイル（usrconf.properties）で設定している場合は，複製先のマシンで値を変更します。

各プロパティで適切な値に変更してください。

・vbroker.se.iiop_tp.host

・ejbserver.ctm.CTMMyHost

・vbroker.se.iiop_ts.proxyHost

・vbroker.se.iiop_tp.proxyHost

・ejbserver.naming.host

次に示すプロパティをJ2EEサーバ用ユーザプロパティファイル（usrconf.properties），およびWebコンテナサーバ用ユーザプロパティファイル（usrconf.properties）で設定している場合は，複製先のマシンで値を変更します。

各プロパティの値を複製先のIPアドレスに変更してください。

・webserver.connector.http.bind_host

・webserver.connector.nio_http.bind_host

各プロパティの値をJ2EEサーバ，またはWebコンテナサーバごとにユニークな値に設定し直してください。

・webserver.container.server_id.value

・webserver.session.server_id.value

Management Serverを使用している場合は，複製先のマシンで次の操作を実施します。

1. 複製で追加したホストの定義

2. 複製先ホスト上に定義されている複製元のホスト定義の削除（Management Serverが動作しているマシンを複製したときだけ）

3. 複製で追加した論理サーバの定義

4. 3.で追加した論理サーバのセットアップ（実サーバ名指定）

5. 3.で追加した論理サーバの設定ファイルの読み込み

6. 3.で追加した論理サーバの設定ファイルの配布

7. サーバ管理コマンドでEARファイル，およびRARファイルを削除したあとの再配布（J2EEサーバのアプリケーション管理機能を使用しているときだけ）

(b)　バッチアプリケーションを実行するシステム（バッチサーバ）使用時

バッチアプリケーションを実行するシステム（バッチサーバ）使用時，Component Containerでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。Management Serverを使用しているときは手順3.も実施してください。

手順

複製元のマシンで，次に示すプログラムを終了します。

・バッチサーバ（リソースアダプタを開始したまま終了しても構いません）

・運用管理エージェント

・Management Server

複製元のマシンで，次のディレクトリ下にファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥maintenance¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥CC¥rmi¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥comtrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥mdltrc¥*

・<Application Serverのインストールディレクトリ>¥CC¥admin¥logs¥TPB¥logj¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥*

・<Application Serverのインストールディレクトリ>¥CC¥client¥logs¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名>¥logs¥*

・<Application Serverのインストールディレクトリ>¥manager¥spool¥default¥*

・<Application Serverのインストールディレクトリ>¥manager¥spool¥lsinfo¥*

・<Application Serverのインストールディレクトリ>¥manager¥tmp¥*

・<Application Serverのインストールディレクトリ>¥manager¥setup¥log¥*

・<Application Serverのインストールディレクトリ>¥manager¥setup¥log¥maintenance¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥watch¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥CC¥maintenance¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥CC¥rmi¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥connectors¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥TPB¥logj¥mdltrc¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥TPB¥logj¥comtrc¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥TPB¥logj¥*

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥*

・<Managerログ出力ディレクトリ>¥maintenance¥*

・<Managerログ出力ディレクトリ>¥maintenance¥mmap¥*

・<Managerログ出力ディレクトリ>¥message¥*

・<Managerログ出力ディレクトリ>¥message¥mmap¥*

・<Managerログ出力ディレクトリ>¥trace¥*

・<Managerログ出力ディレクトリ>¥trace¥mmap¥*

・<Managerログ出力ディレクトリ>¥*

・<snapshotログの出力先ディレクトリ>¥*

・<監査ログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥mmap¥*

・<監査ログの例外情報出力ディレクトリ>¥*

・<監査ログの例外情報出力ディレクトリ>¥mmap¥*

参考

各ディレクトリのデフォルトを次に示します。

<作業ディレクトリ>：<Application Serverのインストールディレクトリ>¥CC¥server¥public

<Managerログ出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥manager¥log

<snapshotログの出力先ディレクトリ>：<Managerログ出力ディレクトリ>¥snapshot

<監査ログ出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥auditlog

<監査ログのメッセージログ出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥auditlog

<監査ログの例外情報出力ディレクトリ>：<Application Serverのインストールディレクトリ>¥auditlog

Management Serverを使用している場合は，複製元のマシンでプロパティファイルの設定を変更します。

複製元のマシンでManagement Serverが動作しているかどうかで作業が異なります。

複製元のマシンでManagement Serverが動作していないとき

複製先のマシンがマルチホームドホストのときは，あらかじめ，複製元のマシンの運用管理エージェントプロパティファイル（adminagent.properties）に，「adminagent.adapter.bind_host=<複製先の管理IPアドレスと一致する正規表現>」を設定してください。

複製元のマシンでManagement Serverが動作しているとき

次の表に示すプロパティを設定してください。

ファイル名

プロパティ

値

adminagent.properties

adminagent.adapter.allowedHosts

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されているときは，同じ値を指定してください。

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されていないときは，ホスト用管理IPアドレスと一致する正規表現を設定してください。

mserver.properties

mngsvr.myhost.name

複製先のマシンがマルチホームドホストのときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

webserver.connector.http.bind_host

adminagent.properties

adminagent.adapter.bind_host

.mngsvrutilrcおよびmngsvrutilcl.properties

mngsvrutil.connect.host

ループバックアドレス以外を設定するときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

mngsvrutil.target_name

.cmxrcおよびcmxclient.properties

cmx.connect.host

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.を実施してください。Management Serverを使用しているときは手順2.も実施してください。

手順

次に示すプロパティをバッチサーバ用ユーザプロパティファイル（usrconf.properties），およびサーバ管理コマンド用ユーザプロパティファイル（usrconf.properties）で設定している場合は，複製先のマシンで値を変更します。

各プロパティで適切な値に変更してください。

・vbroker.se.iiop_tp.host

・ejbserver.naming.host

Management Serverを使用している場合は，複製先のマシンで次の操作を実施します。

1. 複製で追加したホストの定義

2. 複製先ホスト上に定義されてい複製製元のホスト定義の削除（Management Serverが動作しているマシンを複製したときだけ）

3. 複製で追加した論理サーバの定義

4. 3.で追加した論理サーバのセットアップ（実サーバ名指定）

5. 3.で追加した論理サーバの設定ファイルの読み込み

6. 3.で追加した論理サーバの設定ファイルの配布

7. サーバ管理コマンドでRARファイルを削除したあとの再配布（J2EEサーバのアプリケーション管理機能を使用しているときだけ）

(2)　Component Container - Redirectorでの注意事項

Component Container - Redirectorでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。

手順

複製元のマシンで，次に示すプログラムを終了します。

・HTTP Server，またはMicrosoft IIS

複製元のマシンで，次のディレクトリ下にログファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・<Application Serverのインストールディレクトリ>¥CCR¥web¥redirector¥servers¥<サーバ名>¥logs¥*

・<Application Serverのインストールディレクトリ>¥CCR¥web¥redirector¥servers¥<サーバ名>¥logs¥mmap¥*

・<Application Serverのインストールディレクトリ>¥CCR¥web¥redirector¥logs¥*

・<Application Serverのインストールディレクトリ>¥CCR¥web¥redirector¥logs¥mmap¥*

(3)　Reliable Messagingでの注意事項

Reliable Messagingでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。

手順

J2EEサーバにReliable Messagingをデプロイし，Reliable Messagingが開始している場合は，J2EEサーバ上でReliable Messagingを停止します。

複製元のマシンで，次のディレクトリ下にログファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・<作業ディレクトリ>¥ejb¥<サーバ名>¥logs¥RM¥maintenance

<作業ディレクトリ>のデフォルトは，<Application Serverのインストールディレクトリ>¥CC¥server¥publicです。

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.〜手順5.を実施してください。

手順

複製後のシステムでホスト名またはIPアドレスを変更した場合は，次に示すReliable Messagingの設定を更新します。

・環境変数HRM_CMD_HOSTの設定を，複製後のシステムのホスト名またはIPアドレスに更新してください。

・キュー間転送機能を使用し，転送先システムのホスト名またはIPアドレスを変更したときは，次に示す手順で転送元システムに存在するあて先と，そのあて先を使用する転送キューを再作成してください。

1. 転送元システムのあて先を使用しているすべての転送キューにメッセージがないことを確認します。

2. 転送元システムのあて先を使用しているすべての転送キューを削除します。

3. 転送元システムのあて先を削除します。

4. 変更後のホスト名またはIPアドレスを指定して，転送元システムのあて先を新規作成します。

5. 転送元システムのあて先を使用する転送キューを新規作成します。

Reliable Messagingのシステム名が一意となるように，コンフィグレーションプロパティのRMSystemNameと，環境変数HRM_SYSTEM_NAMEを変更します。

手順2.で変更したシステム名に対応する管理情報テーブルを作成します。

管理情報テーブルの作成方法については，マニュアル「Reliable Messaging」を参照してください。

DBMSにHiRDBを使用し，XAトランザクションを使用する構成の場合は，Reliable Messagingの連携先DB ConnectorのXAOpenStringが，同一HiRDBに接続するリソースアダプタ間で一意になるように，連携先DB ConnectorのコンフィグレーションプロパティのdescriptionとXAOpenStringを変更します。

Reliable Messagingを開始して，必要なキューを作成します。

(4)　Component Transaction Monitorでの注意事項

Component Transaction Monitorでの注意事項を次に示します。

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで環境変数CTMSPOOLに設定したディレクトリ下を削除してください。

(5)　Performance Tracerでの注意事項

複製を実施したあとに，複製先のマシンで環境変数PRFSPOOLに設定したディレクトリ下を削除してください。

(6)　HTTP Serverでの注意事項

HTTP Serverでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンでHTTP Serverのすべてのプログラム，および関連ファイルへのすべての操作を終了してください。

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.〜手順3.を実施してください。

手順

必要に応じて，複製後のディレクティブの設定を変更します。

・ネットワーク関連のディレクティブ

ServerName，<VirtualHost>，BindAddress，Listen，NameVirtualHost

・ファイルシステム関連のディレクティブ

<Directory>，<DirectoryMatch>，Alias，AliasMatch，AuthGroupFile，AuthUserFile，CustomLog，DocumentRoot，ErrorLog，HWSRequestLog，HWSTraceIdFile，HWSTraceLogFile，Include，LoadFile，LoadModule，PidFile，QOSResponse，ScriptAlias，ScriptAliasMatch，ScriptLog，ServerRoot，SSLCACertificateFile，SSLCertificateFile，SSLCertificateKeyFile，SSLCertificateKeyPassword，SSLCRLDERPath，SSLCRLPEMPath，TransferLog，TypesConfig，UserDir

PidFileディレクティブに指定されているファイルがコピーされている場合は，HTTP Serverを起動する前に削除します。

ログ関連のファイルがコピーされている場合は，必要に応じて，不要なファイルを削除します。

(7)　TPBrokerでの注意事項

TPBrokerでの注意事項を次に示します。

複製を実施したあとにすること

複製を実施したあとに，実施する作業について説明します。手順1.〜手順2.を実施してください。

手順

仮想化プラットフォームが提供するイメージファイル化による複製機能を使用する場合に，次の設定があるときは，指定したホスト名やIPアドレスをシステムに合わせて変更します。

・agentaddrファイル（環境変数OSAGENT_ADDR_FILEまたはプロパティvbroker.agent.addrFileでも指定できます）

・localaddrファイル（環境変数OSAGENT_LOCAL_FILEまたはプロパティvbroker.agent.localFileでも指定できます）

・htc.clienthandleraddrファイル（環境変数HVI_OSAGENT_CLIENTHANDLERADDR_FILEでも指定できます）

・プロパティvbroker.agent.addr

・プロパティvbroker.se.<サーバエンジン>.host

・プロパティvbroker.se.<サーバエンジン>.proxyHost

・プロパティvbroker.orb.initRef

・プロパティvbroker.orb.defaultInitRef（C++だけ）

・コマンドラインオプション ORBInitRef

・コマンドラインオプション ORBDefaultInitRef（C++だけ）

・コマンドラインオプション ORBagentAddr

・osagentのコマンドラインオプション -a

・環境変数OSAGENT_ADDR

また，ホスト名やIPアドレスを変更する前に作成したIORファイルは，変更後に再作成し，再配布してください。

仮想化環境での複製機能を使用し，かつグローバルトランザクションを使用する場合，仮想化環境の複製元にインプロセストランザクションサービスのステータスファイルを含まないように，インプロセストランザクションサービスのステータスファイルがあるときは削除します。

(8)　Service Coordinatorでの注意事項

Service Coordinatorでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.〜手順2.を実施してください。

手順

マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「実行環境に必要なソフトウェアを設定する」までの作業を実施します。

次に示す構成ソフトウェアの「複製を実施する前にすること」の作業を実施します。

・Component Container

・Reliable Messaging

・HTTP Server

・TPBroker

複製を実施したあとにすること

複製を実施したあとに，実施する作業について説明します。手順1.〜手順2.を実施してください。

手順

複製先のマシンで，次に示す構成ソフトウェアの「複製を実施したあとにすること」の作業を実施します。

・Component Container

・Reliable Messaging

・Component Transaction Monitor

・Performance Tracer

・HTTP Server

・TPBroker

複製元のマシン，および複製先のマシンで，マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「HCSCサーバをセットアップする」以降の作業を実施します。

付録I.4　ディスク複製インストールおよび仮想化プラットフォームが提供する複製機能を使用するときの注意事項（Linuxの場合）

構成ソフトウェアごとに，複製をするときの注意事項を説明します。

(1)　Component Containerでの注意事項

Component Containerでの注意事項を次に示します。Component Containerでは，構築するシステム構成によって実施する作業などが異なります。

(a)　J2EEアプリケーションを実行するシステム（J2EEサーバ）使用時

J2EEアプリケーションを実行するシステム（J2EEサーバ）使用時，Component Containerでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。Management Serverを使用しているときは手順3.も実施してください。

手順

複製元のマシンで，次に示すプログラムを終了します。

・J2EEサーバ（グローバルトランザクションを使用している場合は，開始済みのトランザクションを決着させてから終了してください）

・Webコンテナサーバ

・運用管理エージェント

・Management Server

・HTTP Server

複製元のマシンで，次のディレクトリ下にファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・/opt/Cosminexus/CC/admin/logs/*

・/opt/Cosminexus/CC/admin/logs/CC/maintenance/*

・/opt/Cosminexus/CC/admin/logs/CC/maintenance/mmap/*

・/opt/Cosminexus/CC/admin/logs/CC/rmi/*

・/opt/Cosminexus/CC/admin/logs/CC/rmi/mmap/*

・/opt/Cosminexus/CC/admin/logs/mmap/*

・/opt/Cosminexus/CC/admin/logs/TPB/logj/comtrc/*

・/opt/Cosminexus/CC/admin/logs/TPB/logj/mdltrc/*

・/opt/Cosminexus/CC/admin/logs/TPB/logj/*

・/opt/Cosminexus/CC/client/logs/*

・/opt/Cosminexus/CC/client/logs/mmap/*

・/opt/Cosminexus/CC/client/logs/system/ejbcl/mmap/*

・/opt/Cosminexus/CC/client/logs/system/ejbcl/*

・/opt/Cosminexus/CC/client/logs/system/TPB/logj/comtrc/*

・/opt/Cosminexus/CC/client/logs/system/TPB/logj/mdltrc/*

・/opt/Cosminexus/CC/client/logs/system/TPB/logj/*

・/opt/Cosminexus/CC/web/containers/<サーバ名>/logs/TPB/logj/comtrc/*

・/opt/Cosminexus/CC/web/containers/<サーバ名>/logs/TPB/logj/mdltrc/*

・/opt/Cosminexus/CC/web/containers/<サーバ名>/logs/TPB/logj/*

・/opt/Cosminexus/CC/web/containers/<サーバ名>/logs/*

・/opt/Cosminexus/CC/web/redirector/servers/<サーバ名>/logs/*

・/opt/Cosminexus/CC/web/redirector/servers/<サーバ名>/logs/mmap/*

・/opt/Cosminexus/CC/web/redirector/logs/*

・/opt/Cosminexus/CC/web/redirector/logs/mmap/*

・/opt/Cosminexus/manager/spool/default/*

・/opt/Cosminexus/manager/spool/lsinfo/*

・/opt/Cosminexus/manager/tmp/*

・/opt/Cosminexus/manager/setup/log/*

・/opt/Cosminexus/manager/setup/log/maintenance/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/watch/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/CC/maintenance/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/CC/rmi/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/connectors/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/connectors/<アプリケーション表示名>/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/connectors/TEST#<アプリケーション表示名>/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/TPB/logj/mdltrc/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/TPB/logj/comtrc/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/TPB/logj/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/http/comm/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/http/thr/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/http/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/*

・<Managerログ出力ディレクトリ>/maintenance/*

・<Managerログ出力ディレクトリ>/maintenance/mmap/*

・<Managerログ出力ディレクトリ>/message/*

・<Managerログ出力ディレクトリ>/message/mmap/*

・<Managerログ出力ディレクトリ>/trace/*

・<Managerログ出力ディレクトリ>/trace/mmap/*

・<Managerログ出力ディレクトリ>/*

・<snapshotログの出力先ディレクトリ>/*

・<監査ログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥mmap¥*

・<監査ログの例外情報出力ディレクトリ>¥*

・<監査ログの例外情報出力ディレクトリ>¥mmap¥*

参考

各ディレクトリのデフォルトを次に示します。

<作業ディレクトリ>：/opt/Cosminexus/CC/server/public

<Managerログ出力ディレクトリ>：/opt/Cosminexus/manager/log

<snapshotログの出力先ディレクトリ>：<Managerログ出力ディレクトリ>/snapshot

<監査ログ出力ディレクトリ>：/opt/Cosminexus/auditlog

<監査ログのメッセージログ出力ディレクトリ>：/opt/Cosminexus/auditlog

<監査ログの例外情報出力ディレクトリ>：/opt/Cosminexus/auditlog

Management Serverを使用している場合は，複製元のマシンでプロパティファイルの設定を変更します。

複製元のマシンでManagement Serverが動作しているかどうかで作業が異なります。

複製元のマシンでManagement Serverが動作していないとき

複製先のマシンがマルチホームドホストのときは，あらかじめ，複製元のマシンの運用管理エージェントプロパティファイル（adminagent.properties）に，「adminagent.adapter.bind_host=<複製先の管理IPアドレスと一致する正規表現>」を設定してください。

複製元のマシンでManagement Serverが動作しているとき

次の表に示すプロパティを設定してください。

ファイル名

プロパティ

値

.cmxrcおよびcmxclient.properties

cmx.lb

keepvs

adminagent.properties

adminagent.adapter.allowedHosts

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されているときは，同じ値を指定してください。

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されていないときは，ホスト用管理IPアドレスと一致する正規表現を設定してください。

mserver.properties

mngsvr.myhost.name

複製先のマシンがマルチホームドホストのときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

webserver.connector.http.bind_host

adminagent.properties

adminagent.adapter.bind_host

.mngsvrutilrcおよびmngsvrutilcl.properties

mngsvrutil.connect.host

ループバックアドレス以外を設定するときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

mngsvrutil.target_name

.cmxrcおよびcmxclient.properties

cmx.connect.host

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.〜手順3.を実施してください。Management Serverを使用しているときは手順4.も実施してください。

手順

次に示すプロパティをJ2EEサーバ用ユーザプロパティファイル（usrconf.properties），およびサーバ管理コマンド用ユーザプロパティファイル（usrconf.properties）で設定している場合は，複製先のマシンで値を変更します。

各プロパティで適切な値に変更してください。

・vbroker.se.iiop_tp.host

・ejbserver.ctm.CTMMyHost

・ejbserver.naming.host

・ejbserver.rmi.naming.host

次に示すプロパティをJ2EEサーバ用ユーザプロパティファイル（usrconf.properties），およびWebコンテナサーバ用ユーザプロパティファイル（usrconf.properties）で設定している場合は，複製先のマシンで値を変更します。

各プロパティの値を複製先のIPアドレスに変更してください。

・webserver.connector.http.bind_host

・webserver.connector.nio_http.bind_host

各プロパティの値をJ2EEサーバ，またはWebコンテナサーバごとにユニークな値に設定し直してください。

・webserver.container.server_id.value

・webserver.session.server_id.value

Management Serverを使用している場合は，複製先のマシンで次の操作を実施します。

1. 複製で追加したホストの定義

2. 複製先ホスト上に定義されている複製元のホスト定義の削除（Management Serverが動作しているマシンを複製したときだけ）

3. 複製で追加した論理サーバの定義

4. 3.で追加した論理サーバのセットアップ（実サーバ名指定）

5. 3.で追加した論理サーバの設定ファイルの読み込み

6. 3.で追加した論理サーバの設定ファイルの配布

7. サーバ管理コマンドでEARファイル，およびRARファイルを削除したあとの再配布（J2EEサーバのアプリケーション管理機能を使用しているときだけ）

(b)　バッチアプリケーションを実行するシステム（バッチサーバ）使用時

バッチアプリケーションを実行するシステム（バッチサーバ）使用時，Component Containerでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。Management Serverを使用しているときは手順3.も実施してください。

手順

複製元のマシンで，次に示すプログラムを終了します。

・バッチサーバ（リソースアダプタを開始したまま終了しても構いません）

・運用管理エージェント

・Management Server

複製元のマシンで，次のディレクトリ下にファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・/opt/Cosminexus/CC/admin/logs/*

・/opt/Cosminexus/CC/admin/logs/CC/maintenance/*

・/opt/Cosminexus/CC/admin/logs/CC/maintenance/mmap/*

・/opt/Cosminexus/CC/admin/logs/CC/rmi/*

・/opt/Cosminexus/CC/admin/logs/CC/rmi/mmap/*

・/opt/Cosminexus/CC/admin/logs/mmap/*

・/opt/Cosminexus/CC/admin/logs/TPB/logj/comtrc/*

・/opt/Cosminexus/CC/admin/logs/TPB/logj/mdltrc/*

・/opt/Cosminexus/CC/admin/logs/TPB/logj/*

・/opt/Cosminexus/CC/client/logs/*

・/opt/Cosminexus/CC/client/logs/mmap/*

・/opt/Cosminexus/CC/web/containers/<サーバ名>/logs/*

・/opt/Cosminexus/manager/spool/default/*

・/opt/Cosminexus/manager/spool/lsinfo/*

・/opt/Cosminexus/manager/tmp/*

・/opt/Cosminexus/manager/setup/log/*

・/opt/Cosminexus/manager/setup/log/maintenance/*"

・<作業ディレクトリ>/ejb/<サーバ名>/logs/watch/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/CC/maintenance/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/CC/rmi/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/connectors/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/TPB/logj/mdltrc/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/TPB/logj/comtrc/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/TPB/logj/*

・<作業ディレクトリ>/ejb/<サーバ名>/logs/*

・<Managerログ出力ディレクトリ>/maintenance/*

・<Managerログ出力ディレクトリ>/maintenance/mmap/*

・<Managerログ出力ディレクトリ>/message/*

・<Managerログ出力ディレクトリ>/message/mmap/*

・<Managerログ出力ディレクトリ>/trace/*

・<Managerログ出力ディレクトリ>/trace/mmap/*

・<Managerログ出力ディレクトリ>/*

・<snapshotログの出力先ディレクトリ>/*

・<監査ログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥*

・<監査ログのメッセージログ出力ディレクトリ>¥mmap¥*

・<監査ログの例外情報出力ディレクトリ>¥*

・<監査ログの例外情報出力ディレクトリ>¥mmap¥*

参考

各ディレクトリのデフォルトを次に示します。

<作業ディレクトリ>：/opt/Cosminexus/CC/server/public

<Managerログ出力ディレクトリ>：/opt/Cosminexus/manager/log

<snapshotログの出力先ディレクトリ>：<Managerログ出力ディレクトリ>/snapshot

<監査ログ出力ディレクトリ>：/opt/Cosminexus/auditlog

<監査ログのメッセージログ出力ディレクトリ>：/opt/Cosminexus/auditlog

<監査ログの例外情報出力ディレクトリ>：/opt/Cosminexus/auditlog

Management Serverを使用している場合は，複製元のマシンでプロパティファイルの設定を変更します。

複製元のマシンでManagement Serverが動作しているかどうかで作業が異なります。

複製元のマシンでManagement Serverが動作していないとき

複製先のマシンがマルチホームドホストのときは，あらかじめ，複製元のマシンの運用管理エージェントプロパティファイル（adminagent.properties）に，「adminagent.adapter.bind_host=<複製先の管理IPアドレスと一致する正規表現>」を設定してください。

複製元のマシンでManagement Serverが動作しているとき

次の表に示すプロパティを設定してください。

ファイル名

プロパティ

値

adminagent.properties

adminagent.adapter.allowedHosts

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されているときは，同じ値を指定してください。

mserver.propertiesのmngsvr.myhost.nameプロパティが設定されていないときは，ホスト用管理IPアドレスと一致する正規表現を設定してください。

mserver.properties

mngsvr.myhost.name

複製先のマシンがマルチホームドホストのときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

webserver.connector.http.bind_host

adminagent.properties

adminagent.adapter.bind_host

.mngsvrutilrcおよびmngsvrutilcl.properties

mngsvrutil.connect.host

ループバックアドレス以外を設定するときは，<複製先の管理IPアドレスと一致する正規表現>を設定してください。

mngsvrutil.target_name

.cmxrcおよびcmxclient.properties

cmx.connect.host

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.を実施してください。Management Serverを使用しているときは手順2.も実施してください。

手順

次に示すプロパティをバッチサーバ用ユーザプロパティファイル（usrconf.properties），およびサーバ管理コマンド用ユーザプロパティファイル（usrconf.properties）で設定している場合は，複製先のマシンで値を変更します。

各プロパティで適切な値に変更してください。

・vbroker.se.iiop_tp.host

・ejbserver.naming.host

・ejbserver.rmi.naming.host

Management Serverを使用している場合は，複製先のマシンで次の操作を実施します。

1. 複製で追加したホストの定義

2. 複製先ホスト上に定義されている複製元のホスト定義の削除（Management Serverが動作しているマシンを複製したときだけ）

3. 複製で追加した論理サーバの定義

4. 3.で追加した論理サーバのセットアップ（実サーバ名指定）

5. 3.で追加した論理サーバの設定ファイルの読み込み

6. 3.で追加した論理サーバの設定ファイルの配布

7. サーバ管理コマンドでRARファイルを削除したあとの再配布（J2EEサーバのアプリケーション管理機能を使用しているときだけ）

(2)　Component Container - Redirectorでの注意事項

Component Container - Redirectorでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。

手順

複製元のマシンで，次に示すプログラムを終了します。

・HTTP Server

複製元のマシンで，次のディレクトリ下にファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・/opt/Cosminexus/CCR/web/redirector/servers/<サーバ名>/logs/*

・/opt/Cosminexus/CCR/web/redirector/servers/<サーバ名>/logs/mmap/*

・/opt/Cosminexus/CCR/web/redirector/logs/*

・/opt/Cosminexus/CCR/web/redirector/logs/mmap/*

(3)　Reliable Messagingでの注意事項

Reliable Messagingでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.および手順2.を実施してください。

手順

J2EEサーバにReliable Messagingをデプロイし，Reliable Messagingが開始している場合は，J2EEサーバ上でReliable Messagingを停止します。

複製元のマシンで，次のディレクトリ下にログファイルがある場合は削除します。ただし，ディレクトリは削除しないでください。

・<作業ディレクトリ>/ejb/<サーバ名>/logs/RM/maintenance

<作業ディレクトリ>のデフォルトは，/opt/Cosminexus/CC/server/publicです。

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.〜手順5.を実施してください。

手順

複製後のシステムでホスト名またはIPアドレスを変更した場合は，次に示すReliable Messagingの設定を更新します。

・環境変数HRM_CMD_HOSTの設定を，複製後のシステムのホスト名またはIPアドレスに更新してください。

・キュー間転送機能を使用し，転送先システムのホスト名またはIPアドレスを変更したときは，次に示す手順で転送元システムに存在するあて先と，そのあて先を使用する転送キューを再作成してください。

1. 転送元システムのあて先を使用しているすべての転送キューにメッセージがないことを確認します。

2. 転送元システムのあて先を使用しているすべての転送キューを削除します。

3. 転送元システムのあて先を削除します。

4. 変更後のホスト名またはIPアドレスを指定して，転送元システムのあて先を新規作成します。

5. 転送元システムのあて先を使用する転送キューを新規作成します。

Reliable Messagingのシステム名が一意となるように，コンフィグレーションプロパティのRMSystemNameと，環境変数HRM_SYSTEM_NAMEを変更します。

手順2.で変更したシステム名に対応する管理情報テーブルを作成します。

管理情報テーブルの作成方法については，マニュアル「Reliable Messaging」を参照してください。

DBMSにHiRDBを使用し，XAトランザクションを使用する構成の場合は，Reliable Messagingの連携先DB ConnectorのXAOpenStringが，同一HiRDBに接続するリソースアダプタ間で一意になるように，連携先DB ConnectorのコンフィグレーションプロパティのdescriptionとXAOpenStringを変更します。

Reliable Messagingを開始して，必要なキューを作成します。

(4)　Component Transaction Monitorでの注意事項

Component Transaction Monitorでの注意事項を次に示します。

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで環境変数CTMSPOOLに設定したディレクトリ下を削除してください。

(5)　Performance Tracerでの注意事項

複製を実施したあとに，複製先のマシンで環境変数PRFSPOOLに設定したディレクトリ下を削除してください。

(6)　HTTP Serverでの注意事項

HTTP Serverでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンでHTTP Serverのすべてのプログラム，および関連ファイルへのすべての操作を終了してください。

複製を実施したあとにすること

複製を実施したあとに，複製先のマシンで実施する作業について説明します。

複製先のマシンで，手順1.〜手順3.を実施してください。

手順

必要に応じて，複製後のディレクティブの設定を変更します。

・ネットワーク関連のディレクティブ

ServerName，<VirtualHost>，BindAddress，Listen，NameVirtualHost

・ファイルシステム関連のディレクティブ

<Directory>，<DirectoryMatch>，AccessFileName，Alias，AliasMatch，AuthGroupFile，AuthUserFile，CoreDumpDirectory，CustomLog，DocumentRoot，ErrorLog，HWSRequestLog，HWSTraceIdFile，HWSTraceLogFile，Include，LoadFile，LoadModule，PidFile，QOSResponse，ScriptAlias，ScriptAliasMatch，ScriptLog，ServerRoot，SSLCACertificateFile，SSLCACertificatePath，SSLCacheServerPath，SSLCacheServerPort，SSLCacheServerRunDir，SSLCertificateFile，SSLCertificateKeyFile，SSLCertificateKeyPassword，SSLCRLDERPath，SSLCRLPEMPath，TransferLog，TypesConfig，UserDir

PidFileディレクティブに指定されているファイルがコピーされている場合は，HTTP Serverを起動する前に削除します。

ログ関連のファイルがコピーされている場合は，必要に応じて，不要なファイルを削除します。

(7)　TPBrokerでの注意事項

TPBrokerでの注意事項を次に示します。

複製を実施したあとにすること

複製を実施したあとに，実施する作業について説明します。手順1.〜手順2.を実施してください。

手順

仮想化プラットフォームが提供するイメージファイル化による複製機能を使用する場合に，次の設定があるときは，指定したホスト名やIPアドレスをシステムに合わせて変更します。

・agentaddrファイル（環境変数OSAGENT_ADDR_FILEまたはプロパティvbroker.agent.addrFileでも指定できます）

・localaddrファイル（環境変数OSAGENT_LOCAL_FILEまたはプロパティvbroker.agent.localFileでも指定できます）

・htc.clienthandleraddrファイル（環境変数HVI_OSAGENT_CLIENTHANDLERADDR_FILEでも指定できます）

・プロパティvbroker.agent.addr

・プロパティvbroker.se.<サーバエンジン>.host

・プロパティvbroker.se.<サーバエンジン>.proxyHost

・プロパティvbroker.orb.initRef

・プロパティvbroker.orb.defaultInitRef（C++だけ）

・コマンドラインオプション ORBInitRef

・コマンドラインオプション ORBDefaultInitRef（C++だけ）

・コマンドラインオプション ORBagentAddr

・osagentのコマンドラインオプション -a

・環境変数OSAGENT_ADDR

また，ホスト名やIPアドレスを変更する前に作成したIORファイルは，変更後に再作成し，再配布してください。

仮想化環境での複製機能を使用し，かつグローバルトランザクションを使用する場合，仮想化環境の複製元にインプロセストランザクションサービスのステータスファイルを含まないように，インプロセストランザクションサービスのステータスファイルがあるときは削除します。

(8)　Service Coordinatorでの注意事項

Service Coordinatorでの注意事項を次に示します。

複製を実施する前にすること

複製を実施する前に，複製元のマシンで実施する作業について説明します。

複製元のマシンで，手順1.〜手順2.を実施してください。

手順

マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「実行環境に必要なソフトウェアを設定する」までの作業を実施します。

次に示す構成ソフトウェアの「複製を実施する前にすること」の作業を実施します。

・Component Container

・Reliable Messaging

・HTTP Server

・TPBroker

複製を実施したあとにすること

複製を実施したあとに，実施する作業について説明します。手順1.〜手順2.を実施してください。

手順

複製先のマシンで，次に示す構成ソフトウェアの「複製を実施したあとにすること」の作業を実施します。

・Component Container

・Reliable Messaging

・Component Transaction Monitor

・Performance Tracer

・HTTP Server

・TPBroker

複製元のマシン，および複製先のマシンで，マニュアル「サービスプラットフォーム システム構築・運用ガイド」の「HCSCサーバをセットアップする」以降の作業を実施します。

付録I.5　リモートインストールをするときの注意事項

リモートインストールをするときの注意事項を次の表に示します。

表I‒1　リモートインストールをするときの注意事項

分類

注意事項

新規インストール

更新インストール

Windows

各製品の構成ソフトウェアをリモートインストールする場合は，構成ソフトウェアのリモートインストールの前に，必ず製品のリモートインストールを実施してください。構成ソフトウェアのリモートインストールは，製品のインストール先の指定に従って実施されます。

○

○

新規インストールするインストール先は，指定によって次のようになります。

ドライブとパスの両方とも省略（デフォルト値を使用）している場合

<システムがインストールされているドライブ名>:¥Program Files¥Hitachi¥Cosminexusディレクトリを作成して，インストールします。

ドライブを指定した場合

指定したドライブに¥Program Files¥Hitachi¥Cosminexusディレクトリを作成して，インストールします。

パスを指定した場合

指定したパスにインストールします。

○

−

インストール済みの製品と同じディレクトリに更新インストールします。

−

○

（凡例）○：該当します。−：該当しません。

付録I.6　Application Serverのインストールおよびアンインストール時のエラーコード一覧（Windowsの場合）

ここでは，インストールおよびアンインストール時の障害を通知するコードについて説明します。

製品固有のリターンコードおよび構成ソフトウェア固有のエラーコード

製品および構成ソフトウェアの固有のコードの意味と対処を次の表に示します。次の表にコードがない場合は，「表I-3　製品および構成ソフトウェア共通のコードの意味と対処」に示す製品共通のリターンコードおよび構成ソフトウェア共通のエラーコードを参照してください。なお，リターンコードおよびエラーコードが取得できない場合は，「**」が出力されます。

表I‒2　製品および構成ソフトウェアの固有のコードの意味と対処

製品または構成ソフトウェアの名称

コード

意味

対処

Application Server

04

Application Serverのインストールは正常終了しましたが，製品の修正パッチ適用時に障害が発生しました。

<Application Serverのインストールディレクトリ>¥install.logの"PATCH END"のあとに出力されている修正パッチ適用時のエラーコードを確認し，「表I-4　修正パッチ適用時のエラーコードの意味と対処」に示す対処を実施してください。

90

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

91

未サポートのプラットフォームでインストールを実行しました。

Application Serverがサポートしているプラットフォームへインストールしてください。

92

Application Server以外の製品がインストール済みです。

インストール済みのApplication Server以外の製品をアンインストールしたあとに，Application Serverをインストールしてください。

93

新しいバージョンのApplication Serverがインストール済みです。

インストールしようとしているApplication Serverのバージョンを確認してください。

94

共用モジュールのファイル転送で障害が発生しました。

保守員に連絡してください。

95

構成ソフトウェアのインストーラの起動で障害が発生しました。

保守員に連絡してください。

96

構成ソフトウェアのインストーラの処理で障害が発生しました。

構成ソフトウェアのエラーコードを参照して原因を取り除いたあとに再度インストールを実行してください。

97

その他の障害が発生しました。

HiRDB/Single Server Version 10のインストールおよびアンインストールで障害が発生したときは，「97,XX,YY」の形式でリターンコードを出力することがあります。YYは，HiRDB/Single Server Version 10のエラーコードを参照してください。

上記以外のときは，保守員に連絡してください。

98

インストール先ディレクトリ名の文字数が制限値を超えました。

インストール先ディレクトリ名は半角50文字以下にしてください。

99

Application Serverのアンインストール処理でタイムアウトが発生しました。

保守員に連絡してください。

Client

04

Clientのインストールは正常終了しましたが，製品の修正パッチ適用時に障害が発生しました。

<Clientのインストールディレクトリ>¥install.logの"PATCH END"のあとに出力されている修正パッチ適用時のエラーコードを確認し，「表I-3　製品および構成ソフトウェア共通のコードの意味と対処」に示す対処を実施してください。

90

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

91

未サポートのプラットフォームでインストールを実行しました。

Clientがサポートしているプラットフォームへインストールしてください。

92

Client以外の製品がインストール済みです。

インストール済みのClient以外の製品をアンインストールしたあとに，Clientをインストールしてください。

93

新しいバージョンのClientがインストール済みです。

インストールしようとしているClientのバージョンを確認してください。

94

共用モジュールのファイル転送で障害が発生しました。

保守員に連絡してください。

95

構成ソフトウェアのインストーラの起動で障害が発生しました。

保守員に連絡してください。

96

構成ソフトウェアのインストーラの処理で障害が発生しました。

構成ソフトウェアのエラーコードを参照して原因を取り除いたあとに再度インストールを実行してください。

97

その他の障害が発生しました。

HiRDB/Single Server Version 10のインストールおよびアンインストールで障害が発生したときは，「97,XX,YY」の形式でリターンコードを出力することがあります。YYは，HiRDB/Single Server Version 10のエラーコードを参照してください。

上記以外のときは，保守員に連絡してください。

98

インストール先ディレクトリ名の文字数が制限値を超えました。

インストール先ディレクトリ名は半角50文字以下にしてください。

99

Clientのアンインストール処理でタイムアウトが発生しました。

保守員に連絡してください。

Developer

04

Developerのインストールは正常終了しましたが，製品の修正パッチ適用時に障害が発生しました。

<Developerのインストールディレクトリ>¥install.logの"PATCH END"のあとに出力されている修正パッチ適用時のエラーコードを確認し，「表I-3　製品および構成ソフトウェア共通のコードの意味と対処」に示す対処を実施してください。

90

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

91

未サポートのプラットフォームでインストールを実行しました。

Developerがサポートしているプラットフォームへインストールしてください。

92

Developer以外の製品がインストール済みです。

インストール済みのDeveloper以外の製品をアンインストールしたあとに，Developerをインストールしてください。

93

新しいバージョンのDeveloperがインストール済みです。

インストールしようとしているDeveloperのバージョンを確認してください。

94

共用モジュールのファイル転送で障害が発生しました。

保守員に連絡してください。

95

構成ソフトウェアのインストーラの起動で障害が発生しました。

保守員に連絡してください。

96

構成ソフトウェアのインストーラの処理で障害が発生しました。

構成ソフトウェアのエラーコードを参照して原因を取り除いたあとに再度インストールを実行してください。

97

その他の障害が発生しました。

HiRDB/Single Server Version 10のインストールおよびアンインストールで障害が発生したときは，「97,XX,YY」の形式でリターンコードを出力することがあります。YYは，HiRDB/Single Server Version 10のエラーコードを参照してください。

上記以外のときは，保守員に連絡してください。

98

インストール先ディレクトリ名の文字数が制限値を超えました。

インストール先ディレクトリ名は半角50文字以下にしてください。

99

Developerのアンインストール処理でタイムアウトが発生しました。

保守員に連絡してください。

Service Architect

04

Service Architectのインストールは正常終了しましたが，製品の修正パッチ適用時に障害が発生しました。

<Service Architectのインストールディレクトリ>¥install.logの"PATCH END"のあとに出力されている修正パッチ適用時のエラーコードを確認し，「表I-3　製品および構成ソフトウェア共通のコードの意味と対処」に示す対処を実施してください。

90

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

91

未サポートのプラットフォームでインストールを実行しました。

Service Architectがサポートしているプラットフォームへインストールしてください。

92

Service Architect以外の製品がインストール済みです。

インストール済みのService Architect以外の製品アンインストールしたあとに，Service Architectをインストールしてください。

93

新しいバージョンのService Architectがインストール済みです。

インストールしようとしているService Architectのバージョンを確認してください。

94

共用モジュールのファイル転送で障害が発生しました。

保守員に連絡してください。

95

構成ソフトウェアのインストーラの起動で障害が発生しました。

保守員に連絡してください。

96

構成ソフトウェアのインストーラの処理で障害が発生しました。

構成ソフトウェアのエラーコードを参照して原因を取り除いたあとに再度インストールを実行してください。

97

その他の障害が発生しました。

HiRDB/Single Server Version 10のインストールおよびアンインストールで障害が発生したときは，「97,XX,YY」の形式でリターンコードを出力することがあります。YYは，HiRDB/Single Server Version 10のエラーコードを参照してください。

上記以外のときは，保守員に連絡してください。

98

インストール先ディレクトリ名の文字数が制限値を超えました。

インストール先ディレクトリ名は半角50文字以下にしてください。

99

Service Architectのアンインストール処理でタイムアウトが発生しました。

保守員に連絡してください。

Service Platform

04

Service Platformのインストールは正常終了しましたが，製品の修正パッチ適用時に障害が発生しました。

<Service Platformのインストールディレクトリ>¥install.logの"PATCH END"のあとに出力されている修正パッチ適用時のエラーコードを確認し，「表I-3　製品および構成ソフトウェア共通のコードの意味と対処」に示す対処を実施してください。

90

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

91

未サポートのプラットフォームでインストールを実行しました。

Service Platformがサポートしているプラットフォームへインストールしてください。

92

Service Platform以外の製品がインストール済みです。

インストール済みのService Platform以外の製品をアンインストールしたあとに，Service Platformをインストールしてください。

93

新しいバージョンのService Platformがインストール済みです。

インストールしようとしているService Platformのバージョンを確認してください。

94

共用モジュールのファイル転送で障害が発生しました。

保守員に連絡してください。

95

構成ソフトウェアのインストーラの起動で障害が発生しました。

保守員に連絡してください。

96

構成ソフトウェアのインストーラの処理で障害が発生しました。

構成ソフトウェアのエラーコードを参照して原因を取り除いたあとに再度インストールを実行してください。

97

その他の障害が発生しました。

HiRDB/Single Server Version 10のインストールおよびアンインストールで障害が発生したときは，「97,XX,YY」の形式でリターンコードを出力することがあります。YYは，HiRDB/Single Server Version 10のエラーコードを参照してください。

上記以外のときは，保守員に連絡してください。

98

インストール先ディレクトリ名の文字数が制限値を超えました。

インストール先ディレクトリ名は半角50文字以下にしてください。

99

Service Platformのアンインストール処理でタイムアウトが発生しました。

保守員に連絡してください。

Application Development Plug-in

90

新しいバージョンの製品がインストール済みです。

インストールしようとしている製品のバージョンを確認してください。

Component Container

8C

次のどちらかの理由でインストールが拒否されました。

インストーラを使用しないで，個別の製品のインストーラを直接起動した場合

管理者権限のないユーザでセットアップを実行した場合

1.の場合

インストーラのセットアッププログラム（HCD_INST.EXE）を使用してください。

2.の場合

管理者権限のあるユーザでログインして，再度セットアップを実行してください。

90

Cosminexus Server Component Container for Java 01-00または01-01がインストール済みです。

Cosminexus Server Component Container for Java 01-00または01-01をアンインストールしたあとに，インストールを実行してください。

91

Component Server for Java 01-00がインストール済みです。

Component Server for Java 01-00をアンインストールしたあとに，インストールを実行してください。

92

バージョンダウンの可能性があります。

新しいバージョンの製品がインストール済みの場合

評価版がインストールされている状態で，正規版のインストールを実行した場合

すでにインストールされている製品のバージョンと，インストールする製品のバージョンを確認してください。

93

コマンドの実行に失敗しました。

保守員に連絡してください。

95

サービスの起動を検出しました。

起動している製品のサービスをすべて停止させ，再度セットアップを実行してください。

97

実行中のプログラムまたはファイルを検出しました。

起動しているComponent Containerのプログラムと，Webサーバなどの関連プログラムをすべて停止させて，再度セットアップを実行してください。

98

OSの再起動後に更新予約されているが，現在未更新のプログラムまたはファイルを検出しました。

OSを再起動し，プログラムまたはファイルが更新されてから，再度セットアップを実行してください。

99

SI Navigation System - Agentがインストールされています。

SI Navigation System - Agentをアンインストールしたあとに，再度インストールを実行してください。

Component Container - Client

8C

次のどちらかの理由でインストールが拒否されました。

インストーラを使用しないで，個別の製品のインストーラを直接起動した場合

管理者権限のないユーザでセットアップを実行した場合

1.の場合

インストーラのセットアッププログラム（HCD_INST.EXEを使用してください。

2.の場合

管理者権限のあるユーザでログインして，再度セットアップを実行してください。

90

Cosminexus Server Component Container for Java 01-00または01-01がインストール済みです。

Cosminexus Server Component Container for Java 01-00または01-01をアンインストールしたあとに，インストールを実行してください。

91

Component Server for Java 01-00がインストール済みです。

Component Server for Java 01-00をアンインストールしたあとに，インストールを実行してください。

92

バージョンダウンの可能性があります。

新しいバージョンの製品がインストール済みの場合

評価版がインストールされている状態で，正規版のインストールを実行した場合

すでにインストールされている製品のバージョンと，インストールする製品のバージョンを確認してください。

97

実行中のプログラムまたはファイルを検出しました。

起動しているComponent Containerのプログラムと，Webサーバなどの関連プログラムをすべて停止させて，再度セットアップを実行してください。

98

OSの再起動後に更新予約されているが，現在未更新のプログラムまたはファイルを検出しました。

OSを再起動し，プログラムまたはファイルが更新されてから，再度セットアップを実行してください。

99

SI Navigation System - Agentがインストールされています。

SI Navigation System - Agentをアンインストールしたあとに，再度インストールしてください。

Component Container - Redirector

8C

次のどちらかの理由でインストールが拒否されました。

インストーラを使用しないで，個別の製品のインストーラを直接起動した場合

管理者権限のないユーザでセットアップを実行した場合

1.の場合

インストーラのセットアッププログラム（HCD_INST.EXE）を使用してください。

2.の場合

管理者権限のあるユーザでログインして，再度セットアップを実行してください。

90

Cosminexus Server Component Container for Java 01-00または01-01がインストール済みです。

Cosminexus Server Component Container for Java 01-00または01-01をアンインストールしたあとに，インストールを実行してください。

91

Component Server for Java 01-00がインストール済みです。

Component Server for Java 01-00をアンインストールしたあとに，インストールを実行してください。

92

バージョンダウンの可能性があります。

新しいバージョンの製品がインストール済みの場合

評価版がインストールされている状態で，正規版のインストールを実行した場合

すでにインストールされている製品のバージョンと，インストールする製品のバージョンを確認してください。

97

実行中のプログラムまたはファイルを検出しました。

起動しているComponent Container - Redirectorのプログラムと，Webサーバなどの関連プログラムをすべて停止させて，再度セットアップを実行してください。

98

OSの再起動後に更新予約されているが，現在未更新のプログラムまたはファイルを検出しました。

OSを再起動し，プログラムまたはファイルが更新されてから，再度セットアップを実行してください。

99

SI Navigation System - Agentがインストールされています。

SI Navigation System - Agentをアンインストールしたあとに，再度インストールしてください。

Component Transaction Monitor

−

固有なエラーコードはありません。

−

Developer's Kit for Java

90

新しいバージョンのDeveloper's Kit for Javaがインストール済みです。

Developer's Kit for Javaをアンインストールしたあとに，インストールを実行してください。

91

ファイルのコピーに失敗しました。

インストール先のディスク容量が不足していないか，アクセス権限が正しく設定されているかを確認してください。

97

実行中のプログラムまたはファイルを検出しました。

起動しているDeveloper's Kit for Javaのプログラムと，関連するファイルにアクセスしているすべてのプログラムを終了させて，再度インストールを実行してください。

HTTP Server

83

HTTP Serverのサービスが動作中です。または，レジストリ操作でエラーが発生しました。

HTTP Serverが動作中かどうかを確認してください。

動作中の場合は，停止して再操作してください。

動作していない場合は，保守員に連絡してください。

90

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

91

未サポートのプラットフォームでインストールを実行しました。

製品がサポートしているプラットフォームへインストールしてください。

94

単体版のWeb Serverがインストール済みの環境へ，製品をインストールしました。

単体版のWeb Serverをアンインストールしてから，製品をインストールしてください。

Performance Tracer

−

固有なエラーコードはありません。

−

Reliable Messaging

90

バージョンチェックでエラーが発生しました。

インストール済みのReliable Messagingをアンインストールしたあと，再度インストールを実行してください。

91

ファイル転送でエラーが発生しました。

再度インストールを実行してください。

Service Coordinator

90

ダウングレードインストールです。

インストールしようとしている製品のバージョンを確認してください。

Service Development Plug-in

90

新しいバージョンの製品がインストール済みです。

インストールしようとしている製品のバージョンを確認してください。

TPBroker

90

新しいバージョンの製品がインストール済みです。

インストールしようとしている製品のバージョンを確認してください。

再度インストールが必要な場合は，インストールされている製品と同じバージョン，または新しいバージョンの製品をインストールしてください。

91

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

93

内部エラーが発生しました。

すべてのプログラムを終了したあと，またはOSの再起動後，再度インストールを実行してください。

94

旧バージョンで提供していたファイルの削除に失敗しました。

すべてのプログラムを終了後，またはOSの再起動後，再度インストールを実行してください。

95

レジストリ操作で異常が発生しました。

すべてのプログラムを終了後，またはOSの再起動後，再度インストールを実行してください。

96

システム環境の調査で異常が発生しました。

すべてのプログラムを終了後，またはOSの再起動後，再度インストールを実行してください。

97

ファイルのコピーに失敗しました。

ディスク容量が不足していないか，アクセス権限が正しく設定されているかを確認してください。

問題がない場合，すべてのプログラムを終了したあと，またはOSの再起動後，再度インストールを実行してください。

98

レジストリ情報の設定に失敗しました。

すべてのプログラムを終了したあと，またはOSの再起動後，再度インストールを実行してください。

99

媒体が不正です。

すべてのプログラムを終了したあと，またはOSの再起動後，再度インストールを実行してください。

Web Services - Security

90

管理者権限のないユーザがインストールまたはアンインストールを実行しました。

管理者権限のあるユーザがインストールしてください。

93

新しいバージョンの製品がインストール済みです。

インストールしようとしている製品のバージョンを確認してください。

XML Processor

90

新しいバージョンの製品がインストール済みです。

インストールしようとしている製品のバージョンを確認してください。

HiRDB/Single Server Version 10

92

適用OSではありません。

製品がサポートしているプラットフォームへインストールしてください。

94

同じセットアップ識別子（_CS0）の組み込みHiRDBのサービスが停止状態ではありません。

起動済みのサービスを停止してからインストールを実行してください。

95

同じセットアップ識別子（_CS0）の組み込みHiRDBがインストールされていません。

保守員に連絡してください。

96

同じセットアップ識別子（_CS0）の組み込みHiRDBがすでにインストールされています。

保守員に連絡してください。

9C

実行中のプロセスが残っています。

インストール時は，OSを再起動して再実行してください。

アンインストール時は，アンインストール後，直ちにOSを再起動してください。

（凡例）−：該当しません。

注　製品と，製品に含まれる構成ソフトウェアについては，「2.2.1(3)　製品に対応する構成ソフトウェアについて」を参照してください。

製品共通のリターンコードおよび構成ソフトウェア共通のエラーコード

製品および構成ソフトウェアの共通のコードの意味と対処を次の表に示します。

表I‒3　製品および構成ソフトウェア共通のコードの意味と対処

コード

意味

対処

00

正常終了しました。

対処はありません。

01

正常終了しました。次の処理が該当します。

異なるバージョンへの更新インストール（バージョンアップ）

アンインストール済みの環境に対するアンインストール

対処はありません。

82

次のインストール後処理でエラーが発生しました。

アイコン追加処理

グループ追加処理

保守員に連絡してください。

84

インストール時にメモリ不足が発生しました。

ほかのプログラムを終了させるなど，メモリを確保してから，再度実行してください。

85

ディスクのアクセスエラーが発生しました。

保守員に連絡してください。

88

起動パラメタが誤っています。

更新インストールが指示されたが，該当するプログラムがインストールされていないなどの要因が考えられます。

更新インストールで該当するプログラムがインストールされていない場合は，新規インストールで再度実行してください。

上記以外の場合は，保守員に連絡してください。

8A

構成ソフトウェアの新規インストールができません。

保守員に連絡してください。

8C

インストールが拒否されました。

前提プログラムがないなどの要因が考えられます。

前提プログラムがない場合は，前提となるプログラムをインストールしたあと，再度実行してください。

上記以外の場合は，保守員に連絡してください。

80，81，87，89，8B，8D，8E，8F

インストールが異常終了しました。

保守員に連絡してください。

9A

インストールがキャンセルされました。

対処はありません。

9B

対応する製品がインストールされていません。

11-50の製品をインストールしたあと，再度リモートインストールを実行してください。

9C

製品情報の取得に失敗しました。

製品が正しくインストールされているかを確認したあと，再度インストールを実行してください。

9D

インストール履歴ファイル，またはインストール状態ファイルの出力に失敗しました。

ディスク容量が不足していないか，アクセス権限が正しく設定されているかを確認してください。これらの問題がない場合，すべてのプログラムを終了したあと，またはOSの再起動後，再度インストールを実行してください。

修正パッチ適用時のエラーコード

アプリケーションサーバおよびBPM/ESB基盤の製品では，製品をインストールすると，インストールが正常終了したあとにその製品の修正パッチが適用されます。修正パッチ適用時にエラーが発生した場合は，<製品のインストールディレクトリ>¥install.logの"PATCH END"のあとに，エラーコードが出力されます。修正パッチ適用時のエラーコードの意味と対処を次の表に示します。

表I‒4　修正パッチ適用時のエラーコードの意味と対処

コード

意味

対処

0または1

適用する修正パッチはありません。または，修正パッチは正常に適用されました。

対処は不要です。

129

修正パッチ適用時にメモリ不足が発生しました。

ほかのプログラムを終了させるなど，メモリを確保してから，再度実行してください。

134

修正パッチ適用時にディスク容量不足が発生しました。

ハードディスク容量を確保してから，再度実行してください。

144

プログラムまたはサービスが実行中のため，修正パッチ適用に失敗しました。

製品に関連するプログラムまたはサービスを停止してから，再度実行してください。

停止後に実行しても同じエラーになる場合は，製品の提供媒体が不正な可能性があるので，保守員へ連絡してください。

上記以外

製品の提供媒体が不正な可能性があります。

保守員へ連絡してください。

付録I.7　Component Containerおよびリダイレクタ機能のインストールおよびアンインストール時のログ（UNIXの場合）

Component Containerおよびリダイレクタ機能のインストールおよびアンインストールの実行状況は，次に示すインストールログに出力されます。

Component Containerの場合：/opt/Cosminexus/CC/logs/install.log

リダイレクタ機能の場合：/opt/Cosminexus/CCR/logs/install.log

インストールログは，最大で4面install1.log〜install4.logのバックアップを作成し，最新のインストールログは常にinstall.logになります。

インストールおよびアンインストール時にエラーが発生した場合は，インストールログの内容を基に対処してください。エラーの原因が突き止められない場合は，次の表に示すファイルを保守員に送付して，お問い合わせください。

表I‒5　インストールおよびアンインストールでのエラー発生時に送付するファイル

出力対象

エラーの発生タイミング

インストール時

アンインストール時

Component Container

/opt/Cosminexus/CC/logs/install.log（バックアップファイル含む）

/etc/.hitachi/.install.log（バックアップファイル含む）

/opt/Cosminexus/CC/logs/install.log（バックアップファイル含む）

/etc/.hitachi/.uninstall.log（バックアップファイル含む）

リダイレクタ機能

/opt/Cosminexus/CCR/logs/install.log（バックアップファイル含む）

/etc/.hitachi/.install.log（バックアップファイル含む）

/opt/Cosminexus/CCR/logs/install.log（バックアップファイル含む）

/etc/.hitachi/.uninstall.log（バックアップファイル含む）

出力形式

インストールログのフォーマットを次に示します。

MM-DD-YYYY/hh:mm:ss/rc=y/msg=zz...zz

出力項目

インストールログのフォーマットで示した各項目について説明します。

表I‒6　出力項目（Component Containerおよびリダイレクタ機能のインストールログ）

出力項目

意味

MM

月（01〜12）

DD

日（01〜31）

YYYY

西暦（2003以降）

hh

時間（00〜23）

mm

分（00〜59）

ss

秒（00〜59）

rc

リターンコードを示すラベル

y

リターンコードの内容（10進数）

msg

ログメッセージの内容を示すラベル

zz...zz

トレース情報およびエラー情報の内容

接頭辞が[I:]の場合：トレース情報

接頭辞が[E:]の場合：エラー情報

トレース情報およびエラー情報の内容

トレース情報およびエラー情報の内容について説明します。トレース情報およびエラー情報の説明で使用する可変値を次の表に示します。

表I‒7　トレース情報およびエラー情報の説明で使用する可変値

可変値

内容

aa...aa

started：開始

ended：終了

bb...bb

バンドル名称

Cosminexus Component Container

Cosminexus Component Container - Redirector

cc...cc

コマンドの名称

dd...dd

ファイルの名称

ee...ee

ディレクトリの名称

ff...ff

ファイルまたはディレクトリの名称

gg...gg

追加する定義の内容

hh...hh

旧バージョン（システムにセットアップ済みのバージョン）

ii...ii

旧SIバージョン（システムにセットアップ済みのSIバージョン）

jj...jj

新バージョン（システムにセットアップする製品のバージョン）

kk...kk

新SIバージョン（システムにセットアップする製品のSIバージョン）

ll...ll

情報１（引数などの付加情報）

mm...mm

情報２（引数などの付加情報）

nn...nn

情報３（引数などの付加情報）

oo...oo

コマンドの戻り値

rr...rr

サービス名（Component Containerの場合だけ出力）

出力項目zz...zzのトレース情報の内容と意味を次の表に示します。

表I‒8　トレース情報の内容と意味（Component Containerおよびリダイレクタ機能のインストールログ）

項番

yの内容

zz...zzの内容

意味

1

0

I:Setup of HNTRLib2 has aa...aa.

HNTRLib2のセットアップ処理をaa...aaしました。

2

0

I:Extraction processing for HNTRLib2 has aa...aa.

HNTRLib2の展開処理をaa...aaしました。

3

0

I:Installation of HNTRLib2 has aa...aa.

HNTRLib2のインストール処理をaa...aaしました。

4

0

I:Registration processing for the HNTRLib2 daemon has aa...aa.

HNTRLib2へのデーモン登録処理をaa...aaしました。

5

0

I:Startup processing of the HNTRLib2 daemon has aa...aa.

HNTRLib2のデーモン起動処理をaa...aaしました。

6

0

I:Registration of the bundled program product bb...bb into HNTRLib2 has aa...aa.

HNTRLib2へバンドルPP名称[bb...bb]の登録をaa...aaしました。

7

0

I:The command has aa...aa. (Command = cc...cc)

コマンドcc...ccをaa...aaしました。

8

0

I:The file to be copied already exists in the copy destination. (file = dd...dd)

コピー指定されたファイルと同名のファイルがすでにコピー先に存在しました。

9

0

I:The directory to be copied already exists in the copy destination. (directory = ee...ee)

コピー指定されたディレクトリと同名のディレクトリがすでにコピー先に存在しました。

10

0

I:The directory to be created already exists. (directory = ee...ee)

作成指示されたディレクトリは，すでに存在しました。

11

0

I:The file or directory to be deleted does not exist. (file or directory = ff...ff)

削除指示されたファイルまたはディレクトリはすでに存在していません。

12

0

I:The file or directory to be copied does not exist. (file or directory = ff...ff)

コピーしようとしたファイルまたはディレクトリは存在していません。

13

0

I:The specified directory does not exist. (directory = ee...ee)

指定されたディレクトリは存在していません。

14

0

I:The specified definition already exists.[File=dd...dd,Define=gg...gg]

追加指定された定義gg...ggは，すでにファイルdd...ddに存在します。

15

0

I:The specified bundle name is already registered. (bundle name = bb...bb)

指定されたバンドル名称bb...bbはすでに登録されています。

16

0

I:The specified name has already been de-registered. (bundle name = bb...bb)

指定されたバンドル名称bb...bbはすでに登録解除されています。

17

0

I:HNTRLib2 was not uninstalled because other applications are registered in it.

HNTRLib2に，ほかのPPが登録されているため，HNTRLib2のアンインストールは実行されませんでした。

18

0

I:Cancellation processing of the HNTRLib2 daemon has aa...aa.

HNTRLib2からのデーモン登録解除処理をaa...aaしました。

19

0

I:Uninstallation of HNTRLib2 has aa...aa.

HNTRLib2のアンインストールをaa...aaしました。

20

0

I:An overwrite installation will be performed. (version = hh...hh, SI version = ii...ii)

バージョンhh...hh・SIバージョンii...iiの上書きインストールを実行します。

21

0

I:An upgrade installation will be performed. (earlier version = hh...hh new version = jj...jj, new SI version = kk...kk)

旧バージョンhh...hhに対して，新バージョンjj...jj・SIバージョンkk...kkの上書きインストールを実行します。

22

0

I:An upgrade installation will be performed. (earlier version = hh...hh, earlier SI version = ii...ii, new version = jj...jj, new SI version = kk...kk)

旧バージョンhh...hh・SIバージョンii...iiに対して，新バージョンjj...jj・SIバージョンkk...kkの上書きインストールを実行します。

23

0

I:Version information was acquired from the file dd...dd. (version = hh...hh)

ファイルdd...ddからバージョン情報hh...hhを取得しました。

24

0

I:Version information was acquired from the file dd...dd. (version = hh...hh, SI version = ii...ii)

ファイルdd...ddからバージョン情報hh...hh・SIバージョンii...iiを取得しました。

25

0

I:The shift processing to a version jj...jj from a version hh...hh is aa...aa.

旧バージョンhh...hhから新バージョンjj...jjへ移行処理をaa...aaしました。

26

0

I:The upgrade from the earlier version to the new version was not performed because the earlier version had already been uninstalled. (earlier version = jj...jj, new version = hh...hh)

旧バージョンのアンインストールが実行済みだったため，旧バージョンjj...jjから新バージョンhh...hhへのアップグレードは実行されません。

27

oo...oo

I:The command has executed. (command = cc...cc)

コマンドcc...ccを実行しました。

出力項目zz...zzのエラー情報の内容と意味および対処を次の表に示します。

表I‒9　エラー情報の内容と意味および対処（Component Containerおよびリダイレクタ機能のインストールログ）

項番

yの内容

zz...zzの内容

意味

対処

1

1

E:The specified file does not exist. (file = dd...dd)

編集などの対象として指定されたファイルは存在しませんでした。

適切な権限で実行しているか確認し，再度セットアップを実行してください。

2

1

E:The specified directory does not exist. (directory = ee...ee)

指定されたディレクトリは存在しないディレクトリでした。

適切な権限で実行しているか確認し，再度セットアップを実行してください。

3

92

E:A downgrade installation cannot be performed. (installed version = hh...hh, installed SI version = ii...ii, version to be installed = jj...jj, SI version to be installed = kk...kk)

バージョンダウンインストールはできません。すでにインストールされているバージョン=hh...hh，・SIバージョンii...ii，セットアップしようとしている新バージョン= jj...jj・SIバージョン=kk...kkです。

セットアップしようとしている製品より，新しいバージョンの製品がすでにインストールされています。セットアップする製品のバージョンを確認してください。古いバージョンの製品をインストールするには，現在インストールされている新しいバージョンの製品をアンインストールしてからインストールしてください。

4

92

E:A downgrade installation cannot be performed. (installed version = hh...hh, new version to be installed = jj...jj, new SI version to be installed = kk...kk)

バージョンダウンインストールはできません。すでにインストールされているバージョン=hh...hh，セットアップしようとしている新バージョン=jj...jj・SIバージョン=kk...kkです。

セットアップしようとしている製品より，新しいバージョンの製品がすでにインストールされています。セットアップする製品のバージョンを確認してください。古いバージョンの製品をインストールするには，現在インストールされている新しいバージョンの製品をアンインストールしてからインストールしてください。

5

92

E:Upgrade of this version is not supported. (installed version = hh...hh, new version to be installed = jj...jj, new SI version to be installed = kk...kk)

すでにインストールされているバージョン=hh...hhからセットアップしようとしている新バージョン=jj...jj・SIバージョン=kk...kkへのアップグレードはサポートされていません。

アップグレードをサポートしていない旧製品が存在します。この製品をセットアップする前に旧製品をアンインストールして，再度セットアップを実行してください。

6

92

E:Upgrading this version is not supported. (installed version = hh...hh, installed SI version = ii...ii, version to be installed = jj...jj, SI version to be installed = kk...kk)

すでにインストールされているバージョン=hh...hh・SIバージョンii...iiからセットアップしようとしている新バージョン=jj...jj・SIバージョン=kk...kkへのアップグレードはサポートされていません。

アップグレードをサポートしていない旧製品が存在します。この製品をセットアップする前に旧製品をアンインストールして，再度セットアップを実行してください。

7

94

E:An attempt to install the Cosminexus Component Container has failed.※

Component Containerのインストールに失敗しました。

該当する製品をアンインストールしたあと，再度インストールしてください。

8

95

E:An attempt to perform setup failed because the rr...rr service is running.※

rr...rr サービスが起動中のため，セットアップに失敗しました。

サービスを停止したあと，再度セットアップを実行してください。

9

97

E:An executing or locked file was detected. (file = dd...dd)

ビジー状態（実行中）またはロックされているファイルdd...ddを検出しました。

Component Containerのプログラム，および関連するWebサーバなどを停止させて，再度セットアップを実行してください。

10

oo...oo

E:The command returned an error. (command = cc...cc)

コマンドcc...ccがエラーを返しました。

コマンドの名称とエラー情報から対処を実施し，再度セットアップを実行してください。

11

oo...oo

E:The command returned an error. (command = cc...cc, information 1 = ll...ll)

コマンドcc...ccがエラーを返しました。情報１=ll...ll

コマンドの名称とエラー情報から対処を実施し，再度セットアップを実行してください。

12

oo...oo

E:The command returned an error. (command = cc...cc, information 1 = ll...ll, information 2 = mm...mm)

コマンドcc...ccがエラーを返しました。情報１=ll...ll，情報２=mm...mm

コマンドの名称とエラー情報から対処を実施し，再度セットアップを実行してください。

13

oo...oo

E:The command returned an error. (command = cc...cc, information 1 = ll...ll, information 2 = mm...mm, information 3 = nn...nn)

コマンドcc...ccがエラーを返しました。情報１=ll...ll，情報２=mm...mm，情報３=nn...nn

コマンドの名称とエラー情報から対処を実施し，再度セットアップを実行してください。

注※　Component Containerの場合に出力されるインストールログです。リダイレクタ機能では出力されません。

付録J　Smart Composer機能が実行する負荷分散機のCLIコマンドまたはAPI

Smart Composer機能で提供するコマンドを実行すると，Management Serverと接続して，負荷分散機の設定をします。負荷分散機の設定は，業務リクエストをWebサーバに振り分けるための設定で，仮想サーバや実サーバの作成，仮想サーバと実サーバの接続，および実サーバへのリクエスト振り分けの開始・停止などを設定します。ここでは，Smart Composer機能が実行する負荷分散機のCLIコマンドとAPIについて説明します。それぞれ使用する製品を次に示します。

負荷分散機のAPIを使用する製品

BIG-IP v9※，BIG-IP v10.1※，BIG-IP v10.2※，BIG-IP v11，ACOS（AX2500）

負荷分散機のCLIコマンドを使用する製品

ACOS（AX2000，BS320）

注※　負荷分散機のCLIコマンドも使用できます。

付録J.1　Smart Composer機能が実行する負荷分散機のAPI

Smart Composer機能が実行する負荷分散機のAPIについては，マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」の「8.3　運用管理機能が実行する負荷分散機のAPI」を参照してください。

付録J.2　Smart Composer機能が実行する負荷分散機のCLIコマンド

Smart Composer機能が実行する負荷分散機のCLIコマンドを製品ごとに説明します。負荷分散機のCLIコマンドの詳細は，使用する製品のドキュメントを参照してください。

(1)　AX2000またはBS320の場合

AX2000またはBS320の場合，負荷分散機の接続方式としてtelnetプロトコルを使用した直接接続が使用できます。

負荷分散機としてACOS（AX2000またはBS320）を使用する場合に，Smart Composer機能が実行する負荷分散機のCLIコマンドを次の表に示します。ACOSのCLIコマンドの詳細は，使用する製品のドキュメントを参照してください。

表J‒1　Smart Composer機能が実行する負荷分散機のCLIコマンド（AX2000またはBS320の場合）

Smart Composer機能のコマンド

実行する負荷分散機のCLIコマンド

共通

enable

config

show version

exit

cmx_build_system（Webシステムを構築する場合）

cookieスイッチングの使用なし※1

slb server <実サーバ名> <実サーバIPアドレス>

　port <実ポート> tcp

slb service-group <仮想サーバ名> tcp

　member <実サーバ名>:<実ポート> disable

slb virtual-server <仮想サーバ名> <仮想サーバIPアドレス>

　port <仮想ポート> http

　　service-group <仮想サーバ名>

write memory

cookieスイッチングの使用あり※1

slb server <実サーバ名> <実サーバIPアドレス>

　port <実ポート> tcp

slb service-group <仮想サーバ名> tcp

member <実サーバ名>:<実ポート> disable

slb template persist cookie <仮想サーバ名>

　name <cookie名>

　expire 0

slb virtual-server <仮想サーバ名> <仮想サーバIPアドレス>

　port <仮想ポート> http

　　service-group <仮想サーバ名>

　　template persist cookie <仮想サーバ名>

write memory

cmx_build_system（スケールアウトする場合）

slb server <実サーバ名> <実サーバIPアドレス>

　port <実ポート> tcp

slb service-group <仮想サーバ名> tcp

　member <実サーバ名>:<実ポート> disable

write memory

cmx_build_system（実ポートを変更する場合）

slb server <実サーバ名> <実サーバIPアドレス>

　port <変更後の実ポート> tcp

　exit

　no port <実ポート> tcp

slb service-group <仮想サーバ名> tcp

　member <実サーバ名>:<変更後の実ポート> disable

write memory

cmx_delete_system（サービスユニットを削除する場合）※2

slb server <実サーバ名> <実サーバIPアドレス>

　no port <実ポート> tcp

write memory

cmx_delete_system（ホスト単位モデルのスケールインを行う場合）※3

no slb server <実サーバ名>

write memory

cmx_delete_system（Webシステムを削除する場合）

cookieスイッチングの使用なし

no slb virtual-server <仮想サーバ名>

no slb service-group <仮想サーバ名>

no slb server <実サーバ名>

write memory

cookieスイッチングの使用あり

no slb virtual-server <仮想サーバ名>

no slb service-group <仮想サーバ名>

no slb server <実サーバ名>

no slb template persist cookie <仮想サーバ名>

write memory

cmx_start_target

slb service-group <仮想サーバ名> tcp

　member <実サーバ名>:<実ポート> enable

write memory

cmx_stop_target

slb service-group <仮想サーバ名> tcp

　member <実サーバ名>:<実ポート> disable

write memory

注※1　仮想サーバの初期化を実施しない場合（-lb keepvsを指定した場合）も実行するCLIコマンドは同じです。

注※2　実サーバを共有するそのほかのサービスユニットがある場合は，サーバごとの削除はしません。

注※3　実サーバを共有するそのほかのサービスユニットがない場合は，サーバごと削除します。

参考

ACOSの場合，仮想サーバ名をサービスグループ名およびテンプレート名として使用します。

(2)　BIG-IP v9，BIG-IP v10.1，またはBIG-IP v10.2の場合

BIG-IP v9，BIG-IP v10.1，またはBIG-IP v10.2の場合，負荷分散機の接続方式としてsshプロトコルを使用した直接接続が使用できます。なお，09-00以降では，負荷分散機の接続方式としてAPIを使用した直接接続が使用できます。

sshプロトコルを使用した直接接続する場合は，Management Serverを配置するホストにsshのクライアント環境を設定する必要があります。sshのクライアント環境の設定方法をOSごとに次に示します。

Windowsの場合

Management Serverを配置するホストにsshクライアントプログラムが必要です。使用できるsshクライアントプログラムは，PuTTYのCLIコマンドです。事前にPuTTYを入手し，インストールします。また，PuTTYのインストールフォルダ以下にあるplinkコマンドが格納されたフォルダを，システム環境変数PATHに追加します。PuTTYは，該当ページ（http://www.chiark.greenend.org.uk/~sgtatham/putty/）からダウンロードできます。

UNIXの場合

sshコマンドは，初めて使用する際に接続確認の問い合わせ要求を実行します。

root権限のあるユーザでsshコマンドを実行して負荷分散機と接続し，接続確認の問い合わせ要求（Are you sure you want to continue connecting (yes/no)?）に対して「yes」を応答してください。「yes」を応答したあと，sshコマンドは接続確認の問い合わせ要求を実行しなくなります。

注意事項

AIXの場合，負荷分散機との接続形態にsshの直接使用を選択すると，sshコマンドが必要になります。sshコマンドを使用するために必要なソフトウェアは事前に入手してください。

Smart Composer機能が実行するBIG-IPのCLIコマンドを製品ごとに説明します。BIG-IPのCLIコマンドの詳細については，使用する製品のドキュメントを参照してください。

(a)　BIG-IP v9またはBIG-IP v10.1の場合

負荷分散機としてBIG-IP v9またはBIG-IP v10.1を使用する場合に，Smart Composer機能が実行する負荷分散機のCLIコマンドを次の表に示します。

表J‒2　Smart Composer機能が実行する負荷分散機のCLIコマンド（BIG-IP v9またはBIG-IP v10.1の場合）

Smart Composer機能のコマンド

実行する負荷分散機のCLIコマンド

共通

b save

b version

cmx_build_system（Webシステムを構築する場合）

cookieスイッチングの使用なし

b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable

b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http enable}

cookieスイッチングの使用あり

b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable

b profile persist <仮想サーバ名> {mode cookie cookie mode insert cookie name <cookie名>}

b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http persist <仮想サーバ名> enable}

cmx_build_system（スケールアウトする場合）

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable

cmx_build_system（実ポートを変更する場合）

b pool <仮想サーバ名> member <実サーバIPアドレス>:<変更後の実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<変更後の実ポート> session disable

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> delete

cmx_build_system（負荷分散機の仮想サーバを初期化しないでWebシステムを構築する場合）

cookieスイッチングの使用なし

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable

b virtual <仮想サーバ名> {destination

　<仮想サーバIPアドレス>:<仮想ポート> pool

　<仮想サーバ名> profile http enable}

cookieスイッチングの使用あり

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable

b profile persist <仮想サーバ名> {mode cookie cookie mode insert cookie name <cookie名>}

b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http persist <仮想サーバ名> enable}

cmx_delete_system（サービスユニットを削除，およびホスト単位管理モデルをスケールインする場合）

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> delete

b node <実サーバIPアドレス> delete

cmx_delete_system（Webシステムを削除する場合）

cookieスイッチングの使用なし

b virtual <仮想サーバ名> delete

b pool <仮想サーバ名> delete

b node <実サーバIPアドレス> delete

cookieスイッチングの使用あり

b virtual <仮想サーバ名> delete

b pool <仮想サーバ名> delete

b node <実サーバIPアドレス> delete

b profile persist <仮想サーバ名> delete

cmx_start_target

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session enable

cmx_stop_target

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session disable

参考

BIG-IP v9，BIG-IP v10.1の場合，仮想サーバ名をプール名として使用します。

(b)　BIG-IP v10.2の場合

負荷分散機としてBIG-IP v10.2を使用する場合に，Smart Composer機能が実行する負荷分散機のCLIコマンドを次の表に示します。

表J‒3　Smart Composer機能が実行する負荷分散機のCLIコマンド（BIG-IP v10.2の場合）

Smart Composer機能のコマンド

実行する負荷分散機のCLIコマンド

共通

b save

b version

cmx_build_system（Webシステムを構築する場合）

cookieスイッチングの使用なし

b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session user disabled

b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http enable}

cookieスイッチングの使用あり

b pool <仮想サーバ名> {member <実サーバIPアドレス>:<実ポート>}

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session user disabled

b profile persist <仮想サーバ名> {mode cookie cookie mode insert cookie name <cookie名>}

b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http persist <仮想サーバ名> enable}

cmx_build_system（スケールアウトする場合）

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session user disabled

cmx_build_system（実ポートを変更する場合）

b pool <仮想サーバ名> member <実サーバIPアドレス>:<変更後の実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<変更後の実ポート> session user disabled

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> delete

cmx_build_system（負荷分散機の仮想サーバを初期化しないでWebシステムを構築する場合）

cookieスイッチングの使用なし

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session user disabled

b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http enable}

cookieスイッチングの使用あり

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> add

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session user disabled

b profile persist <仮想サーバ名> {mode cookie cookie mode insert cookie name <cookie名>}

b virtual <仮想サーバ名> {destination <仮想サーバIPアドレス>:<仮想ポート> pool <仮想サーバ名> profile http persist <仮想サーバ名> enable}

cmx_delete_system（サービスユニットを削除，およびホスト単位管理モデルをスケールインする場合）

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> delete

b node <実サーバIPアドレス> delete

cmx_delete_system（Webシステムを削除する場合）

cookieスイッチングの使用なし

b virtual <仮想サーバ名> delete

b pool <仮想サーバ名> delete

b node <実サーバIPアドレス> delete

cookieスイッチングの使用あり

b virtual <仮想サーバ名> delete

b pool <仮想サーバ名> delete

b node <実サーバIPアドレス> delete

b profile persist <仮想サーバ名> delete

cmx_start_target

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session user enabled

cmx_stop_target

b pool <仮想サーバ名> member <実サーバIPアドレス>:<実ポート> session user disabled

参考

BIG-IP v10.2の場合，仮想サーバ名をプール名として使用します。

付録K　XDM/RD E2の設定

HiRDB Type4 JDBC Driverを使用してXDM/RD E2に接続する場合の設定について説明します。なお，データベースとしてXDM/RD E2を使用する場合は，XDM/RD E2をインストールして初期設定を済ませておいてください。詳細については，マニュアル「HiRDB XDM/RD E2接続機能」を参照してください。なお，HiRDB Type4 JDBC Driverの設定については，「4.1.6　データベース接続環境を設定する（HiRDBの設定）」を参照してください。

参考

データベースとして，HiRDB，OracleまたはSQL Serverを使用する場合の設定については，それぞれ次の個所を参照してください。

HiRDBの場合

HiRDB Type4 JDBC Driverを使用して接続する場合の設定については，「4.1.6　データベース接続環境を設定する（HiRDBの設定）」を参照してください。

Oracleの場合

Oracle JDBC Thin Driverを使用して接続する場合の設定については，「4.1.7　データベース接続環境を設定する（Oracleの設定）」を参照してください。

SQL Serverの場合

SQL Serverを使用して接続する場合の設定については，「4.1.8　データベース接続環境を設定する（SQL Serverの設定）」を参照してください。

ここでは，XDM/RD E2でJ2EEリソースを扱う場合に必要な次の設定について説明します。

環境変数の設定

環境変数のグループ登録

タイムアウトの設定

付録K.1　環境変数の設定

次の環境変数を設定する必要があります。詳細については，マニュアル「HiRDB XDM/RD E2接続機能」，およびマニュアル「HiRDB UAP開発ガイド」を参照してください。

PDHOST

データベースのホスト名またはIPアドレスを指定します。

PDUSER

データベースのユーザ名およびデータベースのパスワードを指定します。

PDNAMEPORT

DBコネクションサーバのサーバスケジュール番号を指定します。

PDSRVTYPE

サーバの種別として，「VOS3」（固定値）を指定します。

PDCLTRDNODE

接続するXDM/RD E2のデータベース識別子として，RDノード名称（例：XRAA）を指定します。

PDXAMODE

トランザクションの移行機能は使用しないので，「0」（固定値）を指定します。

PDCWAITTIME

レスポンスタイムアウトとして，トランザクションタイムアウトの値よりも大きな値を指定します。

付録K.2　環境変数のグループ登録

環境変数のグループは，次の方法で登録します。

Windowsの場合

HiRDBのクライアント環境変数登録ツールで「システムグループ」を選択して，環境変数のグループを登録します。この場合，DB Connectorのプロパティ定義では，ここで登録したグループ名を指定してください。

UNIXの場合

HiRDBのクライアント環境変数グループの設定ファイルに登録します。この場合，DB Connectorのプロパティ定義では，ここで登録した環境変数グループの設定ファイルのパスを指定してください。

なお，環境変数のグループ登録の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

付録K.3　タイムアウトの設定

XDM/RD E2のタイムアウトは，HiRDBのクライアント環境変数，またはDBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文に設定します。

XDM/RD E2のタイムアウトを設定するチューニングパラメタを次の表に示します。

表K‒1　XDM/RD E2のタイムアウトを設定するチューニングパラメタ

タイムアウトの種類

設定個所

設定方法（パラメタ名）

設定内容

レスポンスタイムアウト

HiRDBクライアント環境変数

PDCWAITTIME

任意の値を指定します。※1

SQL実行CPU時間タイムアウト

DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文

SQLCTIME

任意の値を指定します。※2

SQL実行経過時間タイムアウト

DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文

SQLETIME

任意の値を指定します。※2

トランザクション経過時間タイムアウト

DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文

SVETIME

任意の値を指定します。※2

サーバ処理要求の間隔時間

DBコネクションサーバのコントロール空間起動制御文／サーバ空間起動制御文

SVINTERVAL

コネクションプーリング機能を使用する場合は，「0」を指定してください。※2

注※1

詳細については，マニュアル「HiRDB XDM/RD E2接続機能」を参照してください。

注※2

詳細については，マニュアル「VOS3　Database Connection Server」を参照してください。

タイムアウトの設定については，マニュアル「アプリケーションサーバ システム設計ガイド」の「8.6.6　データベースでのタイムアウトを設定する」を参照してください。

付録L　アプリケーションサーバが提供するサンプルプログラム

アプリケーションサーバでは，次に示すサンプルプログラムを提供しています。

Enterprise Bean（EJB2.0）のサンプルプログラム

Enterprise Bean（アノテーション）のサンプルプログラム

Enterprise Bean（Timer Service）のサンプルプログラム

Java Beansリソースのサンプルプログラム

ユーザログ機能のサンプルプログラム

Webアプリケーションのサンプルプログラム

TP1インバウンド連携機能のサンプルプログラム

JSFのサンプルプログラム

Bean ValidationおよびCDI連携アプリケーションのサンプル

注意事項

提供しているサンプルプログラムは，わかりやすさを優先するため，紹介している多くのコードで，エラー処理やセキュリティ脆弱性問題を回避するための処理などを省略しています。そのため，サンプルプログラムを悪意のある第三者から攻撃された場合は，重大な問題が発生するおそれがあります。本番環境ではサンプルプログラムを使用しないでください。サンプルプログラムを本番環境で使用して，サンプルプログラムを原因とする問題が発生しても保証しません。

ここでは，各サンプルの概要，サンプルの実行手順，およびサンプルの実行例を説明します。なお，サンプルプログラムは，サーバ管理コマンドを使用した実行手順と実行例について説明しています。

注意事項

UNIX環境で使用する場合は，本文を次のとおりに読み替えてください。

Windows用のディレクトリ（<Application Serverのインストールディレクトリ>¥）を，UNIX用のディレクトリ（/opt/Cosminexus/）に読み替えてください。

Windows環境で使用するバッチファイルは，UNIX環境ではシェルスクリプトになります。拡張子を除いて読み替えてください。

（例）Windows環境：testClient.bat，UNIX環境：testClient

なお，アプリケーションサーバが提供するサンプルプログラムを実行する場合は，書き込み権限のある別のディレクトリへサンプルプログラムをコピーして使用することをお勧めします。

付録L.1　サーバ管理コマンドによるサンプル実行環境の構築，運用手順

ここでは，サーバ管理コマンドを使用してサンプルプログラムを実行する場合のJ2EEサーバの構築，運用手順を説明します。この手順は，付録I.2以降の各サンプルプログラムを実行するときに必要になります。

(1)　J2EEサーバのセットアップ

コマンドプロンプトでcjsetupコマンドを入力し，J2EEサーバをセットアップします。セットアップの実行例を次に示します。実行例では，「MyServer」という名称のJ2EEサーバをセットアップしています。

C:¥> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjsetup MyServer
KDJE40001-I The setup for the J2EE server has finished successfully. Server name = MyServer
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>

(2)　J2EEサーバのカスタマイズ

アプリケーションにアクセスするための設定をします。アプリケーションにアクセスするには，次のどちらかの方法を使用します。

Webサーバと連携する。

J2EEサーバのNIO HTTPサーバに直接アクセスする。

ここでは，設定や運用が容易なJ2EEサーバのNIO HTTPサーバに直接アクセスする方法を説明します。

注意事項

NIO HTTPサーバでは，8008番ポートをデフォルトで使用します。ポート番号を変更するには，ユーザ定義ファイル（usrconf.properties）に，webserver.connector.nio_http.portプロパティキーを定義します。

NIO HTTPサーバで使用するポート番号に8081番を定義する例を示します。

webserver.connector.nio_http.port=8081

(3)　J2EEサーバの起動

cjstartsvコマンドでセットアップ済みのJ2EEサーバを起動します。

C:¥> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstartsv MyServer
＜起動ログが出力される＞
  ：
KDJE30028-I The J2EE server has started. Server name = MyServer

(4)　リソースアダプタの設定

次の手順でリソースアダプタの設定をします。

cjimportresコマンドでリソースアダプタをインポートします。

cjdeployrarコマンドを使用して，リソースアダプタをデプロイします。

cjgetrarpropコマンドでConnector属性ファイルを取得し，ファイル編集後に，cjsetrarpropコマンドで編集内容を反映させます。

cjtestresコマンドを使用して，リソースアダプタのテストをします。

cjstartrarコマンドを使用して，リソースアダプタを開始します。

(5)　アプリケーションのインポート，設定，および開始

サンプルで提供するバッチファイル（deployApp.bat）を使用して，アプリケーションを操作します。このバッチファイルでは，アプリケーションのJ2EEサーバへのインポートから，設定，開始が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjimportappコマンドが実行され，アプリケーションがJ2EEサーバにインポートされます。

cjstartappコマンドが実行され，アプリケーションが開始されます。

cjlistappコマンドが実行され，J2EEサーバ上のアプリケーションの状態が一覧表示されます。この一覧を確認することで，アプリケーションが稼働状態（running）になっていることを確認できます。

(6)　アプリケーションの停止，削除

サンプルで提供するバッチファイル（unDeployApp.bat）を使用して，アプリケーションを操作します。このバッチファイルでは，アプリケーションの停止とJ2EEサーバからの削除が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjstopappコマンドが実行され，アプリケーションが停止します。

cjdeleteappコマンドが実行され，アプリケーションがJ2EEサーバから削除されます。

cjlistappコマンドが実行され，J2EEサーバ上のアプリケーションの状態が一覧表示されます。この一覧を確認することで，アプリケーションが削除されたことを確認できます。

(7)　J2EEサーバの終了

cjstopsvコマンドでJ2EEサーバを終了します。

cjstopsvコマンドのコンソール

> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstopsv MyServer
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>

J2EEサーバのコンソール

C:¥> cd Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjstartsv MyServer
＜起動ログが出力される＞
  ：
KDJE30028-I The J2EE server has started. Server name = MyServer
  ：
<終了ログが出力される>
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>

付録L.2　Enterprise Bean（EJB2.0）のサンプルプログラム

Enterprise Bean（EJB2.0）を使用したサンプルプログラムは，次に示すディレクトリに格納されています。

<Application Serverのインストールディレクトリ>¥CC¥examples¥ejb¥ejb20

ここでは，サンプルプログラムの一覧，実行例，および各サンプルプログラムの概要について説明します。

(1)　Enterprise Bean（EJB2.0）のサンプルプログラム一覧

サンプルプログラムの一覧およびサンプルプログラム実行時の注意事項を示します。サンプルプログラムの一覧は，Enterprise Beanの種類と動作概要をまとめた一覧と，利用する技術，およびリソースをまとめた一覧に分けて示します。

注意事項

Enterprise Beanのサンプルプログラムは，現在使用している製品のバージョン・リビジョンのものを使用してください。旧バージョン・リビジョンのサンプルプログラムの動作は保証されません。

(a)　サンプルプログラム一覧（Enterprise Beanの種類と動作内容）

表L‒1　サンプルプログラムの一覧（Enterprise Beanの種類と動作内容）

サンプル名

Enterprise Bean種別

パーシスタンス

トランザクション

動作概要

account

Entity Bean

BMP

−

預金や払い戻しに応じて残高を計算し，データベースを更新します。

adder

Stateful Session Bean

−

CMT

入力数値の合計を計算して，ブラウザ上に表示します。

bank

Stateful Session Bean

−

CMT

当座預金口座から普通預金口座に資金を移動し，データベースを更新します。

cart

Stateful Session Bean

−

CMT

購入する本をショッピングカートに入れます。カートにない本をカートから出そうとした場合は，例外を発生させます。

checker

Stateful Session Bean

−

CMT

割引対象となる金額を超えた場合，割引率を基に割引後の金額を計算します。割引対象となる金額と割引率は，Enterprise Beanの環境エントリで指定します。

cmp20product

Entity Bean

CMP2.0

−

商品情報をデータベースに登録し，登録された商品情報を検索します。このサンプルは，CMP 2.0形式のEnterprise Beanを利用します。

confirmer

Stateless Session Bean

−

CMT

商品の注文に対する確認メールを送信します。

converter

Stateless Session Bean

−

CMT

通貨の種類をドルから円，円からユーロに変換します。

enroller

Stateless Session Bean

−

CMT

学生と科目の追加，および受講登録をして，データベースを更新します。

Entity Bean

BMP

−

jsptag※

Stateless Session Bean

−

CMT

通貨の種類をドルから円，円からユーロに変換します。このサンプルは，JSPを利用してブラウザ上に表示します。

jsptobean

Entity Bean

BMP

−

預金や払い戻しに応じて残高を計算し，データベースを更新します。残高は，JSPを利用してブラウザ上に表示します。

localadder

Stateful Session Bean

−

CMT

入力数値の合計を計算して，ブラウザ上に表示します。このサンプルは，サーブレットからローカルインタフェースを利用してEnterprise Beanを呼び出します。

message

Stateless Session Bean

−

CMT

JMSのキューを利用して，メッセージを送受信します。

Message -driven Bean

−

CMT

order

Entity Bean

BMP

−

注文番号と対応する商品情報を検索して表示します。注文番号と商品情報はデータベースで管理します。

product

Entity Bean

CMP

−

商品情報をデータベースに登録し，登録された商品情報を検索します。

salesrep

Entity Bean

BMP

−

顧客の追加と，担当する販売員の変更を行い，データベースを更新します。

shipper

Stateful Session Bean

−

CMT

注文に対する商品在庫を計算し，データベースを更新します。在庫が一定の数量を下回った場合，引き当て処理を呼び出します。

Entity Bean

BMP

−

storagebin

Entity Bean

BMP

−

データベースの部品情報テーブルと部品在庫情報テーブルから，対応する部品の情報と在庫を検索します。

teller

Stateful Session Bean

−

BMT

銀行用端末機から当座預金のお金を引き出し，残高を計算します。

warehouse

Stateless Session Bean

−

CMT

注文を受けた商品の状態，および商品の在庫を更新します。

（凡例）

−：該当しないことを示します。

注※　jsptagサンプルをコンパイルおよびアーカイブしたEARファイル（converter.ear）も提供しています。

(b)　サンプルプログラムの一覧（接続するリソース，クライアントの種類）

サンプルプログラムの一覧と，接続するリソース，クライアントの種類を次の表に示します。

表L‒2　サンプルプログラム一覧（接続するリソース，クライアントの種類）

サンプル

接続するリソース※1

クライアントの種類※2

データベース

メール

JMS

EJBクライアントアプリケーション

Webブラウザ

account

○

−

−

○

−

adder

−

−

−

−

○

bank

○

−

−

○

−

cart

−

−

−

○

−

checker

−

−

−

○

−

confirmer

−

○

−

○

−

converter

−

−

−

○

−

enroller

○

−

−

○

−

jsptag

−

−

−

−

○

jsptobean

○

−

−

−

○

order

○

−

−

○

−

product

○

−

−

○

−

salesrep

○

−

−

○

−

shipper

○

−

−

○

−

storagebin

○

−

−

○

−

teller

○

−

−

○

−

warehouse

○

−

−

○

−

message

−

−

○

○

−

cmp20product

○

−

−

○

−

localadder

−

−

−

−

○

（凡例）

○：該当することを示します。　−：該当しないことを示します。

注※1　接続するリソースごとに，必要な設定があります。接続するリソースに応じて，「付録L.2(1)(c)　サンプルプログラムで使用するデータベースの設定」，「付録L.2(1)(d)　サンプルプログラムで使用するメールの設定」または「付録L.2(1)(e)　サンプルプログラムで使用するJMSの設定」を参照してください。

注※2　クライアントの種類に応じて，実行方法などが異なります。詳細は，「付録L.2(1)(f)　サンプルプログラムのクライアントの種類」を参照してください。

(c)　サンプルプログラムで使用するデータベースの設定

ここでは，サンプルプログラムで使用するデータベースの設定について説明します。

「表L-2　サンプルプログラム一覧（接続するリソース，クライアントの種類）」の「データベース」列に「○」が付いているサンプルプログラムでは，リソースとしてデータベースを利用します。サンプルプログラムを実行する前に，データベースおよびデータベース接続関連の設定を適切にしてください。

なお，データベースとして利用できるのは，OracleまたはHiRDBです。

必要な設定を次に示します。

HiRDBを利用する場合，外部キーの指定（参照制約）を有効に設定してください。

設定方法については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

利用するデータベース種別に従って，サンプルが提供する「createTable_Oracle.sql」（Oracleの場合）または「createTable_HiRDB.sql」（HiRDBの場合）を実行して，データベースのテーブルを初期化してください。なお，HiRDBを利用する場合，外部キーの指定（参照制約）が有効になっていないと，「createTable_HiRDB.sql」の実行に失敗します。

サーバ管理コマンドでDB Connectorの設定をします。

DB Connectorは，「DBConnector_Oracle_CP.rar」または「DBConnector_HiRDB_Type4_CP.rar」を利用することをお勧めします。「DBConnector_Oracle_XA.rar」または「DBConnector_HiRDB_Type4_XA.rar」を利用した場合は，ライトトランザクション機能が無効になるように設定してからJ2EEサーバを起動して，DB Connectorを設定します。ライトトランザクション機能は，usrconf.propertiesのejbserver.distributedtx.XATransaction.enabledキーにtrueを指定すると無効になります。

リソースのリンクを解決します。

リンクの解決には，サンプルで提供するアプリケーション属性ファイル「cosminexus.xml」を利用します。「cosminexus.xml」の<resource-ref>タグにリソースの表示名を指定して，サーバ管理コマンドを利用して設定してください。リソースのリンク解決をしてから，アプリケーションのデプロイ操作をしてください。

サンプルプログラムのうち，「product」と「cmp20product」では，「cosminexus.xml」の<schema-name>タグに「user1」が設定されています。利用するデータベース環境に応じて，適切な値に変更してからアプリケーションのデプロイ操作を実行してください。

サンプルプログラムのうち，「teller」の実行にHiRDBを使用する場合，TellerEJB.javaファイル中の日付指定関数を指定している個所を，HiRDB用に書き換えてコンパイルしてください。

(d)　サンプルプログラムで使用するメールの設定

ここでは，サンプルプログラムで使用するメールの設定について説明します。

「表L-2　サンプルプログラム一覧（接続するリソース，クライアントの種類）」の「メール」列に「○」が付いているサンプルプログラムでは，リソースとしてメールを利用します。サンプルプログラムを実行する前に，メールサーバへの接続関連の設定を適切にしてください。

必要な設定を次に示します。

EJBクライアントアプリケーションのソースファイル（ConfirmerClient.java）に，受信メールアドレスがコーディングされています。この個所を適切な受信メールアドレスに書き換えてからコンパイルしてください。

サーバ管理コマンドでメールコンフィグレーションを設定する必要があります。サーバ管理コマンドの利用方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「6.3　メールコンフィグレーションの設定」を参照してください。

リソースのリンクを解決します。ただし，メールコンフィグレーションの表示名を「Cosminexus_SMTP_Server」と定義した場合は，リンクの解決は不要です。これ以外の表示名を定義した場合は，リンクを解決してください。

リンクの解決には，サンプルで提供するアプリケーション属性ファイル「cosminexus.xml」を利用します。「cosminexus.xml」の<resource-ref>タグにリソースの表示名を指定して，サーバ管理コマンドで設定してください。リソースのリンク解決をしてから，アプリケーションのデプロイ操作をしてください。

(e)　サンプルプログラムで使用するJMSの設定

ここでは，サンプルプログラムで使用するJMSの設定について説明します。

「表L-2　サンプルプログラム一覧（接続するリソース，クライアントの種類）」の「JMS」列に「○」が付いているサンプルプログラムでは，リソースとしてJMSを利用します。サンプルプログラムを実行する前に，JMSへの接続関連の設定を適切にしてください。

必要な設定を次に示します。

JMSとしてTP1/Message Queue - Accessを使用するため，あらかじめTP1/Message Queue - Accessをインストールしておきます。また，OpenTP1および TP1/Message Queueのサーバ実行環境もあらかじめ準備しておきます。

サーバ管理コマンドによって，TP1/Message Queue - Accessの設定をします。

ライトトランザクション機能を無効にしてJ2EEサーバを起動してから，TP1/Message Queue - Accessの設定をします。なお，ライトトランザクション機能は，usrconf.propertiesのejbserver.distributedtx.XATransaction.enabledキーにtrueを指定すると無効になります。

また，TP1/Message Queue - Accessのトランザクションサポートレベルを，「XATransaction」にしてください。

リソースのリンクを解決します。ただし，TP1/Message Queue - Accessのデフォルトの表示名を変更しないで，かつ，キュー定義ファイルに表示名が「QUEUE1」となるキューを定義している場合，リンクの解決は不要です。TP1/Message Queue - Accessのデフォルトの表示名を変更した場合や，キュー定義ファイルに表示名が「QUEUE1」となるキューを定義していない場合は，リンクの解決が必要です。

リンクの解決には，サンプルで提供するアプリケーション属性ファイル「cosminexus.xml」を利用します。「cosminexus.xml」の<resource-ref>タグ，<resource-env-ref>タグ，および<message-ref>タグにリソースの表示名を指定して，サーバ管理コマンドで設定してください。リソースのリンク解決をしてから，アプリケーションのデプロイ操作をしてください。

(f)　サンプルプログラムのクライアントの種類

サンプルプログラムのクライアントには，EJBクライアントアプリケーションと，Webブラウザで表示するアプリケーションの2種類があります。

「表L-2　サンプルプログラム一覧（接続するリソース，クライアントの種類）」の「EJBクライアントアプリケーション」列に「○」が付いているサンプルプログラムは，EJBクライアントアプリケーションです。サンプルとして提供されている「testClient.bat」を使用して，クライアントアプリケーションを開始してください。

「表L-2　サンプルプログラム一覧（接続するリソース，クライアントの種類）」の「Webブラウザ」列に「○」が付いているサンプルプログラムは，Webブラウザから操作するWebアプリケーションです。クライアントから操作する場合は，Webブラウザを起動して，次のURLを指定してください。

http://<マシン名>:<ポート番号>/<ContextRoot>/<ターゲットファイル>

例えば，ローカルホストで動作するサンプル「adder」の場合は，次のように指定します。

http://localhost/adder/adder_war/adder.html

(2)　Enterprise Bean（EJB2.0）のサンプル実行手順

converterを例に，サンプルの実行例を示します。converterは，クライアントのJavaアプリケーションからEnterprise Beanを呼び出すプログラムです。データベースなどのリソースは利用しません。リソースを利用する場合は，ここで示す手順に加え，リソースにアクセスできる環境を整える必要があります。リソースの設定方法については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「3.3　リソース接続」を参照してください。

(a)　converterの概要

通貨の種類をドルから円，円からユーロに変換します。converterの構成を次に示します。

図L‒1　converterの構成

(b)　コンパイル

サンプルで提供するバッチファイル（compileBean.batおよびcompileClient.bat）を使用して，Enterprise Beanとクライアントをコンパイルします。このバッチファイルで，アプリケーション（.earファイル）が作成されます。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥converter
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>compileBean
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>compileClient
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥...¥converter>

(c)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(d)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(e)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(f)　アプリケーションのデプロイ

サンプルで提供するバッチファイル（deployApp.bat）を使用して，アプリケーションをデプロイします。このバッチファイルでは，アプリケーションのJ2EEサーバへのインポートから，アプリケーションの設定，開始，EJBのスタブおよびインタフェースファイルの取得までが実行されます。

このバッチファイルで実行される処理の内容を示します。

アプリケーションのインポート，設定，開始，一覧表示

実行内容については，「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

Enterprise Beanのスタブ・インタフェースファイルの取得

cjgetsubsjarコマンドで，Enterprise Beanのスタブとインタフェースを取得します。

(g)　アプリケーションの実行

サンプルで提供するバッチファイル（testClient.bat）を使用して，アプリケーションを実行します。実行後，EJBクライアントアプリケーションの起動コンソール画面に次のように表示されれば成功です。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ ejb¥ejb20¥converter
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ ejb¥ejb20¥converter>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥converter, PID = 3684)
12160.0
0.77
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ ejb¥ejb20¥converter>

(h)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(i)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

(3)　Enterprise Bean（EJB2.0）のサンプルの概要

Enterprise Bean（2.0）のサンプルの概要，構成，実行例を示します。なお，必要な設定については，「付録L.2(1)(b)　サンプルプログラムの一覧（接続するリソース，クライアントの種類）」を参照してください。

(a)　accountの概要

預金や払い戻しに応じて残高を計算し，銀行口座テーブルを更新します。accountの構成を次に示します。

図L‒2　accountの構成

accountの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥account>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥account, PID = 3684)
balance = 68.25
balance = 32.55
456: 44.77
730: 19.54
268: 100.07
456: 44.77
836: 32.55
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥account>

(b)　adderの概要

ブラウザから入力された数値の合計を計算します。adderの構成を次に示します。

図L‒3　adderの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/adder.html

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは次のURLを指定します。

http://localhost:8008/adder/adder_war/adder.html

adderの実行例を示します。

図L‒4　adderの実行例

(c)　bankの概要

当座預金口座から普通預金口座に資金を移動します。資金はデータベースで管理し，資金移動時に，対応する当座預金口座テーブルと普通預金口座テーブルを更新します。bankの構成を次に示します。

図L‒5　bankの構成

bankの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥bank>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥bank, PID = 3684)
checking: 60.0
saving: 540.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥bank>

(d)　cartの概要

本を購入するショッピングカートです。3冊の本をカートに入れ，カートにない本1冊をカートから出そうとして「BookException」を発生させます。cartの構成を次に示します。

図L‒6　cartの構成

cartの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cart>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥cart, PID = 3684)
The Martian Chronicles
2001 A Space Odyssey
The Left Hand of Darkness
Caught a BookException： Alice in Wonderland not in cart.
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cart>

(e)　checkerの概要

割引対象となる金額を超えた場合，割引率を基に割引後の金額を計算します。割引対象となる金額と割引率は，Enterprise Beanの環境エントリで指定します。checkerの構成を次に示します。

図L‒7　checkerの構成

checkerの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥checker>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥checker, PID = 3684)
discount = 4200.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥checker>

(f)　cmp20productの概要

商品情報をデータベースに登録し，登録された商品情報を検索します。このサンプルは，CMP 2.0形式のEnterprise Beanを利用します。cmp20productの構成を次に示します。

図L‒8　cmp20productの構成

cmp20productの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cmp20product>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥cmp20product, PID = 3684)
Ceramic Dog: 10.0
Ceramic Dog: 14.0
Chrome Fish: 22.0
999: Ivory Cat 19.0
789: Ivory Cat 33.0
123: 14.0
456: 13.0
999: 19.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥cmp20product>

(g)　confirmerの概要

商品の注文に対する確認メールを送信します。confirmerの構成を次に示します。

図L‒9　confirmerの構成

confirmerのクライアント（メール送信側）の実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥confirmer>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥confirmer, PID = 3684)
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥confirmer>

クライアント実行後，ConfirmerClient.javaで指定したアドレスにメールが送信されます。受信されるメールの例を示します。

件名:"Test Message from ConfirmerEJB"
文面:
Thank you for your order.
We received your order on 2002/03/18 12:35.

(h)　converterの概要

converterについては，「付録L.2(2)　Enterprise Bean（EJB2.0）のサンプル実行手順」を参照してください。

(i)　enrollerの概要

学生と科目の追加，および受講登録をして，対応する学生情報テーブル，科目テーブル，受講登録情報テーブルを更新します。enrollerの構成を次に示します。

図L‒10　enrollerの構成

enrollerの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥enroller>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥enroller, PID = 3684)
Denise Smith:
220 Power J2EE Programming
333 XML Made Easy
777 An Introduction to Java Programming

An Introduction to Java Programming:
823 Denise Smith
456 Joe Smith
388 Elizabeth Willis
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥enroller>

(j)　jsptagの概要

通貨の種類をドルから円，円からユーロに変換します。変換した結果は，JSPを利用して，ブラウザに表示します。jsptagの構成を次に示します。

図L‒11　jsptagの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/Converter.jsp

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは次のURLを指定します。

http://localhost:8008/jsptag/converter_war/Converter.jsp

jsptagの実行例を示します。

図L‒12　jsptagの実行例

(k)　jsptobeanの概要

預金や払い戻しに応じて残高を計算し，データベースを更新します。残高は，JSPを利用してブラウザ上に表示します。jsptobeanの構成を次に示します。

図L‒13　jsptobeanの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/Account.jsp

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは次のURLを指定します。

http://localhost:8008/jsptobean/account_war/Account.jsp

jsptobeanの実行例を示します。

図L‒14　jsptobeanの実行例

(l)　localadderの概要

入力数値の合計を計算して，ブラウザ上に表示します。このサンプルは，サーブレットからローカルインタフェースを利用してEnterprise Beanを呼び出します。localadderの構成を次に示します。

図L‒15　localadderの構成

実行時には，ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/adder.html

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは次のURLを指定します。

http://localhost:8008/localadder/localadder_war/adder.html

localadderの実行例を示します。

図L‒16　localadderの実行例

(m)　messageの概要

Session BeanからJMSのQueueへ送信したメッセージを，Message-driven Beanで受信します。messageの構成を次に示します。

図L‒17　messageの構成

messageのクライアントの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥message>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥message, PID = 3684)
sending message=MY MESSAGE
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥message>

クライアント実行後，メッセージの送受信が正常に完了した場合は，J2EEサーバの起動コンソール上に次のように表示されます。

...
MessageBean: onMessage（）
MessageBean: received message=MY MESSAGE
...

(n)　orderの概要

注文番号と対応する商品情報を検索して表示します。注文番号と商品情報は，それぞれ注文情報テーブルと商品情報テーブルで管理します。orderの構成を次に示します。

図L‒18　orderの構成

orderの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥order>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥order, PID = 3684)
about to create
123 1 p23 12.0
123 2 p67 89.0
123 3 p11 41.0

123
456
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥order>

(o)　productの概要

商品名や価格などの商品情報をデータベースに登録し，登録された商品情報を検索します。商品情報は，商品情報テーブルで管理します。productの構成を次に示します。

図L‒19　productの構成

productの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥product>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥product, PID = 3684)
Ceramic Dog: 10.0
Ceramic Dog: 14.0
Chrome Fish: 22.0
999: Ivory Cat 19.0
789: Ivory Cat 33.0
123: 14.0
456: 13.0
999: 19.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥product>

(p)　salesrepの概要

顧客の追加と，担当する販売員の変更を行い，データベースを更新します。二つのEnterprise Beanを連携し，顧客テーブルと販売員テーブルへの検索と更新を行います。salesrepの構成を次に示します。

図L‒20　salesrepの構成

salesrepの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥salesrep>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥salesrep, PID = 3684)
customerId = 221
customerId = 388
customerId = 456
customerId = 844

987: Mary Jackson
221: Alice Smith
388: Bill Williamson
456: Joe Smith
844: Buzz Murphy
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥salesrep>

(q)　shipperの概要

注文に対する商品在庫を計算し，データベースを更新します。在庫が一定の数量を下回った場合，引き当て処理を呼び出します。二つのEnterprise Beanを連携し，商品在庫情報テーブルへの検索と更新を行います。shipperの構成を次に示します。

図L‒21　shipperの構成

shipperの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥shipper>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥shipper, PID = 3684)
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥shipper>

shipperの実行後，J2EEサーバの起動コンソール上に次のように表示されます。

...
ShipperEJB： ejbCreate()
ShipperEJB： shipItem()
StockEJB： updateOnHand()
StockEJB： reorderNeeded()
...

(r)　storagebinの概要

データベースから部品の情報と在庫を検索します。二つのEnterprise Beanを連携し,部品情報テーブルと部品在庫情報テーブルへの検索を行います。storagebinの構成を次に示します。

図L‒22　storagebinの構成

storagebinの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥storagebin>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥storagebin, PID = 3684)
777 388 500 1.0 Duct Tape
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥storagebin>

(s)　tellerの概要

銀行用端末機から当座預金を引き出し，残高を計算します。データベースの（銀行用端末機の）入金情報テーブルと取引履歴情報テーブルに対し，取引内容を追加します。

tellerの構成を次に示します。

図L‒23　tellerの構成

tellerの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥teller>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥teller, PID = 3684)
checking = 500.0
checking = 440.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥teller>

(t)　warehouseの概要

注文を受けた商品の状態，および商品の在庫を更新します。データベースの商品情報テーブルと在庫情報テーブルのそれぞれを更新します。warehouseの構成を次に示します。

図L‒24　warehouseの構成

warehouseの実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥warehouse>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥HITACHI¥Cosminexus¥CC¥examples¥
ejb¥ejb20¥warehouse, PID = 3684)
status = shipped
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥warehouse>

付録L.3　Enterprise Bean（アノテーション）のサンプルプログラム

アノテーションに対応したEnterprise Beanのサンプルプログラムは，次の3種類を提供します。

アノテーション対応のEnterprise Bean（データベース接続なし）

格納場所は<Application Serverのインストールディレクトリ>¥CC¥examples¥ejb¥annotation¥statelessです。

アノテーション対応のEnterprise Bean（データベース接続あり）

格納場所は<Application Serverのインストールディレクトリ>¥CC¥examples¥ejb¥annotation¥statefulです。

Enterprise Bean（EJB2.0）から接続するアノテーション対応のEnterprise Bean

格納場所は<Application Serverのインストールディレクトリ>¥CC¥examples¥ejb¥annotation¥homeです。

サンプルプログラムの概要と，実行手順を示します。

(1)　アノテーション対応のEnterprise Bean（データベース接続なし）の概要

データベースに接続しない場合のアノテーション対応のEnterprise Beanサンプルプログラム「annotation_stateless」の構成を次に示します。

図L‒25　annotation_statelessの構成（アノテーション対応・データベース接続なし）

Webブラウザ経由でサーブレットにアクセスし，実行結果をブラウザ上に表示します。このサンプルプログラムでは，サーブレットからビジネスインタフェースを使用したEnterprise Beanを呼び出します。

アノテーション対応のEnterprise Beanの参照を取得するため，サーブレット側で@EJBアノテーションを使用します。

@EJB(beanName="MyConverter")
Converter converter;

実行例を次に示します。

図L‒26　アノテーション対応Enterprise Beanのサンプルプログラム（データベース接続なし）の実行例

(2)　アノテーション対応のEnterprise Bean（データベース接続あり）の概要

データベースに接続する場合のアノテーション対応のEnterprise Beanサンプルプログラム「annotation_stateful」の構成を次に示します。

図L‒27　annotation_statefulの構成（アノテーション対応・データベース接続あり）

このサンプルプログラムでは，アノテーションを使用してデータベースに接続します。アノテーション対応のEnterprise Beanで，@Resourceアノテーションを使用してリソースを取得します。

@Resource(mappedName="DB_Connector_for_Cosminexus_Driver")
private DataSource ds;

サーブレット側からビジネスインタフェースを使用したStateful Session Beanをlookupするには，JNDIを使用します。

Context initial = new InitialContext();
duke = (Bank)initial.lookup("java:comp/env/ejb/Bank");

実行例を次に示します。

図L‒28　アノテーション対応Enterprise Beanのサンプルプログラム（データベース接続あり）の実行例

ユーザID，金額を入力して処理を実行します。指定できるユーザIDは001だけです。初期残高は10,000円です。

(3)　Enterprise Bean（EJB2.0）から接続するアノテーション対応のEnterprise Beanの概要

アノテーション対応のEnterprise Beanにホームインタフェースの定義を追加することで，EJB2.0からアノテーション対応のEnterprise Beanを呼び出せます。この処理を実行するサンプルプログラム「annotation_home」の構成を次に示します。

図L‒29　annotation_homeの構成（アノテーション対応・EJB2.0からの接続）

このサンプルプログラムでは，EJB2.0のEnterprise Beanからローカルホームインタフェースが使用されているアノテーション対応のEnterprise Beanを呼び出します。EJB2.0のEnterprise Beanのコードでは，ローカルホームインタフェースをlookupします。

...
Context ctx = new InitialContext();
Converter2LocalHome home = (Converter2LocalHome)ctx.lookup("java:comp/env/ejb/Converter2");
...

アノテーション対応のEnterprise Beanのローカルホームインタフェースは，Enterprise Beanに@LocalHomeアノテーションを指定します。

@Stateless(name="MyConverter2")
@LocalHome(value=Converter2LocalHome.class)
public class Converter2EJB {
...
}

(4)　Enterprise Bean（アノテーション）のサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイルを使用して，サンプルプログラムをコンパイルします。

アノテーション対応のEnterprise Bean（データベース接続あり／なし）のサンプルプログラムは，「compile.bat」を実行します。

EJB2.0のEnterprise Beanからアノテーション対応のEnterprise Beanへ接続するサンプルは，「compileBean.bat」および「compileClient.bat」を実行します。

(b)　SQLの実行（アノテーション対応のEnterprise Bean（データベース接続ありの場合））

データベースに接続するサンプルプログラムの場合は，あらかじめSQLを実行してください。SQL文はサンプルで提供しています（createTable_Oracle.sql，createTable_HiRDB.sql）。

(c)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(d)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(e)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(f)　リソースアダプタの設定（アノテーション対応のEnterprise Bean（データベース接続ありの場合））

データベースに接続するサンプルプログラムの場合は，リソースアダプタの設定が必要です。「付録L.1(4)　リソースアダプタの設定」を参照してください。

(g)　アプリケーションのデプロイ

サンプルで提供するバッチファイル（deployApp.bat）を使用して，アプリケーションをデプロイします。このバッチファイルは，アプリケーションのインポート，開始，一覧表示，およびEnterprise Beanのスタブ・インタフェースの取得をします。

このバッチファイルで実行される処理の内容を示します。

アプリケーションのインポート，開始，一覧表示

実行内容については，「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

Enterprise Beanのスタブ・インタフェースファイルの取得

cjgetsubsjarコマンドで，Enterprise Beanのスタブとインタフェースを取得します。

(h)　アプリケーションの実行

アプリケーションごとに実行方法を示します。

アノテーション対応のEnterprise Bean（データベース接続なし）の場合

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/<ターゲットファイル>

アノテーション対応のEnterprise Bean（データベース接続あり）の場合

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/<ターゲットファイル>

Enterprise Bean（EJB2.0）から接続するアノテーション対応のEnterprise Beanの場合

サンプルで提供するバッチファイル（testClient.bat）を使用してEJBクライアントアプリケーションを実行します。実行例を示します。

C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥annotation¥home>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the
user definition file = C:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥
ejb¥annotation¥home, PID = 3684)
93.632
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)

(i)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(j)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

付録L.4　Enterprise Bean（Timer Service）のサンプルプログラム

Timer Serviceを実装するサンプルプログラムは，次のディレクトリに格納されます。

<Application Serverのインストールディレクトリ>¥CC¥examples¥ejb¥timerservice

サンプルの概要と実行手順を示します。

(1)　Enterprise Bean（Timer Service）のサンプルプログラムの概要

Timer Serviceのサンプルプログラム「TimerService」の構成を次に示します。

図L‒30　TimerServiceの構成

このサンプルプログラムでは，Webブラウザ経由でEJBタイマの生成，一覧表示，キャンセルができます。EJBタイマがタイムアウトすると，ユーザログにメッセージを出力します。

実行例を次に示します。

図L‒31　TimerServiceのサンプルプログラムの実行例

サンプルでは，次の機能を提供します。

EJBタイマの生成

アプリケーションの開始時に，EJBタイマが一つ生成されます。サーブレットに対してDDに<load-on-startup>タグを指定し，サーブレットのinitメソッドでEJBタイマを生成するStateless Session Beanのメソッドを呼び出します。

また，WebページEJBタイマ種別とタイムアウト時間と文字列情報を指定して［Create］ボタンをクリックすると，EJBタイマが生成されます。

EJBタイマ一覧の表示

WebページにEJBタイマの一覧が表示されます。［Refresh］ボタンをクリックすると，最新のEJBタイマ一覧が表示されます。

EJBタイマのキャンセル

Webページの［Cancel］ボタンをクリックすると，該当するEJBタイマがキャンセルされます。

ユーザログへの出力

EJBタイマがタイムアウト日時になると，タイムアウトメソッドが呼び出されユーザログにメッセージが出力されます。出力例を下記に示します。

The timeout method was invoked. (Information = MyTimer02)

(2)　Enterprise Bean（Timer Service）のサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，サンプルプログラムをコンパイルします。このバッチファイルで，EJB-JARファイル（timerservice.jar）とWARファイル（timerservice.war）とEARファイル（timerservice.ear）が作成されます。

(b)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(c)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(e)　アプリケーションのデプロイ

「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(f)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/TimerServiceServlet

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは，次のURLを指定します。

http://localhost:8008/timerservice/TimerServiceServlet

(g)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(h)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

付録L.5　JavaBeansリソースのサンプルプログラム

JavaBeansリソースを使用するサンプルプログラムは，次のディレクトリに格納されます。

<Application Serverのインストールディレクトリ>¥CC¥examples¥javabeans

サンプルの概要と実行手順を説明します。

(1)　JavaBeansリソースのサンプルプログラムの概要

JavaBeansリソースのサンプルプログラムの構成を次に示します。

図L‒32　JavaBeansリソースのサンプルプログラムの構成

このサンプルプログラムは，JavaBeansリソース属性ファイルのプロパティに指定された各設定情報に基づき，ブラウザにその値を表示します。

実行例を次に示します。

図L‒33　JavaBeansリソースのサンプルプログラムの実行例

(2)　JavaBeansリソースのサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，サンプルプログラムをコンパイルします。このバッチファイルで，JavaBeansリソース（MyJavaBean.jar）とEARファイル（LookupBean.ear）が作成されます。

(b)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(c)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(e)　JavaBeansリソースのインポート，開始

サンプルで提供するバッチファイル（deployJb.bat）を使用して，JavaBeansリソースをデプロイします。このバッチファイルでは，JavaBeansリソースのインポート，開始が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjimportjbコマンドが実行され，JavaBeansリソースがJ2EEサーバにインポートされます。使用されるJavaBeansリソース属性ファイルは「jb_resource.xml」です。

cjstartjbコマンドが実行され，JavaBeansリソースが開始されます。使用されるJavaBeansリソース表示名は「JavaBean_resource」です。

cjlistjbコマンドが実行され，J2EEサーバ上のJavaBeansリソースの状態が一覧表示されます。この一覧を確認することで，JavaBeansリソースが稼働状態（running）になっていることを確認できます。

(f)　アプリケーションのデプロイ

「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(g)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/<ContextRoot>/servlet/LookupBeanServlet

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは，次のURLを指定します。

http://localhost:8008/web_jb/servlet/LookupBeanServlet

(h)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(i)　JavaBeansリソースの停止

cjstopjbコマンドでJavaBeansリソースを停止します。

C:¥>cd Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin>cjstopjb MyServer -resname JavaBean_resource

(j)　J2EEサーバの再起動

cjstopsvコマンドでJ2EEサーバを終了し，cjstartsvコマンドでJ2EEサーバを起動します。J2EEサーバの終了方法については，「付録L.1(7)　J2EEサーバの終了」を参照してください。J2EEサーバの起動方法については，「付録L.1(3)　J2EEサーバの起動」を参照してください。

(k)　JavaBeansリソースの削除

cjdeletejbコマンドでJavaBeansリソースを削除します。

C:¥>cd Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥bin>cjdeletejb MyServer -resname JavaBean_resource

(l)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

付録L.6　ユーザログ機能のサンプルプログラム

ユーザログ機能の動作確認用のサンプルプログラムとして，userlogが提供されています。また，このサンプルプログラムを実行するためのソースファイルと定義ファイルのサンプルとして次の表に示すファイルが提供されています。

表L‒3　ユーザログ機能の動作確認用のサンプルプログラム

ファイル名

用途

UserLogServlet.java

ユーザログのサーブレットプログラムです。

UserLogHome.java

ホームインタフェースです。

UserLog.java

リモートインタフェースです。

AdderEJB.java

整数の合計を計算するEnterprise Beanの実装クラスです。

sample.properties

プロパティにセットするロガーのサンプルプロパティです。

MyFormatter.java

フォーマッタとして提供される独自クラスです。

MyFilter.java

フィルタとして提供される独自クラスです。

これらのファイルは，次の場所にあります。

<Application Serverのインストールディレクトリ>¥CC¥examples¥userlog

ユーザログ機能のサンプルプログラムの概要と実行手順を説明します。

(1)　ユーザログ機能のサンプルプログラムの概要

このサンプルプログラムでは，三つのタイプのログ出力を実行できます。

タイプ1：Sample for outputting messages from servlet

入力されたメッセージがサーブレット側から出力されます。

タイプ2：Sample for outputting the entered numbers and total value from AdderEJB

入力された整数の合計を計算する「AdderEJB（Enterprise Bean）」から，入力した値とその値を足した合計値がログファイルに出力されます。

タイプ3：Sample for outputting exception logs from the servlet

Exceptionが発生し，その内容がサーブレットからログファイルに出力されます。

サンプルプログラムでは，次の図に示す流れで処理が行われます。

図L‒34　ユーザログのサンプルプログラムの構造（サーブレット，Enterprise Bean）

［入力］画面で選択するロガー名およびログレベルによって，出力先のログファイルが異なります。

ロガー名「com.example.userlogger1」を選択した場合は，どのレベルを指定してもlogfileAに出力されます。

ロガー名「com.example.userlogger1」を選択して，ログレベルで「SEVERE」以上を指定した場合は，logfileAとlogfileBに出力されます。

ロガー名「com.example.userlogger2」を選択し，ログレベルで「INFO」以上を指定した場合，かつ「MyFilter」によってフィルタリングされなかった場合に，logfileCに出力されます。出力フォーマッタは「MyFormatter（独自クラス）」が使用されます。

MyFormatterの仕様

次の形式で出力します。

message：<入力されたメッセージ>　　　　LEVEL：<指定されたレベル>

MyFilterの仕様

メッセージの頭に「debug:」が付いているものは，ログに出力しません。

(2)　ユーザログ機能のサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(b)　サンプルファイルのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，ユーザログサンプルをコンパイルします。

コンパイルすると「myloglib.jar」というファイルが作成されます。これを任意のディレクトリに格納し，JARファイルにパスを通します。パスを通す方法については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「8.7.2　コンテナ拡張ライブラリを利用する方法」を参照してください。

(c)　プロパティ情報の設定

セットアップしたサーバにプロパティ情報を設定します。セットアップしたサーバのusrconf.propertiesの内容の一部を，サンプルで提供する設定ファイル（sample.properties）に書き換えます。Management Serverを利用してシステムを構築している場合は，マニュアル「アプリケーションサーバ機能解説 拡張編」の「8.8　J2EEアプリケーションのユーザログ出力の設定」を参照して設定してください。

セットアップしたサーバを「MyServer」としたときのusrconf.propertiesの格納場所と，usrconf.propertiesファイル内の書き換え位置を次に示します。

ファイルの場所

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥MyServer¥usrconf.properties

ファイルの書き換え位置

次に示す個所を，sample.propertyの内容に書き換えます。

     ：
# user-log handler settings
#ejbserver.application.userlog.CJLogHandler.<Specify handler-name>.path=user_log
#ejbserver.application.userlog.CJLogHandler.<Specify handler-name>.count=2
     ：
# user-log logger settings
#ejbserver.application.userlog.Logger.<Specify logger-name>.handlers=<Specify handler-class>
#ejbserver.application.userlog.Logger.<Specify logger-name>.useParentHandlers=true
     ：

サンプルで提供するsample.propertiesの内容を示します。

# user-log handler settings
#conf1 settings
ejbserver.application.userlog.CJLogHandler.conf1.path=userlog/logFileA
ejbserver.application.userlog.CJLogHandler.conf1.level=ALL
ejbserver.application.userlog.CJLogHandler.conf1.appname=userlog_app
ejbserver.application.userlog.CJLogHandler.conf1.formatter=com.hitachi.software.ejb.application.userlog.CJSimpleFormatter

#conf2 settings
ejbserver.application.userlog.CJLogHandler.conf2.path=userlog/logFileB
ejbserver.application.userlog.CJLogHandler.conf2.level=SEVERE
ejbserver.application.userlog.CJLogHandler.conf2.appname=userlog_app

#conf3 settings
ejbserver.application.userlog.CJLogHandler.conf3.path=userlog/logFileC
ejbserver.application.userlog.CJLogHandler.conf3.level=INFO
ejbserver.application.userlog.CJLogHandler.conf3.appname=userlog_app

# user-log logger settings
#logger1 settings
ejbserver.application.userlog.Logger.com.example.userlogger1.handlers=com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf1,com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf2
ejbserver.application.userlog.Logger.com.example.userlogger1.level=ALL

#logger2 settings
ejbserver.application.userlog.Logger.com.example.userlogger2.handlers=com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf3
ejbserver.application.userlog.Logger.com.example.userlogger2.level=INFO

ejbserver.application.userlog.loggers=com.example.userlogger1, com.example.userlogger2

NIO HTTPサーバの設定については「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(e)　アプリケーションのデプロイ

「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(f)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>：<ポート番号>/<ContextRoot>/userlog.html

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは次のURLを指定します。

http://localhost:8008/userlog/userlog_war/userlog.html

(g)　userlogの実行例

userlogの実行例を示します。アプリケーションを実行して，URLを指定すると，次に示す［実行サンプルタイプの選択］画面が表示されます。

図L‒35　［実行サンプルタイプの選択］画面（ユーザログのサンプルプログラム）

実行するサンプルのタイプを選択し，各データ入力フォームへ移ります。この画面以降の操作とログ出力例については，選択したタイプごとに説明します。

出力結果のログファイルは，セットアップしたサーバ名を「MyServer」とした場合，usrconf.propertiesに設定したファイル名で，次に示すディレクトリに出力されます。

<Application Serverのインストールディレクトリ>¥CC¥server¥public¥MyServer¥logs¥user¥userlog

タイプ1：outputting messageの実行例

［実行サンプルタイプの選択］画面で「Sample for outputting message from the servlet」タイプを選んだ場合の画面遷移とログファイルの出力例を示します。

タイプ選択後，表示された［入力］画面で次の値を入力します。

ロガー名：com.example.userlogger1

メッセージ：AAA

メッセージレベル：SEVERE（致命的）

次に，タイプ1を選択した場合の［入力］画面を示します。

図L‒36　［入力］画面（タイプ1：ユーザログのサンプルプログラム）

入力後，［send］ボタンをクリックすると，［入力結果表示］画面が表示されます。

図L‒37　［入力結果表示］画面（タイプ1：ユーザログのサンプルプログラム）

この例では，logfileAとlogfileBに出力されます。

logfileAの出力結果を示します。

0310 2005/01/21 20:37:53.296     userlog_app      00922804 01000BCF Msg_100               2005/01/21 20:37:53|UserLogServlet|doPost|致命的|AAA

logfileBの出力結果を示します。

0888 2005/01/21 19:41:03.609     userlog_app      00922804 009B6220 Msg_100               AAA

タイプ2：outputting the entered numbers and total valueの実行例

［実行サンプルタイプの選択］画面で「Sample for outputting the entered numbers and total value from AdderEJB」タイプを選んだ場合の画面遷移とログファイルの出力例を示します。

タイプ選択後，表示された［入力］画面で次の値を入力します。

ロガー名：com.example.userlogger1

入力数：10

次に，タイプ2を選択した場合の［入力］画面を示します。

図L‒38　［入力］画面（タイプ2：ユーザログのサンプルプログラム）

入力後，［send］ボタンをクリックすると，［入力結果表示］画面が表示されます。

図L‒39　［入力結果表示］画面（タイプ2：ユーザログのサンプルプログラム）

この例では，logfileAだけに出力されます。

logfileAの出力結果を示します。

0324 2005/01/21 20:38:59.500     userlog_app      00922804 015C998A Adder_200             2005/01/21 20:38:59|AdderEJB|add|情報|inputNumber = 10
0327 2005/01/21 20:38:59.500     userlog_app      00922804 015C998A Adder_201             2005/01/21 20:38:59|AdderEJB|getTotal|情報|total = 10

タイプ3：outputting exception logsの実行例

［実行サンプルタイプの選択］画面で「Sample for outputting exception logs from the servlet」タイプを選んだ場合の画面遷移とログファイルの出力例を示します。

タイプ選択後，表示された［入力］画面で次の値を入力します。

ロガー名：com.example.userlogger2

次に，タイプ3を選択した場合の［入力］画面を示します。

図L‒40　［入力］画面（タイプ3：ユーザログのサンプルプログラム）

入力後，［send］ボタンをクリックすると，［入力結果表示］画面が表示されます。

図L‒41　［入力結果表示］画面（タイプ3：ユーザログのサンプルプログラム）

この例では，logfileCだけに出力されます。

logfileCの出力結果を示します。

1077 2005/01/21 19:55:19.328     userlog_app      00922804 006458A6 Exp_300               message:Exception     LEVEL:SEVERE

(h)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(i)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

付録L.7　Webアプリケーションのサンプルプログラム

Webアプリケーションのサンプルプログラムは，次のディレクトリに格納されます。

<Application Serverのインストールディレクトリ>¥CC¥examples¥webapps

サンプルプログラムの概要と実行手順を示します。

(1)　Webアプリケーションのサンプルプログラムの概要

Webアプリケーションのサンプルとして，Servlet 2.5仕様に準じたサーブレットおよびJSPのサンプルプログラムを利用できます。ここでは，前提事項，サンプルプログラムの種類，およびサンプルプログラムの構成について説明します。

(a)　前提事項

Webアプリケーションのサンプルプログラムの前提事項を次に示します。

Webアプリケーションのバージョンは，Servlet 2.5であること。

J2EEサーバモードで実行すること。

また，Webアプリケーションのサンプルプログラムでは，JSTL 1.2を使用します。JSTL 1.2を使用するためには，usrconf.cfgにクラスパスを設定する必要があります。

(b)　サンプルプログラムの種類

提供するサンプルプログラムの種類を次に示します。

サーブレット

「Hello World」の表示

HTTPリクエスト情報の表示

HTTPヘッダの表示

HTTPリクエストのパラメタ表示

Cookie操作

HTTPセッションの操作

JSP

Expression Language※1

シンプルタグハンドラ，JSPフラグメント

タグファイル※1

XMLシンタックスのJSP※1※2

その他JSP2.0仕様の機能

JSP1.2仕様の機能

注※1

JSTLを使用するサンプルプログラムです。

注※2

このサンプルでは，実行結果としてSVG形式のデータを返します。SVG形式のデータをブラウザで表示するには，SVGに対応したブラウザが必要です。

(c)　サンプルプログラムの構成

Webアプリケーションのサンプルプログラムは，展開ディレクトリ形式のアプリケーションとしてそのまま使用できます。<Application Serverのインストールディレクトリ>¥CC¥examples¥webapps以下の構成を次に示します。

図L‒42　webappsディレクトリ以下の構成

以降に説明するWebアプリケーションのサンプルプログラムの実行手順では，<Application Serverのインストールディレクトリ>¥CC¥examplesの下にあるwebappディレクトリを，<webappsディレクトリ>と表記します。

(2)　Webアプリケーションのサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。この手順では，次の機能を使用します。

展開ディレクトリ形式のデプロイ

JSPの事前コンパイル

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，Webアプリケーションのサーブレット，フィルタ，リスナ，JavaBeansのJavaソースファイル，およびJSPファイルをコンパイルします。

なお，サーブレットやフィルタなどJavaソースファイルはjavacコマンドが使用され，JSPファイルのコンパイルには，cjjspcコマンドが使用されます。

(b)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(c)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(e)　ユーザ，ロールの登録

サンプルで提供するバッチファイル（setupUsers.bat）を使用して，ユーザおよびロールを登録します。このバッチファイルでは，J2EEサーバ名「MyServer」のJ2EEサーバに対し，ユーザの登録とロールの登録の処理が実行されます。

このバッチファイルで実行される処理の内容を示します。

cjaddsecコマンドが実行され，次のユーザが登録されます。

ユーザ１：ユーザ名「user1」，パスワード「passwd1」

ユーザ２：ユーザ名「user2」，パスワード「passwd2」

cjaddsecコマンドが実行され，ロール「role1」とロール「role2」が登録されます。

cjmapsecコマンドが実行され，次のマッピングが登録されます。

マッピング１：ロール「role1」とユーザ「user1」

マッピング２：ロール「role2」とユーザ「user2」

ここで登録したユーザ名とパスワードは，JSPのサンプルページの「Security」で使用します。

(f)　アプリケーションのデプロイ

「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(g)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定してWebアプリケーションのトップページにアクセスします。

http://<マシン名>/examples

ポート番号をカスタマイズしている場合は，<マシン名>のあとに，「:<ポート番号>」を指定してください。

J2EEサーバを起動したホストからアクセスする場合は，次のように指定します。

http://localhost/examples

アクセスに成功すると，次のようなトップ画面が表示されます。

図L‒43　Webアプリケーションのサンプルプログラムの実行例

(h)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(i)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

付録L.8　TP1インバウンド連携機能のサンプルプログラム

TP1インバウンド連携機能を使用するサンプルプログラムは，次のディレクトリに格納されます。

<Application Serverのインストールディレクトリ>¥CC¥examples¥tp1inbound

サンプルプログラムの概要と実行手順を説明します。

(1)　TP1インバウンド連携機能のサンプルプログラムの概要

TP1インバウンド連携機能のサンプルプログラムの構成を次に示します。

図L‒44　TP1インバウンド連携機能のサンプルプログラムの構成

このサンプルプログラムは，TP1/Server Baseが提供するBaseサンプルのC言語のSUPからRPC要求電文を受け付け，BaseサンプルのC言語のSPPと同等の処理を実行するMessage-driven Beanのプログラムです。BaseサンプルのC言語のSPPと同等の処理とは，RPC要求電文の受け付け時にMessage-driven Beanが実行され，実行結果がRPC応答電文としてC言語のSUPに返される処理を指します。Message-driven Beanの処理は，BaseサンプルのC言語のSPPと同様に顧客情報の取得や更新を実施します。

サンプルプログラムでは，メモリ上のテーブルに顧客情報を格納します。サンプルプログラムで使用するテーブル構成を「表L-4　サンプルプログラムで使用するテーブルの構成」に，テーブルの内容を「表L-5　サンプルプログラムで使用するテーブルの内容」に示します。

表L‒4　サンプルプログラムで使用するテーブルの構成

カラム

説明

name

名前

sex

性別

age

年齢

sale

販売額

表L‒5　サンプルプログラムで使用するテーブルの内容

name

sex

age

sale

Suzuki

M

30

1000000

Okada

F

23

1500000

Yoshida

F

26

800000

Saitoh

M

24

1000000

Itoh

M

35

1800000

Nishikawa

M

20

300000

Katoh

F

28

1000000

Satoh

F

27

2100000

Hasegawa

M

25

600000

Watanabe

M

31

1600000

(2)　TP1インバウンド連携機能のサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　TP1/Server BaseのBaseサンプルの設定

TP1/Server BaseのBaseサンプルに対して，次の設定を実施してください。

ユーザサービスネットワーク定義によるスケジューラダイレクトの設定

TP1インバウンドアダプタをユーザサービスネットワーク定義によるスケジューラダイレクト機能を使って呼び出すために，OpenTP1のユーザサービス定義，ユーザサービスネットワーク定義の定義を設定します。設定する内容について次に示します。

ユーザサービスネットワーク定義に，TP1インバウンドアダプタのサービスグループ名，ホスト名，およびポート番号を指定します。設定項目について次の表に示します。

表L‒6　ユーザサービスネットワーク定義の設定項目

設定項目

設定する内容

サービスグループ名

Baseサンプルで指定しているサービスグループ名「base_svg」を指定します。

ホスト名

アプリケーションサーバのホスト名を指定します。※

ポート番号

TP1インバウンドアダプタのConnector属性ファイルのscd_portプロパティで定義したポート番号を指定します。

注※　OpenTP1では，RPCの送信元と送信先のIPアドレスを比較し，同一マシンである場合はUNIXドメイン通信を，異なるマシンである場合はINETドメイン通信をします。TP1インバウンドアダプタでは，INETドメイン通信だけをサポートするため，OpenTP1とTP1インバウンドアダプタを同一のマシンで利用する場合は，IP alias機能によって割り振った送信元とは異なるIPアドレスをホスト名に指定する必要があります。

ユーザサービスネットワーク定義の例

dcsvgdef -g base_svg -h ホスト名[:ポート番号]

ユーザサービス定義のrpc_destination_modeにdefinitionを設定します。これによって，dc_rpc_call関数を呼び出す際に，ユーザサービスネットワーク定義の指定値から宛先を検索するようになります。

ユーザサービス定義の例

set rpc_destination_mode = definition

なお，詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

性能解析トレースの設定

TP1インバウンドアダプタでOpenTP1の性能解析トレースの情報を引き継ぐためには，システム共通定義に性能解析トレースの設定を実施する必要があります。設定内容について次の表に示します。

表L‒7　性能解析トレースの設定内容

設定内容

設定の目的

set prf_trace=Y

性能検証用トレース情報を取得するために設定します。

set rpc_prf_trace_level=00010001

OpenTP1のPRF情報をApplication Serverに伝播するために設定します。

システム共通定義については，マニュアル「OpenTP1 システム定義」を参照してください。

(b)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，サンプルプログラムをコンパイルします。このバッチファイルで，EARファイルが作成されます。

(c)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(d)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(e)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(f)　TP1インバウンドアダプタのインポート，設定，および開始

TP1インバウンドアダプタのインポートおよび設定方法については，「付録L.1(4)　リソースアダプタの設定」を参照してください。ただし，参照先の記述のうち，cjtestresコマンドを使用したリソースアダプタの接続テストは不要です。接続テストを実施するとメッセージKDJE48606-Eが発生します。TP1インバウンドアダプタの設定では，Connector属性ファイルのservice_groupプロパティにはのBaseサンプルで指定しているサービスグループ名「base_svg」を指定します。

(g)　アプリケーションのデプロイ

「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(h)　SUPの実行

TP1/Server Baseで提供しているBaseサンプルを参照してください。

(i)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(j)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

(3)　サンプルプログラムの注意事項

ここでは，サンプルプログラムを使用するときの注意事項について説明します。

TP1インバウンドアダプタ接続関連の設定について

このサンプルプログラムは，リソースとしてTP1インバウンドアダプタを使用するため，TP1インバウンドアダプタ接続に関する設定を適切に実施してください。

リソースのリンク解決について

TP1インバウンドアダプタのデフォルトの表示名を変更しなければ，リンク解決は不要です。TP1インバウンドアダプタのデフォルトの表示名を変更した場合は，リンク解決が必要になります。リンク解決の方法を次に示します。

1. サンプルで提供するcosminexus.xmlの<message-ref>にリソースの表示名を設定します。

設定方法については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「2.　アプリケーション属性ファイル（cosminexus.xml）」を参照してください。

2. アプリケーションをデプロイします。

サンプルプログラムを実行するプラットフォームについて

このサンプルプログラムは，エンディアンを意識したユーザデータの作成，取得は実施しません。このため，エンディアンが同一のプラットフォームでSUPを実行してください。エンディアンが異なるプラットフォームでSUPを実行すると，サンプルプログラムの「販売額」が不正な値となります。

付録L.9　JSFのサンプルプログラム

JSFを使用するサンプルプログラムは，次のディレクトリに格納されています。

<Application Serverのインストールディレクトリ>¥CC¥examples¥jsf

サンプルの概要と実行手順を説明します。

(1)　JSFのサンプルプログラムの概要

このサンプルプログラムでは，次の動作をするJSFのアプリケーションを提供しています。

文字列を入力してボタンをクリックすると，画面に入力した文字列が表示されます。

入力した文字列が15文字を超えている場合にボタンをクリックすると，画面に「Length is greater than allowable maximum of 15」が表示されます。

JSFのサンプルプログラムでは，JSFを使用します。JSFを使用するためには，usrconf.cfgにクラスパスを設定する必要があります。

JSFのサンプルプログラムの実行例を次の図に示します。

図L‒45　JSFのサンプルプログラムの実行例

サンプルプログラムの構成を次の図に示します。

図L‒46　JSFのサンプルプログラムの構成

(2)　JSFのサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(b)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(c)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(d)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，サンプルプログラムをコンパイルします。このバッチファイルで，WARファイル（helloworld.war）とEARファイル（helloworld.ear）が作成されます。

(e)　アプリケーションデプロイ

サンプルで提供するバッチファイル（deployApp.bat）を使用して，アプリケーションをデプロイします。「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(f)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定します。

http://<マシン名>:<ポート番号>/ helloworld/

J2EEサーバのNIO HTTPサーバに直接アクセスする場合，デフォルトでは次のURLを指定します。

http://localhost:8008/helloworld/

(g)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(h)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

付録L.10　Bean ValidationおよびCDI連携アプリケーションのサンプル

Bean ValidationおよびCDI連携アプリケーションを使用するサンプルプログラムは，次のディレクトリに格納されています。

<Application Serverのインストールディレクトリ>¥CC¥examples¥bv_cdi

サンプルの概要と実行手順を説明します。

(1)　Bean ValidationおよびCDI連携アプリケーションのサンプルプログラムの概要

このサンプルプログラムでは，Bean Validation，CDI，およびJSFを組み合わせたサンプルを提供しています。

Bean ValidationおよびCDIアプリケーションのサンプルでは，実行前に次に示す設定を実施する必要があります。

JSFを使用するためのusrconf.cfgへのクラスパスの設定

CDIを使用するためのserver.policyへのアクセス権の設定

server.policyについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.4　server.policy（J2EEサーバ用セキュリティポリシーファイル）」を参照してください。

<Application Serverのインストールディレクトリ>¥CC¥examples¥bv_cdi以下の構成を次に示します。

図L‒47　bv_cdiディレクトリ以下の構成

(2)　Bean ValidationおよびCDI連携アプリケーションのサンプルプログラムの実行手順

サンプルプログラムの実行手順を示します。

(a)　サンプルプログラムのコンパイル

サンプルで提供するバッチファイル（compile.bat）を使用して，サンプルプログラムをコンパイルします。このバッチファイルで，WARファイル（paramcheck.war）とEARファイル（paramcheck.ear）が作成されます。

(b)　J2EEサーバのセットアップ

「付録L.1(1)　J2EEサーバのセットアップ」を参照してください。

(c)　J2EEサーバのカスタマイズ

「付録L.1(2)　J2EEサーバのカスタマイズ」を参照してください。

(d)　J2EEサーバの起動

「付録L.1(3)　J2EEサーバの起動」を参照してください。

(e)　アプリケーションのデプロイ

「付録L.1(5)　アプリケーションのインポート，設定，および開始」を参照してください。

(f)　アプリケーションの実行

ブラウザを起動し，URLに次の文字列を指定して，アプリケーションを実行します。

http://<マシン名>:<ポート番号>/paramcheck/

ポート番号をカスタマイズしている場合は，カスタマイズした<ポート番号>を指定してください。

Bean ValidationおよびCDI連携アプリケーションのサンプルプログラムの実行例を次に示します。

図L‒48　CDI連携アプリケーションのサンプルプログラムの実行例

［Submit］ボタンをクリックすると，メッセージ出力個所に検証結果が表示されます。

出力されるメッセージの条件および出力メッセージを次の表に示します。

表L‒8　出力されるメッセージの条件および出力メッセージ

項番

条件

出力メッセージ※1

1

検証に成功した場合

Validation Successful!

2

Nameテキストボックスに16文字以上の文字列が入力されている場合※2

size must be between 0 and 15

The name must be no more than 15 characters.

3

Ageテキストボックスに0より小さい値が入力されている場合※2

must be greater than or equal to 0

The age is less than the minimum value. Enter a number from 0 through 120.

4

Ageテキストボックスに120より大きい値が入力されている場合※2

must be less than or equal to 120

The age exceeds the maximum value. Enter a number from 0 through 120.

5

Ageテキストボックスに数値に変換できない値が入力されている場合※2

For your age, enter a number (0 to 120).

6

検証処理で例外が発生した場合

Validation Failed.

注※1　検証に失敗した原因が複数ある場合は，それぞれのメッセージが連続して出力されます。

注※2　これらの条件で出力されるメッセージは，項番6の「検証処理で例外が発生した場合」は出力されません。

(g)　アプリケーションのアンデプロイ

「付録L.1(6)　アプリケーションの停止，削除」を参照してください。

(h)　J2EEサーバの終了

「付録L.1(7)　J2EEサーバの終了」を参照してください。

付録M　用語解説

マニュアルで使用する用語について

マニュアル「アプリケーションサーバ & BPM/ESB基盤 用語解説」を参照してください。

索引

A

accountの概要[1]

adderの概要[1]

AllTextパラメタでのhttpsd.confの直接設定[1]

Application Serverのディレクトリ構成[1]

B

bankの概要[1]

C

cartの概要[1]

checkerの概要[1]

CJMEMDUMP_PATH（Windowsの場合）[1]

CLIコマンド[1]

cmp20productの概要[1]

cmxdefcombinedmodel.xml[1]

Component Container管理者[1]

Component Container管理者を設定する（UNIXの場合）[1]

Component Container管理者を設定するときの注意事項（UNIXの場合）[1]

Component Containerのディレクトリ構成[1]

confirmerの概要[1]

Connector属性ファイルの取得と編集〔DB Connector以外の場合〕[1]

Connector属性ファイルの取得と編集〔DB Connectorの場合〕[1]

Cookieスイッチング機能[1]

D

DB Connector以外のリソースアダプタを設定する（CUI利用時）[1]

DB Connectorを設定する（CUI利用時）[1]

E

Eclipseでの操作[1]

enrollerの概要[1]

Enterprise Bean（EJB2.0）のサンプル実行手順[1]

Enterprise Bean（EJB2.0）のサンプルの概要[1]

Enterprise Bean（EJB2.0）のサンプルプログラム[1]

Enterprise Bean（Timer Service）のサンプルプログラム[1]

Enterprise Bean（アノテーション）のサンプルプログラム[1]

Enterprise Bean（アノテーション）のサンプルプログラムの実行手順[1]

Explicitヒープのメモリサイズの設定[1]

H

HTTP Server動作確認用URLの設定[1]

HTTP Serverの動作確認の設定[1]

J

J2EEアプリケーションのプロパティについて[1]

J2EEアプリケーションのメソッドタイムアウトの設定[1]

J2EEアプリケーションを実行するシステムの構成情報と簡易構築定義ファイルの定義との対応[1]

J2EEサーバの作業ディレクトリ[1]

J2EEサーバの作業ディレクトリの構成[1]

J2EEサーバを複数配置してマルチテナント対応するには[1]

J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステム[1]

J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムの構成例[1]

J2EEサーバを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否[1]

J2EEサーバを複数配置してマルチテナントに対応する[1]

JavaBeansリソースのサンプルプログラム[1]

JavaVMのメモリチューニング[1]

JavaVMのメモリチューニングを反映する[1]

JavaヒープおよびExplicitヒープのチューニング[1]

Javaヒープ全体のメモリサイズの設定[1]

JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項[1]

JP1/SC/DPMを使ったディスク複製インストール[1]

jsptagの概要[1]

jsptobeanの概要[1]

L

localadderの概要[1]

M

Management ServerがCTMドメインマネジャに自動で設定する内容[1]

Management ServerがCTMに自動で設定する内容[1]

Management ServerがJ2EEサーバに自動で設定する内容[1]

Management ServerがWebサーバに自動で設定する内容[1]

Management Serverが自動で生成するユーザ定義ファイル[1]

Management Serverが自動で設定する内容[1]

Management Serverが自動で設定する論理サーバの環境変数（UNIXの場合）[1]

Management Serverが自動で設定する論理サーバの環境変数（Windowsの場合）[1]

Management Serverがバッチサーバに自動で設定する内容[1]

Management Serverの動作環境の設定[1]

Management Serverのプロパティの設定[1]

Management Serverを起動する[1]

Management Serverを使用するために設定する情報[1]

Management Serverを停止する[1]

messageの概要[1]

Metaspace領域のメモリサイズの設定[1]

O

orderの概要[1]

OSの起動と同時に運用管理機能を自動起動するための設定[1]

P

productの概要[1]

S

salesrepの概要[1]

shipperの概要[1]

Smart Composer機能[1]

Smart Composer機能で実現する運用形態[1]

storagebinの概要[1]

T

tellerの概要[1]

TP1インバウンド連携機能のサンプルプログラム[1]

TZ（OS共通）[1]

U

URLグループ単位の同時実行数の設定[1]

W

warehouseの概要[1]

Webアプリケーションのサンプルプログラム[1]

WebコンテナまたはWebアプリケーション単位の同時実行数の設定[1]

Webサーバを別ホストに配置してマシン性能を向上するシステムの構築[1]

Webシステム間での負荷分散機の共有[1]

Webシステムの複製[1]

Windows〔注意事項〕[1]

X

XDM/RD E2の設定[1]

あ

アプリケーションサーバが提供するコマンドの使用[1]

アプリケーションサーバが提供する定義ファイルの更新[1]

アプリケーションサーバでサポートしているシンボリックリンク[1]

アプリケーションサーバの機能を有効にするための設定[1]

アプリケーションサーバの構築[1]

い

移行先の環境でのホストの準備[1]

移行先のシステム環境の構築[1]

移行時に使用する構成・定義情報の内容[1]

入れ替え後のJ2EEアプリケーションの開始[1]

入れ替え後のJ2EEアプリケーションの設定[1]

入れ替え前のJ2EEアプリケーションの削除[1]

入れ替え前のJ2EEアプリケーションの停止[1]

インストール後のディレクトリ構成[1]

う

運用[1]

運用管理エージェントによる論理サーバの監視に関する設定[1]

運用管理エージェントのプロパティの設定[1]

運用管理エージェントを起動する[1]

運用管理エージェントを使用するために設定する情報[1]

運用管理エージェントを停止する[1]

運用管理機能の管理ユーザアカウントの設定を変更する[1]

運用管理機能のツール[1]

運用管理機能の停止[1]

運用管理機能を構築する[1]

運用管理ドメイン内の論理サーバの稼働状況の確認[1]

運用管理ポータル[1]

運用管理ポータルで実現する運用形態[1]

運用管理ポータルの操作で失敗したときの対処方法[1]

か

カスタムセットアップ[1]

可用性を確保したWebフロントシステム[1]

可用性を確保したWebフロントシステムの構成例[1]

可用性を確保したWebフロントシステムの構築時に実施する作業と作業の要否[1]

簡易構築定義ファイル[1]

簡易構築定義ファイルの構成[1]

簡易構築定義ファイルの作成例[1]

簡易構築定義ファイルを設定する[1]

簡易構築定義ファイルを設定するときの注意事項（J2EEアプリケーション使用時）[1]

簡易構築定義ファイルを設定するときの注意事項（バッチアプリケーション使用時）[1]

環境構築／運用時の注意事項[1]

環境変数[1]

管理者特権で実行する必要がある操作[1]

管理ユーザアカウントの設定変更[1]

管理ユーザアカウントを設定しない場合の設定[1]

き

業務アプリケーションとの関連づけの設定[1]

業務アプリケーションの開始（GUI利用時）[1]

業務アプリケーションの設定（GUI利用時）[1]

業務アプリケーションの設定を変更する（CUI利用時）[1]

業務アプリケーションを入れ替える[1]

業務アプリケーションを設定して開始する（CUI利用時）[1]

業務アプリケーションを設定して開始する（GUI利用時）[1]

こ

更新インストール[1]

構成変更定義ファイルの作成[1]

構成・定義情報の出力[1]

構成・定義情報を出力してシステムを移行するときの注意事項[1]

構築[1]

コンフィグレーション定義で使用するタグと適用範囲[1]

さ

サーバ管理コマンド実行時に設定する情報[1]

サーバ管理コマンドによるサンプル実行環境の構築，運用手順[1]

サーバ管理コマンドを使用する操作[1]

サービスユニットの削除[1]

サービスユニットの追加[1]

サービスユニットの停止[1]

作業ディレクトリに関する注意事項[1]

作業ディレクトリのパス長の見積もり式〔J2EEサーバ〕[1]

作業ディレクトリのパス長の見積もり式〔バッチサーバ〕[1]

削除対象のシステム環境の内容確認[1]

サンプルプログラム一覧（Enterprise Beanの種類と動作内容）[1]

サンプルプログラムで使用するJMSの設定[1]

サンプルプログラムで使用するデータベースの設定[1]

サンプルプログラムで使用するメールの設定[1]

サンプルプログラムのクライアントの種類[1]

サンプルプログラムの使用[1]

し

システム環境定義（簡易構築定義ファイルのパラメタ）を変更する（CUI利用時）[1]

システム環境定義の設定[1]

システム環境のセットアップ[1]

システム環境をアンセットアップする[1]

システム環境を構築する[1]

システム環境を削除する[1]

システム環境をスケールアウトする（CUI利用時）[1]

システム環境をスケールインする（CUI利用時）[1]

システム環境をセットアップする[1]

システム環境をセットアップするときの注意事項[1]

システム構築の概要[1]

システムの運用[1]

システムの稼働状況を確認する（GUI利用時）[1]

システムの環境変数を設定する[1]

システムの構成・定義情報[1]

システムの構成・定義情報を取得する[1]

システムの構築[1]

システムの構築・運用時に使用する画面[1]

システムの構築・運用時に使用するコマンド[1]

システムの構築・運用時に使用するファイル[1]

システムの情報モデルの変更[1]

システムの設定変更[1]

システムを一括構築するときの注意事項（負荷分散機制御をする場合）[1]

システムを起動して業務を開始する（GUI利用時）[1]

システムを起動する（CUI利用時）[1]

システムを停止する（CUI利用時）[1]

システムを停止する（GUI利用時）[1]

障害運用[1]

新規インストール[1]

す

スケールアウト[1]

スケールイン[1]

せ

接続方法にAPIを使用するときの注意事項[1]

セットアップウィザード[1]

セットアップウィザードで使用するファイルの一覧[1]

セットアップウィザードで設定されるパラメタ[1]

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理J2EEサーバ）[1]

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理Webサーバ）[1]

セットアップウィザードでパラメタの省略値と異なる値が設定されるパラメタ（論理パフォーマンストレーサ）[1]

セットアップウィザードの起動[1]

た

タイムアウトの設定[1]

タイムアウトを設定する[1]

単一のWebフロントシステム[1]

単一のWebフロントシステムの構成例[1]

単一のWebフロントシステムの構築時に実施する作業と作業の要否[1]

単一のWebフロントシステムを構築する[1]

単一のWebフロントシステムを構築するには[1]

つ

通常運用[1]

て

データベースサーバの構築[1]

データベース接続環境を設定する（HiRDBの設定）[1]

データベース接続環境を設定する（Oracleの設定）[1]

データベース接続環境を設定する（SQL Serverの設定）[1]

データベース接続環境を変更する[1]

データベースの環境を設定する（Oracleの設定）[1]

データベースを準備する[1]

と

同一構成のホストを複数配置して可用性を確保したWebフロントシステム[1]

同一構成のホストを複数配置して可用性を確保したWebフロントシステムの構成例[1]

同一構成のホストを複数配置して可用性を確保したWebフロントシステムの構築時に実施する作業と作業の要否[1]

同一構成のホストを複数配置して可用性を確保する[1]

同一構成のホストを複数配置して可用性を確保するには[1]

同一構成のホストを複数配置するときの注意事項[1]

動作確認用HTTPメソッドの設定[1]

同時実行数の最適化[1]

同時実行数を最適化するためのチューニングを反映する[1]

トランザクションのトランザクションタイムアウト時間のデフォルトの設定[1]

は

バッチアプリケーションのスケジューリング機能を使用するための設定[1]

バッチアプリケーションを実行するシステムを運用するときの注意事項[1]

バッチサーバで使用しない定義[1]

バッチサーバとして動作するための設定[1]

バッチサーバの作業ディレクトリ[1]

バッチサーバの作業ディレクトリの構成[1]

バッチサーバを複数配置するときの注意事項[1]

パフォーマンスチューニング[1]

ひ

標準セットアップ[1]

ふ

負荷分散機[1]、[2]

負荷分散機のAPI[1]

負荷分散機のCLIコマンド[1]

負荷分散機の冗長化[1]

負荷分散機の制御方法[1]

負荷分散機へ接続する環境を設定する[1]

負荷分散機への接続の設定[1]

負荷分散機を共有するときの注意事項[1]

負荷分散機を準備する[1]

負荷分散機を冗長化するときの注意事項[1]

負荷分散機を制御するときの注意事項[1]

複製情報の出力[1]

複製情報を使ったセットアップ[1]

プログラムのインストール[1]

ほ

保守運用[1]

ホスト内の論理サーバの稼働状況の確認[1]

ま

マルチテナント対応するWebフロントシステム〔リソースアダプタの複数配置〕[1]

マルチテナントに対応したWebフロントシステムの構成例〔J2EEサーバの複数配置〕[1]

マルチテナントに対応したWebフロントシステムの構成例〔リソースアダプタの複数配置〕[1]

マルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否〔J2EEサーバの複数配置〕[1]

マルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否〔リソースアダプタの複数配置〕[1]

マルチテナントに対応したWebフロントシステム〔J2EEサーバの複数配置〕[1]

ゆ

ユーザログ機能のサンプルプログラム[1]

り

リクエストで使用する場合の注意事項[1]

リソースアダプタの接続テスト〔DB Connector以外の場合〕[1]

リソースアダプタの接続テスト〔DB Connectorの場合〕[1]

リソースアダプタの設定（データベースの接続環境）を変更する（CUI利用時）[1]

リソースアダプタの設定〔DB Connector以外の場合〕[1]

リソースアダプタの設定〔DB Connectorの場合〕[1]

リソースアダプタの追加[1]

リソースアダプタのプロパティの設定変更[1]

リソースアダプタまたは業務アプリケーションを操作するときの確認事項（CUI利用時）[1]

リソースアダプタを開始する（CUI利用時）[1]

リソースアダプタを複数配置してマルチテナント対応するWebフロントシステム[1]

リソースアダプタを複数配置してマルチテナント対応するには[1]

リソースアダプタを複数配置してマルチテナントに対応したWebフロントシステムの構成例[1]

リソースアダプタを複数配置してマルチテナントに対応したWebフロントシステムの構築時に実施する作業と作業の要否[1]

リソースアダプタを複数配置してマルチテナントに対応する[1]

リモートインストール[1]

れ

レスポンスタイムアウトおよびリクエスト間隔タイムアウトの設定（HiRDBの場合）[1]

レスポンスデータ待ちの通信タイムアウトの設定[1]

ろ

論理サーバ（Webサーバ，J2EEサーバおよびパフォーマンストレーサ）の追加[1]

論理サーバごとの稼働状況の確認[1]

論理サーバの環境のアンセットアップ[1]

論理サーバの環境変数を設定する[1]

論理サーバの環境変数を設定するときの確認事項[1]

論理サーバの起動[1]

論理サーバのコンフィグレーション定義時に使用する簡易構築定義ファイルの主なタグ[1]

論理サーバのコンフィグレーション定義の適用範囲〔J2EEアプリケーションを実行するシステム〕[1]

論理サーバの停止[1]

論理サーバの動作確認間隔の設定[1]

論理サーバの動作確認タイムアウトの設定[1]

論理サーバの動作確認の開始時間の設定[1]

論理サーバの動作確認リトライの設定[1]

論理サーバの動作確認レベルの設定[1]