Cosminexus V11 アプリケーションサーバ ファーストステップガイド

入門書

3021-3-J00-80

前書き

対象製品

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

輸出時の注意

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

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

商標類

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

AMDは，Advanced Micro Devices, Inc.の商標です。

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

Intelは，Intel Corporation またはその子会社の商標です。

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

Microsoft，Internet Explorer，Microsoft Edge，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/).

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

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

発行

2026年 1月 3021-3-J00-80

著作権

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

変更内容

変更内容(3021-3-J00-80) uCosminexus Application Server 11-70，uCosminexus Client 11-70，uCosminexus Developer 11-70，uCosminexus Service Architect 11-70，uCosminexus Service Platform 11-70

追加・変更内容

変更個所

JDK21サポートに関する記述を追加した。

2.2.2

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

はじめに

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

1　このマニュアルの見方

この章では，このマニュアルで体験できる内容，およびこのマニュアルの読み方について説明します。

1.1　このマニュアルで体験できること

このマニュアルは，実際にマシンを操作しながら，アプリケーションサーバの環境構築からサンプル実行までの一とおりの操作を体験するためのマニュアルです。

実際の業務で使用する環境（本番稼働用の環境）は，このマニュアルでは構築できません。本番稼働用の環境を構築する際は，使用する機能やシステム構成について，あらかじめ検討する必要があります。

本番稼働用の環境の構築については，次のマニュアルを参照してください。

本番稼働用の開発環境を構築したい場合

マニュアル「アプリケーションサーバ アプリケーション開発ガイド」

本番稼働用の実行環境を構築したい場合

マニュアル「アプリケーションサーバ システム構築・運用ガイド」

このマニュアルで体験できる内容について説明します。

1.1.1　開発環境を構築してサンプルを実行できる（2章）

開発環境では，Eclipseを使用してJ2EEアプリケーションを開発します。

このマニュアルでは，Eclipseを使用できる環境の構築から，デバッグ時のEclipseの操作までを説明します。手順どおりに操作を進めることで，開発環境の構築，およびサンプルプロジェクト（Bank）を使用したEclipseのデバッグ操作を体験できます。サンプルプロジェクト（Bank）は，Webブラウザから入力されたユーザIDを持つユーザの資金を当座預金口座から普通預金口座へ移動させるサンプルです。

注意事項

このマニュアルで構築する環境は，デフォルトの値が設定された環境になります。環境をカスタマイズしたい場合は，マニュアル「アプリケーションサーバ アプリケーション開発ガイド」を参照して開発環境を構築してください。

1.1.2　実行環境を構築してサンプルを実行できる（3章）

アプリケーションサーバの実行環境は，セットアップウィザードや運用管理ポータルなどの構築機能を使用して構築します。

このマニュアルでは，セットアップウィザードおよび運用管理ポータルを使用した環境構築手順，およびサンプルプログラム（jsptag）の実行手順について説明します。手順どおりに操作を進めることで，実行環境の構築とアプリケーション開始までの一連の作業を体験できます。サンプルプログラム（jsptag）は，JSPとStateless Session Beanで構成されるJ2EEアプリケーションです。

このサンプルプログラムを実行すると，次の内容がWebブラウザ上に表示されます。

通貨の値をドルから円に換算した結果

通貨の値を円からユーロに換算した結果

注意事項

このマニュアルで構築する環境は，デフォルトの値が設定された環境になります。このため，使用する機能やシステム構成によっては，このマニュアルとは異なる手順で環境を構築する必要があります。デフォルトの値ではない設定で環境を構築したい場合は，マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

1.2　マニュアルの記載に関する留意事項

このマニュアルを読むときは，次のことに留意してください。

コマンドプロンプトの起動方法について

このマニュアルでは，Windowsを使用する場合，コマンドプロンプトを使用してコマンドを実行します。

コマンドプロンプトの起動方法については，OSのドキュメントを参照してください。

Eclipseに関するサポートについて

このマニュアルの2章では，Developerが提供する機能を使ってEclipse環境を構築します。Developerが提供するEclipseのプラグイン機能以外のEclipseに関するサポートはしていません。Eclipseの使用方法やEclipseが表示するエラーの対処方法については，ユーザで調査，対処してください。

ランゲージパックの使用について

このマニュアルの2章では，Eclipse Babel Projectが提供するBABEL日本語ランゲージパックを適用したEclipseメニュー表記を使用しています。使用するランゲージパックのバージョンによっては，マニュアル内の表記と異なる場合があります。

インストールディレクトリについて

アプリケーションサーバのインストールディレクトリについて次に示します。

Windowsの場合

Application ServerおよびDeveloperのデフォルトのインストールディレクトリは，「<システムドライブ>:¥Program Files¥Hitachi¥Cosminexus」です。環境に合わせて別のディレクトリにインストールする場合には，このマニュアルに記載されている「<Application Serverのインストールディレクトリ>」または「<Developerのインストールディレクトリ>」をご利用のディレクトリに読み替えてください。

なお，<Application Serverのインストールディレクトリ>は，「%COSMINEXUS_HOME%」と指定することもできます。「%COSMINEXUS_HOME%」は，製品のインストーラが設定する環境変数です。

UNIXの場合

Application Serverのインストールディレクトリは，/opt/Cosminexus/です。

Windowsのメニュー名の表記について

Windowsのメニュー名の表記は，使用するWindowsのバージョンによって異なります。ご使用のOSに合わせて読み替えて操作してください。

2　開発環境を構築してサンプルを実行してみよう

この章では，開発環境およびデバッグ環境を構築して，Developerが提供するサンプルプロジェクト（Bank）を実行する手順を説明します。

2.1　開発環境でサンプルを実行する流れ

この章では，開発環境インスタントセットアップ機能を使用してデバッグ環境を構築し，サンプルプロジェクト（Bank）を実行する手順について説明します。

Developerが提供する開発環境インスタントセットアップ機能を使用すれば，サンプルプログラムを動かす環境を簡単に構築できます。

この章で構築する開発環境とサンプルプロジェクト（Bank）について，次の図に示します。

図2‒1　開発環境インスタントセットアップ機能で構築するシステムとサンプルプロジェクト（Bank）

サンプルプロジェクト（Bank）を使用することで，Eclipseが提供する開発支援機能のデバッグ操作，組み込みデータベースの構築および接続のチュートリアルを体験できます。このため，Eclipseによるデータベースを使用したJ2EEアプリケーション開発手順の理解を深めることもできます。なお，組み込みデータベースの用途は開発時の利用に限定されているため，本番環境で利用することはできません。

環境の構築とサンプルプロジェクト（Bank）の実行の手順は，次のとおりです。

図2‒2　環境構築からサンプルプロジェクト（Bank）実行までの流れ

各作業の概要

環境変数を設定してDeveloperをインストールします

必要な環境変数を設定して， Developerをインストールします。詳細については，「2.2　環境変数を設定してDeveloperをインストールします」を参照してください。

デバッグ環境を構築します

開発環境インスタントセットアップ機能を使用して，デバッグ環境を構築します。詳細については，「2.3　デバッグ環境を構築します」を参照してください。

Eclipseを準備します

開発環境で使用するEclipseをインストールするための準備をします。詳細については，「2.4　Eclipseを準備します」を参照してください。

Eclipseをセットアップします

Eclipse環境をセットアップします。詳細については，「2.5　Eclipseをセットアップします」を参照してください。

Eclipseで使用するJDKを確認します

Eclipseで使用するJDKが指定されていることを確認します。詳細については，「2.6　Eclipseで使用するJDKを確認します」を参照してください。

データベースを開始します

開発環境インスタントセットアップ機能で構築した組み込みデータベースを開始します。

なお，開発環境インスタントセットアップ機能でデバッグ環境を構築した直後は，組み込みデータベースは自動的に開始されているため，この操作は不要です。詳細については，「2.7　データベースを開始します」を参照してください。

サンプルプロジェクト（Bank）を実行します

構築した環境を使用して，サンプルプロジェクト（Bank）を実行します。詳細については，「2.8　サンプルプロジェクト（Bank）を実行します」を参照してください。

以降では，サンプルプロジェクト（Bank）を実行するために必要な作業を手順どおりに説明します。

2.2　環境変数を設定してDeveloperをインストールします

Developerを使用するための環境変数の設定，およびDeveloperのインストール手順について説明します。

2.2.1　環境変数を設定します

まず，Developerを使用するための環境変数を設定します。

注意事項

ここでは，Windows 10を使用した場合の手順を示します。Windows 10以外のOSを使用する場合は，各OSの環境変数設定方法に従ってください。

操作手順

Windowsのスタートメニューから［Windows システムツール］−［コントロールパネル］−［システム］−［システムの詳細設定］を選択します。

［システムのプロパティ］ダイアログが表示されます。

［詳細設定］タブの［環境変数］ボタンをクリックします。

［環境変数］ダイアログが表示されます。

［システム環境変数］の枠の中に変数「TZ」がある場合は，変数「TZ」を選択して［編集］ボタンをクリックします。変数「TZ」がない場合は［新規］ボタンをクリックします。

システム環境変数を編集または追加するためのダイアログが表示されます。

次の値を設定します。

変数名

変数値

TZ

JST-9

日本で使用する場合は，タイムゾーン（TZ）にJST-9を指定してください。

環境変数「TZ」がすでにある場合で，「JST-9」が設定されていないときは，設定する変数名を選択して［編集］ボタンをクリックします。表示されたダイアログで，環境変数の値を追加・変更してください。

環境変数「TZ」がない場合は，［新規］ボタンをクリックします。表示されたダイアログで，環境変数および値を追加してください。

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

システム環境変数を編集または追加するためのダイアログが閉じます。

［システム環境変数］の枠の中に変数「Path」がある場合は，変数「Path」を選択して［編集］ボタンをクリックします。変数「Path」がない場合は［新規］ボタンをクリックします。

システム環境変数を編集または追加するためのダイアログが表示されます。

次の値を設定します。

変数「Path」を編集する場合は，次の値を先頭に追加します。「<Developerのインストールディレクトリ>」は実際のディレクトリに置き換えてください。

変数名

変数値

Path

<Developerのインストールディレクトリ>¥jdk¥bin

環境変数「Path」がすでにある場合は，設定する変数名を選択して［編集］ボタンをクリックします。表示されたダイアログで，環境変数の値を先頭に追加してください。「<Developerのインストールディレクトリ>」は実際のディレクトリに置き換えてください。

環境変数「Path」がない場合は，［新規］ボタンをクリックします。表示されたダイアログで，環境変数および値を追加してください。

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

システム環境変数を編集または追加するためのダイアログが閉じます。

［環境変数］ダイアログの［OK］ボタンをクリックします。

［環境変数］ダイアログが閉じます。

［システムのプロパティ］ダイアログの［OK］ボタンをクリックします。

［システムのプロパティ］ダイアログが閉じて環境変数の設定が完了します。

これで，Developerを使用するための環境変数の設定は完了です。

2.2.2　Developerをインストールします

次の手順に従って，Developerをインストールします。

注意事項

Developerをインストールする前に，すべてのWindowsアプリケーションを終了させておいてください。

操作手順

インストールCD-ROMを，CD-ROMドライブにセットします。

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

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

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

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

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

［uCosminexus Developerセットアッププログラムへようこそ］ページが表示されます。

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

［インストール先の選択］ページが表示されます。

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

［機能の選択］ページが表示されます。

注意事項

インストール先ディレクトリには，次のパスを指定しないでください。

ネットワークドライブ

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

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

半角50文字を超えるパス

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

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

ポイント

インストール先ディレクトリは，50バイト以内になるように指定してください。

「2.3　デバッグ環境を構築します」以降の手順を実行するためには，次の条件を満たす必要があります。

<Developerのインストールディレクトリ>¥ADP¥DBのパスのうち，<Developerのインストールディレクトリ>の長さが50バイト以内となること。

ADPディレクトリおよびDBディレクトリは，インストール時にDeveloperによって自動的に作成されるディレクトリです。

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

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

ポイント

Javaの開発環境は，次の3種類から選択できます。

Java SE 21に準拠したJava開発環境であるJDK 21

Java SE 17に準拠したJava開発環境であるJDK 17

Java SE 11に準拠したJava開発環境であるJDK 11

選択したJavaバージョンのCosminexus Developer's Kit for Java (TM)がインストールされます。

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

［ユーザ情報］ページが表示されます。

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

注意事項

［ユーザ名］および［会社名］にスラッシュ（/），セミコロン（;），ダブルクォーテーション（"）を含めることはできません。

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

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

