Exporting and importing custom reports

This topic describes how to back up the report (apart from a database backup) or to transfer the report to another console using export in XML format and import operations.

This topic provides the information about the following procedures:

Exporting and importing custom reports using the console

To export a report using the console

In the BMC Release Package and Deployment console, click the Report tab.
From the left menu, select Reports.
Locate the report to export, and click Download XML in its associated Actions menu.
(Optional) When you are offered a file name and asked for the location to save the XML file, you can change the file name and location as needed.
Click OK.

To import a report using the console

Click the Report tab.
From the left menu, select Reports.
Click Import located on the right after the list of reports.
Use Browse to locate and select the XML file to import.
Click Import.

Exporting and importing custom reports using the CLI

Note

For correct and stable operation of BMC Release Lifecycle Management suite, ensure that BMC Release Package and Deployment uses the instance of PHP and additional libraries that are bundled with the BMC Release Lifecycle Management suite using the following procedure:

For Windows OS:
1. On the command line, execute the following command:
  set "PATH=$RLM_HOME\lib\php; $RLM_HOME\lib\oracle-instant-client;%PATH%"
  where $RLM_HOME is a full path to directory where BMC Release Lifecycle Management is installed.
  
  For example:
  set "PATH=D:\RLM\lib\php;D:\RLM\lib\oracle-instant-client;%PATH%"
For Linux OS:
1. In the terminal, execute the following command:
  export PATH=$RLM_HOME/lib/php:$RLM_HOME/lib/oracle-instant-client:$PATH
  where $RLM_HOME is a full path to directory where BMC Release Lifecycle Management is installed.
  For example:
  export PATH=/opt/bmc/RLM/lib/php/bin:/opt/bmc/RLM/lib/oracle-instant-client:$PATH

To export a report using the command-line interface

On the command line, change directory to the <product installation directory>/releases/4.3.0/Q.
Run the vlreport command to list the reports available for export, along with their index numbers, as follows:
run vlreport list
The following sample illustrates the output:
Available Reports
-----------------
Index. Report Name
   52. Database Objects Individual Counts Weekly Report
  54. Database Records Individual Count Weekly Report
  56. Instance Size Usage Weekly Report
  58. Database Objects Total Count Weekly Report
  59. Database Records Total Count Weekly Report
  61. Deployments Report
Run the vlreport command to export a report as follows:
run vlreport export index output_file
- index is the index number displayed by the vlreport command.
- output_file is the file name to use for the XML form of the report. If you specify a path, the path is relative to the current working directory.

To import a report using the command-line interface

Change directory to the <product installation directory>/releases/4.3.0/Q.
Run the vlreport command to import an XML report file as follows:
run vlreport install file name
- file is the XML report file to import.
- name is the name to use for the imported report. If the name already exists, the system modifies the imported name for uniqueness.