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.

 

windows_services.png

Disable automatic start of the P9 tray application

The Panorama9 agent automatically starts the tray application when an user logins to the desktop. However, if you prefer to disable the tray application just edit the registry key:

32bit system

HKLM\SOFTWARE\Panorama9\Agent\DisableTrayIcon

64bit system

HKLM\SOFTWARE\Wow6432Node\Panorama9\Agent\DisableTrayIcon

"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. 

Panorama9-help.png

 

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

HKLM\SOFTWARE\Panorama9\Agent\ForceHandleAsServer

Windows 64-bit

HKLM\SOFTWARE\Wow6432Node\Panorama9\Agent\ForceHandleAsServer

"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 Dashboard the Panorama9 Agent 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 unconfigured version of the P9 Agent does not initially belong to any client dashboard but you can configure the 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 unconfigured P9 Agent but just use the preconfigured Agent version for a particular MSP client which is much simpler.

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

To configure the P9 Agent for Windows, run the tool:

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 unconfigured Agent:
- when installed the 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 to Agent to a client Dashboard
   MS Windows : Panorama9.Agent.ConfigTool.exe (requires admin privileges)
   Apple macOS: p9-configure-agent (requires root privileges)

P9_Agent_-_Enable_agent_configuration_key.png

Last updated:

Comments