［インストールの開始］ページが表示されます。

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

インストールが開始されます。インストールが完了すると，［セットアップの完了］ダイアログが表示されます。インストールには数分掛かる場合があります。

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

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

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

OSが再起動し，Developerのインストールが完了します。

これで，Developerはインストールされました。

2.3　デバッグ環境を構築します

開発環境インスタントセットアップ機能を使用してデバッグ環境を構築します。

注意事項

管理者特権で開発環境インスタントセットアップ機能を起動してください。

操作手順

Windowsスタートメニューの［Cosminexus］−［デバッグ環境セットアップ］を選択します※。

［セットアップ - 開発環境インスタントセットアップ］ダイアログの［セットアップの種類の選択］ページが表示されます。

注※

対象OSのスタートメニューの表示仕様によっては，［Cosminexus］−［環境構築］−［デバッグ環境セットアップ］と表示される場合があります。

［標準］を選択して，［次へ］ボタンをクリックします。

［組み込みデータベースユーザの設定］ページが表示されます。

ポイント

［標準］が選択できない場合は，次の要因が考えられます。

必要なファイルまたはディレクトリがない，またはパスの長さが長過ぎる。

開発環境インスタントセットアップ機能で設定するポート番号が，システム内で使用しているポート番号と重複している。

ポート番号が重複している場合は，［カスタム］を選択して重複しないポート番号を選択してください。

詳細については，マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「2.3.3　セットアップする環境の設定内容」および「2.3.4　デバッグ環境の標準セットアップ」を参照してください。

注意事項

開発環境とデバッグ環境を異なるマシンに構築する場合，開発環境にインストールするJDKのバージョンは，デバッグ環境のJDKのバージョンに合わせてください。

JDKのバージョンを変更する場合，アプリケーションサーバをアンインストールしてから再インストールしてください。

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

［セットアップの確認］ページが表示されます。

［セットアップの内容］エリアにセットアップされる内容が表示されます。標準セットアップで構築される環境の設定内容の詳細は，マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「2.3.3　セットアップする環境の設定内容」を参照してください。

なお，組み込みデータベースのパスワードは，設定した値に関係なく8文字の「*（アスタリスク）」で表示されます。

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

［進行状況］ページが表示され，セットアップが実行されます。セットアップには数分掛かる場合があります。セットアップが終了すると，［セットアップの完了］ページが表示されます。

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

［セットアップ - 開発環境インスタントセットアップ］ダイアログが終了します。

これで，デバッグ環境を構築できました。

2.4　Eclipseを準備します

Eclipseを使用するための環境を準備します。次の手順に従って，Eclipseのアーカイブファイルを準備します。

操作手順

Eclipseのアーカイブファイルを入手します。

Developerに同梱されている添付品またはEclipse.orgのダウンロードサイトからサポートしているバージョンを入手してください。

入手したEclipseのアーカイブファイルを次のディレクトリへ格納します。

<Developerのインストールディレクトリ>¥ADP¥Archives

これで，Eclipseをインストールする準備ができました。

注意事項

サポートするEclipseのバージョンは，DeveloperでインストールしたJDKのバージョンによって異なります。

参考

添付品のEclipseランゲージパックをEclipseのアーカイブファイルと同じディレクトリに格納すると，Eclipseセットアップ時にEclipseを日本語化できます。

2.5　Eclipseをセットアップします

Eclipseセットアップ機能を使用してEclipse環境を構築します。

注意事項

管理者特権でEclipseセットアップ機能を起動してください。

操作手順

Windows のスタートメニューから，［Cosminexus］−［Eclipseセットアップ］を選択します※。

Eclipseのアーカイブファイルを準備したかどうかを確認するダイアログが表示されます。

注※

対象OSのスタートメニューの表示仕様によっては，［Cosminexus］−［環境構築］−［Eclipseセットアップ］と表示される場合があります。

確認ダイアログで，［了解］ボタンをクリックします。

［Eclipseのインストール］ページが表示されます。

［Eclipseのインストール］ページで，Eclipseのインストールディレクトリおよびアーカイブファイルディレクトリを指定して，［次へ］ボタンをクリックします。

［セットアップの確認］ページが表示されます。

［セットアップの確認］ページでセットアップ内容を確認して，［実行］ボタンをクリックします。

［進行状況］ページが表示され，セットアップが実行されます。セットアップが完了すると［セットアップの完了］ページが表示されます。

Eclipseセットアップは数分掛かる場合があります。

［セットアップの完了］ページで，［終了］ボタンをクリックします。

［セットアップ − Eclipseセットアップ］ダイアログが閉じて，Eclipseのセットアップが完了します。

デスクトップにEclipseのショートカットが生成されます。

これで，Eclipse環境が構築できました。

2.6　Eclipseで使用するJDKを確認します

Eclipseで使用するJDKとして，Developerで提供されているJDKが設定されているかどうかを確認します。

操作手順

デスクトップにあるEclipseのショートカットを右クリックします。

［管理者として実行］を選択します。

Eclipseが起動します。なお，この際，ワークスペース・ディレクトリの設定画面が表示されます。

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

左ペインで［Java］−［インストール済みの JRE］を選択します。

右ペインに［インストール済みの JRE］ページが表示されます。

リストに表示されているJDKがDeveloperで提供されているJDKかどうかを確認します。

［ロケーション］に次のパスが表示されているかどうかを確認してください。

<Developerのインストールディレクトリ>¥jdk

パスが表示されている場合と表示されていない場合の対処について説明します。

パスが表示されている場合

［名前］のチェックボックスがチェックされているかどうかを確認します。チェックされていない場合はチェックしてください。

パスが表示されていない場合

［追加］ボタンをクリックして，上記のパスを設定します。パスの設定後，［名前］のチェックボックスにチェックします。

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

設定が保存されます。

これで，Eclipseで使用するJDKの設定の確認ができました。

2.7　データベースを開始します

サンプルプロジェクト（Bank）では，開発環境インスタントセットアップ機能で構築した組み込みデータベースを使用します。なお，開発環境インスタントセットアップ機能でデバッグ環境を構築した直後は，組み込みデータベースは自動的に開始されているため，データベースを開始する操作は不要です。

組み込みデータベースが停止しているときは，次に示す組み込みデータベースを開始する操作をしてください。

注意事項

