Cisco Headend System Release 2.7 User Guide

11-2 

Convert IP Addresses With the convertIP Utility 

749640 Rev D 

System operators who want to use the convertIP utility to convert many IP addresses 

should prepare a text file beforehand. System operators can then run the convertIP 

utility with the name of the text file as an argument. This section contains guidelines 

and instructions for preparing the text file. 

Use the following guidelines when preparing the text file: 
• 

Prepare the file using a standard text editor, such as vi. 

• 

Prepare the file with one IP address per line. 

• 

Use either format (decimal or dotted-decimal notation) when preparing the text 

file. The convertIP utility automatically recognizes the input format and converts 

the IP address to the other format. 
Note:  You can even mix formats in the text file. 

• 

Cisco recommends that you save the file in the /dvs/dncs/tmp directory of the 

DNCS. 

Follow these instructions to prepare the text file for use with the convertIP utility. 
Important:  These instructions use the vi text editor as an example. The vi text editor 

is not intuitive. These instructions are not a substitute for a good working 

knowledge of the vi text editor. 

 

1. 

 

If necessary, open an xterm window on the DNCS. 

2. 

 

Type cd  /dvs/dncs/tmp and then press Enter. 
Note:  Cisco recommends that you save the file in the /dvs/dncs/tmp directory 

of the DNCS. 

3. 

 

Type vi  [file name].txt and then press Enter. 
Note:  Substitute the name of the input file you are creating for [file name]. 
Example:  Type vi  IP_input_file and then press Enter. 
Result:  The file opens for editing. 

4. 

 

Insert your list of IP addresses into the file you have just opened. 
Note:  Use the guidelines set forth in Guidelines for Preparing the Text File, 

earlier in this section. 

5. 

 

Save the file and close the vi editor.