Adaptiva OneSite - Hash Errors and Server GUIDS

Each OneSite Server you install generates its own unique GUID, clients then use this GUID to communicate with each other. This is especially necessary if you have multiple Adaptiva OneSite environments / Clients.
I had performed a side-by-side migration of SCCM 2012 to a new site, along with an Adaptiva OneSite migration, at times I had subnets with clients from both environments and as such as made extensive use of this GUID, particularly when imaging new machines.

The problem is that when you boot a device to Windows PE for imaging the full Adaptiva OneSite Client is not used as an ACP (Alternate Content Provider) to download content, rather the executable OneSiteDownloader.exe is used instead.

OneSiteDownloader.exe has no knowledge of any Server GUIDS, and when a migration has occurred this can cause issues. Since a migration has taken place PackageIDs will match in both the new and the old environments but the hash will not (see where im going with this?)

The Client in Windows PE will happily download the content with ID of ABC0012 via the ACP and pass back control to the SCCM Client at which point a hash check will occur and cause a failure, (unless of course you have made no modifications to the package between migrations, but lets assume you have)

The fix for this and to ensure that OneSiteDownloader.exe talks only to clients with the correct server GUID is rather simple, at the beginning of your task sequence (or on a collection of your choice) create a task sequence variable named:
AdaptivaServerGUIDs

Assign this variable the Server GUID from a client, which can be found in the following registry location:

HKLM\Software\[Wow6432Node]JavaSoft\Prefs\Adaptiva\Client| client_data_manager.server_guid

Voila! your clients will stop generating hash errors and image correctly :)

Cheers
Wayne

Adaptiva OneSite - Sysprepping the client

In order to sysprep the Adaptiva OneSite client stop the AdaptivaClient service and locate the following registry key:

x86: HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\prefs\Adaptiva\clientx
x64: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\JavaSoft\prefs\Adaptiva\Client

Set the following value to True:

client_data_manager.inactivated_client

The next time the service starts the client will communicate with the server, activate, and will be assigned a new unique ID.


Cheers
Wayne

Adaptiva OneSite

Long time no post... over the last year I have been working on a global ConfigMgr Implementation coupled with Adaptiva OneSite.
Adaptiva OneSite as a product is excellent, however the documentation at this stage is somewhat lacking, therefore I am taking the time to blog my discoveries over the past year with regards to the product for the benefit of myself and others.



This will be in no particular order, rather just a collection of thoughts / findings around real world usage of the product, enjoy :)

Cheers
Wayne