Using command line utilities
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
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.
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. 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.
Use of command line utilities
Although command line utilities offer a potentially faster or more convenient way to perform a specific function, they might also cause unintended consequences that might compromise your environment if not used carefully.
When using command line utilities, particularly long-running processes such as
tw_ds_offline_compact it is recommended that you use the screen utility to prevent any problems that might arise from dropped connections. An example of using screen is shown in the
tw_ds_offline_compact documentation. Using screen provides more detailed information on screen and links to online resources.
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
Displays the required use of the utility and describes the available options
Specifies the number of backup logs files that are preserved
Specifies the log file that log messages are written to
Specifies the logging level as one of the following values:
Specifies a file from which the password is to be read. This is only relevant for utilities that have the
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
The user to run the utility as. This has to be a valid BMC Atrium Discovery UI user such as the system user, not a username used to access the command line via ssh.
Displays the BMC Atrium Discovery version number, copyright information, and the name of the utility
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.