• Loading...
This documentation relates to the latest released version of BMC Atrium Discovery (other versions).

Using command line utilities

Skip to end of metadata
Go to start of metadata
Space Search

Searching ADDM 8.3

Table of Contents

BMC Atrium Discovery provides utilities that you can run on a command line interface to configure Discovery by obtaining information from specific systems. All the utilities are located in the /usr/tideway/bin directory and are named tw_utilityname. Documentation for each utility in this section includes a link to the corresponding location in the user interface where you can perform the intended function.

Supported utilities
All command line utilities that are supported in BMC Atrium Discovery are documented in this section. Any utility that is not documented in this section is an explicitly unsupported tool.
Click here to show the list of supported command line utilities

Duplicate or enhanced functionality in user interface

Many of the utilities perform functions that are already part the BMC Atrium Discovery user interface, and might duplicate what you might be able to accomplish more easily in the best-practice use of the product. Most of the configuration you perform will be done using the Discovery Configuration page accessed from the Administration tab; however, the functionality might be located in other areas of the product.

Note
Although command line utilities offer a potentially faster or more convenient way to perform a specific function, they may also cause unintended consequences that might compromise your environment if not used carefully.

Common options in the utilities

In each utility, you can specify options, or arguments, that enable you to specify what action you want the utility to perform. For many of the utilities, several options are inherited and their basic purpose does not change. In this section, common options are not described for each utility because they are not typically used.

The following table lists the common options that are inherited by many of the command line utilities available with BMC Atrium Discovery.

Common Command Line Option Description
-h,
--help		 Displays the required use of the utility and describes the available options
--logbackupcount=NUM Specifies the number of backup logs files that are preserved
--logfile=FILE Specifies the log file that log messages are written to
--loglevel=LEVEL Specifies the logging level as one of the following values:
  • debug: logs all messages
  • info: logs critical, error, warning, and information messages
  • warn: logs critical, error, and warning messages
  • error: logs critical and error messages
  • crit: logs only critical messages
--passwordfile=FILE Specifies a file from which the password is to be read. This is only relevant for utilities that have the --username option. Note that this file is not encrypted, though you can set the file permissions to owner-only (chmod 600 passwordfile.txt) to restrict access to the file. For more information about password policies, see Managing security policies.
-p, --password=PASSWD Specifies the password of the BMC Atrium Discovery user. If no password is specified, you are prompted for one. This is only relevant for utilities that have the --username option. For more information about password policies, see Managing security policies.
-v, --version Displays the BMC Atrium Discovery version number, copyright information, and the name of the utility

Warning
You should not use any service utilities (those named tw_svc_name), because the improper use of a service-based command could have potentially adverse results on your system.
Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.