組み込みデータベースの開始または停止は，管理者権限（Administratorsグループ）を持つユーザで開始または停止してください。

操作手順

Windowsの［スタート］メニューから，［HiRDBSingleServer _CS0］−［HiRDBコマンドプロンプト］を選択します。

表示されたコマンドプロンプトでpdstartを実行します。

組み込みデータベースが開始されます。

2.8　サンプルプロジェクト（Bank）を実行します

構築したデバッグ環境で，サンプルプロジェクト（Bank）を実行します。

2.8.1　Eclipseを起動します

Eclipseを起動します。

操作手順

デスクトップにあるEclipseのショートカットを右クリックします。

［管理者として実行］を選択します。

Eclipseが起動します。

2.8.2　サーバランタイムを作成します

EclipseでJ2EEサーバを使用するためにサーバランタイムを作成します。

なお，Eclipseを起動した際，［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている場合，作業は不要です。

図2‒3　［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている例

操作手順

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

［設定］ダイアログで，［サーバー］−［ランタイム環境］を選択します。

［サーバー・ランタイム環境］ページが表示されます。

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

［新規サーバー・ランタイム］ダイアログが表示されます。

［新規サーバー・ランタイム］ページで，［Cosminexus］−［Cosminexus J2EE］を選択し，［終了］ボタンをクリックします。

EclipseでJ2EEサーバを操作するためのサーバランタイムが作成されます。

［設定］ダイアログで，［OK］ボタンをクリックします。

設定が保存されます。

これで，J2EEサーバを使用するための設定ができました。

2.8.3　J2EEサーバの作成

Eclipseで操作するJ2EEサーバを作成します。

なお，Eclipseを起動した際，［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている場合，作業は不要です。

操作手順

Eclipseのメニューから［ファイル］−［新規］−［その他］を選択します。

［新規］ダイアログで，［サーバー］−［サーバー］を選択し，［次へ］ボタンをクリックします。

［新規サーバー］ダイアログの［新規サーバーの定義］ページが表示されます。

［新規サーバー］ダイアログで，［Cosminexus］−［J2EE サーバー］を選択し，［次へ］ボタンをクリックします。

［J2EE サーバー］ページが表示されます。

［J2EE サーバー］ページで，［リモート管理機能］の［接続ホスト］に［localhost］を選択します。ログインしていない場合は，［ログイン］ボタンをクリックしてログインします。

Management Serverリモート管理機能に接続され，サーバのリストに接続先のJ2EEサーバが表示されます。

［J2EE サーバー］ページのサーバのリストで［InstantJ2EEServer］をチェックして，［終了］ボタンをクリックします。

J2EEサーバが作成されます。

2.8.4　サンプルプロジェクト（Bank）をインポートします

サンプルプロジェクト（Bank）をEclipseのワークスペースにインポートします。

操作手順

Eclipseのメニューから［ファイル］−［インポート］を選択します。

［インポート］ダイアログが表示されます。

［インポート］ダイアログの［インポート・ソースの選択］で，［General］−［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。

［プロジェクトのインポート］ページが表示されます。

［アーカイブ・ファイルの選択］をチェックし，［参照］ボタンをクリックします。

［インポートするプロジェクトを含むアーカイブの選択］ダイアログが表示されます。

「<Developerのインストールディレクトリ>¥ADP¥samples¥Bank.zip」を選択して，［開く］ボタンをクリックします。

［プロジェクトのインポート］ページの［プロジェクト］エリア内にBank.zipに含まれるプロジェクトの一覧が表示されます。

［プロジェクトのインポート］ページの［プロジェクト］エリア内にある項目をすべてチェックして，［終了］ボタンをクリックします。

サンプルプロジェクト（Bank）がEclipseのワークスペースにインポートされます。

注意事項

インポートしたサンプルプロジェクト（Bank）でビルドエラーが発生した場合，プロジェクトのプロパティでターゲット・ランタイムを変更してください。ターゲット・ランタイムの変更手順を次に示します。

［プロジェクト・エクスプローラー］ビュー※でBankプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］−［プロパティ］を選択します。

［プロパティ：<プロジェクト名>］ダイアログが表示されます。

［プロパティ：<プロジェクト名>］ダイアログの左ペインで［ターゲット・ランタイム］を選択します。

［ターゲット・ランタイム］ページが表示されます。

作成したターゲット・ランタイムのチェックボックスを選択し，［OK］ボタンをクリックします。

ターゲット・ランタイムが変更されます。

注※

［プロジェクト・エクスプローラー］ビューは，［ウィンドウ］−［ビューの表示］−［プロジェクト・エクスプローラー］を選択して表示します。

これで，サンプルプロジェクト（Bank）をインポートできました。

2.8.5　テーブルを作成します

サンプルプロジェクト（Bank）で使用するテーブルを作成します。

注意事項

テーブルを作成する前に，次の状態であることを必ず確認してください。

組み込みデータベースが開始状態であること

組み込みデータベースの開始方法については，「2.7　データベースを開始します」を参照してください。

J2EEサーバが停止状態であること

［サーバー］ビューで［InstantJ2EEServer at localhost］の状態が「停止」になっていることを確認してください。

操作手順

［プロジェクト・エクスプローラー］ビューで，［BankDBBatch］−［bank_tblcreate.bat］を選択し，右クリックで［アプリケーションから開く］−［テキストエディタ］を選択します。

bank_tblcreate.batファイルがEclipseのテキストエディタで開かれます。

bank_tblcreate.batファイルの5行目のユーザIDおよび6行目のパスワードが，次のとおりに指定されているかを確認します。

set USER="USER1"
set PSWD=

確認後，Eclipseのテキストエディタを閉じます。

［プロジェクト・エクスプローラー］ビューで，［BankDBBatch］−［bank_tblcreate.bat］を選択し，右クリックで［アプリケーションから開く］−［デフォルト・エディター］を選択します。

コマンドプロンプトが起動し，bank_tblcreate.batファイルの内容が実行されます。サンプルプロジェクト（Bank）用のテーブルが作成されると，コマンドプロンプトにテーブルの作成に成功したことを示すメッセージが表示されます。

参考

テーブルの作成に成功すると，リターンコード0が表示されます。

これで，サンプルプロジェクト（Bank）で使用するテーブルを作成できました。

2.8.6　サンプルプロジェクト（Bank）をデバッグします

