Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Troubleshoot Location Services Using the RF Environment

In your Juniper Mist network, you can use the RF Environment (also known as RF Glasses) for troubleshooting location accuracy issues. This tool helps you gain insight into what is going on with Mist SDK-enabled clients and named assets.

Video Demo

Steps

  1. From the left menu of the Juniper Mist portal, select Location > Live View.
  2. Click the site and the floorplan that you want to troubleshoot.
  3. Adjust the page settings to show the app clients:
    1. Click the Settings button (near the top right corner of the page).
      Settings button
    2. In the Location Settings window, select the Show App Clients and Show App Clients (Cellular) check boxes.
      check boxes on the Location Settings window
    3. Click X to close the Location Settings window.
      The floorplan displays any clients that are running the Juniper Mist SDK.
  4. Select a client and record the RF environment:
    1. Select the Clients tab on the right side of the page, and then select the client that you want to troubleshoot.
    2. Click RF Environment (near the bottom right corner of the page).

      location of the RF Environment link in the right panel

      Note:

      The RF Environment link is available only for SDK clients, named assets, and connected wireless clients.

    3. Click Record Session (near the top right corner of the page).
      • Your session begins recording. A progress bar appears at the top of the screen.

      • In the Rename Session window, you can rename the session recording or close the window to keep the current date and time as the session name.

      • When finished, click Stop Recording.

        Note:

        If you do not stop the recording manually by clicking the button, the recording stops automatically after three minutes.

  5. Replay the recording:
    1. From the left menu, select Location > RF Environment Replay.
    2. From the Recorded Sessions list, click the session you just recorded.
      RF Environment Replay page

    You will see your recording. You can use it to gain an understanding of the current issues, troubleshoot, or send to customer support for review.

    Example: replaying the RF environment recording

Troubleshooting Tips

When troubleshooting in the RF Environment, pay attention to these elements:

  • Smoothed Location Estimate

    The lime green colored dot represents the smoothed location estimate. (See the Legend in the top right corner of the page.) This estimate takes the received signal strength indicator (RSSI) data and smooths it out for accuracy and user readability.

  • Beams and Beacons

    On the right side of the page, see how many access points (APs) the client detects. Look at:

    • Beams per second

    • Beacons per beam per second

    These RSSI values come from the AP from the client’s perspective. They indicate how many APs the client detects and the number of beams the client detects from the AP.

  • Speed and Direction

    On the right side of the page, Speed and Direction are updated as the client moves within the site.

    • When the client is in motion, the probability surface spreads out.

    • As the client slows down or becomes still, the probability surface shrinks.

    • The red area depicts the peak of the surface and the highest probability of the client's location.

    • The blue area depicts the lowest area of the surface and the least probability of the client's location.

Keep in mind:

  • With a lower-than-average number of beams per second or beacons per beam per second, location accuracy might deteriorate.

  • If the RSSI values are not updated for SDK clients, the client is offline.

  • If the RSSI values are not updated for assets, data from the tag is not detected.

  • If the RSSI values are missing, the environment has less data to work with. Less data means that location accuracy might deteriorate. If you notice missing RSSI values: