Troubleshooting Network Shell issues
The following topics apply to troubleshooting issues with Network Shells:
- Network Shell not functioning after uninstalling an agent
- Extracted package includes host name in file structure
- *tar* command issues message - End of archive volume
- vi command takes too long to load
- vi command fails due to permission issues
- Network Shell upgrade encounters problems
- Interactive commands blocked by script command
- External process does not return the full amount of data
- RDP tunneling on Windows requires additional configuration
- NSH connection fails with socket errors when the client_keeplive_time is a non-zero integer
Network Shell not functioning after uninstalling an agent
If a 32-bit version of Network Shell and 64-bit agent are installed on a 64-bit server, uninstalling the agent causes Network Shell to not function.
Extracted package includes host name in file structure
The tar command removes a leading slash when it creates and extracts tar files. As a result, if you attempt to package files located on a remote host, the file structure includes the host name when the tar file is extracted.
Workaround: Create the tar file with four leading slashes as shown in the following example:
*tar* command issues message - End of archive volume
Occasionally the tar command produces a tar: End of archive volume 1 reached message at the end of extraction. This message is not an indication of failure and does not affect the extraction in any way.
vi command takes too long to load
The vi command may take 5-10 seconds to load in Windows environments if the TMPDIR environment variable is not set to a local directory. To ensure that vi uses a local temporary directory even when invoked on a remote host, use the following syntax to set your TMPDIR environment variable:
export TMDIR=//@/cygdrive/drive_name/temp_folder_name
vi command fails due to permission issues
When launching the vi command on Windows, permission errors are issued in the TrueSight Server Automation Console.
Workaround:
Choose from the following actions:
- Ensure that you are logged on to the TrueSight Server Automation Console as an administrator (for example, as BLAdmin or RBACAdmin) when you launch Network Shell.
- Ensure that the following directories are granted read and write permissions for all users:
- Temporary file directory, <installation path>/BMC Software/BladeLogic/NSH/tmp
- Recovery file directory, <installation path>/BMC Software/BladeLogic/NSH/var/tmp
Network Shell upgrade encounters problems
Upgrading from previous versions of the Network Shell is not supported using the AIX Package Installer.
Interactive commands blocked by script command
Inclusion of interactive commands in your NSH script can cause issues if you run the NSH script on a remote terminal or shell where the operating system (Linux, AIX, Solaris, or HPUX) uses the script command (a typescript command). The script command blocks or terminates the interactive command and leads to unexpected results.
Workaround:
For the NSH script to successfully execute interactive commands, temporarily comment out the script command in all OS files.
External process does not return the full amount of data
External processes that are included in an NSH script and are planned to return large amounts of data (for example, a nexec command that runs a remote batch file and then uses the echo command to output a message 1000 times) do not return the full amount of output if the NSH process ends to soon after the external process completed. This is due to java limitations.
Workaround:
Include a sleep command in the NSH script to suspend the process for several seconds after the execution of the external process.
RDP tunneling on Windows requires additional configuration
You can use the tcptunnel command to create a TCP tunnel to an RSCD agent for RDP tunneling on Windows. However, after creating the TCP tunnel, a remote desktop (RDP) connection is not established successfully without additional configuration.
To ensure successful RDP tunneling, additional configuration is required. Depending on how you launch the RDP connection, perform the relevant configuration task:
Mode of launching RDP | Configuration task |
|---|---|
mstsc <RDP file>.rdp /v:<host>:<port> | In your RDP (.rdp) file, set the authentication level to a value of 0: authentication level:i:0 |
mstsc /v:<host>:<port> | In the default RDP file (Default.rdp) in the My Documents or Documents folder, set the authentication level to a value of 0: authentication level:i:0 |
mstsc or through any other shortcut to mstsc.exe |
|
NSH connection fails with socket errors when the client_keeplive_time is a non-zero integer
When you set the value for the client_keeplive_time parameter to a positive integer and start the NSH shell, the NSH connection is terminated with the socket errors. This problem occurs on a RHEL 6.5 system.
Workaround:
The client_keeplive_time cannot be set to a positive non-zero number for the following RHEL kernel version:
2.6.32-431.23.3.el6.x86_64
To set the value for the client_keeplive_time parameter to a positive non-zero number, upgrade the kernel version or RHEL version to the next released version.