Skip to content

Quick Start Guide

This quick start section briefly explains how to set up Rimscout.

Rimscout generally consists of two components that need to be configured/installed: The portal and clients.

Portal

Login to the portal

  1. Go to https://portal.rimscout.com
  2. Login with your Microsoft username and password.
  3. On first login grant consent for the Rimscout Portal.

You will see the landing page. welcome

If you want to grant others access to your tenant as well read Manage access.

Configure the portal

In order to allow clients to send their data to the Rimscout portal you have to create client tokens.

If your user devices are domain joined you can use the domain SID as a token.

  1. Navigate to Configuration > Client tokens
  2. Click on the Create button.
  3. Select the token type Domain SID
  4. Input your domain SID (Retrieve a domain SID)
  5. Add a description and specify the maximal number of clients that can use this token. Save the token.
  6. Clients on domain joined devices will now automatically register themselves on start.

If your clients aren't domain joined and you want to manually add them, you can also use an auto-generated token.

  1. Again click on the Create button
  2. Make sure the token type Auto-generated is selected
  3. To create an auto-generated token just add a description and specify how many clients may use this token. Save the new token.
  4. Use this token to register newly installed clients either by deploying the token to the registry or registering the client manually.

It is useful but not necessary to configure locations for the clients. The Locations section describes how to do so.

Client

Installation requirements

  • Windows 7 or higher
  • 64-bit system architecture
  • Clients need to be able to access the following domains using HTTPS (for updates and data synchronization)

Uploading connectivity data to the Rimscout backend: 

iot-rimscout-clients.azure-devices.net

Important

There may not be any SSL inspection (e.g. by a firewall) for packets going to iot-rimscout-clients.azure-devices.net.

Registration and uploading system profile data: 

portal.rimscout.com
Automatically updating the client: 
update.rimscout.com
Downloading the client configuration: 
config.rimscout.com
Detecting the public IP address: 
checkip.amazonaws.com/

Download and install the client

  1. Go to https://www.rimscout.com/download/
  2. Click on Download and save the Rimscout.zip file.
  3. Go to your download location and unzip the file.
  4. Double-click the RimScout.exe file in the unzipped RimScout folder.

The client installs itself and after a short time the client status screen will pop up. For details about the client installation see Client local folders.

rimscout-startscreen

Handle the firewall notification

A firewall notification for Rimscout might show up. Simply click on Cancel. rimscout-firewall

Register a client

If a client is not automatically registered, a notification will be shown. To manually register the client

  1. Click at the Register link in the notification.
  2. In the Register dialog input an auto-generated token you created on the portal
  3. Hit Submit and wait until the client is successfully registered.

register-token

Verify the setup

If the portal and the client(s) are correctly set up you should see all your registered clients in the portal.

  1. Navigate to Clients
  2. Check if your client's device name appears in the list.
  3. If yes, click on Details and verify that the client is reporting data. The diagrams shouldn't show the message "No data present for selected period."

In case of any issues with the setup, contact support@rimscout.com.

Info

It might take up to 15 minutes until a newly installed client appears on the clients list. Usually it takes only a few minutes.

Next steps

After completing the initial configuration steps outlined in the quick start guide, you can explore additional features and functionality of Rimscout in the following user guide articles:

Understand how to use the Rimscout data for monitoring and troubleshooting by learning about the health of your clients:

Explore the types of Rimscout tests and learn how to create your own custom tests:

Learn more about setting up alerts and include them in your existing monitoring setup:

Create locations to know where your clients report from: