Troubleshooting
Problem
IBM Planning Analytics Workspace (PAW) relies on Docker, which is a non-IBM software.
Docker can be installed on Windows Server 2016 by simply running these two commands in Powershell :
Install-Module DockerMsftProvider -Force
Install-Package Docker -ProviderName DockerMsftProvider -Force
Docker can be installed on Windows Server 2016 by simply running these two commands in Powershell :
Install-Module DockerMsftProvider -Force
Install-Package Docker -ProviderName DockerMsftProvider -Force
But sometimes, on some machines, the Install-Package command may terminate with this error :
WARNING: Cannot verify the file SHA256. Deleting the file.
Sometimes it can be worked around by installing a specific version of Docker:
-Install the latest known build of 18.09.x version :
Install-Package -Name docker -ProviderName DockerMsftProvider -RequiredVersion 18.09 -Update -Force
-Install the latest known build of 18.03.x version :
Install-Package -Name docker -ProviderName DockerMsftProvider -RequiredVersion 18.03 -Update -Force
-Install the latest known build of 17.06.x version :
Install-Package -Name docker -ProviderName DockerMsftProvider -RequiredVersion 17.06 -Update -Force
But sometimes none of these commands work.
Cause
Microsoft issue
Resolving The Problem
1) First step is to download a "manifest" file that contains the list of known Docker package versions along with the correct URL to download them:
To download the correct version of the package, you’ll have to get the manifest and to look for your version to get the right URL :
Run this is Powershell: (or directly type the URL in an internet browser to download the file)
Start-BitsTransfer -Source https://dockermsft.blob.core.windows.net/dockercontainer/DockerMsftIndex.json
After that, DockerMsftIndex.json is placed in the current directory.
To download the correct version of the package, you’ll have to get the manifest and to look for your version to get the right URL :
Run this is Powershell: (or directly type the URL in an internet browser to download the file)
Start-BitsTransfer -Source https://dockermsft.blob.core.windows.net/dockercontainer/DockerMsftIndex.json
After that, DockerMsftIndex.json is placed in the current directory.
2) Open DockerMsftIndex.json in a text editor and copy the URL that corresponds to the version you want to install:
For example,for version 18.09.9 :
https://dockermsft.blob.core.windows.net/dockercontainer/docker-18-09-9.zip
For example,for version 18.09.9 :
https://dockermsft.blob.core.windows.net/dockercontainer/docker-18-09-9.zip
3) Still in Powershell, go to the directory where the "install-package" command usually puts the downloaded package files, which is here:
cd C:\Users\<UserName>\AppData\Local\Temp\DockerMsftProvider\
(just replace UserName by your own)
cd C:\Users\<UserName>\AppData\Local\Temp\DockerMsftProvider\
(just replace UserName by your own)
4) Now download the Docker package:
Start-BitsTransfer -Source https://dockermsft.blob.core.windows.net/dockercontainer/docker-18-09-9.zip -Destination /docker-18-09-9.zip
Start-BitsTransfer -Source https://dockermsft.blob.core.windows.net/dockercontainer/docker-18-09-9.zip -Destination /docker-18-09-9.zip
5) Computes a new SHA256 Hash value for this file (don't change anything to the file after doing this):
Get-FileHash -Path /docker-18-09-9.zip -Algorithm SHA256
Get-FileHash -Path /docker-18-09-9.zip -Algorithm SHA256
6) Now the installation can be done:
Install-Package -Name docker -ProviderName DockerMsftProvider -Verbose -RequiredVersion 18.09.9
Install-Package -Name docker -ProviderName DockerMsftProvider -Verbose -RequiredVersion 18.09.9
7) Restart the machine:
Restart-Computer
Restart-Computer
Now you can finish the PAW installation, which is another subject (in brief: download docker-compose.exe and put it in Program Files/Docker folder, run Start.ps1, run the admintool, validate, update, start containers with /scripts/paw.ps1 ...)
Document Location
Worldwide
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSCTEW","label":"IBM Planning Analytics Local"},"Component":"PAW;Planning Analytics Workspace;docker","Platform":[{"code":"PF033","label":"Windows"}],"Version":"2016","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]
Was this topic helpful?
Document Information
Modified date:
10 October 2019
UID
ibm11085859