Cognos Analytics 11.1.6@LinuxでのIHS V9 ゲートウェイ構成手順

#Cognos Analytics 11.1.6@LinuxでのIHS V9 ゲートウェイ構成手順
ゲートウェイはSSOの実装の際や、80番ポートでCognosにアクセスしたい時に実装を行います。
Webサーバーとして、IBM HTTP ServerやApacheの使用が必要です。
Cognos Analytics 11.1では、IBM HTTP Server V9が従プログラムとして使用可能となっています。
本記事では、Cognos Analytics 11.1.6@Redhat7で、IHS V9をゲートウェイとして実装する手順をまとめました。

手順の基本はマニュアルのこちらです。
https://www.ibm.com/support/knowledgecenter/SSEP7J_11.1.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/t_http9_sup.html



#事前
以下のモジュールの準備が必要です。
IBM SDK, Java(TM) Technology Edition, Version 8
IBM WebSphere Application Server V9.0 supplements - Web Server Plug-ins (CND1EML)
IBM WebSphere Application Server V9.0 supplements - IBM HTTP Server (CND1DML)

IIM(IBM Installation Manager)は導入済の状態です。

Cognos Analyticsのインストールは済み。
※インストール時に、コンポーネントの選択で「ゲートウェイ」を入れておく必要があります。
<img width="622" alt="001.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/c430f62c-0571-3c03-3e44-79c1e2ead803.png">


#IHS V9+Plugin V9導入
Installation Managerの起動

```html
cd /opt/IBM/InstallationManager/eclipse
./IBMIM
```

「ファイル」→「設定」
<img width="346" alt="001.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/a48479ca-1e41-090b-94c4-4968c01dc03a.png">

画面の5つ(IBM Java8、Java8 FixPack、IHS V9、IHS V9 FixPack、Plugin V9)を指定し「OK」
<img width="651" alt="002.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/a46ade6e-b516-accd-25bc-d9f9b8079334.png">

インストール
<img width="610" alt="003.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/7488295f-4b43-d790-6302-53eaad3b17d6.png">

IHSとPluginをチェックし「次へ」
<img width="610" alt="004.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/9acb7e0c-c73b-c190-9811-5ff1fd2a53c4.png">

同意して「次へ」
<img width="612" alt="005.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/b36119cb-34b5-bba6-abd2-a8c722abde27.png">

IHSを選択しパスを指定
<img width="611" alt="006.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/149fb6e7-2542-ee32-4daf-073eaf505073.png">

Pluginを選択しパスを指定
<img width="610" alt="007.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/ae40d29c-a1a9-21d3-de01-b93c39a0f60d.png">

次へ
<img width="609" alt="008.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/fa59445c-8d1f-b0ef-3615-747ae9e70a39.png">

次へ
<img width="610" alt="009.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/459d06b4-be0a-9edc-32d4-3d20d030c5d7.png">

インストール
<img width="610" alt="010.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/5ed727a1-76a0-8f04-cd8d-2666eae9942c.png">

完了
<img width="611" alt="011.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/8c6dd2ae-b86b-f761-8fae-8c9c7431b0e9.png">

#Pluginの構成
※前述のインストール画面では、インストールパスは/mnt/IHS90/optとしていたが、以降の説明ではインストール先は/optとする

IHSとPluginを関連付ける

```html
# pwd
/opt/IBM/HTTPServer

# ./bin/simplepct.sh /opt/IBM/WebSphere/Plugins/
To continue, configure your server.xml with <pluginConfiguration pluginInstallRoot="/opt/IBM/WebSphere/Plugins" />,
then transfer your usr/servers/server-name/logs/state/plugin-cfg.xml to
'/opt/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml'
```

\<CognosInstall>/wlp/usr/servers/cognosserver/server.xmlファイルに以下の行を追加

```html
<pluginConfiguration pluginInstallRoot="/opt/IBM/WebSphere/Plugins" webserverPort="80"/>
```
<img width="544" alt="017.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/52c59832-47ef-f2f1-b694-a74ba2d3f33b.png">