「2.8.4　サンプルプロジェクト（Bank）をインポートします」でインポートしたサンプルプロジェクト（Bank）をJ2EEサーバにデプロイし，正しく動作するか確認します。

(1)　サンプルプロジェクト（Bank）のデプロイ

サンプルプロジェクト（Bank）をデプロイします。

操作手順

［プロジェクト・エクスプローラー］ビューで［Bank］を選択して，右クリックで［デバッグ］−［サーバーでデバッグ］を選択します。

［サーバーでデバッグ］ダイアログが表示されます。

［サーバーでデバッグ］ダイアログのサーバのリストで［localhost］−［InstantJ2EEServer at localhost］を選択して，［終了］ボタンを選択します。

J2EEサーバ（InstantJ2EEServer）の開始，サンプルプロジェクト（Bank）の公開，およびWebブラウザへのアクセスが一度に実施され，Webブラウザにサンプルアプリケーション（Bank）の画面が表示されます。

なお，このときJ2EEサーバ（InstantJ2EEServer）はデバッグモードで開始されます。

(2)　サンプルプロジェクト（Bank）の操作

サンプルプロジェクト（Bank）は，指定されたユーザの資金を当座預金口座（Checking Account）から普通預金口座（Savings Account）へ移動させるプログラムです。

次の操作をすると，指定したユーザのChecking AccountからSavings Accountに，指定した金額が送金（Transfer）されます。

操作手順

表示された画面上で，送金するユーザのユーザID（User ID），および取引額（Transaction amount）を入力します。

ここでは，次のように入力します。

User ID：001

Transaction amount：500

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

画面上の表で，User ID「001」のChecking Accountが「9500」に減少し，Savings Accountが「1000」に増加したことを確認します。

資金はデータベースで管理されています。資金移動時にChecking AccountテーブルとSavings Accountテーブルが更新されます。更新された金額が，同じ画面上の表に反映されるので確認してください。

以上で2章のサンプルプロジェクト（Bank）の操作は終わりです。2章に続いて3章に進む場合に，同じマシンの環境を使用するときは，次の作業をしてください。

マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「2.8.1　デバッグ環境のアンセットアップ」

マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「2.8.2　Eclipse環境のアンセットアップ」

マニュアル「アプリケーションサーバ アプリケーション開発ガイド」の「2.9　Developerのアンインストール」

3　実行環境を構築してサンプルを実行してみよう

この章では，実行環境を構築して，Application Serverが提供するサンプルプログラム（jsptag）を実行する手順を説明します。実行環境の構築には，セットアップウィザードを使用します。

3.1　実行環境でサンプルを実行する流れ

この章では，セットアップウィザードを使用して実行環境を構築して，サンプルプログラム（jsptag）を実行する手順について説明します。この章の手順を実行することで，実行環境を構築して実際にアプリケーションを動作させるまでの手順を体験できます。

セットアップウィザードは，ウィザードに従って対話形式で操作を進めることで，J2EEアプリケーションの実行環境を構築できる機能です。1台のマシンで構成される基本的なシステムを最小限の手順で構築できます。

サンプルプログラム（jsptag）は，JSPとStateless Session Beanで構成されるJ2EEアプリケーションです。このサンプルプログラムを実行すると，次の内容がWebブラウザ上に表示されます。

通貨の値をドルから円に換算した結果

通貨の値を円からユーロに換算した結果

この章で構築する実行環境とサンプルプログラム（jsptag）について，次の図に示します。

図3‒1　この章で構築する実行環境とサンプルプログラム（jsptag）

この章では，一つのマシンに実行環境を構築します。また，実行環境を構築したマシン上のWebブラウザからリクエストを送信して，実際にサンプルプログラム（jsptag）を実行してみます。

Webブラウザから送信されたリクエストは，Webサーバ経由でJ2EEサーバに送信されます。J2EEサーバ上のサンプルプログラム（jsptag）では，"Converter" JSPと"MyConverter" Stateless Session Beanによって処理が実行され，結果がWebサーバ経由でWebブラウザに返却されます。なお，サンプルプログラム（jsptag）には，データベースに接続する処理は含まれません。

参考

実行環境に含まれる「PRFデーモン」「運用管理エージェント」および「Management Server」について，このマニュアルでは意識する必要はありません。必要に応じて，マニュアル「アプリケーションサーバ システム設計ガイド」を参照してください。

実行環境の構築とサンプル実行は，次の図に示す手順で実行します。

図3‒2　実行環境の構築とサンプル実行の流れ

各作業の概要

環境変数を設定してApplication Serverをインストールします

環境変数を設定します。設定後，Application Serverをインストールします。なお，インストール方法は，使用しているOSによって異なります。

詳細については，「3.2　環境変数を設定してApplication Serverをインストールします」を参照してください。

実行環境を構築します

セットアップウィザードを使用して，実行環境を構築します。

詳細については，「3.3　実行環境を構築します」を参照してください。

アプリケーションサーバを起動します

J2EEサーバが停止している場合に，運用管理ポータルを使用してJ2EEサーバを起動します。なお，セットアップウィザードを使用して構築した直後は，アプリケーションサーバは自動的に起動しているため，この操作は不要です。詳細については，「3.4　アプリケーションサーバを起動します」を参照してください。

アプリケーション（サンプルプログラム）をインポートして開始します

サンプルプログラム（jsptag）をインポートして開始します。ここでは，サンプルプログラム（jsptag）をコンパイルしたファイルである，converter.earをインポートする手順について説明します。詳細については，「3.5　アプリケーション（サンプルプログラム）をインポートして開始します」を参照してください。

アプリケーション（サンプルプログラム）の動作を確認します

インポートしたサンプルプログラムを実行します。ここでは，サンプルプログラム（jsptag）をコンパイルしたファイルである，converter.earの動作を確認する手順について説明します。詳細については，「3.6　アプリケーション（サンプルプログラム）の動作を確認します」を参照してください。

アプリケーション（サンプルプログラム）を停止します

実行したアプリケーションを停止します。詳細については，「3.7　アプリケーション（サンプルプログラム）を停止します」を参照してください。

アプリケーション（サンプルプログラム）を削除します

停止したアプリケーションを削除します。詳細については，「3.8　アプリケーション（サンプルプログラム）を削除します」を参照してください。

アプリケーションサーバを停止します

