Upgrade an Indoors workspace

Available with the ArcGIS Indoors Pro or ArcGIS Indoors Maps extension.

If you created an Indoors workspace with an earlier version of ArcGIS Pro, you can use the Upgrade Indoors Database tool to upgrade it to the latest version of the ArcGIS Indoors Information Model. You can use this tool to upgrade a workspace created with the Create Indoors Database tool or the Create Indoor Dataset tool.

Note:

Names of feature classes, fields, domains, and tables in your Indoors workspace must match the names of feature classes, fields, domains, and tables in the Indoors model for your workspace to be successfully upgraded by the tool. If you have renamed these items in your workspace, revert these names to match the Indoors model before running the Upgrade Indoors Database tool.

You can run the Upgrade Indoors Database tool in two modes. The default is the Upgrade Database option, which upgrades the Indoors workspace with all possible schema changes. If you select Generate Schema Change Report, the tool does not change the workspace schema, and instead generates a text file report preview of all potential schema changes and issues that may be encountered during an upgrade of the input Indoors workspace.

The Upgrade Indoors Database tool updates an existing Indoors workspace in the following ways:

• Creates missing feature classes
• Creates missing tables
• Creates missing fields in Indoors feature classes and tables
• Creates missing domains and domain values in the geodatabase
• Creates the LEVEL_ID field in the Pathways and PrelimPathways feature classes and populates LEVEL_ID values for pathway features located inside buildings
• Updates field nullability properties to align with the Indoors model schema
• Creates or updates the Reservations layer security attribute rule
• Adds missing Indoors validation attribute rules and upgrades existing rules

  Note:

  Attribute rules are only upgraded if the Upgrade Attribute Rules check box is checked.

When upgrading your Indoors workspace, there are different considerations for updating existing web maps and apps depending on your environment and how your services are shared. If you have Indoors layers shared only as hosted feature services, you can run the tool and republish your web layers, replacing existing layers in your web maps with the upgraded versions. If you have Indoors layers shared as referenced or branch versioned feature services to ArcGIS Enterprise, you must take further steps including stopping your services and re-enabling branch versioning on any branch-versioned datasets that have had new feature classes added. Choose the workflow below that best suits your organizational environment.

Upgrade an existing Indoors workspace in an unregistered geodatabase

If your Indoors geodatabase is a file geodatabase or an enterprise geodatabase without layers shared from registered data, you can run the Upgrade Indoors Database tool on the geodatabase and republish web feature layers to your ArcGIS organization.

Note:

It is recommended that you do an initial run of the Upgrade Indoors Database tool with Generate Schema Change Report selected to review potential changes to your existing workspace from the upgrade process.

Complete the following steps to use the Upgrade Indoors Database tool:

1. Start ArcGIS Pro.
2. Open a project containing an Indoors workspace.
3. On the Analysis tab, click the Tools button .

   The Geoprocessing pane appears.

4. In the Geoprocessing pane, click the Toolboxes tab.
5. Click Indoors Tools > Upgrade Indoors Database.

   The Upgrade Indoors Database tool opens.

6. Set the parameters as follows:
   1. For the Input Indoors Database parameter, browse to the geodatabase that contains the Indoors workspace you want to upgrade.
   2. Optionally, uncheck the Upgrade Attribute Rules check box.

      If the Upgrade Attribute Rules check box is checked and there are existing Indoors validation rules in the input Indoors database, the tool upgrades the Indoors attribute rules. The target geodatabase must be an enterprise geodatabase with branch versioning enabled or a file geodatabase to upgrade attribute rules.

   3. For the Upgrade Indoors Database parameter, choose Upgrade Database.

      This is the default.

      Note:

      It is recommended that you do an initial run of the Upgrade Indoors Database tool with Generate Schema Change Report selected for the Upgrade Indoors Database parameter. With this setting selected, the tool does not change your input workspace and instead generates a text file of potential changes for you to review.

7. Click Run.

The input Indoors database schema is updated to conform to the version of the Indoors model for the current version of ArcGIS Pro, or a text file of potential changes is generated without updating the database.

Note:

Any existing hosted web feature layers must be deleted and shared again to reflect schema updates from the Upgrade Indoors Database tool, such as new feature classes, tables, fields, or domains. After sharing a new web feature layer with your schema updates, ensure that any existing web maps are sourced to the new web layer so the changes are reflected in your Indoors apps.

Upgrade an Indoors workspace in a registered enterprise geodatabase

