Cognos Command Center の検証メモ（IBM Planning Analytics on Cloud対応）

#概要
Cognos Command Center(CCC)とは、Cognos BIやTM1などの環境を、運用管理するためのツールです。
このツールを使っている方は、ほとんどいらっしゃらないと思いますが、Cognos TM1の後継のIPA(IBM Planning Analytics)のon Cloud版では、Planning Analytics(PA)環境の運用管理のため、CCCを使用する事がガイドされています。
例えば、クラウド環境のPAの共有フォルダにファイルがアップロードされたのを検知して、取り込みのための（Turbo Integrator)TIプロセスを実行する様な、ジョブを設定するとか、ジョブスケジュールでのTIプロセス処理のエラーを検知して、メールで通知する、というような事は、CCCを使ってやるようです。
IPA on Cloudを本格的に使うために、CCCの構成や機能を知っておく必要があり、個人的に学習するため検証してみましたので、こちらに学んだ事を共有しておきます。



#導入&構成
Cognos Command Centerは、各IPA環境に導入する(されている)Agentと、一括管理のためのServerから構成されます。
Serverモジュールは、オンプレのサーバーに導入する構成になります。
CCC Serverを動作させるために、リポジトリDBとして、SQL ServerかOracleが必要になります。

**Cognos Command Center**
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_cloud_mg.2.0.0.doc/c_tm1_cloud_cognos_command_center_agents.html

\<抜粋>
You can use IBM® Cognos® Command Center on-premises to automate your TM1® Server on the cloud.

![image.png](https://qiita-image-store.s3.amazonaws.com/0/147246/7cc5030b-071a-a21b-e917-ce34bf62b5ee.png)

マニュアルを見る限り、SQL Serverの方が簡単そうなので、Microsoftのサイトから無償版のSQL Server Expressをダウンロードして、インストールします。

SQL Serverのインストールの際には、認証モードは「混合モード」にして、saユーザーでアクセスできるようにしておきます。
![028.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/3d3411db-2eca-fe1e-924a-79870e72a2d2.png)

Cognos Command Center 10.2.3の環境サポート情報サイトが見つからないので、参考までに10.2.4見てやりました。

**Cognos Command Center 10.2.4 Supported Software Environments**
http://www-01.ibm.com/support/docview.wss?uid=swg27049408

SQL Serverは、2008、2008 R2、2012がサポートされるようなので、いずれかのバージョンを導入してみます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/147246/cc8729de-7189-133f-9400-810dfdca4af6.png)

次に、CCCの本体を導入します。

IPAを契約すると送付されてくるWelcome Kitの中に、Cognos Command Centerのセットアップやアクセス情報があります。
まずは、Welcome Kit内の**Planning Analytics shared folder**にある、以下を見て、IPAノード上からCCCを導入するためのモジュールをダウンロードします。
**Your install for Cognos Command Center is available in:**
\\data\s\install\Cognos Command Center

2017年11月現在のIPA On Cloudでは、以下のモジュールが提供されていましたので、これをオンプレのCCCノードにコピーしてきて、導入を開始します。
CCCのバージョンとしては、10.2.3となります。
10.2.9100.23が本体、.29がFixPackになりますので、.23を先に導入します。
![001.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/22a468c5-e0f9-8485-c2ea-f6204d93ab19.png)

※SQL Serverが起動している状態で、.23のモジュールを管理者で実行します。

コンポーネントは、一応全部選択しました。※Agentは本当は不要です。
![008.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/1d15552d-88b7-03a8-0f5d-3a50941f8d1b.png)

リポジトリ用のSQL Serverの指定は以下の指定です。黒塗りの箇所はCCCノードのホスト名です。※正確にはSQL Serverのノードのホスト名。
User nameにsaとパスワードを指定します。
![011.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/2a6c8beb-8e0a-abd9-356b-a952f4e3548c.png)

無事に.23のインストールが終わったら、次に.29のインストールですが、その前にSQL Serverで、NT AUTHORITYユーザーにsysadmin権限を付与する必要があります。

以下の様なファイルを作成して、sqlcmd -U hostname\SQLEXPRESS -i filename で実行しました。

```html
IF NOT EXISTS
(
    SELECT name
    FROM master.sys.server_principals 
    WHERE IS_SRVROLEMEMBER ('sysadmin', name) = 1 
    AND name LIKE 'NT AUTHORITY\SYSTEM'
)
EXEC master..sp_addsrvrolemember
    @loginame = N'NT AUTHORITY\SYSTEM', @rolename = N'sysadmin'
```

これで.29ファイルを実行すると、無事インストールは完了します。

#CCC Clientの操作

デスクトップのClientアイコンか、WindowsのメニューからClientを起動します。
![041.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/d57a4928-2ced-91a7-4053-e2ce017d1983.png)

まずはAgentの登録を行います。
「Agents」を右クリック→Newで、Welcome Kitにある、以下の情報を入力します。
**Setting up an agent in your Cognos Command Center Server**
Host name: XXXX.planning-analytics.ibmcloud.com/ccagent/
Port: 443
Platform: Windows
Agent user name: admin
Agent password: XXXXX

![042.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/9f921086-2c41-37a1-3385-bc8bd47d9a1e.png)