アプリケーションサーバを停止します。詳細については，「3.9　アプリケーションサーバを停止します」を参照してください。

以降の節では，サンプルプログラム（jsptag）を実行するために必要な作業を手順どおりに説明します。

なお，ここで説明する以外の操作を実行したい場合は，マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

3.2　環境変数を設定してApplication Serverをインストールします

まず，環境変数を設定します。日本で使用する場合は，タイムゾーン（TZ）にJST-9を指定してください。設定後，Application Serverをインストールします。インストール手順は，使用しているOSによって異なります。

ここでは，Windowsの場合とUNIXの場合に分けて，インストール手順を説明します。

参考

ここで説明する手順は，Developerでも実行できます。

3.2.1　Windowsの場合

Windowsの場合に設定が必要な環境変数，およびApplication Serverのインストール手順について説明します。

(1)　環境変数の設定

実行環境で使用する環境変数を設定します。

次の手順に従って，環境変数を設定してください。

操作手順

Windowsのスタートメニューから［Windowsシステムツール］−［コントロールパネル］−［システム］−［システムの詳細設定］を選択します。

［システムのプロパティ］ダイアログが表示されます。

［詳細設定］タブの［環境変数］ボタンをクリックします。

［環境変数］ダイアログが表示されます。

［システム環境変数］に環境変数を設定します。

［システム環境変数］の枠に設定されている環境変数を確認してください。

Application Serverで設定が必要な環境変数と設定する値を次の表に示します。

表3‒1　実行環境で使用する環境変数（Windowsの場合）

変数名

設定する値

TZ

JST-9

Path

<Application Serverのインストールディレクトリ>¥jdk¥bin

環境変数「TZ」がすでにある場合で，「JST-9」が設定されていないときは，設定する変数名を選択して［編集］ボタンをクリックします。表示されたダイアログで，環境変数の値を追加・変更してください。

環境変数「TZ」がない場合は，［新規］ボタンをクリックします。表示されたダイアログで，環境変数および値を追加してください。

環境変数「Path」がすでにある場合は，設定する変数名を選択して［編集］ボタンをクリックします。表示されたダイアログで，環境変数の値を先頭に追加してください。「<Application Serverのインストールディレクトリ>」は実際のディレクトリに置き換えてください。

環境変数「Path」がない場合は，［新規］ボタンをクリックします。表示されたダイアログで，環境変数および値を追加してください。

［環境変数］ダイアログで［OK］ボタンをクリックします。

［環境変数］ダイアログが閉じます。

［システムのプロパティ］ダイアログで［OK］ボタンをクリックします。

［システムのプロパティ］ダイアログが閉じて環境変数の設定が完了します。

これで，Application Serverを使用するための環境変数の設定は完了です。

(2)　Application Serverのインストール

次の手順に従って，Application Serverをインストールします。

注意事項

Application Serverをインストールする前に，すべてのWindowsアプリケーションを終了させておいてください。

操作手順

インストールCD-ROMを，CD-ROMドライブにセットします。

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

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

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

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

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

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

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

［インストール先の選択］ページが表示されます。

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

［機能の選択］ページが表示されます。

注意事項

インストール先ディレクトリには，次のパスを指定しないでください。

ネットワークドライブ

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

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

半角50文字を超えるパス

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

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

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

［ユーザ情報］ページが表示されます。

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

注意事項

［ユーザ名］および［会社名］にスラッシュ（/），セミコロン（;），ダブルクォーテーション（"）を含めることはできません。

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

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

［インストールの開始］ページが表示されます。

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

インストールが開始されます。インストールが完了すると，［セットアップの完了］ページが表示されます。インストールは数分掛かる場合があります。

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

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

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

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

これで，Application Serverはインストールされました。

3.2.2　UNIXの場合

UNIXの場合に設定が必要な環境変数，およびApplication Serverのインストール手順について説明します。

(1)　環境変数の設定

実行環境で使用する環境変数を設定します。日本で使用する場合は，タイムゾーン（TZ）にJST-9を指定してください。環境変数の設定方法については，OSのドキュメントを参照してください。

設定する環境変数を次の表に示します。

表3‒2　実行環境で使用する環境変数（UNIXの場合）

変数名

設定する値

　TZ

JST-9

(2)　Application Serverのインストール

UNIXの場合，インストールには，PPインストーラを使用します。

注意事項

ここでは，Linuxの場合のインストール手順を示します。これ以外のUNIXを使用する場合のインストール手順については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「2.2.3　Application Serverを新規インストールする（AIXの場合）」を参照してください。

操作手順

Application Serverをインストールするマシンにroot権限でログインします。

インストールCD-ROMをCD-ROMドライブにセットします。

OSのmountコマンドで，CD-ROMファイルシステムをマウントします。

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

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

PPインストーラのsetupコマンドで，セットアッププログラムを起動します。

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

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

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

PP インストール画面で，プログラムにカーソルを移動させ，［スペース］キーを押します。

すべてのプログラムを選択してください。選択したプログラムの左側には「@」が表示されます。

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

インストールするかどうかを確認するメッセージが出力されたら，［Y］キーを押します。インストールは数分掛かる場合があります。

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

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

これで，Application Serverのインストール作業は完了です。

3.3　実行環境を構築します

セットアップウィザードを使用して実行環境を構築します。

ここでは，セットアップウィザードを使用する前に準備および確認が必要な内容と，セットアップウィザードの使用手順について説明します。

3.3.1　セットアップウィザードを使用する前の準備と確認をします

セットアップウィザードを使用する前に，次の2点を確認してください。

(1)　使用できるユーザの権限

セットアップウィザードを使用できるユーザの権限を次の表に示します。

表3‒3　セットアップウィザードを使用できるユーザ

OS

使用できるユーザ

Windows

Administrator権限のあるユーザ

UNIX

root権限のあるユーザ

これらの権限を持つユーザでログインした状態で，セットアップウィザードを使用してください。

(2)　実行環境を構築するシステムで使用されているポート番号

以降の手順では，セットアップウィザードの標準セットアップを使用する方法について説明します。

標準セットアップでは，次の表に示すポート番号を使用したシステムが構築されます。

表3‒4　標準セットアップで使用されるポート番号

ポート番号

用途

80

Webサーバのポート番号

900

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

8008

HTTPサーバのポート番号

8080

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

20295

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

23152

