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