IBM Support

Configure Planning Analytics Workspace on Windows Server 2016 Core (no GUI)

Troubleshooting


Problem

When launching the Planning Analytics Workspace Administration Tool on a Windows install without a GUI, you will receive the following error:
Exception occurred:
This command cannot be run due to the error: Class not registered.

Cause

By default, when launching the Planning Analytics Workspace Administration Tool, the script attempts to launch a browser on the local system to complete configuration.  Since Windows Server Core has no GUI and therefore no browser, the script fails.

Resolving The Problem

Open the scripts\admintool.ps1 powershell script using a text editor.
Locate and comment out the following line:
Start-Process -FilePath "${ADMINTOOL_URI}"
Save the scripts\admintool.ps1 powershell script.
In addition, you will need to allow access to the administration tool remotely.  By default the administration tool is only accessible from the machine where it is installed.  To allow access from an external system, specify the ADMINTOOL_PORT environment variable in the config/paw.ps1 file.
For example:
$env:ADMINTOOL_PORT="8888"
Once both changes are in place, execute the Start.ps1 script to launch the administration tool and connect to the administration tool from a remote machine with a web browser.

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:
22 November 2019

UID

ibm11110441