Install the client

Rimscout consists of two components: the client and the portal. The Rimscout clients are installed on user devices where they perform network connection tests and collect network environment data. This data is sent to the portal where the information can be analyzed.

This section covers the steps necessary for the manual installation of your first client.

Installation requirements

First, verify that all system requirements are met. Also allow Rimscout to query the endpoints listed below to function properly.

System requirements

• Windows 7 or higher
• 64-bit system architecture

Main endpoints

The listed endpoints are needed for data synchronization and updates.

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. The connection to that host also ignores any configured system proxy.

Registration and uploading system profile data:

portal.rimscout.com 

Automatically updating the client:

update.rimscout.com

Downloading the client configuration:

config.rimscout.com

Data endpoints

These endpoints are queried by the client to obtain connectivity and network environment information. If these endpoints are blocked, the client will still work. However, some information can't be provided then.

Detecting the public IP address:

checkip.amazonaws.com
www.rimscout.com/getip.php

Measuring the latency to the internet provider and MS Connect endpoint:

internetbeacon.msedge.net
www.msftconnecttest.com 

To check if SSL inspection is done in general (therefore this endpoint should be reachable, but besides this not bypassed anywhere):

ssltest.rimscout.com/

Info

In general Rimscout measures the latency to the first hops of the network using ICMP packets (pings). Therefore, it is recommended to allow ICMP requests.

Download and install the client

The Rimscout client installs itself when it runs for the first time.

1. Go to https://www.rimscout.com/download/ to get the current Rimscout client version.
2. Click on Download and save the Rimscout.zip file.
3. Go to your download folder and unzip the file.
4. Double-click the RimScout.exe file in the unzipped RimScout folder to start the client.
5. Wait until the client status screen will pop up. This might take a moment as the client will install itself.

If the client UI looks similar to the one below you successfully installed the client.

Handle the firewall notification

A firewall notification for Rimscout might show up. Simply click on cancel as it doesn't matter whether this firewall features are allowed or not.

Handle endpoint protection issues

When using an endpoint protection software besides Windows Defender, you might receive a notification during Rimscout installation because it's unrecognized. To resolve this, add an exception or contact your endpoint protection provider.

Register the client

After the installation, a notification will appear indicating that your client is unregistered. Registration is necessary to link the client to your tenant and enable data upload.

To manually register your client

1. Click on the Register link in the notification.
2. In the Register dialog input the auto-generated token that is provided on the portal landing page.
3. Hit Submit and wait until the client is successfully registered.

For more details on client registration visit the Client tokens section.

Verify the setup

If your client(s) are installed and registered you should see them in the Rimscout portal.

1. Open the Rimscout portal and navigate to Analyze > Clients.
2. Check if your client's device name appears in the list. It might take some minutes until a newly registered client appears.
3. If yes, click on Details and verify that the client reports data. The diagrams shouldn't show the message "No data present for the selected period."

Next steps

Configure your tenant