Skip To Content

Rebalance scene layer caches

If your tile cache data store machines start to run out of space, install ArcGIS Data Store on additional machines and register them with the same hosting GIS Server site. The caches for new scene layers are distributed on the new machines, but existing scene caches remain on the original machines. To rebalance the existing caches to use the newly added machines, you must create a backup of the tile cache data store and restore it.

Follow these steps to rebalance caches for scene layers:

  1. Run the describedatastore utility to determine the mode that is set for your tile cache data store.
  2. If your data store is in primary-standby mode and contains two machines, and you need to add a third machine (or more), change to cluster mode.
  3. Confirm you have configured a shared backup location for the tile cache data store. If you have not, configure one now.
  4. Ensure no one publishes or updates any scene layers or is building any scene caches.

    To detect if a scene cache is being built or rebuilt, sign in to ArcGIS Server Manager for the hosting server, open Site > Jobs, choose System/SceneCachingControllers from the Services drop-down list, and click Query. If the server is building scene caches, the job statuses appear when you query. Do not proceed until these cache jobs complete. If no scene cache jobs are listed, you can proceed.

    To ensure no one publishes new layers or edits, you can place ArcGIS Enterprise in read-only mode. However, be aware that this affects everyone using the portal.

  5. Create a backup of the tile cache data store.

    In this example, a backup file named myscenecachebu is created and stored in a backup location in an Amazon Simple Storage Service (S3) bucket you registered as a backup location for the tile cache data store.

    backupdatastore myscenecachebu --store tilecache --location type=s3;location=mys3bucket

  6. Use the restoredatastore utility with the replicatedata option set to true to overwrite the contents of the tile cache data store and rebalance the content across all the machines.

    In the following example, the myscenecachebu file is used to restore the tile cache data store, and the replicatedata option is set to true to indicate to ArcGIS Data Store that two copies of each scene cache should be distributed across all machines in the tile cache data store.

    restoredatastore --store tilecache --target myscenecachebu --serverurl https://gisserver.domain.com:6443 --server-admin myadmin --server-password myAdminPWd! --replicatedata true

  7. If you placed ArcGIS Enterprise in read-only mode, put it back in read-write mode.
  8. Run validate again to ensure there are two copies of all scene caches.