Migrate Fusion Objects

You can use the Fusion UI and the Objects API to migrate collections and related objects, including your searchable data, configuration data, pipelines, aggregations, and other objects on which your collections depend. You can also migrate entire apps.

Important
When upgrading from one Fusion version to a later one, you must use the migrator to migrate objects. The migrator automates the process of translating relevant objects to the new version. Exporting an object from one Fusion version and importing it into a different Fusion version isn’t supported.

You might need to migrate objects in the following circumstances:

  • When migrating data from development environments into testing and production environments

  • To back up data, so you can restore it after an incident of data loss

  • When the migrator script wasn’t able to migrate an object automatically

Caution
When you export and import objects to migrate them, make sure you that any data gets to where it is going before deleting the sources.

Migration approaches

Several approaches are available for migrating Fusion objects. This table summarizes the approaches.

Export an app Import an app Export an object Import an object Add an object to an app

Fusion UI

App configuration

Launcher
(entire app)

App configuration
(combine apps)

Object Explorer

Objects API
(endpoints)

GET from export endpoint

POST to import endpoint

GET from export endpoint

POST to import endpoint

For more information about using the Objects API to export and import objects, see Objects API.

The remainder of this topic describes approaches in the Fusion UI.

Use the parts of the Fusion UI indicated in the table to export and import apps and specific objects. Exporting creates a zip file. To import, you select a data file and possibly a variable file.

The approach with Object Explorer differs. With Object Explorer, you can add objects from other apps (or that are not linked to any apps) to the currently open app.

Export an app with the Fusion UI

To export an app with the Fusion UI
  1. Navigate to the launcher.

  2. Hover over the app you want to export and click the Configure icon:

    App config button

  3. In the app config window, click Export app to zip:

    Export app to zip

    This downloads a zip file that you can import into other instances of Fusion Server.

Import an app with the Fusion UI

To import an app with the Fusion UI
  1. Navigate to the launcher.

  2. Click Import app.

    Import app

  3. Under Data File, click Choose File and select the zip file containing the app you want to import.

  4. If your app has usernames and passwords in a separate file, select it under Variables File.

    Tip
    If the variables file is included inside the zip file, then you don’t need to upload it separately.
  5. In some cases, you can edit parameter values to use the new values in the imported app. If this is the case, Fusion displays a dialog box that lets you edit the parameter values.

    Edit parameter values

    Make desired changes, and then click Import.

Copy an app

To copy an app from one deployment to a different one, export the app on the source deployment, and then import the app on the target deployment.

Import objects into an app

You can import objects into the currently open app.

To import objects into an open app
  1. In the Fusion launcher, click the app into which you want to import objects.

    The Fusion workspace appears.

  2. In the upper left, click System System > Import Fusion Objects.

    Import Fusion Objects

    The Import Fusion Objects window opens.

    Import Objects Window

  3. Select the data file from your local filesystem.

    If you are importing usernames and passwords in a separate file, select it under Variables File.

  4. Click Import.

    If there are conflicts, Fusion prompts you to specify an import policy:

    Import Conflicts

    • Click Overwrite to overwrite the objects on the target system with the ones in the import file.

    • Click Merge to skip all conflicting objects and import only the non-conflicting objects.

    • Click Start Over to abort the import.

    Fusion confirms that the import was successful:

    Successful Import

  5. Click Close to close the Import Fusion Objects window.

Add an object to an app

You can add objects present in other apps (or in no apps) to the open app. Some objects are linked to other apps. You can also add those directly to an app.

  • Add an object to an app – While in the Fusion workspace for the app to which you want to add an object, open Object Explorer and click In Any App. Search for or browse to the object you want to add. Hover over the object, click the App App icon, and then click Add to this app.

    Add to this app

  • Add an object to an app directly – In cases when an object is linked to an app, but is not linked directly to the app (it is linked via some dependency), you can add the object to an app directly.

    While in the Fusion workspace for the app to which you want to add an object directly, open Object Explorer and click In Any App. Search for or browse to the object you want to add. Hover over the object, click the App App icon, and then click Add to this app directly.

    Add to this app directly