Planning Analytics Workspaceの構築時に役立つ操作メモ
PAWの構築って毎度毎度苦労しますね。
同じ手順をやっているつもりでも、何故かうまく行ったり行かなかったり。
今回も相当苦労しましたので、自分のメモも兼ねて、情報共有しておきます。
環境は、Planning Analytics Workspaceの2.0.54@Windows 2016 Serverです。
マニュアル箇所
インストール時に役立つマニュアルのリンクは、
Installing Planning Analytics Workspace Local 配下の各ドキュメントと、
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/c_paw_install_overview.html
こちらのTroubleShootingの下も忘れずに読みましょう。
How do I fix my Planning Analytics Workspace Local installation?
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/c_troubleshooting_paw_local_installation.html
初期構築時
操作は基本はPowerShellを管理者モードで立ち上げて行います。
初期構築時は、このStart.ps1の実行で行いますが、なんと言っても初期構築ではまりガチなのが、アンチウィルスソフトが動作している事です。Start.ps1で非サポートのウィルスソフトの確認をしますが、関係なく構築失敗しますので、アンチウィルスは止めておきましょう。Start.ps1を実行しても、CPUがぶん回らない時、アンチウィルスでブロックされている可能性が高いので、時間かかるな～と、気長に待ってないでCPUの使用具合は確認しましょう。
アンチウィルスS/Wで何を除外すれば良いかは、そのS/Wによって異なるようなので、実際にやってみて試すしかないですが、少なくともDockerの以下のガイドは読み、「C:\Program Files\docker」や「C:\ProgramData\docker」は除外しておきましょう。
https://docs.docker.com/engine/security/antivirus/
通常の起動停止
Windowsサービスのdockerサービスを起動すれば、PAWの各種コンテナーも一緒に起動されますが、少なくとも停止はdockerサービスの停止ではダメです。
PAWの展開先のscriptフォルダの下に移動し、
paw.ps1 stop
で停止して下さい。
このコマンドだとdockerサービスまでは停止しないので、このまま起動したい場合
paw.ps1
となります。
起動判定
docker ps
の実行で、必要なコンテナのSTATUSがUp になっているか確認。
docker ps --format "{{.Names}} {{.Status}}"
このコマンドにすれば、もうちょっと見やすいです。
PAWのバージョンによってバリエーションや数は変わると思うので、自分の環境で何が起動していれば良いかを知っておく事は大事です。
docker ps -a
を実行すると、Up以外のステータスのコンテナーも表示されます。
コンテナーのステータスが「Dead」や「Removal In Progress」とかなっているものは、何とかしないといけません。
Removal In Progressからの復旧
よくこの状態になりますが、放っておいても直りません。
直し方の1番目は、
docker container inspect コンテナID
で、以下のようにIdの詳細見れるので、
エクスプローラーで、C:\ProgramData\docker\containersの下の該当のフォルダに行き、
config.v2.jsonを開き、RemovalInProgressを「false」に修正し、
docker container rm コンテナID でコンテナを削除し、
その後 paw.ps1 stop → paw.ps1で再起動してみる。
直し方の2番目は、
結局何かがコンテナーをつかんでRemoveを妨げているようなので、ズバリWindows OSの再起動が必要です。
Deadの直し方
いくつかのコンテナーのステータスがDeadになっている状態で、paw.ps1で起動しても、起動エラーとなる場合があります。
そういう場合は、
docker container prune
を行うと、Deadのコンテナーの削除ができますので、削除できれいにした後に、
paw.ps1 stop
paw.ps1
で再起動すると、コンテナーが再作成されます。
全部消して一からやり直したい
結局何もかもダメになってしまって、まっさらに一からやり直したい場合。
scriptsフォルダ上で、
paw.ps1 down --rmi all -v
で削除します。
こんな感じのコマンドで確認していって、imageが残っている場合、
docker system prune --volumes --all
コンテナーが削除されずに残ってしまった場合、個別に削除。
dockerそのもののアンインストール
Uninstall-WindowsFeature containers
コマンドウィンドウで以下を実行し、サービスからdockerの登録解除
sc delete docker
dockerのインストールパスのリネーム
dockerのデータパスのリネーム
Workspaceモジュールの解凍先のリネーム
dockerのネットワークはこの状態のままで良い
Windows OSを再起動
Workspaceモジュールの再解凍
Start.ps1
dockerは導入されるので、再度Windows OSを再起動
もう一回、
Start.ps1
で導入を進める。
管理者登録
誰かしらのユーザーを管理者に格上げしたい場合
コマンドウィンドウで、以下のコマンドを打って
docker exec -it wa-proxy powershell -command "C:\wa-proxy\tools\runTool.ps1"
対象ユーザーのuserIdを確認し、
以下のコマンドで、userIdを指定して実行
docker exec -it wa-proxy powershell -command "C:\wa-proxy\tools\runTool.ps1" userIdを指定
管理機能が使用可能になります。
MongoDB停止設定
PAW停止せずに、いきなりWindows OSを停止するとMongoDbコンテナーが破損するようなので、この設定を入れましょう。
Shut down MongoDB cleanly on Windows Server 2016
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/t_paw_shutdown_on_windows_mongo_db.html
バックアップ後に起動不可にならない注意点
PAWはブックやビューなどのコンテンツの保管場所は、TM1のCube内やDataフォルダ内ではなく、PAWのコンテナーの中に保管されるので、PAW独自のバックアップが必要です。
https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/t_paw_backup_restore.html
コマンドとしては、PowerShellで、\scripts\backup.ps1で行いますが、バックアップ中にPAWの各コンテナーが勝手に再起動されますので、必ずオフラインバックアップになります。
30分程度は停止時間を確保するようにした方が良いです。
さて、そのバックアップ中の再起動時に、「Starting コンテナー名...」という表示で起動する時と、「Recreating コンテナー名...」という表示で起動される時があります。
そして残念な事に「Recreating コンテナー名...」の場合、結構な確率で起動できないコンテナーが発生し、破損してしまうコンテナーも出てきます。
なので、「Recreating」ではなく「Starting」で必ず起動する状態にしておく事が必要です。
これはどのように行うかというと、PowerShellでバックアップを取得する場合は、PowerShellのプロンプト上で、一度、paw.ps1 stop+paw.ps1しておく事が必要なようです。
落とし穴になりガチなのが、バックアップは、タスクスケジューラー等からウィンドウズバッチを呼び出して定期取得する運用にする場合です。※むしろ一般的
この場合、バックアップの運用に入る前に、一度コマンドウィンドウ上で、
Powershell.exe -File C:\CognosPAW\scripts\paw.ps1 stop
Powershell.exe -File C:\CognosPAW\scripts\paw.ps1
しておくと、バックアップ後の起動が「Starting」になるので、ちゃんとバックアップが成功するようになります。
PowerShellではバックアップ成功したのに、バッチではエラーになる場合、こちらをお試し頂ければと思います。
vEthernet(HNS Internal NIC)が消えてしまった場合
Start.ps1はこのエラーで失敗
get-containernetwork でnatが表示されるのはNGみたい。
これを削除したい場合、get-containernetwork | remove-containernetwork では消えないので、
net stop HNSでHNSサービス停止。
このファイルを削除
HNSを起動すると、natは消えていて、docker再起動するとvEthernet(HNS Internal NIC)は復活します。
特定のコンテナーが停止しない
paw.ps1 stopでコンテナーが停止せずに残ってしまう事があります。こういう状態でpaw.ps1で起動すると、大概起動エラーになります。
コンテナーの停止は、以下のコマンドでやっておきましょう。
以上です。
バージョンが上がれば、色々と解消されてくるものはあるかも知れませんが、Planning Analytics Workspace 2.0.54 の例として参考にして頂ければと思います。