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 CiscoWorks import tool (and its command line equivalent tw_imp_ciscoworks described on this page) is deprecated in the version 11 release of BMC Discovery. It will be removed in a future release.


The tw_imp_ciscoworks utility enables you to import CiscoWorks network device data from the command line.


Use the BMC Discovery user interface to perform the functionality provided by the tw_imp_ciscoworks command line utility (see Importing network device data). If you choose to run the utility, read the documentation in this section to learn its usage and to understand the risks and potential impact on your environment.

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

tw_imp_ciscoworks [options] --username name 
   --file filename 


  • --username name is the BMC Discovery user name to use to import data.
  • --file filename is the name of the CiscoWorks data file to import.
  • 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



Specifies the field delimiter for input files. The default is the tab character.


Removes network devices and associated ports that do not exist in the imported data


Specifies that the CiscoWorks data file to import has a header row


Specifies that the CiscoWorks data file to import has no header row


Specifies that the data file being imported is in XML format, not CSV


User examples

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

Generating and importing CSV files

To generate a CSV file on the CiscoWorks server, type the following:

C:\Program Files\CSCOpx\campus\bin\ut -cli -query all
   -layout StandardTideway -export c:\data.csv 
   -u user -p password

This command produces a Java stack trace. This is a known issue and can be ignored.
The file that is produced can be imported by running the following command on the BMC Discovery appliance:

$TIDEWAY/bin/tw_imp_ciscoworks --delimiter=',' 
   --username name --password password 
   --file ~/tmp/data.csv

Generating and importing XML files

To generate an XML file on the CiscoWorks server, type the following:

C:\Program Files\CSCOpx\campus\bin\cmexport ut -u userid 
   -p password -host -layout StandardTideway

The file is written into the following directory:
C:\PROGRAM FILES\CSCOpx\files\cmexport\ut
The file can be imported onto the BMC Discovery appliance with the following command:

$TIDEWAY/bin/tw_imp_ciscoworks --xml --username name 
   --password password --file ~/tmp/2006516154526ut.xml
Was this page helpful? Yes No Submitting... Thank you
  • No labels
© Copyright 2004 - 2018 BMC Software, Inc.
Legal notices