If you have published Indoors data to ArcGIS Enterprise as referenced data from an enterprise geodatabase, you must stop services before running the tool. After you upgrade the Indoors database, you must republish services or re-enable branch versioning on versioned datasets if any new feature classes were added. .

Update an enterprise workspace with shared layers that referenced registered data

Complete the following steps to upgrade an existing Indoors workspace in an enterprise geodatabase with feature classes or tables that have been shared to ArcGIS Enterprise as services that reference registered data:

1. Start ArcGIS Pro.
2. Open a project containing an Indoors workspace.
3. Review locks and user connections on your indoor dataset. Disconnect users and release locks on the dataset.
4. Open Server Manager for the ArcGIS Server site that contains your services and sign in as a user with Administrative privileges.
5. Disable schema locking with the following steps, for each map service item that was shared as a branch versioned feature service from your existing Indoors workspace:

   Note:

   If your services are shared to ArcGIS Enterprise on Kubernetes, proceed to substep c to stop the services after signing in to ArcGIS Enterprise Manager.

   1. Uncheck the Lock Database Schema check box.
   2. Click Save and Restart to apply the change and restart the service.
   3. Stop the service.
6. Stop services for any map service items shared as web layers to your ArcGIS Enterprise portal with the shared instance type.
7. In the Geoprocessing pane, click the Toolboxes tab.
8. Click Indoors Tools > Upgrade Indoors Database.

   The Upgrade Indoors Database tool opens.

9. Set the parameters as follows:
   1. For the Input Indoors Database parameter, browse to the geodatabase that contains the Indoors workspace you want to upgrade.
   2. Optionally, uncheck the Upgrade Attribute Rules check box.

      If the Upgrade Attribute Rules check box is checked and there are existing Indoors validation rules in the input Indoors database, the tool upgrades the Indoors attribute rules. The target geodatabase must be an enterprise geodatabase with branch versioning enabled or a file geodatabase to upgrade attribute rules.

   3. For the Upgrade Indoors Database parameter, choose Upgrade Database.

      This is the default.

      Note:

      It is recommended that you do an initial run of the Upgrade Indoors Database tool with Generate Schema Change Report selected for the Upgrade Indoors Database parameter. With this setting selected, the tool does not change your input workspace and instead generates a text file of potential changes for you to review.

10. Click Run.
11. Restart the services if new fields or domains were the only schema change made to your branch versioned feature services. If new feature classes were created in the workspace, you will need to share new services containing them.

    These changes are reflected in the existing feature service and any web maps or apps using the registered data feature service.

    If new feature classes or tables were created by the tool, you must publish them to your ArcGIS Enterprise portal to use them in your ArcGIS organization. These requirements are detailed in the section below.

Share new feature services to ArcGIS Enterprise

If new feature classes or tables were created in the Indoors workspace as a result of running the Upgrade Indoors Database tool, you can share these layers as web feature layers that can be used in your existing Indoors apps. Some additional considerations apply depending on whether you are sharing hosted web feature layers, feature services that reference registered data, or branch versioned services.

Do the following if you are sharing new feature services to be used in your existing Indoors apps:

1. If a new feature class was added to a dataset that was branch versioned, enable branch versioning at the feature dataset level again.

   Note:

   The new feature class must be registered as versioned before you can edit any of the branch versioned feature services in the same feature dataset.

2. Do the following for hosted web feature layers:
   1. Delete any hosted web feature layers and share them again to reflect schema updates from the Upgrade Indoors Database tool, such as new feature classes, tables, fields, or domains.
   2. Ensure that any web maps referencing the previous layer are updated to reference the new layer.
3. Do the following if you are sharing new Indoors feature classes or tables as branch versioned feature services to use in existing Indoors apps:
   1. Register any newly added feature classes or tables as branch versioned.
   2. If the Occupants, Units, Areas table, or Area Roles table are created by the Upgrade Indoors Database tool during the upgrade process, delete any existing feature services using these layers through Server Manager, and share these layers together in a single feature service with version management enabled. After sharing the new feature services, ensure that any web maps using the layer are sourced to the new service.
4. Do the following after upgrading your Indoors workspace schema and refreshing web layers and branch versioned services as necessary:
   1. Restart any map services that were stopped.
   2. Re-enable schema locks if using Enterprise on Windows or Linux.
   3. Refresh your Indoors apps to access any newer functionality added by the Indoors model schema upgrades.