Cisco Headend System Release 2.7 Installation Guide

 

46 

4012763 Rev B 

To help you use the siteCmd program, read through the following descriptions of 

some of the options available for you to use with the program. The following 

discussion includes those relatively simple options that you are most likely to use 

with the siteCmd program. 
Important!  For more complex operations involving the Secure Shell and the 

siteCmd program, the user should be familiar with the use of quotation marks and 

other syntax rules. 

Include / Exclude Remote Sites 
The –a, -i, and the –x options allow you to specify to the siteCmd program the RNCS 

sites to which the commands you execute should apply. To have your command 

apply to all RNCS sites, use the –a option. To include only one specific site, simply 

name the site. To include two or more specific sites, use the –i option. To exclude 

specific sites, use the –x option. 
Examples:  The following examples are constructed using the ps  -ef command. The 

ps  -ef command lists what processes are running at the site-specific RNCS(s): 

 

To execute the ps  -ef command on all RNCS sites, type siteCmd  -a  ps  -ef and 

then press Enter. 

 

To apply the ps  -ef command to only one specific RNCS site (called site1), type 

siteCmd  site1  ps  -ef and then press Enter. 

 

To apply the ps  -ef command to two specific sites (called site1 and site2), type 

siteCmd  -i  site1:site2  ps  -ef and then press Enter. 

 

To exclude one specific RNCS site from the ps  -ef command, add the –x option, 

followed by the host name of the site you want to exclude. Type siteCmd  -a  -x 

site1  ps  -ef and then press Enter. 

 

To exclude two specific RNCS sites from the ps  -ef command, add the –x option, 

followed by the host names of the sites you want to exclude. Type siteCmd  -a  -x 

site1:site2  ps  -ef and then press Enter. 
Note:  Note that the –x option is always used in conjunction with the –a (all) 

option. 

Copy Files from the DNCS to the RNCS 
The /dvs/distFiles/Common directory on the DNCS is known as the common 

directory. Files that are to be loaded onto the RNCS are usually copied into the 

common directory of the DNCS first. The following series of commands 

demonstrates how to copy a file into the common directory of the DNCS and then 

distribute that file to each RNCS. 
Note:  In this example, the file someScript represents the file that needs to be 

distributed to each RNCS.