You can import a suitable deployment manifest to an enterprise
bundle archive (EBA) asset. If you have changed the bundle versions that are specified in the manifest, the import process checks that the bundles can be resolved, then updates the asset with the new manifest and any bundle downloads that are required.
Before you begin
For the import to succeed, the following conditions must be met:- The deployment manifest to import must correspond with the application manifest of the OSGi application that is contained in the EBA asset. For more information, see the section "Importing or exporting a deployment manifest" in Enterprise bundle archives.
- The bundles and their versions that are listed in the deployment manifest must be available to be resolved.
- If the asset has previously been updated, the bundle downloads for the previous update must have completed, and the business-level application must have picked up the previous updates by being restarted. For
more information, see Checking the bundle download status of an EBA asset.
You can import a deployment manifest by using the administrative
console, as described in this topic, or by using wsadmin commands,
as described in Importing a deployment manifest using the importDeploymentManifest command.
About this task
A deployment manifest file is created automatically for an OSGi application when you install an EBA asset. The deployment manifest file lists all the bundles, at specific versions, that make up an application, including bundles that are determined following dependency analysis. The manifest file is used to ensure that each time an application server starts, the bundles that make up the application are the same. You can import a deployment manifest to an EBA asset, and overwrite the current deployment manifest.
For more information about why you might want to import a deployment manifest to an EBA asset, see Maintaining bundle versions for an EBA asset.
Procedure
- Start the administrative console.
- Navigate to .
- Click the name of the asset that you want to import the
deployment manifest to. The Asset settings panel is displayed. If the
bundle downloads for any previous update have completed, and the business-level
application has picked up the previous updates by being restarted,
then the option to import a deployment manifest is displayed under
the Additional Properties section.
- Click [Additional Properties] Import a deployment manifest into this application.
The Import a deployment manifest into this application panel
is displayed.
- Click Local file system or Remote
file system, as required, then enter the fully-qualified
path to the deployment manifest file that you want to import. The file must be a valid deployment manifest, with a .MF file extension.
- Click OK.
The deployment manifest is checked to ensure that the bundles
that it lists can be resolved, then it is imported into the EBA asset.
The file name changes to DEPLOYMENT.MF. Any new
bundles that are required to provision the application are downloaded.
- Save your changes to the master configuration.
- Optional: The business-level application that uses this asset picks up the changes the next time it is restarted. To pick up the changes as soon as possible, wait until bundle downloading is complete for the asset then restart the business-level application.