nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Upgrading ArcGIS Enterprise from 11.3 to 12.1

KikSiops

Hi,

Has anyone done an upgrade of Enterprsie from from 11.3 to 12.1?

I am upgrading our Dev Environments from 11.3 to 12.1, as per tech support, we can directly upgrade but when I did, I realized that we can no longer migrate the items from tile cache datastore to object datastore as tc datastore is no longer available. Does this mean I need to upgrade the whole enterprise first to 11.4 first then upgrade to 12.1?

Find more posts tagged with

Accepted answers

All comments

GlenterpriseUK

Hi @KikSiops,

You would need to migrate the cache from the Tile Cache Data Store to the Object Store Data Store. The process is outlined here: https://www.esri.com/arcgis-blog/products/arcgis-enterprise/administration/arcgis-enterprise-migrating-to-the-object-store

You can deploy the Object Store Data Store starting from ArcGIS Enterprise 11.3.

You can either deploy the Object Store Data Store in 11.3 and upgrade to 11.5 to then run the Migrate hosted scene layer caches using the MigrateSceneServices utility—ArcGIS Server | Documentation for ArcGIS Enterprise or you can upgrade to 11.5 then deploy the Object Store Data Store at 11.5 and proceed with the MigrateSceneServices utility tool.

Regards,

Glen

MiguelParedes

Greetings @KikSiops,

There is another alternative to the migration proposed by @GlenterpriseUK that you should consider. This, however, involves rolling back to your 11.3 Dev Environment.

When upgrading from ArcGIS Enterprise 11.3 to 12.1, it’s important to account for the removal of the Tile Cache Data Store in 12.1. Any hosted scene layers currently stored there must be migrated to a supported storage mechanism before or as part of the upgrade.

I would recommend you export (11.3) the existing scene layers to Scene Layer Packages (SLPKs), and then republish them in the upgraded (12.1) environment.

So the steps to follow would be:

Export Scene Layers to SLPK. You can do this from the Portal or using ArcGIS Pro.
Perform the upgrade to ArcGIS Enterprise 12.1.
Ensure that all required backups (Portal and Data Store) are completed beforehand.
Configure the Object Store, the mechanism used by ArcGIS Enterprise 12.1 for storing cached content such as scene layers.
Republish scene layers from SLPKs

Caveat: The Item IDs for the scene layers will change after republishing, so if existing applications reference these layers, they will need to be updated accordingly.

Hope the above is of assistance.

GG907

Hi @MiguelParedes
If we have a configured Tile Cache deployed in 11.3 and no content in it (including no hosted scene layers), are there any special considerations when upgrading directly from 11.3 to 12.1? In your outlined steps, it appears that you don't need to run disabledatastore when migrating directly - all other documentation only outlines upgrading to 11.4 or 11.5, (migrating data if necessary) disabling the datastore, uninstalling, then proceeding to upgrade to 12.1.

MiguelParedes

Greetings @GG907,

If you have configured the Object Store in 11.3 but have not used it (i.e., it contains no data), I would recommend keeping it in place, as the upgrade to 12.1 will also upgrade the Object Store with the rest of the deployment.

If you have content currently stored in the Tile Cache Data Store, you have a couple of options:

Upgrade to 11.4 or preferably 11.5, as @GlenterpriseUK described, and then proceed with the upgrade to 12.1; or
Export your tile cache content in 11.3 to SLPKs, perform the upgrade to 12.1, and then import the SLPKs into the 12.1 Portal, as described in my previous post.

I hope the above helps.

GG907

Thanks for the feedback. We do not have an object store, only a tile cache with no content in it. Disabledatastore wasn't introduced until 11.4/11.5, and the ESRI documentation only states that it must be removed before upgrading to 12.1. We are just trying to assess the impact if we don't remove it and just upgrade directly to 12.1 from 11.3.
Your second option seems to indicate that there is little to no impact of not removing the tile cache prior to upgrade if you have taken the steps to export content (which we have no content to export). Is that correct?

MiguelParedes

Greetings @GG907,

Oops, sorry, I misunderstood your explanation. So, no Object Store, but you do have an unused (empty) Tile Cache Data Store in your 11.3 deployment, correct?

You are correct that the Tile Cache Data Store must be removed before upgrading to ArcGIS Enterprise 12.1, and also that the disabledatastore utility is not available in version 11.3. The current documentation assumes the use of 11.4 or 11.5, where that tool is available, and does not explicitly describe how to proceed from 11.3. This is the recommended process. Please check Remove the ArcGIS Data Store tile cache data store from an ArcGIS Enterprise deployment.

However, if the Tile Cache Data Store is empty and not in use, it can be removed directly in 11.3 without requiring an intermediate disabledatastore upgrade.

In this case, the approach is to unregister the datastore, using the unregisterdatastore utility.

This removes the Tile Cache Data Store from the hosting server and detaches it from the ArcGIS Enterprise deployment.

After running the command, confirm in ArcGIS Server Manager > Site > Data Stores that the Tile Cache Data Store no longer appears.

If the machine was dedicated to the Tile Cache Data Store only, it could be decommissioned, or the Data Store software uninstalled. If it is shared with other datastore types (such as Relational), no further action is required.

Once the Tile Cache Data Store is no longer registered, you can proceed with a direct upgrade from 11.3 to 12.1.

In conclusion, follow the documented upgrade, which is to upgrade to 11.5 first, run disabledatastore utility, and then upgrade to 12.1.

I am assuming this is a base deployment of ArcGIS Enterprise 11.3, where all components are installed on a single machine.

Before proceeding with the upgrade, ensure you have a full system backup or snapshot available so you can revert if necessary.

Hope the above is of assistance.

GG907

We attempted the first path you described with unregister the datastore. It failed. Tech support says revert to 11.3, and follow the path to upgrade to 11.5 first.

I would recommend to all to not try to upgrade from 11.3 to12.1

Sergioortiz2023

Can you confirm if this was your workflow on this thread?

1) Upgraded from 11.3 directly to 12.1

2) Attempted to unregister the existing Tile Cache Datastore after upgrading to 12.1, but incurred issues with the unregister process.

3) Revert back to 11.3

We are asking these questions becuase we are preparing to upgrade to 12.1 directly and we do have a registered Tile Cache Datastore and want to avoid any pitfall you might have incurred during your upgrade. thanks!

Sarah_Hanson

If the deployment does not have any hosted scene layers present, you should be able to upgrade directly from 11.3 to 12.1 without concern for the tile cache data store. When upgrading to ArcGIS Enterprise 12.0 or later, the software will automatically remove the tile cache data store from the deployment.

To verify the tile cache data store does not have any cache contents stored in it that need to be migrated to the object store using the MigrateSceneServices utility (available in 11.5), follow the instructions in this KB: How To: Inventory the ArcGIS Data Store tile cache data store contents using a Python script

Join the Conversation

Signed in members can post, follow updates, and more. New here? Register a free account.

Quick Links

Community Help
Find useful guides, FAQs, and documents to help you navigate and make the most of Esri Community.