tw_convert_reports

The tw_convert_reports utility enables you to manually customize reports and channels on the appliance. This utility can serve as a standalone tool to manually convert reports from the old format to the new format (introduced in Tideway Foundation 7.3) after you have upgraded BMC Discovery and started the system.

This report format was introduced in Tideway Foundation 7.3. Therefore, the utility is required only for report files that have been manually copied from an appliance version earlier than 7.3 to an appliance version later than 7.3. If you upgrade to a BMC Discovery version later than 7.3, the utility runs automatically.

To use the utility, type the following command at the $TIDEWAY/bin/ directory:

$TIDEWAY/bin/tw_convert_reports options reports_file

where:

• reports_file is the name of the xml reports file to be converted.
  If a file name is not specified, an error is displayed.

• options are any of the options described in the following table and the common command line options described in Using command line utilities.

User example

In the following example, type the commands on a single line. Line breaks are provided to make the example easier to read.

Converting a reports file

To convert a consolidated report file named 30ListenerReports.xml, type the following command:

$ cd /usr/tideway/data/custom/reports
$ ls
30ListenerReports.xml
$ TIDEWAY/bin/tw_convert_reports 30ListenerReports.xml

Generated converted_30ListenerReports.xml (0 errors, 2 warnings)
$ ls
30ListenerReports.xml
converted_30ListenerReports.xml
$

The file is converted and saved as a new file prepended with converted_. The original file is not changed.