Cognos起動

```html
# ./cogconfig.sh -s
```

\<CognosInstall>/wlp/usr/servers/cognosserver/logs/state/plugin-cfg.xmlファイルの編集
以下のように、UriGroupのエントリーを修正。※2行目は元々無いので追加。
※元々記載のあった他のエントリーは削除
<img width="577" alt="013.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/af9d1a2f-1bd8-fbd3-183c-b9893743eaf8.png">

plugin-cfg.xmlファイルをplugin配下の以下のディレクトリにコピー

```html
# pwd
/opt/ibm/cognos/analytics/wlp/usr/servers/cognosserver/logs/state
# cp -p plugin-cfg.xml /opt/IBM/WebSphere/Plugins/config/webserver1/
# ls /opt/IBM/WebSphere/Plugins/config/webserver1/
plugin-cfg.xml  plugin-key.kdb  plugin-key.rdb  plugin-key.sth
```

plugin-cfg.xmlに実行権限を付与

```html
# chmod 755 plugin-cfg.xml
# ls -l /opt/IBM/WebSphere/Plugins/config/webserver1/
合計 120
-rwxr-xr-x. 1 root root   2800  6月 19 16:38 2020 plugin-cfg.xml
-rwxr-xr-x. 1 root root 110080  6月 19 15:27 2020 plugin-key.kdb
-rwxr-xr-x. 1 root root     80  6月 19 15:27 2020 plugin-key.rdb
-rwxr-xr-x. 1 root root    129  6月 19 15:27 2020 plugin-key.sth
```

#cognos.confの構成
cognos_IHS9.confをHTTPServer/confにコピー

```html
# pwd
/opt/ibm/cognos/analytics/cgi-bin/templates
# cp -p cognos_IHS9.conf /opt/IBM/HTTPServer/conf/
# cd /opt/IBM/HTTPServer/conf/
# mv cognos_IHS9.conf cognos.conf
```

※cognos.conf内の以下のパスは環境に応じて修正
/opt/IBM/cognos/analytics

以下の2行をコメントアウト
<img width="455" alt="016.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/daafbdd5-0f16-96a7-2983-b188a5413404.png">

以下の2行のパスで、「IBM」を「ibm」に変更

```html
<Directory /opt/ibm/cognos/analytics>

Alias /ibmcognos /opt/ibm/cognos/analytics/webcontent
```

#httpd.confの構成
httpd.confで、以下の2行のコメントを外す
<img width="414" alt="014.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/37e172d0-b287-ee27-8317-7b1157bb4054.png">

以下の箇所の$"PLG_ROOTの箇所をフルパスに変更
※編集すると""が抜けてしまいがちなので注意
<img width="482" alt="015.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/f96c5c30-4afa-0ad2-dca4-ef47566d1b33.png">

cognos.confの読み込みを追加

```html
<VirtualHost *:80>
  Include conf/cognos.conf
</VirtualHost>
```

WebDav設定追加

```html
Alias /images /opt/ibm/cognos/analytics/webcontent/bi/samples/images
DAVMinTimeout 600
DAVLockDB logs/DavLock
<Directory /opt/ibm/cognos/analytics/webcontent/bi/samples/images>
    DAV On
    Options Indexes MultiViews
    AllowOverride None
    Require all granted
</Directory>
```

#Cognos Configuration
環境のゲートウェイURIを修正する。 

```html
http://<CognosHostname>:80/ibmcognos/bi/v1/disp
```

#LD_LIBRARY_PATH
IHS起動ユーザーの.bash_profileに以下の記載がある事を確認
※Linuxの場合。Unixの場合はLIBPATH

```html
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ibm/cognos/analytics/cgi-
bin
```

#CognosとIHSの起動
Cognosの起動

```html
/opt/ibm/cognos/analytics/bin64/cogconfig.sh -s
```

IHSの起動

```html
/opt/IBM/HTTPServer/bin/apachectl -k start
```