Why doesn't the Planning Analytics Workspace administration tool start?

If you can't launch the Planning Analytics Workspace administration tool or the administration tool exits unexpectedly, check the /log/admintool/up.log for one of the following messages.

Symptoms

One of the following messages appears when the ./scripts/paw.ps1 script runs.

  • "Something went wrong at step 'Starting IBM Planning Analytics Administration Tool' Execution failed with exit code 1"
  • "Cannot start service admintool: failed to create endpoint admintool on network nat: HNS failed with error : Element not found. Encountered errors while bringing up the project."

What to do

Note: All PowerShell commands must be run from an elevated PowerShell session.
  1. Navigate to the Planning Analytics Workspace installation directory, and open the /log/admintool/up.log file.
  2. If the error message mentions HNS, see How do I handle errors with the Host Network Service (HNS)?.
  3. If the error message doesn't mention HNS, run the following command from a PowerShell window:
    ./scripts/paw.ps1

What to do next

If the issue persists, see How do I handle errors when I run the start script?.