Using the LucidLink Upgrade Tool on filespaces integrated with iconik storage gateways

  • Updated

Who this is for: Customers who use iconik to index/preview/manage media stored in LucidLink and are upgrading to the new LucidLink platform.

What to know: The Upgrade Tool preserves paths/permissions. 

 

1) Before your upgrade

  • Confirm the LucidLink mount point used by iconik today (e.g., X:\Projects on Windows or /Volumes/Projects on macOS).
  • Note the LucidLink classic user id that the ISG uses to mount the filespace.
  • Note any iconik Storage(s) in use that point at that path (Admin → Storages).
  • Unmount the Classic Filespace
  • Stop the ISG 

2) Use the Upgrade Tool

  • Follow the steps for upgrading the filespace.
  • When completing the user mapping step, note the email address assigned to the iconik user id

3) Install the new LucidLink client on the ISG 

  • Follow the required steps for upgrading the LucidLink client based on the OS used on the ISG

4) Update the LucidLink login on the ISG

  • If ISG host is Linux, modify the systemd script to login as the new LucidLink iconik user login info
  • If ISG host is Windows Service, update the windows service manager with the new iconik user login info
  • If ISG host is a GUI OS login, login as the new Iconik user.

5) Mount Point confirmation

  • Refer back to step 1, and ensure the same default mount point is used for the new LucidLink filespace

6) Restart the iconik service on the ISG

  • Check the ISG logs to make sure the host and service are connected.
  • Open a few known assets and verify: previews/thumbnails load, proxies link, and collection permissions look normal.
  • Once you've confirmed that everything is working on the new configuration, you may want to delete the former LucidLink cache used by the Classic client.  You can find this by navigating to ~/.lucid/instance_501 and deleting this file.

 

Quick checks

  • If a storage shows “disconnected”: ensure LucidLink client is signed in and the mount is visible to the iconik agent/service account.
  • Re-enable any paused scheduled scans.
    That’s it. No relinking or path changes should be necessary.
  • If thumbnails/previews are stale: clear iconik browser cache or force a Proxy refresh on a single asset to test.
     

Troubleshooting 

  • Assets show “missing”: Confirm the exact mount path that iconik is configured to use is available to the iconik agent after upgrade.
  • Still stuck? Open a ticket and mention “Upgrade Tool – iconik” with screenshots of Storage settings and mount path.
     

Was this article helpful?

0 out of 0 found this helpful