Use software generated UUID

Follow

This article will walk you through the issues of duplicte UUID, what is software-generated UUID and how it is useful.

What is duplicate UUID

When you install or deploy Splashtop streamer on your computer, Splashtop streamer will generate a UUID (unique identifier) for the computer. The way of generating UUID is basing on the computer’s GUID (global unique identifier) and its hardware identifier, like MAC address. These hardware characteristics are unique theoretically, which makes UUIDs should never be duplicate between computers. However, the UUID collision still happens in rare conditions, especially when you have virtual machine setup in your environment.

Symptoms

When two of your computers have the same UUID, following problems may happen:

  • Only one of the cloned computers will show up in the computer list.

  • When you try to connect to that computer in the computer list, connection may be randomly to any of the cloned computers.

  • If you restart the streamer on one of the cloned computer, it will appear in your computer list and take precedence over all the other clones.

To fix these issues, we introduce a different way of generating UUID since version 3.4.8.0.

Software-generated UUID

Under this generation method, UUID is randomly generated by software without referring any hardware identifiers. This will prevent the duplicate UUID cases from happening.

To use the software-generated UUID on your streamer, enable the option “Use software-generated UUID“ when you deploy Splashtop streamer. See the detailed steps below:

  1. Log into my.splashtop.com / my.splashtop.eu and click on Management > Deployment.
  2. Click on the Create Deployment Package button.
  3. Enable the Use software-generated UUID option.
    sw-gen-uuid_en-us.png
Note: The deployment option can only be set at deployment packge configuration, and cannot be configured on streamer settings.

 

Besides, there is also another way to fix the UUID duplicate issue by re-generating UUID via URI command:
  • For Windows users, please type this command into Terminal:
    st-streamer://com.splashtop.streamer?resetuuid=1
  • For Mac users, please type this command into Terminal:
    open st-streamer://com.splashtop.streamer?resetuuid=1
  • For Linux users, please type this command into Terminal:
    splashtop-streamer config -resetuuid

You may choose a way that fits to your conditions.

Duplicate UUID may also happen when you clone computers and VMs with streamer pre-installed. Please see this article to learn how to resolve it.

Support

If you'd like to learn more or need any help, please file a support ticket to Splashtop support team.

0 out of 0 found this helpful