How to transfer 3DSpaces between hubs

Set Up Datapools

instant3Dhub 3.10 introduces Datapools to streamline and unify how instant3Dhub retrieves and authorizes data. Datapools are configured via values.yaml. The configuration includes setting up the relevant URNs to other instant3Dhub instances / Datapools as well as authorization preferences.

More details and explanations can be found in the comments of the values.yaml or in our docs under URN Mapper Configuration.

Add Resources to 3DSpace

Add resources to a 3DSpace with the usual functions. As soon as resources are added to the 3DSpace, the system uses the Datapool configuration to proxy data from responsible instances automatically.

Trigger 3DSpace Transfer:

To make resources available on the local Hub, trigger the 3DSpace Transfer via one of the two options:

  1. Via transferSession(): Use the transferSession() function to initiate the transfer. Refer to the documentation for detailed usage instructions: SessionStorageAPI

  2. Via Resource API: The Request part of the Resource is extended to support a clusterID parameter as part of each element. If no clusterID is given, the ID of the local instance is used. This implies caches will be transferred over if configuration points to another instant3Dhub instance being responsible for the data.

The system now starts to download the caches from the central Hub to the local Hub making the resources locally available.