You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.

29: How to quickly troubleshoot PolicyPak Browser Router

Step 1: Are you licensed? And did you reboot the endpoint?
Each component of PolicyPak On-Prem is licensed separately.
PolicyPak Browser Router is licensed with a license key, and that license key is typically inside a GPO.
To understand how / where your license keys might live, please check this video:

Also, before continuing, reboot the endpoint with the PolicyPak CSE / PolicyPak Browser Router installed upon it.
PolicyPak Browser Router may need a reboot the first time for all features.

Step 2: Are you getting the GPO?
You need a GPO to make the routes. Make sure the following is true:

  1. You have a GPO.
  2. GPO is linked to either USER or COMPUTER OU.
  3. The GPO has data / routes in it for the correct side.

In this example, the GPO has data / routes on the user side and is correctly linked to where users reside (West Sales Users.)

Step 3: Verifying you GOT the GPOs… one for licensing and one for the routes.
Run GPresult /R two times:

  1. AS an ADMIN.. and verify that you got the LICENSING GPO.
  2. As the USER .. and verify you got the GPO with the PolicyPak Browser Router data.

Step 4: Is PolicyPak Browser Router the “default browser” ?
In DEFAULT PROGRAMS, verify that PPBRAgent is the Default Browser for HTTP and HTTPs.
(Will be PPBRAgent32 on 32-bit and PPBRAgent64 on 64-bit).

WARNING: For Non-Domain Joined machines, we (PolicyPak) cannot set this automatically. For more information on this problem, see this article.

For Domain joined Windows 10, Look at Default Programs here,

For Domain Joined Windows 7, check Default Programs as seen here,

CHECKPOINT: If PPBRAGENT is not the default for HTTP and HTTPS then, run GPupdate /force then REBOOT the computer.

Then verify that it took. If it didn’t, stop here and figure out why.

Common reasons:

  1. Computer doesn’t have PolicyPak CSE installed.
  2. Computer isn’t licensed.
  3. User/ Computer didn’t get the GPO.
  4. No PolicyPak Browser Router routes at all.
  5. Again: For NON-Domain Joined machines, you must set PolicyPak as the default browser MANUALLY. There is no workaround.

Step 5: Check PolicyPak Browser Router logs
As the USER, go to AppdataLocalPolicyPakPolicyPak Browser Router and verify that ANY logs exist as seen here.

Open the LATEST-created file (by date) for inspection.

Step 6: Checking what PolicyPak Browser Router thinks are your routes
PolicyPak Browser Router can take routes from various sources and multiple GPOs and/or files and/or PolicyPak Cloud.
Ultimately those rules are boiled down to one file: ppBRresults.xml.

You should manually inspect this to verify that routes are generated as expected.

Step 7: Getting more help (exactly what to do and attach.. THREE THINGS).

To get MORE help with PolicyPak Browser Router, first export your PolicyPak Browser Router collection as seen here.

It’s good to take a screenshot too, so we can see what you’re trying to; computer or user side.

Attach / send both your SCREENSHOT and your XML EXPORT file to your support case.

Then, run PPLOGS twice:

  1. Use an ADMIN command prompt and run PPLOGS. Rename to Attach to your support case.
  2. Use a NORMAL command prompt and run PPLOGS. Rename to Attach to your support case.

NOTE: If your email system strips ZIP files, rename it to .ZIPP or .TXT or whatever you want.

  • 427
  • 05-Apr-2024