EM4C ゲートウェイのインストールと構成

EM4C ゲートウェイは、環境内にある IBM Cognos ゲートウェイの各コンピューター上にインストールする必要があります。

EM4C ゲートウェイは、単独または EM4C サーバーおよび EM4C ディスパッチャと組み合わせてインストールおよび構成できます。詳細については、「サーバー コンポーネントのインストール シーケンス」をご参照ください。Esri Maps for IBM Cognos の配備例については、「Esri Maps for IBM Cognos のアーキテクチャ」をご参照ください。

EM4C ゲートウェイのインストール

インストールを開始する前に、EM4C ゲートウェイをインストールする各コンピューター上に IBM Cognos ゲートウェイのディレクトリが存在することを確認します。

次の手順を管理者として実行する必要があります。

1. インストール メディアの em4c ディレクトリで、インストーラーのバッチ ファイル (*.bat) を起動します。例:

   G:\em4c\launchInstaller.bat

2. [ようこそ] ページで [次へ] をクリックします。
3. 使用許諾契約書の契約条件に同意する場合は、[次へ] をクリックします。同意しない場合は、[終了] をクリックして終了します。
4. インストール パスを選択して、[次へ] をクリックします。
5. Esri Maps for IBM Cognos をインストールする IBM Cognos のバージョンを選択して、[次へ] をクリックします。
6. [EM4C ゲートウェイ] コンポーネントだけが選択されていることを確認して、[次へ] をクリックします。
7. IBM Cognos ゲートウェイの webcontent ディレクトリを指定して、[次へ] をクリックします。
8. [次へ] をクリックして、インストールを続行します。
9. 指定した場所にファイルがコピーされたら、[次へ] をクリックします。
10. 必要に応じて、[自動インストール スクリプトの生成] をクリックして、前のページで設定したすべてのパラメーターを含む XML ファイルを保存します。
11. [完了] をクリックします。

EM4C ゲートウェイの構成

EM4C ゲートウェイの構成には、環境内にある EM4C サーバー コンピューターの順序付きのカンマ区切りのリストが必要です。詳細については、「構成」をご参照ください。

管理者権限のあるユーザーとして、Esri Maps for IBM Cognos の構成を実行します。

1. <em4c_location>\bin ディレクトリを参照し、configure.bat を実行します。
2. 構成ツールのエクスプローラー ウィンドウで、[ローカル構成] をクリックします。
3. 環境に合わせてローカル構成の設定を変更します (たとえば、URL のホスト名の部分を localhost から IP アドレスやネットワーク ホスト名に変更する必要があります)。Esri Maps for IBM Cognos の構成アプリケーションは、インストールされている EM4C コンポーネントを認識し、設定する必要のある構成設定のみをリストします。
4. [適用] をクリックします。
5. [ファイル] メニューの [終了] をクリックします。

Web サーバーの構成

Esri Maps for IBM Cognos と IBM Cognos が通信するには、次の表に示した仮想ディレクトリ (エイリアス) を作成する必要があります。IBM Cognos は Web サーバー上で ibmcognos として公開されていると想定しています (環境に合わせて変更してください)。

エイリアス	場所
ibmcognos\em4c	<em4c_location>\webcontent
ibmcognos\em4c\cgi-bin	<em4c_location>\cgi-bin または <em4c_location>\cgi-bin-64bit (環境 (x86 または x64) によって異なります)

Esri Maps for IBM Cognos の仮想ディレクトリ

Web サーバーの構成の詳細については、「Web サーバーの構成について」をご参照ください。

構成のテスト

Esri Maps for IBM Cognos をインストールおよび構成したら、Web ブラウザーのキャッシュをまだ削除していない場合は削除します (Ctrl + Shift + Delete キー)。その後、インストールおよび構成プロセスのさまざまな側面をテストできます。

次の例では、IBM Cognos が ibmcognos というエイリアスによって公開されていると想定します。

1. 次のテストを実行して、EM4C ゲートウェイが正常に動作しているかどうかを確認します。
   1. EM4C Web サーバーの仮想ディレクトリ (エイリアス) が正しく設定されていることをテストします (これにより、Esri Maps for IBM Cognos の構成で [適用] が選択されたことも確認できます)。

      http://<cognos_gateway>/ibmcognos/em4c/version.txt

   2. EM4C ゲートウェイの CGI スクリプトが正しく動作している (EM4C サーバーに接続している) ことをテストします。動作している場合、次の URL を指定すると、タイム スタンプの付いたメッセージがブラウザーに表示されます。

      http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi

   3. EM4C ゲートウェイの CGI スクリプトが外部リソースにアクセスできるかどうかをテストします。たとえば、次の各 URL は、サーバー上にインストールされているソフトウェアのバージョンを記述する JSON オブジェクトを返します。

      ArcGIS Online:

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://www.arcgis.com/sharing?f=pjson

      Portal for ArcGIS インスタンス:

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://myPortal/gis/sharing/?f=pjson

      テストに成功すると、現在のバージョンが返されます (例: "currentVersion":"x.x")。

   注意:

   上記のテストで予想された結果にならなかった場合、原因は Esri Maps for IBM Cognos の構成が使用されなかった (構成の変更が保存および適用されなかった) こと、または Web サーバーが正しく構成されていないことの 2 つが考えられます。