IBM Support

Error response from daemon when running admintool.ps1 or answering Yes to "Start the Administration Tool?" question

Troubleshooting


Problem

PAW has been correctly installed and the images have been loaded by Start.ps1 (or underlying /scripts/build.ps1) ; the admintool image is listed when running "docker images" or "docker image ls" command.
Despite this, the administration tool container cannot be run. The message is as follows :
Starting IBM planning Analytics Workspace Administration Tool, please wait... Error response from daemon: {"message":"no such image:......}

Cause

Bad or too old version of Docker

Diagnosing The Problem

In Powershell, type this command to show the Docker version :
Here are examples of correct results :
PS C:\> docker version
Client:
 Version:      17.06.2-ee-16
 API version:  1.30
 Go version:   go1.8.7
 Git commit:   9ef4f0a
 Built:        Thu Jul 26 16:43:19 2018
 OS/Arch:      windows/amd64
Server:
   Version:      17.06.2-ee-16
  API version:  1.30 (minimum version 1.24)
  Go version:   go1.8.7
  Git commit:   9ef4f0a
  Built:        Thu Jul 26 16:52:17 2018
  OS/Arch:      windows/amd64
  Experimental: false
or :
PS C:\> docker version
Client: Docker Engine - Enterprise
 Version:           18.09.8
 API version:       1.39
 Go version:        go1.10.8
 Git commit:        90e30bdf98
 Built:             07/16/2019 17:13:22
 OS/Arch:           windows/amd64
 Experimental:      false
Server: Docker Engine - Enterprise Engine:
  Version:          18.09.8
  API version:      1.39 (minimum version 1.24)
  Go version:       go1.10.8
  Git commit:       90e30bdf98
  Built:            07/16/2019 17:11:04
  OS/Arch:          windows/amd64
  Experimental:     false
Here is a example of bad result that can cause this error :
PS C:\> docker version
Client:
 Version:           1.12.0-dev
 API version:       1.24
 Go version:        go1.5.3
 Git commit:        8e92415
 Built:             Thu May 26 17:08:34 2016
 OS/Arch:           windows/amd64
Server:
  Version:          18.09.7
  API version:      1.39
  Go version:       go1.10.8
  Git commit:       b81f47481d
  Built:            06/27/2019 17:57:09
  OS/Arch:          windows/amd64
 
In that last case,
The docker "Client" is very old compared to the docker "Server" version.

Resolving The Problem

Before upgrading the Docker version, make a backup of PAW by running <PAW>/scripts/backup.ps1
This will create a <PAW>/backup directory that will contain a backup of all databases (that contain users, books, and other things)
Caution : this will stop and restart PAW containers automatically.
Once done, run one of these commands in Powershell, depending on the Docker version that is needed :
Install-Package -Name docker -ProviderName DockerMsftProvider -RequiredVersion 18.09 -Update -Force
Install-Package -Name docker -ProviderName DockerMsftProvider -RequiredVersion 18.03 -Update -Force
Install-Package -Name docker -ProviderName DockerMsftProvider -RequiredVersion 17.06 -Update -Force
This command will install the latest build of the required version.

Document Location

Worldwide

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSCTEW","label":"IBM Planning Analytics Local"},"Component":"Planning Analytics Workspace","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
03 September 2019

UID

ibm11072596