@jeena developed this great content for working with bundles in your ExtraHop. I’ll be following up soon with some guidance about building bundles.
Bundles enable you to create and save a set of system customizations for the Discover appliance or ExtraHop Command appliance. The following system customizations can be saved as part of a bundle:
- Custom pages
- Dynamic groups
- Flex grids
After creating a bundle, you can download the file in .json format and share the file with other users either directly or through the ExtraHop Solution Bundle Gallery.
##Create a bundle
These steps show you how to create a downloadable .json file that you can store or send to other users.
- On the Bundles page, click New.
- Complete the following information in the Bundle Settings window:
- Name: Assign a name to the bundle.
- Author: Specify the creator of the bundle. Bundles loaded by default have the author “ExtraHop.”
- Required Version: Specify a required version for this bundle. If you try to import a bundle that requires a newer firmware version, a warning message displays in the Actions section of the Bundle Settings window. Note: This warning does not prevent the bundle from loading.
- Contents: Select the system customizations that you want to add to the bundle, such as triggers, dashboards, or alerts. Click the arrow to expand the list of available items.
- Description (Optional): Type a description about the bundle.
- Click OK to save the bundle.
##Modify a bundle
These steps show you how to modify an existing bundle that has been uploaded to the ExtraHop system.
- On the Bundles page, click the name of a bundle.
- In the View Bundle dialog box, the Actions section is now present. This section appears only after the bundle has been saved to the list.
- Optional: To download the bundle to your work station in .json file format, click the Download button.
- Optional: To choose how to handle imported objects with names that match existing objects, click the Existing Objects drop-down list.
- To exclude the object from the import, select Skip.
- To modify the preexisting object to match the data of the object being imported, select Overwrite.
- Click the Edit Raw Data button to view and edit the raw, JSON-formatted bundle content.
- The raw data text box is blank until the bundle is added to the list.
- The bundle preserves the version of the customizations at the time of creation. If you modify an object after creating a bundle, the object inside the bundle remains unchanged. If you want the bundle to contain the modified object, you must create another bundle.
##Upload a bundle
These steps show you how to upload a bundle .json file to the ExtraHop system. After you upload a bundle, you must apply the bundle.
- On the Bundles page, click the Upload button.
- The Load Bundle dialog box appears.
- In the Load Bundle dialog box, do one of the following:
- Paste the bundle data directly into the Load Bundle window.
- Click the Choose File button to upload a saved bundle in .json file format.
- Click the Upload button.
##Apply a bundle
These steps show you how to apply a bundle that has been uploaded to the ExtraHop system. Some bundles require that you enable related triggers or apply included assignments.
- On the Bundles page, click on the name of a bundle.
- In the Actions section, click the Apply button to enable the bundle and see the Bundle Import Status dialog box.
- This dialog box tells you whether the bundle was applied. If you selected Skip from the Existing objects drop-down list, the dialog box includes a list of skipped objects.
##Delete a bundle
These steps show you how to delete a bundle from the ExtraHop system. If you delete a bundle, you will also delete all of the bundle objects.
- On the Bundles page, select the checkbox next to the bundle(s) that you want to delete.
- Click the Delete button.