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
- Display the Import Applications dialog
().
- Enter the path to the JSON file that contains the application
definitions or click Browse to select the file.
- 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",
- 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.
- Click Submit.