Configure the P9 agent for Microsoft Windows

Table of contents

Once the Panorama9 agent has been installed it will run silent in the background collecting information about the machine and forward it to the Panorama9 cloud. The agent is automatically updated when a new version is released.

Command-line utilities

From time to time you're required to do maintenance work on e.g. a server. Any monitored services that you stop will result in Panorama9 generating an issue and sending you a notification, if you've configured the dashboard to warn you when something is broken. Rebooting the server would result in even more notifications coming your way. Until you've completed your work a stream of disturbing and needless notifications could be filling up your inbox. This is easily avoided by temporarily suspending notifications.

Suspend notifications:

C:\>"%ProgramFiles%\Panorama9\p9-suspend-notifications.exe" -h

(Note: The "-h" argument lists required and available command-line arguments)

You may through the command-line enable/disable the Panorama9 Connect client. Use this with e.g. a logon script if you wish to bulk enable the Panorama9 Connect client.

Enable Panorama9 Connect (allow permanently access):

C:\Program Files\Panorama9>p9-connect.exe --start 

(Note: The "-h" argument lists required and available command-line arguments)

Manually start and stop the Panorama9 agent

You may stop the Panorama9 agent through the Microsoft Windows Service application. Scroll down and locate the "Panorama9 Agent" service and click "Stop Service". This will stop the Panorama9 agent and any communication with the Panorama9 cloud. To disable the built-in update engine stop the "Panorama9 Agent Updater" service. To start the Panorama9 agent again just click on "Start Service" and it will resume reporting to the Panorama9 cloud.



Disable automatic start of the P9 tray application

The Panorama9 agent automatically starts the tray application when an user logins to the desktop. If you are an MSP, thus you have access to the Panorama9 MSP Control Panel, you can edit an existing "Branding" template or create a new that disables the P9 tray application.


Otherwise the tray application can be controlled by editing the registry key:

32bit system
64bit system
"DWORD" should be set to 1 in order to disable the tray icon (0=enabled)

The Panorama9 Agent will continue to run silent in the background and report to the Panorama9 cloud.  

Change classification of machine from "computer" to "server"

The Panorama9 backend will automatically guess if your Microsoft Windows installation is a server or a regular workstation. However if you wish to force set the classification it can easily be changed.

To do this, you’ll have to edit the registry:

Windows 32-bit
Windows 64-bit
"DWORD" should be set to 1 in order to force the Panorama9 system to see the machines as a server

(If the regkey doesn't exist, then create a new DWORD value under HKLM\SOFTWARE\Panorama9\Agent\ give it the name ForceHandleAsServer and set the value to 1)

After changing this, the P9 agent should be restarted.

For more info about configuring the machine classification see here.

Configuration tool: Add device to a given client Dashboard

This tool allows you to configure which client P9 Dashboard the device should belong to (only relevant if your Panorama9 subscription includes the MSP Control Panel).

Normally the P9 Agent is preconfigured to belong to a particular MSP client Dashboard. The un-configured version of the P9 Agent does not initially belong to any client Dashboard, but allows you to configure the P9 Agent at a later point in time. When you run the configuration tool on the device, you then select the client Dashboard it should belong to. An example case could be when provisioning of a client or client device can't be accomplished before the P9 Agent is installed, e.g. as part of a generic software package installed on the end user machine.

Typically you will not need the un-configured P9 Agent but just use the preconfigured P9 Agent version for a particular MSP client.

Running the configuration tool requires an API key. To generate a key login to the the Panorama9 MSP Control Panel, then navigate to "Extensions" -> "P9 Agent" and enable the agent configuration key.

The P9 Agent configuration tool can be found in the folder:

Windows 32-bit

C:\Program Files\Panorama9\Panorama9.Agent.ConfigTool.exe

Windows 64-bit

C:\Program Files (x86)\Panorama9\Panorama9.Agent.ConfigTool.exe


Some things to note about the un-configured P9 Agent:

  • When installed the P9 Agent will be inactive and invisible on the end user machine until it is configured.
  • Use the configuration tool found in the P9 Agent folder to connect the device to a client Dashboard
    • Panorama9.Agent.ConfigTool.exe (requires admin privileges)


Last updated: