Package and export multiple apps and other content in an extension so users can download
related apps or content in one file.
About this task
You can include multiple apps or content types in an extension, which you export as a
compressed (.zip) file.
Procedure
-
Use SSH to log in to QRadar as the root user.
-
To get a list of the content types and search parameters, type the following command:
/opt/qradar/bin/contentManagement.pl -h export
In the following example, you search for apps that are represented by the content type
ID of 100, and the regex .*, which matches
everything.
/opt/qradar/bin/contentManagement.pl --action search -c 100 -r
.*
You must specify the content type (-c) and a search regex
(-r).
In the following example, you search for the custom
content type "dashboard" that is represented by the content type ID of 4, and the regex
.*, which matches everything for dashboards content.
/opt/qradar/bin/contentManagement.pl --action search -c 4 -r .*
Use
regex to narrow your search, for example, you use the following search to find dashboards content
that includes 'Threat' in the name.
/opt/qradar/bin/contentManagement.pl --action
search -c 4 -r Threat
-
Add the content type IDs or string and the IDs of the apps or content in a text file. The
content type can be represented by the string or ID. Use the following format:
<content_type_ID_or_string>,<Content_or_app_ID>
<content_type_ID_or_string>,<Content_or_app_ID>
Use the following rules to create the package text file:
- Use a separate line for each content type.
- Make sure that the first value that you enter on a line is the content type.
- Make sure that the value that follows the content type is the ID of the app or the content.
- Use commas to separate values.
Here's an example of packaging an app that has a content type of 100 and a dashboard that has a
content type of 4.
Here's the same example where the string is used instead of the content type ID to represent the
content type.
dashboard,22
installed_application,1051
In the following example, strings are used for the content type, which are followed by the
content IDs.
installed_application,1001
customrule,1274,1275
dashboard,10
-
Save the text file as <my_package>.txt
-
Type the following command to assemble and export your content in an extension file:
/opt/qradar/bin/contentManagement.pl -a export -c package -f
<mypackage>.txt.
The extension is created as a
.zip file in the
/opt/qradar/bin folder. The file name has the following
format:
<file_name>-ContentExport-YYYYMMDDhhmmss.zip
What to do next
Download the compressed (.zip) file from the
/opt/qradar/bin folder on your QRadar®
Console. You can then use QRadar
Extensions Management on the Admin tab to install your
extension on your QRadar
Console.For
more information about using the contentManagement.pl script to export content,
and about Extensions Management, see the QRadar
SIEM Administration Guide.