Importing applications

When you import applications, you can create applications or upgrade existing applications. Components that are associated with the applications are also imported, including their properties and processes (if available to the importing server).

About this task

For information about templates that are associated with imported components, see Importing components.

Note: If imported components have the Import Versions Automatically parameter set to true, IBM UrbanCode Deploy automatically imports component versions while the artifacts are accessible to the importing server.

Procedure

  1. Display the Import Applications dialog (Applications > Import Applications).
  2. Enter the path to the JSON file that contains the application definitions or click Browse to select the file.
  3. If you want to upgrade existing applications, check the Upgrade Application check box. To create applications, leave the box cleared. If the name of an application in the JSON file (not the name of the file itself) matches an existing application, the application parameters are updated with new values. Also, new items such as processes, environments, and components are added. If the name is not found, the command has no effect.
    Note: The application name is the first parameter in the JSON file; for example,
    "name": "helloWorldApplication",
  4. Specify how imported components are handled with the Component Upgrade Type list. For these options, the components must be on the importing server.
    • To use the same components that are used by the imported applications, select Use Existing Component. The new applications contain references to the components. This option is especially useful if you are importing many applications.

      If you are upgrading, the applications use the imported components, and they no longer use any components that are not used by the imported applications.

    • To create new components that are based on the components that are used by the imported applications, select Create New Component. New components are created (based on the components of the imported applications).

      If you are upgrading, the applications use the newly created components, and they no longer use any components that they previously used.

    • When you want to create a fresh installation, select Fail if Component Exists. If you are creating applications, it creates both new applications and components unless the components already exist, in which case the applications are not imported.

      If you are upgrading, the upgrade fails if any imported components already exist on the importing server.

    • To ensure that a component is on the importing server, select Fail if Component Does Not Exist. If you are creating applications, it creates both new applications and components unless the components do not exist, in which case the applications are not imported.

      If you are upgrading, the upgrade fails if an imported component does not already exist on the importing server.

    • To upgrade existing components, select Upgrade if Exists. This option creates applications and upgrades existing components with data from the imported applications.

      If you are upgrading and existing components match imported ones (all must match), the components are upgraded. If none of the imported components match existing ones, the imported components are used.

  5. Click Submit.

Feedback