RMI（Remote Method Invocation）レジストリのポート番号

28005

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

28009

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

28080

Management Server接続HTTPポート番号

システムでこれらのポート番号をすでに使用している場合，標準セットアップは実行できません。カスタムセットアップを実行して，重複しないポート番号を指定する必要があります。カスタムセットアップについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「1.1.1　セットアップウィザードとは」を参照してください。

3.3.2　セットアップウィザードを使用します

セットアップウィザードを使用して，実行環境を構築します。セットアップウィザードは，CUIで操作します。

操作手順（セットアップウィザードの使用）

セットアップウィザードを起動します。

Windowsの場合

コマンドプロンプトを起動して，次のコマンドを実行します。

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

UNIXの場合

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

/opt/Cosminexus/manager/setup/bin/setupwizard

実行すると，［ようこそ］画面が表示されます。

「1」を入力して，Enterキーを押します。

［セットアップ方法の選択］画面が表示されます。

「1」を入力して，Enterキーを押します。

ここでは，「標準セットアップ」を選択します。

［データベース接続環境の設定］画面が表示されます。

参考

サンプルプログラム（jsptag）ではデータベースを使用しないため，ここではデータベース接続環境の設定は不要です。ただし，今後データベース接続環境が必要なJ2EEアプリケーションを実行する予定がある場合は，次の手順で「y」を入力してEnterキーを押してください。以降の操作については，「データベース接続環境を設定する場合」を参照してください。

「n」を入力して，Enterキーを押します。

［データベース接続環境の設定］画面（設定内容確認）が表示されます。

「1」を入力して，Enterキーを押します。

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

「1」を入力して，Enterキーを押します。

セットアップが実行されます。セットアップが完了すると，［セットアップ完了］画面が表示されます。セットアップの実行には数分掛かる場合があります。

これで，実行環境の構築は完了です。

データベース接続環境を設定する場合

データベース接続環境を設定するには，データベースの環境が整っている必要があります。セットアップウィザードで接続環境を設定できるデータベースは次のとおりです。

HiRDB（Version 9以降）

HiRDB Type4 JDBC Driverを使用して接続します。

Oracle（Oracle11g R2以降のバージョン）

Oracle JDBC Thin Driverを使用して接続します。

ここでは，「操作手順（セットアップウィザードの使用）」の操作手順4.で「y」を入力してEnterキーを押したあとの操作について説明します。

［データベース接続環境の設定］画面で，HiRDBを使用する場合は「1」を，Oracleを使用する場合は「2」を入力して，Enterキーを押します。

Oracleを使用する場合は，引き続きデータベース名（SID）を入力して，Enterキーを押してください。

データベースのホスト名を入力してEnterキーを押します。

データベースのポート番号を入力してEnterキーを押します。

データベースにアクセスするユーザ名を入力してEnterキーを押します。

データベースのパスワードを入力してEnterキーを押します。

JDBCドライバ（JARファイル）の絶対パスを入力してEnterキーを押します。

［データベース接続環境の設定］画面（設定内容確認）が表示されます。

以上でデータベース接続環境の設定は完了です。以降は「操作手順（セットアップウィザードの使用）」の操作手順5.に戻り，操作を実行してください。

3.4　アプリケーションサーバを起動します

セットアップウィザードを使用して構築した直後は，アプリケーションサーバは起動しているため，この操作は不要です。「3.5　アプリケーション（サンプルプログラム）をインポートして開始します」へ進んでください。

ここでは，マシンの再起動などによって停止したシステムを起動する方法について説明します。なお，Management Serverを起動する前に，運用管理エージェントを起動します。

操作手順

運用管理エージェントを起動します。

Windowsの場合

コマンドプロンプトを起動して，次のコマンドを実行します。

"<Application Serverのインストールディレクトリ>¥manager¥bin¥adminagentctl" start -sync

UNIXの場合

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

/opt/Cosminexus/manager/bin/adminagentctl start -sync

コンソールに「"KEOS21200-I The administration agent has started."」と表示され，運用管理エージェントが起動します。

Management Serverを起動します。

Windowsの場合

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

"<Application Serverのインストールディレクトリ>¥manager¥bin¥mngsvrctl" start -sync

コンソールに「"KEOS10110-I Management Server service has started from command line."」と表示され，Management Serverが起動します。

UNIXの場合

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

/opt/Cosminexus/manager/bin/mngsvrctl start -sync

コンソールに「"KDJE30028-I The J2EE server has started. Server name = cosmi_m"」と表示され，Management Serverが起動します。

運用管理ポータルにログインして，［論理サーバの稼働状況］画面を表示します。

表示方法については，「3.9　アプリケーションサーバを停止します」の操作手順1.〜4.を参照してください。

［一括起動］タブをクリックします。

［一括起動］画面が表示されます。

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

論理サーバが一括起動します。一括起動が完了したことは，［ログの表示］画面に表示される「KEOS20010-I 一括起動を終了します。」というメッセージで確認できます。なお，［ログの表示］画面は［ログの表示］タブをクリックすると表示されます。

これで，アプリケーションサーバを起動できました。

3.5　アプリケーション（サンプルプログラム）をインポートして開始します

製品が提供するコンパイル済みのファイル（converter.ear）を実行環境にインポートして，アプリケーションを開始します。インポートの処理には，運用管理ポータルを使用します。

アプリケーションをインポートする手順を次に示します。

操作手順

Windowsのスタートメニューから，［Cosminexus］−［運用管理ポータル］を選択します。

運用管理ポータルのログイン画面が表示されます。

管理ユーザIDに「admin」と入力して［ログイン］ボタンをクリックします。

［運用管理ポータル］画面が表示されます。

［論理サーバのアプリケーション管理］をクリックします。

左のツリーペインで，［DefaultDomain］をクリックします。

［J2EEアプリケーションのアップロード］画面が表示されます。

Microsoft Edge（Internet Explorerモード）の場合

Microsoft Edge（ネイティブ）の場合

［J2EEアプリケーションファイル］の［参照］ボタン（Microsoft Edge（Internet Explorerモード）の場合），または［ファイルの選択］ボタン（Microsoft Edge（ネイティブ）の場合）をクリックし，アップロード元にあるEARファイルを選択し，［アップロード］ボタンをクリックします。

アップロード元にあるEARファイル（アーカイブ形式）を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥examples¥ejb¥ejb20¥jsptag¥converter.ear