次に、TM1 10.2.2.2に接続用のプラグインを導入します。
「Tools」→「Manage Plugin Tasks」から「Load file」を選択し、
![037.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/4cf27390-e314-92aa-a376-d99531bbe1c1.png)

以下のフォルダから、TM1 10.2.2.2のファイルを選択します。
※IPAへのアクセスですが、TM1 10.2.2.2で問題ありません。
![039.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/d1ab008e-dd5e-1612-75e2-268a40c23de5.png)

「Ecosystems」を新規に作成し、「Computing resources」タブで、接続先のIPAのTM1サーバーを指定します。
Typeは、「TM1 10.2.2.2 Server」を選択します。
![036.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/9cc0ca86-3f71-a01c-2ca8-7090457e8f51.png)

Welcome Kitにある、以下の情報を入力します。
**Setting up a computing resource in your Cognos Command Center Server**
Agent: Select the one you created above
Home Directory: c:\ccc\your_choice
Server endpoint: The TM1 server endpoint. Server endpoint is created by concatenating
"https://"+hostname+"/tm1/api/"+tm1_server_name+"/api/v1".
User name: Your TM1 user name
Password: Your TM1 password

こちらも参考にして下さい。
**Configure a TM1 10.2.2.2 Computing Resource**
http://www-01.ibm.com/support/docview.wss?uid=swg21983018

#CCCの機能
「Ecosystems」の下の「Processes」「File Resources」「Triggers」の下で、ジョブストリームみたいなものを作っていくイメージです。
ここでは、何が出来そうかを書いておきたいので、全機能の画面キャプチャーを貼っておきます。

**「Processes」でできる事**
メールの送信はできそうです。
![001.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/50bf6001-700a-97eb-f569-d93f791e72c9.png)

ファイルの各種操作
![002.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/d3bdbd6f-4209-4300-356a-c896d3c4c15e.png)

ファイルのFTP送信
![003.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/5d71a5fd-543d-d0d4-4281-a912c731bca8.png)

FTPS送信
![004.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/50862977-fb17-a960-9e67-e4ae273e02f2.png)

Cognos BIに対する操作
![005.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/64c78b2c-3797-c337-9688-709c8cc2ce8b.png)

Cognos Integration Serverに対する操作
![006.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/ef7d1d97-2ef8-ceb6-f4da-f6fd099fa9a1.png)

一番知りたい、TM1に対する操作ですね。TIプロセスの実行もちゃんとできます。
![007.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/ffd0f329-3764-308a-0a15-2a4a8675a662.png)

Oracleの色々なS/Wに対する操作
![008.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/0d8c17c3-ff97-1ab5-13c6-44c798147f11.png)

SFTPで送信
![009.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/f649c0a1-920a-d105-6a43-e1f10ce0aad6.png)

サーバーの管理のようですね。
![010.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/c5d0cbf6-e820-13b2-3a18-52cccb483e36.png)

サーバーに対するユーティリティ
![011.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/4e534b2e-b8d1-2820-22c7-0eb56a9a01ce.png)

「Run Process」で、プロセスの中からプロセスを呼び出す事ができます。
![012.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/d922550b-732d-7eee-b56c-ad27b07d61d6.png)

「Run Program」は、バッチファイルを実行したりするようです。
![013.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/b6aac71f-7c01-a25b-9a4e-0e46c46d9925.png)

「Conditional Task」は以下の感じです。
![014.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/0f6d9fd6-d1ac-c5fa-4a39-c0c4b499585c.png)

「Wait on Process」タスクでは、プロセスが完了・起動するのを待って、他の処理をするというのができそうです。
![017.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/816bd54f-2e28-c32b-3ce7-fe5afdf84aaf.png)

例えば、あるプロセスが終わって、何かConditionを評価して、条件に当てはまったらメールを送付するなどできそうです。
![018.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/b7ea0048-8041-33f9-26ed-04d9e8696441.png)

そのた、Sleepとか、色々な処理があります。
![015.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/de1f6aee-2002-3ba6-abdf-a3da13892939.png)

次に、「File Resources」ですが、これはIPAにファイルを送信するタスクのようです。
![016.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/ce66773b-dcdf-6223-fb3e-230968c7b8de.png)


「Triggers」です。指定したファイルが作成・削除・修正されたら、トリガーとなってActionを実行できるようです。
![019.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/5f68c9f9-562c-c54a-27bb-e5f4b2f8be72.png)

Actionは、特定のプロセスを実行するとかのようですね。
![020.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/5b0a11ec-f826-294a-f94d-e77a20e1b3d2.png)


あと、「Process Overview」では、作成したプロセスの実行スケジュールを設定できます。
![021.PNG](https://qiita-image-store.s3.amazonaws.com/0/147246/b38ff394-12e1-94e1-c227-b6bb7a8e870c.png)

という感じで、ジョブスケジューラーとしての、必要最低限の機能は保持してそうですね。

是非、どこかの環境で、本番使用した事例がありましたら、フィードバック頂けると非常にうれしいです。

#参考
CCCのマニュアルのリンクになります。
**Cognos Command Center 10.2.3 documentation**
https://www.ibm.com/support/knowledgecenter/SSPLNP_10.2.3/com.ibm.swg.ba.cognos.ccc.doc/welcome.html