ここでは、エンタープライズ サーバー インスタンスをプロジェクトに関連付けてプロジェクトをビルドし、ディプロイ プロパティを設定してサービス インターフェイスをディプロイし、ディプロイ結果を確認する手順について説明します。
制限事項:本トピックは、Windows 環境 (ローカル開発) にのみ該当します。
REST サービス インターフェイスをエンタープライズ サーバー インスタンスに正しくディプロイするには、最初に Enterprise Developer でいくつかのオプションを設定する必要があります。
ディプロイ プロパティの設定
ディプロイ処理がスムーズに行われるように、いくつかのオプションを設定して、Enterprise Developer に特定のファイルの場所を伝える必要があります。
- Team Developer Tree View で、[ProgramREST > Web Services] を展開します。
- [ProgramREST] Web インターフェイスを右クリックし、コンテキスト メニューで [Web Service Properties] を選択します。
- [ディプロイメント サーバー] タブで、[Enterprise Server name] フィールドに対応する [変更] ボタンをクリックします。
- [Server] カラムで [ESREST] をクリックしてから、[OK] をクリックします。
- [Application Files] タブで [Legacy application needs deploying] をクリックしてから、[Add Files] をクリックして次のファイルを追加します。
ファイル |
場所 |
説明 |
- appoint.dat
- consultants.dat
- customers.dat
|
プロジェクトの ProgramREST フォルダー
|
サービスによってアクセスされるデータ ファイルです。 |
schedule.dll |
プロジェクトの New_Configuration.bin フォルダー |
サービスのデバッグに必要な実行可能ファイルです。 |
これらのファイルは、ディプロイ時にエンタープライズ サーバーにコピーされます。
- [OK] をクリックします。
エンタープライズ サーバー インスタンスの停止
使用しているエンタープライズ サーバー インスタンスと、同じリスナー ポートを使用する他のエンタープライズ サーバー インスタンスの間でポートの競合が発生しないように、次の手順に従って、開始されているエンタープライズ サーバー インスタンスをすべて停止します。
- Enterprise Developer でサーバー エクスプローラーがアクティブになっていない場合は、[ウィンドウ > ビューの表示 > その他 > Micro Focus > サーバー エクスプローラー] をクリックして、[OK] をクリックします。
- サーバー エクスプローラーで、[Local [localhost:86]] を展開して、エンタープライズ サーバー インスタンスのリストを表示します。
- 開始されているエンタープライズ サーバー インスタンスをそれぞれ右クリックして、コンテキスト メニューで [Stop] を選択して停止します。開始されているエンタープライズ サーバー インスタンスには、緑色のアイコン (
) が表示されています。
ESREST エンタープライズ サーバー インスタンスの開始
サービス インターフェイスをディプロイする前に、ProgramREST サービスが実行される ESREST インスタンスを開始する必要があります。
- Enterprise Developer でサーバー エクスプローラーがアクティブになっていない場合は、[ウィンドウ > ビューの表示 > その他 > Micro Focus > サーバー エクスプローラー] をクリックして、[OK] をクリックします。
- サーバー エクスプローラーで、[Local [localhost:86]] を展開して、使用できるエンタープライズ サーバー インスタンスのリストを表示します。
- ESREST エンタープライズ サーバー インスタンスを開始するには、右クリックして [Start] をクリックします。
注:サーバーを初めて起動した場合は、サインオン ダイアログ ボックスが表示されます。[Store Credentials] がオンになっていない場合はオンにします。[Store Credentials] をオンにすると、次回のエンタープライズ サーバー インスタンスの開始から、このダイアログ ボックスがデフォルトで表示されなくなります。[OK] をクリックします。
Enterprise Server デーモンがコンソールから呼び出されて、ESREST エンタープライズ サーバー インスタンスが開始されます。
ProgramREST Web サービスをディプロイします。
- Eclipse では、[Console] タブをクリックします。
- アイコン バーで、Display Selected Console (
) と関連付けられている下矢印をクリックします。
- [3 Service Interfaces Console] をクリックします。
- Team Developer Tree View で [ProgramREST] Web サービスを右クリックし、[ディプロイ] をクリックします。
[Console] ビューにディプロイ処理の進捗状況が表示されます。ディプロイに成功すると、成功を知らせるメッセージが表示されます。
注:ディプロイ後にコンソールが [
Micro Focus Build] ビューに切り替わる場合は、[
Service Interfaces Console] ビューに戻り、ディプロイ ログを再確認します。
ディプロイに失敗した場合は、失敗の理由を知らせるメッセージが [Console] ビューに表示されます。このエラー メッセージにはログ ファイルのパスも表示されるので、ブラウザーでこのパスを指定してログ ファイルを開くこともできます。
ディプロイ結果の表示
これで、ESREST エンタープライズ サーバーで実行されるサービスとしてサービス インターフェイスがディプロイされたので、ディプロイされたサービスの詳細を Enterprise Server Administration ページで確認できます。
- Enterprise Developer で Enterprise Server Administration ウィンドウを閉じた場合は、再度開始します。
ESREST エンタープライズ サーバーの情報が表示されている行の [オブジェクト] 列に、このエンタープライズ サーバー インスタンスで実行されているサービスの数が表示されます。この例では、実行されているサービスが少なくとも 4 つあるはずです。エンタープライズ サーバーには標準で 2 つのサービスが含まれており、ここで追加した 1 つのサービスに 2 つの操作が含まれているからです。ESREST エンタープライズ サーバーにその他のサービスをディプロイした場合は、サービスの数がこれより多くなります。
- ESREST サービスの [Details] ボタンをクリックします。
新しいサービス (ProgramREST) が表示されている行の [現ステータス] 列で、両方の操作が [利用可能] になっていることを確認します。これは、クライアントがアクセスできる状態になっていることを示します。
- Enterprise Server Administration を閉じます。