PingPlotter Cloud Manual

Mass Deployment

 

 

In some situations, you may wish to deploy PingPlotter Cloud Agents to a large number of remote devices using an installation manager instead of manually creating and deploying Agents individually. These steps will help speed up the process.

Note

These instructions are tailored for deployment to Windows devices. We will be adding mass-deployment instructions for macOS shortly. If you need to deploy PingPlotter Cloud Agents to multiple macOS devices, please reach out to our Service Team.

Creating an Agent template for mass deployment

Agent templates allow you to create Agent configurations for repeated or mass deployment.

On the Agents screen, select Create Template.

Your Agent template will let you use a number of variables to generate unique Agent names based on where and when your Agent is created. These variables may be combined with other text to help you easily name and identify multiple Agents once deployed.

Once your Agent template is saved, you may select it from your list of existing templates. You may use a template to generate Agents as needed or use them to mass-deploy multiple Agents at once.

Mass deploying Cloud Agents

Method 1 - Using the Installer .EXE

The easiest way to mass deploy Cloud Agents is to use the installer .EXE file. This will already have the proper configuration ID embedded in it enabling you to use it to deploy many Agents using the same installer.

  • Navigate to the Agents tab, select the Agent template you wish to use, and click the Installer button.

    Cloud Installer button image

  • Distribute the Agent installer to every device you wish to monitor with Cloud. On the remote devices, have your installation management system launch the .EXE installer silently by using the following command:

    [installer directory]/pingplotter_installer.exe /quiet

    This will automate the .MSI extraction and configuration ID insertion covered in Method 2.

  • Alternatively, you can open CMD with Administrator privileges, change the current directory to the location of the executable, and run the installer using the command above.

  • The new Agents will now appear in the Cloud Agents list (you may need to refresh the page to see any newly-deployed Agents).

Method 2 - Using an extracted Agent .MSI

In some cases, you may find it useful to deploy agents using an .MSI file.

  • In addition to the installer, you will need to copy the configuration link ID for the Agent you created. This can be found within the download link URL you used previously to download the Agent. The URL should look like this:

    https://www.pingman.com/account/getagent/?configLinkID=[CONFIGURATION LINK ID]

    Make sure you copy only the configuration link ID (everything after the = sign), not the rest of the URL.

  • Open CMD with Administrator privileges

  • Extract the .MSI from the Agent installer .EXE using the following command:

    [installer directory]\pingplotter_installer.exe /extract="[destination directory]\pppro.msi"
  • If possible, validate your extracted .MSI file by using it to install an Agent on a test machine.

  • From here, you can distribute the extracted .MSI file to every device you wish to monitor with PingPlotter Cloud. On the remote devices, open CMD and change the current directory to the location of the .MSI file.

  • Install the .MSI quietly by using the following command, inserting your configuration link ID:

    msiexec /i pppro.msi /quiet INSTALL_AGENT=1 PM_SERVICE=1 CLIENTCONFIGLINK="[CONFIGURATION LINK ID]"

    For example:

    msiexec /i pppro.msi /quiet INSTALL_AGENT=1 PM_SERVICE=1 CLIENTCONFIGLINK="irhfjys75iufjsyeh5n39fhtnslrofje"

The installer should install the Agent silently and will also appear in the Agents interface of PingPlotter Cloud. At this point, if you've pushed this to multiple machines, multiple Agents should now appear with the same name. You may rename your newly-deployed Agents at any time for easier management.

Important!

Deleting an Agent from PingPlotter Cloud will invalidate the URL for that Agent's download page. In addition, its configuration link and ID will cease to function. This means that you'll no longer be able to use that Agent's Installer or Auto-Setup link to activate new Agents.

Method 3 - Using an extracted .MSI & Auto-Setup links

  • Go to PingPlotter.com - download the Free version.

  • Extract the MSI

    • Using an elevated command prompt, navigate to the directory of your PingPlotter Free download.

    • Extract the .MSI from the PingPlotter .EXE using the following command: (replace brackets with your directories):

      [installer directory]\pingplotter_installer.exe /extract="[destination directory]\pingplotter.msi"
    • For more information on this, see the PingPlotter Manual.

  • Deploy the MSI to remote machines 

    • You can use various tools to accomplish this (ManageEngine - Desktop CentralPDQ DeployGroup Policy, or SCCM)

    • In an elevated command prompt, use this command to install the program with the Windows Service (replace brackets with your filename):

      msiexec /i [MSI file name] PM_SERVICE=1 /quiet

To activate an Agent:

  • Within the Cloud Interface, click on the Agents menu button in the sidebar. At the top of the next screen, select Create Agent - you will be prompted to name the Agent.

  • Once created, select the Agent row and click the button in the lower-right corner called Auto-Setup. This will copy an activation link to your clipboard.

  • Paste this link into the web browser of the remote machine and hit Enter to activate it as a PingPlotter Cloud Agent. Alternatively, you can share this link with another person and have them enter it into their web browser for you.

  • Once your Agents are deployed, you may need to refresh the Agents page. Each Agent will be listed with the name you created earlier; you'll notice the Machine Name of each Agent corresponds to the deployed device.

Important!

Deleting an Agent from PingPlotter Cloud will invalidate the URL for that Agent's download page. In addition, its configuration link and ID will cease to function. This means that you'll no longer be able to use that Agent's Installer or Auto-Setup link to activate new Agents.