License Manager

Starting with ScanImage® 2020, a valid license is required to use ScanImage. The ScanImage® license manager provides a streamlined way to install licenses on a microscope. For any questions regarding licensing contact sales@vidriotech.com.

../_images/SI+License+Manager.PNG

ScanImage® License Manager

License File

../_images/Download+License.PNG

ScanImage® Launch Screen

A ScanImage® license file holds information such as the ScanImage® version and the support status available to the user. A license file is linked to a specific computer via the computer’s host ID.

License File Generation

There are two ways to retrieve a license file for ScanImage® depending on whether the ScanImage® PC is connected to the internet:

  1. The ScanImage® computer has access to the Internet

    • Launch ScanImage

    • From the launch screen, log in with your vidriotech.com credentials

    • Select ‘Download License’

    • Select the license to be used with ScanImage® and click ‘Select License’.

  2. The ScanImage® computer is offline

    • Use your credentials to log on to https://vidriotechnologies.com/my-account/

    • Select ‘Download License’

    • Fill out the form and select ‘Get License’. (See infobox below to retrieve host ID).

    • Select the license you want to use with ScanImage.

    • Copy the license text into a text file with the name ‘license.txt’.

    • Launch ScanImage® and select ‘Open License File’. Select the file from the previous step.

Note

There are two ways to retrieve the computer’s host ID.

  1. Launch ScanImage® - the host ID will be displayed on the launch screen

  2. Open a Windows command prompt and execute the command ‘vol’. The host ID is the volume serial number of the C drive.

License File Storage

ScanImage® stores data in the folder C:\ProgramData\Vidrio\ScanImage\License

If this folder is not writeable, the license file and settings for the license manager cannot be stored. This folder can be deleted to remove all licensing information from the computer.

License File Transfer

To transfer a license to a new computer, generate a new license file and delete ScanImage® and the old license file from the old computer. No deactivation is required.

../_images/Example+license+file.PNG

License File Example

License File Format

The following information is stored in the license file:

License field

Description

License Key

Unique Identifier of the license

Product

Product for which the license is valid

Version

Product version for which the license is valid

License User

User who requested the license

Organization

Organization for which the license was issued

License Contact

Contact at organization who manages the license

Number of Seats

Number of computers on which the license may be installed

License Expiration

Expiration date of the license (if empty license does not expire)

Service Expiration

Expiration date of the support services

Host ID

Unique identifier of the computer

License Generated

Date of license file generation

The license file carries a cryptographic signature. Make sure not to modify the content of the license file to maintain the validity of the signature.

Data Collection

ScanImage® 2019a and later automatically collects license and usage data. This information is used to:

  • Verify the license status of ScanImage® software.

  • Identify commonly used data acquisition and computer hardware.

  • Identify commonly used ScanImage® configurations.

  • Provide data for support.

The collection of usage data can be deactivated in ScanImage® Premium.

Note

Vidrio never collects experiment data or experiment protocols. See the table on the right for a complete list of collected data.

Note

To delete data already transferred to Vidrio contact support@vidriotech.com

To disable all communication between ScanImage® and Vidrio’s license server, execute the following command:

hLM = scanimage.util.private.LM();

hLM.allowCommunication = false;

Data Type

Collected Data

License Data

Vidrio account username ScanImage® version ScanImage® license file Windows computer & user name

Usage Data (can be deactivated in ScanImage® Premium)

Matlab version ScanImage® Machine Data File Installed NI Hardware Computer Hardware Configuration


After licensing, the user can go on to configuring their Machine Data File.