Importing applications

When you import an application, you can create an entirely new application or upgrade an existing one. Components that are associated with the application 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 Application dialog (Applications > Import Application).
  2. Enter the path to the JSON file that contains the application definition or click Browse to select one.
  3. If you want to upgrade an existing application, check the Upgrade Application check box. To create an application, leave the box cleared. If the name of the 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 application, select Use Existing Component. The new application contains references to the imported applications components. This option is especially useful if you are importing many applications.

      If you are upgrading, the application uses the imported components, and no longer uses any not used by the imported application.

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

      If you are upgrading, the application uses the newly created components and no longer uses any it previously used.

    • When you want to create a fresh installation, select Fail if Component Exists. If you are creating an application, it creates both a new application and component unless the component already exists, in which case the application is 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 an application, it creates both a new application and component unless the component does not exist, in which case the application is 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 an application and upgrades existing components with data from the imported application.

      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