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 based 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.
- Affected computers will have their streamers logged out consistently and removed from 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:
- Log into my.splashtop.com / my.splashtop.eu and click on Management > Deployment.
- Click on the Create Deployment Package button.
- Enable the Use software-generated UUID option.
- For Windows users, at the remote machine please type this command into a web browser:
st-streamer://com.splashtop.streamer?resetuuid=1
- For Mac users, at the remote machine please type this command into a web browser:
st-streamer://com.splashtop.streamer?resetuuid=1
- For Linux users, at the remote machine please type this command into Terminal:
splashtop-streamer config -resetuuid
You may choose a way that fits to your conditions.
Attached on this page is a file to generate new UUID
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.
WARNING: Resetting UUID may cause a reset to the access permissions set on the computer. You will need to provide access to users again (e.g., Business Access subscription with Member Role user)
Support
If you'd like to learn more or need any help, please file a support ticket to Splashtop support team.