UNIXの場合

/opt/Cosminexus/CC/examples/ejb/ejb20/jsptag/converter.ear

J2EEアプリケーションのアップロードが実行されます。完了すると，アップロードが成功したことを示すメッセージが表示されます。

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

アップロードディレクトリファイル一覧にEARファイル（converter.ear）が表示されます。

Microsoft Edge（Internet Explorerモード）の場合

Microsoft Edge（ネイティブ）の場合

左のツリーペインで，［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックします。

［J2EEアプリケーションの開始／停止］画面が表示されます。

［インポート］タブをクリックします。

［J2EEアプリケーションのインポート］画面が表示されます。

［J2EEアプリケーションファイル］プルダウンメニューからconverter.earを選択し，［実行］ボタンをクリックします。

アプリケーションのインポートが実行されます。完了すると，実行結果に「成功」と表示されます。

［開始／停止］タブをクリックします。

［J2EEアプリケーションの開始／停止］画面が表示されます。

［開始］アンカーをクリックします。

［J2EEアプリケーションの開始］画面が表示されます。

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

アプリケーションが開始します。完了すると，実行結果に「成功」と表示されます。

これで，アプリケーションを開始できました。

3.6　アプリケーション（サンプルプログラム）の動作を確認します

Webブラウザからサンプルプログラム（jsptag）が正しく動作していることを確認します。

操作手順

Webブラウザを起動します。

サンプルプログラム（jsptag）を呼び出すURLを指定して，実行画面を表示します。

次のURLを指定します。

http://localhost/jsptag/converter_war/Converter.jsp

参考

localhostは，Webサーバが動作するホスト名です。このマニュアルの場合は，Application ServerをインストールしたマシンのWebブラウザから処理を実行します。

jsptagの実行画面として，通貨の値を換算した結果を示す画面が表示されます。

図3‒3　jsptagの実行画面

上記の画面が表示されていれば，アプリケーションの動作の確認は完了です。

3.7　アプリケーション（サンプルプログラム）を停止します

アプリケーションの停止には，運用管理ポータルを使用します。なお，「3.5　アプリケーション（サンプルプログラム）をインポートして開始します」の操作が完了した時点では，アプリケーションは，開始された状態になっています。アプリケーションを停止する操作は，システムが起動された状態で実行してください。

操作手順について説明します。

操作手順

Windowsのスタートメニューから，［Cosminexus］−［運用管理ポータル］を選択します。

運用管理ポータルのログイン画面が表示されます。

管理ユーザIDに「admin」と入力して［ログイン］ボタンをクリックします。

［運用管理ポータル］画面が表示されます。

［論理サーバのアプリケーション管理］をクリックします。

左のツリーペインで，［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックします。

［J2EEアプリケーションの開始／停止］画面が表示されます。

［停止］アンカーをクリックします。

［J2EEアプリケーションの停止］画面が表示されます。

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

アプリケーションが停止します。完了すると，実行結果に「成功」と表示されます。

これで，アプリケーションを停止できました。

3.8　アプリケーション（サンプルプログラム）を削除します

アプリケーションの削除には，運用管理ポータルを使用します。

操作手順について説明します。

操作手順

Windowsのスタートメニューから，［Cosminexus］−［運用管理ポータル］を選択します。

運用管理ポータルのログイン画面が表示されます。

管理ユーザIDに「admin」と入力して［ログイン］ボタンをクリックします。

［運用管理ポータル］画面が表示されます。

［論理サーバのアプリケーション管理］をクリックします。

左のツリーペインで，［論理J2EEサーバ］−［J2EEサーバ］−［MyJ2EEServer］−［アプリケーション］をクリックします。

［J2EEアプリケーションの開始／停止］画面が表示されます。

［削除］タブをクリックします。

［J2EEアプリケーションの削除］画面が表示されます。

削除するJ2EEアプリケーションの［削除］アンカーをクリックします。

J2EEアプリケーションの削除を確認する画面が表示されます。

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

アプリケーションを削除します。削除が完了すると，実行結果に「成功」と表示されます。

これで，アプリケーションを削除できました。

3.9　アプリケーションサーバを停止します

セットアップウィザードで構築したシステムの停止には，運用管理ポータルおよびコマンドを使用します。なお，「3.5　アプリケーション（サンプルプログラム）をインポートして開始します」の操作が完了した時点では，システムは起動された状態になっています。

また，システムを停止する際は，運用管理エージェントを停止する前にManagement Serverを停止します。

操作手順について説明します。

操作手順

Windowsのスタートメニューから，［Cosminexus］−［運用管理ポータル］を選択します。

運用管理ポータルのログイン画面が表示されます。

管理ユーザIDに「admin」と入力して［ログイン］ボタンをクリックします。

［運用管理ポータル］画面が表示されます。

［論理サーバの起動／停止］をクリックします。

［論理サーバの起動／停止］画面が表示されます。

左のツリーペインで，［DefaultDomain］をクリックします。

［論理サーバの稼働状況］画面が表示されます。

［一括停止］タブをクリックします。

［一括停止］画面が表示されます。

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

論理サーバが一括停止します。一括停止が完了したことは，［ログの表示］画面に表示される「KEOS20015-I 一括停止を終了します。」というメッセージで確認できます。なお，［ログの表示］画面は［ログの表示］タブをクリックすると表示されます。

Management Serverを停止します。

Windowsの場合

コマンドプロンプトを起動して，次のコマンドを実行します。

"<Application Serverのインストールディレクトリ>¥manager¥bin¥mngsvrctl" stop -sync

UNIXの場合

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

/opt/Cosminexus/manager/bin/mngsvrctl stop -sync

コンソールに「"KEOS10111-I Management Server service ended from command line."」と表示され，Management Serverが停止します。

運用管理エージェントを停止します。

Windowsの場合

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

"<Application Serverのインストールディレクトリ>¥manager¥bin¥adminagentctl" stop -sync

UNIXの場合

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

/opt/Cosminexus/manager/bin/adminagentctl stop -sync

コンソールに「"KEOS21201-I The administration agent has stopped."」と表示され，運用管理エージェントが停止します。

これで，アプリケーションサーバを停止できました。

付録

付録A　用語解説

マニュアルで使用する用語について

マニュアル「アプリケーションサーバ & BPM/ESB基盤 用語解説」を参照してください。