This documentation supports the 21.05 (12.2) version of BMC Discovery.To view an earlier version of the product, select the version from the Product version menu.

Using command line utilities


BMC 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.

Warning

All command line utilities that are supported in BMC Discovery are documented in this section. Any utility that is not documented in this section is an explicitly unsupported tool.

Click here to expand...

Duplicate or enhanced functionality in user interface

Many of the utilities perform functions that are already part the BMC 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.

Note

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 Discovery.

 


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.