Introspect installation and instrument registration

This article summarizes how to install Introspect and register instruments.

Supported instruments:

• Fluent
• Veya
• Freedom EVO
• Digital Dispensers Uno, Duo and D300e

To be able to register an instrument to Introspect^TM make sure that the latest IoT Client is installed. It requires IoT Client v2.8 or 3.0 and newer. You might need to update the IoT Client, please find here the link to download the IoT Client 2.8 and 3.1.

Compatibility:

IoT Client 2.8: for FluentControl 3.6 and lower and for all versions of Freedom EVOware

IoT Client 3.1: for FluentControl 3.7 and newer and vControl 1.1 and newer

Note: Digital Dispensers Uno, Duo and D300e are now supported as well, here is how to connect them: How to connect your Digital Dispenser to Introspect for DispenseControl

Download the IoT Client – Zip – File, extract all files and start the Setup with local Windows administrator rights. The setup runs the installation program to install the IoT Client.

After the installation was completed you find the IoT Client Configuration tool in the task bar. Select the red IoT Client icon with a right mouse click. This opens the menu where you can start the registration window by clicking register.

IoT Client 3.0 and newer:

1. To begin IoT client registration, right-click on the red IoT client icon  located in the taskbar.
2. Select “Settings”, to open the Configuration tool.
3. Navigate to the configuration tab and enter the Alias if required, the proxy and certificate details can be added optionally.
4. If the instrument PC connects to the internet through proxy server, click on DETECT PROXY SETTINGS. If the proxy server requires authentication, enter username and password.
   
   
   
   
5. Once you have entered the necessary details in the configuration tab, navigate to the registration tab and click on REGISTER IOT CLIENT.
6. You will be asked to login with your Tecan account credentials (email-address and password)
   
   If you don’t have a Tecan Account yes, click SIGN UP and fill out the sign up form. You will get an email to activate your account and after the activation was successful your account is ready for the registration.
   
   
7. After successful registration, start IoT client service.
8. Once the IoT client service is started successfully, navigate to the status tab to verify the system status and it should all be green and running.
   
   
   
   

IoT Client 2.8 registration:

1. To begin IoT Client registration, right-click on the red IoT Client icon located in the taskbar.
   
   
   
   
   
   
   
   
   
   
   
2.  Select Register
   
   
   
   
   
   
   
   
   
3.  Fill in the fields in the registration window as displayed starting at the top by selecting the platform type and size. Fields marked with an * are required for the registration, the proxy settings and Custom SSL certificate are optional and depend on your IT infrastructure settings. Once all required fields are entered, click Register. 
4. You will be asked to login with your Tecan account credentials (email-address and password)
5. There will be a message after the registration was successful. The IoT client icon in the tray icon will turn green after approx.1 minute and starts parsing data.
   
   If you don’t have a Tecan Account yes, click SIGN UP and fill out the sign up form. You will get an email to activate your account and after the activation was successful your account is ready for the registration.
   
   
6. The next step will be to assign the instruments to an organization and to users, which is needed that you are able to see the data in Introspect.
   
   

Setting up the organization

Assign users and instruments in the Organization management page. A user with administrator rights in Organization Management has to configure the structure of the organization to provide users access to instruments data. At minimum, one layer must be assigned with instruments and users.

In the section Organization Management Managing instruments in Introspect you can find the instructions for setting up the organizations.

Firewall

If no data is sent after the installation and set up have been completed, you might need to check the firewall settings. The firewall must allow data to be sent using WebSockets, and the URLs in the table below must be accessible.

These URLs need to be whitelisted in the firewall.

Activate WebSocket

Depending on the settings on the local network, WebSockets might be blocked. This is most likely due to explicit blocking by the local IT set-up. If that’s the case, they should be activated for the above listed URLs. If there are no specific local configurations to block WebSockets, they are usually activated by default.

Proxy server

In case you manage your internet access via a proxy server, the settings can be detected automatically. Otherwise, the address and port number can be set manually during the registration of the IoT client. 

If the proxy server requires authentication, IoT client provides the ability to configure username and password.

Troubleshooting

In case some of the IoT Client states are not green, check the following:

• IoT Client Not Running:
  • Try to start the IoT client from the tray icon or contact your support.
• Not Registered:
  • Either the IoT client is not running or that the iot client is not registered. Initiate the registration process.
• Tecan Cloud Connection:
  • Either the IoT client is not running, is not registered or the iothub URL over MQTT (8883) cannot be reached. Check that port 8883 and 443 are open and https://tecan-iot-hub-prod.Azure-devices.Net/* domain is whitelisted.
• Internet Connection:

This one is red if the IoT client is not running or if the https://digital.tecan.com over HTTPS (port 443) cannot be reached. Check that port 443 is open and digital.tecan.com domain is whitelisted. 

Further help

For further help, please refer to our Helpdesk.

Link to Tecan Product Page

Introspect^TM Page 

403020-003