Bundles are snapshots of your application artifacts such as configurations and customizations at a certain point in time.

Bundles work on environments where the source and target are at the same level or the source is at a lower version and the target is at a higher version. For example, a bundle generated from a previous content version works on the latest content version. Ensure that your bundle size is less than 1 GB. If the bundle size exceeds 1GB, then consider splitting the bundle by selectively including necessary artifacts. Prior to deployment, the system validates the bundles to confirm whether the bundles contain all prerequisites. If there is a validation error, then you see the applicable bundle with "Validation Failed" status and you can't deploy it. You must fix the issue and try to deploy again.

You can bundle your application artifacts as:

• Data Config bundle: This includes pipeline parameters, activation metadata, data augmentations, and custom data configurations. You can install this bundle in an existing environment after a hard data reset. This is useful to leave content as-is and reset the data pipeline. When you bundle data configurations, only the deployed data augmentations or configurations are included. Augmentations or configurations that aren't in deployed state in the source instance won't be included in a data configuration bundle.
• Semantic Model bundle: This includes main branch, tags, custom branch, and all the security customizations. Use this bundle to import the semantic model extensions because it allows you to select which tag and version to publish and what to publish.
• Security bundle: This includes custom application roles and custom data security.
• Content bundle: This includes snapshots of Oracle Analytics Cloud folders, projects, dataset definitions,workbooks, duty roles for content, and report parameters. The content bundle always merges the catalog content from source to target. While merging, if any conflicts are found, it replaces the content. It doesn't track the deleted content.
• Composite bundle: This includes one or more of the other bundles.
• Environment bundle: Environment bundle publishes the original semantic model without the customizations. This includes all artifacts of a specific environment to revert to a known state of system. For example, at the end of every week, the service administrator can create a bundle called DevEnv_YYMMDD to maintain a backup of the environment. You must first deploy the data configuration bundle or manually activate your data pipelines before deploying the environment bundle.

Learn what's available in bundles.

Create a snapshot of your application artifacts to save their current state. You can view the bundles that you created on the Bundles page.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, click Create.
   
   

   
   

   
   
4. In Create Bundles, select the type of bundle that you want to create. For example, Content Bundle.
   
   

   
   

   
   
5. Enter a name and description for your bundle.
6. Depending on the type of bundle, select the applicable option and then click Save:
   • For a content bundle, select the Include All Content check box, or select the applicable Oracle Analytics Cloud content, workbooks, and key metrics using the corresponding toggles and buttons. You can select the Include Reporting Parameters and Include Configurable Account Analysis check boxes, if applicable.
     
     
     
     
     
   • For a key metrics content bundle, select the key metrics you want to bundle using the corresponding toggles and buttons. Key metrics are also included with Environment Bundles. To improve performance, select the specific key metrics you want to bundle.
     
     

     

     
     
     Note
     
     To import key metrics, you must deploy a key metric bundle into a new instance with key metrics enabled. You can import key metrics in datasets however the entire dataset won't be imported due to security limitations. Datasets without key metrics aren't included in key metrics.
   • For a data configuration bundle, select the Include all data configuration settings check box, or select the applicable modules, augmentations, and custom data configurations using the corresponding toggles and buttons.
     
     
     
     
     
   • For a semantic extensions bundle, select the Include all semantic extensions check box, or select the applicable branch or tag in the Publish a branch or tag in the target environment field, or select applicable tags and branches using the corresponding toggles and buttons. You can select the Include External RPD or Publish External RPD check boxes to include or publish the external semantic model.
     
     
     
     
     

     If you've migrated to the latest wizards for extending the semantic model, then select the applicable external application and select the Semantic Extensions check box to include all the extensions.
     
     

   • For a security bundle, select the Include all security settings check box or select all the application roles. If the number of application roles exceed 1000, then you may encounter an error. In such a case, use the Select Application Roles button to select specific roles.
     Note
     
     If you've uptaken the enhanced security capability of Oracle Fusion Data Intelligence, then you no longer can specifically select groups as part of the Security bundle. See About Managing Users, Groups, Application Roles, and Data Access.
     
     
     
     
     
     
   • For an environment bundle, provide a name.
     
     
     
     
     
   • For a composite bundle, select any of the other bundles.
     
     
     
     
     

Edit a bundle if you need to change the application artifacts captured in the bundle.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Edit.
   
   

   
   

   
   
5. On the applicable bundles page, make your changes and then click Update.

Publish a bundle from the source environment. This action generates a snapshot of the application artifacts and saves the snapshot to a repository. You can download this bundled artifact and import it into different instances.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Generate to create and publish the bundle.
   
   

   
   

   
   

Export the bundle .aab file from your source system to a repository or your local machine.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Export.
   
   

   
   

   
   

Import the bundle .aab file into the target environment from your computer to restore the state of the application to the checkpoint represented by the bundle.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, click Import.
   
   

   
   

   
   
4. In the Import Bundle dialog, click in Drag and Drop, and then select the applicable .aab file from your local machine.
   
   

   
   

   
   
5. Click Import.

You can deploy a generated bundle in the target environment to revert to the state of artifacts represented by the bundle. The system validates the bundle before attempting any deployment to ensure software and model versions and any other dependencies are met.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Deploy.
   
   

   
   

   
   
5. In the Deploy Bundle dialog, ensure that you see the bundle that you have selected.
6. Click Deploy.

Delete a bundle if you no longer require the snapshot of your application artifacts captured in the bundle.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Delete.
   
   

   
   

   
   

View all the bundles-related activities to understand the changes made to your instance, which bundles to use, and whether the existing bundles are still current. This information enables you to make informed decisions about creating updated bundles or deploying an existing bundle.

1. Sign in to your service.
2. In Oracle Fusion Data Intelligence Console, click Bundles under Application Administration.
3. On the Bundles page, click the Activity tab.