NSH cheat sheet

This topic provides examples of frequently used NSH commands and script elements that can help you get started with writing NSH scripts.

Frequently used NSH commands

The following table lists few examples of NSH commands and their results. Note that because NSH is based on ZSH, you can find some helpful information by searching the web for ZSH guides (for example http://zsh.sourceforge.net/Guide/).

To take this action	Use this command
Connect to a remote server.	`host% cd //hostname host% uname -a`
List directory contents on one or many remote machines.	`host% ls -l //host1/directory host% ls -l //host1/directory //host2/directory`
Take actions on a remote file.	`host% vi //host1/dir/file` `host% more //host1/dir/file` `host% tail -f //host1/dir/file` `host% cat //host1/dir/file` `host% md5sum //host1/dir/file`
Copy one or more file or directories from one machine to another.	`host% cp /directory/file //host2/directory host% cp -r //host1/directory //host2/directory host% cp //host1/directory/file //@/directory host% ncp //host1/directory/file -d //host1/directory1 //host2/directory2`
Compare a file that exists on multiple hosts	`host% diff //host1/directory/file //host2/directory/file`
Use `n` commands to retrieve pertinent os-level information about servers: ndf — runs "df" across many machines nps — runs "ps" across many machines ntop — runs "top" across many machines nover — provides system-level overview across many machines nmem — summary of memory across many machines nnet — summary of network info across many machines nstats — system statistics across many machines	`host% nmem -h` `host1 host% ndf -h` `host1 host2 host% ntop -h` `host1 host2 -t`
Convert CSV output to XML using pipe	`host% ndf --- h host1 host2 -c \| csv2xml`
Remotely execute a command that lives locally on the target server.	`host% nexec <redhat_host> rpm -qa host% nexec <solaris_host> pkginfo -l host% nexec <windows_host> ipconfig -all`
Execute a command against many servers.	`host% runcmd -h host 1 host 2 -e rm /file_being_deleted`
Verify a process exists across many servers.	`host% runcmd -f /hostlist -e ps -ef \| grep process`
Execute an NSH script across many servers	`host% runscript -NH -V -f /hostlist -e //host/script`
Verify the RSCD agent version, mapping, and license status.	`host% agentinfo host1`
View RSCD agent logfile contents.	`host% logman cat -h host1 \| tail`
Execute a WMIC command on a remote Windows server.	`nexec -ncq <windows_host> cmd /c '<WMIC_command>'` Examples: `host% nexec -ncq <windows_host> cmd /c 'echo test"test'` `host% nexec -ncq <windows_host> cmd /c 'wmic path win32_groupuser where (groupcomponent="win32_group.name= \"Administrators\",domain=\"%COMPUTERNAME%\"")'`

To view summarized descriptions of commands and utilities, see the alphabetized table in Summarized descriptions of commands.

NSH scripting elements

The following table provides descriptions and examples of commonly used elements within an NSH Script. It provides information on basic scripting elements such as checking if a file or directory exists, creating a for loop, creating an if else condition, and so on.

To do this	Use this syntax	Examples / Comments
Identify the script as an NSH script	`#!/bin/nsh`	This should be the first line of an NSH script when run on a UNIX/Linux host to identify it as NSH.
Check to see if a file exists	`[ -f <file> ]` Note: To see if a file does not exist, use an exclamation mark as in the following command: `[! -f <file> ]`	(From the command line) `host% [ -f //@/c/WINNT/win.ini ] host% echo $? 0 host% [ -f //@/c/WINNT/winx.ini ] host% echo $? 1`
Check to see if a directory exists	`[ -d <directory> ]` Note: To see if a directory does not exist, use an exclamation mark as in the following command: `[! -d <directory> ]`	(From the command line) `host% [ -d //@/c/WINNT ] host% echo $? 0 host% [ -d //@/c/WIN ] host% echo $? 1`
Loop through a list, performing the same actions on each item	`for X in $X..do..done` Another method for looping through a list, performing the same actions on each item. foreach X in $X..{..}	`for HOST in $* do echo $HOST done` for each HOST in `cat $HOST_LIST` { echo HOST }
Check conditions and perform actions depending on results.	`if..then..else..fi`	`if [! -d /tmp/blade] then mkdir /tmp/blade else echo "Directory already exists." fi`

Miscellaneous Tips and Tricks

The following table lists various tips and tricks for using NSH:

To do this Use this syntax Examples / Comments

Execute a command in a remote path on a server

-D //<server>/<directory>

To run the OS ls command in /var/tmp/stage on <server>:

nexec -D //<server>/var/tmp/stage <server> ls

To run the uname -a command against <server> without "cding" into <server>:

uname -D //<server> -a

To call cscript and run the myScript.vbs that is in the /C/Temp directory on the target without having to translate the NSH path /C/Temp to Windows path to C:\Temp:

nexec -D //<server>/C/Temp <server> cmd /c "cscript /nologo myScript.vbs"

Reference the host that NSH was launched from

//@

To cd back to the root directory of the system running NSH

cd //@

To cd back to /tmp on the system running NSH

cd //@/tmp

To copy /tmp/file.txt from <server> to /tmp on the system running NSH

cp //<server>/tmp/file.txt //@/tmp

Disconnect NSH from a system

disconnect <server>

To cd back to the system running NSH and closes the NSH connection to <server> instead of letting it idle out:

cd //@;disconnect <server>

Where to go from here

Adding a Network Shell script

Creating Network Shell Script Jobs