Skip to content

Remote Data Pull

One-line summary

This deployment is the "downstream". It pulls system-built-in (PUBLIC) resources from an "upstream" ThinkLink deployment.

System Platform → Advanced → Remote Data Pull lets a TKG gateway / TKE / Docker standalone ThinkLink instance sync built-in thing models, RPC models, trigger models, device templates, and plugins from a central (upstream) ThinkLink deployment. In a distributed-deployment scenario this is the main channel for keeping each node's "built-in model library" consistent.

Remote Data Pull

When to Use

  • A field-installed TKG gateway needs an updated local set of thing models / plugins but nobody is going to maintain them by hand → configure the upstream and pull on demand.
  • A customer's privately-deployed TKE wants to reuse the official models and device templates curated on the vendor's central server.
  • Multiple branch deployments unify on resources curated by a single master site.

Prerequisite: Enable Pull on the Upstream

On the upstream ThinkLink you intend to pull from:

  1. Log in as admin → System Platform → System ConfigNetwork Service Config.
  2. Turn on the Allow Data Pull switch.
  3. Click the button next to Secret Key to generate / refresh secret_key, and copy it.

Note the upstream host, port (default 80), and that secret_key — you will need them in the next step.

Configure and Pull from This (Downstream) Side

Back on the "Remote Data Pull" page on this deployment:

FieldHow to fill
Remote URLProtocol (http:// / https://) + Host + Port; defaults to 80
tenant_codeDefaults to PUBLIC; normally don't change (pulling upstream PUBLIC-scope resources)
secret_keyPaste the secret you generated on the upstream

Then:

  • Click One-Click Pull — sync plugins, thing models, RPC, trigger models, and device templates in one shot.
  • Or expand Advanced Features to pull only one category at a time:
    • Pull Plugins
    • Pull Thing Models
    • Pull RPC
    • Pull Trigger Models
    • Pull Device Templates
    • Pull Device Configs
    • Pull Devices via Local Device Template
    • Pull LoRaWAN Profiles

Incremental top-up

The per-category buttons under "Advanced" are useful when the upstream has added one new category and you only want to top up that one, without re-pulling the entire set.

Pull Behavior

  • Pulled resources are written into the local PUBLIC scope and show up in the corresponding "Model Management / Plugin" lists.
  • Same-ID resources are upserted: any local PUBLIC record with the same ID is overwritten by the upstream version.
  • Only the upstream's PUBLIC scope is pulled; other tenants' private models on the upstream are not exposed.

Troubleshooting

SymptomLikely cause
Connection failed / timeoutWrong URL/port, upstream port not open, network/firewall blocked
401 / 403Upstream Allow Data Pull is off, or the secret_key doesn't match
Pull succeeds but nothing new appearsUpstream PUBLIC scope had no such resources to begin with
Some plugins failPlugin's dependent resource (e.g. a related thing model) was not pulled together; prefer "One-Click Pull" to avoid dependency gaps