This documentation refers to a previously released version of BMC Discovery.
See the information on this topic for the latest version (11.3) or version 11.2.

The tw_tax_import utility enables you to import custom taxonomy files into the current taxonomy.

Recommendation

After you run a taxonomy import using this utility, you must restart the tideway service. Failure to do so will result in a malfunctioning user interface.

Taxonomy definitions are configured using .xml files that are stored in the following directories:

/usr/tideway/data/installed/taxonomy/
/usr/tideway/data/custom/taxonomy/

The directories are parsed in the order shown (installed files take precedence over custom files), and the files contained in these directories are parsed in alphabetical order (numbers before letters). This order is important, because any taxonomy definitions that are subsquently added override any previously loaded definitions. The standard base taxonomy file is contained in /usr/tideway/data/installed/taxonomy/00taxonomy.xml.

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

tw_tax_import [options] files

where:

  • files is a list of files to be imported. This command is optional if you use the --clear option, but cannot be used with the --handle-broken-extensions option.
  • options are any of the options described in the following table and the common command line options described in Using command line utilities.

Command Line Option

Description

--clear

Specifies to clear any existing taxonomy before importing

--handle-broken-extensions

Specifies to ignore any broken extensions. If a taxonomy extension is invalid, the importer ignores it and restarts, attempting to load all other extensions. It repeats this until it has loaded the base taxonomy and has loaded or attempted to load all extensions. In this way you always finish with a valid taxonomy. Where the taxonomy importer fails to load an extension it logs a message to stdout. This option cannot be used with the files command. It is primarily intended for upgrading, but it can be used from the command line.

-D, --datastore=NAME

(Do Not Use) Specifies the name of the datastore service

--merge

Specifies to merge import data with any existing taxonomy

-P, --partition=NAME

Specifies the name of the datastore partition

--replace

Specifies to replace data in any existing taxonomy with imported data

--strict

Specifies that there is no backwards compatibility for the previous format

-t, --taxonomy=ARG

(Do Not Use) Specifies the name of the taxonomy service

-u, --username=NAME

Specifies the name of the BMC Discovery user. If no user is specified, BMC Discovery uses the default, system.

--verbose

Specifies to display informational messages

--verify

Specifies to verify XML data only

User example

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

Importing customized taxonomy definitions

The following example illustrates how to import a custom taxonomy file and merge the imported data into the existing taxonomy.

  1. Type the following command:
    $TIDEWAY/bin/tw_tax_import --merge 
    /usr/tideway/data/custom/taxonomy/MYtaxonomy.xml
    The standard base taxonomy file named /usr/tideway/data/installed/taxonomy/00taxonomy.xml is supplemented with the imported data, and you can view the updated installed .xml file on the Administration > Taxonomy page.
  2. Restart the tideway service.
Was this page helpful? Yes No Submitting... Thank you
  • No labels
© Copyright 2004 - 2018 BMC Software, Inc.
Legal notices