Cisco IP Solution Center Installation Guide, 3.2 - Troubleshooting [Cisco IP Solution Center]

Table Of Contents

Troubleshooting

Unable to Find the Hostname

Multiple ISC Instances with the Same TIBCO Rendezvous Port

Known Installation Issues

Troubleshooting

The following sections describe the major areas in the Cisco IP Solution Center installation in which troubleshooting might be necessary:

•Unable to Find the Hostname

•Multiple ISC Instances with the Same TIBCO Rendezvous Port

•Known Installation Issues

Unable to Find the Hostname

Symptom

Cannot find hostname.

Recommended Action

Step 1 If you cannot find the hostname, check the /etc/nsswitch.conf file to determine how the hostname is resolved.

Step 2 If you are using DNS, use nslookup <machine name> to check if it is working properly.

Step 3 If it is not working properly, you need a system administrator to fix the DNS entry.

Step 4 If you are not using DNS, be sure there is an entry for your machine in the hosts file in the /etc directory.

Multiple ISC Instances with the Same TIBCO Rendezvous Port

Symptom

You might not see any error messages, but you might see inconsistencies with events and tasks that you have just created.

Recommended Action

You might have more than one ISC server on the same subnet of a LAN, in which case, multiple instances of the ISC server will have the same TIBCO Rendezvous port. To fix this problem, you must ensure that the TIBCO port has a unique value.

To change the value for the TIBCO port, follow these steps:

Step 1 From the terminal window where the WatchDog is running, stop the WatchDog with the following command:

stopwd -y

Step 2 Use a text editor to open the etc/install.cfg file.

Step 3 Change the TIBCO_PORT variable to the desired value.

The default value for the TIBCO_PORT variable is 7530.

Step 4 To update all the dependent files with the new TIBCO port value, run the applycfg.sh command.

Step 5 startdb

Step 6 initdb.sh

Step 7 stopdb -y

Step 8 ps -e | grep rvrd

The returned result is the process id for the rvrd process.

Step 9 kill -9 <process id>

where: <process id> is the returned process from Step 8.

Step 10 rm -f $ISC_HOME/tmp/rvrd.isc.store

Step 11 rvrd -store $ISC_HOME/tmp/rvrd.isc.store

Step 12 startwd

Step 13 Run the following multiple line Java command:

java -classpath $VPNSC_HOME/resources/java/classes/common:\

$VPNSC_HOME/thirdparty/rv/lib/rvconfig.jar:\

$VPNSC_HOME/thirdparty/rv/lib/tibrvj.jar:\

$VPNSC_HOME/thirdparty/rv/lib/tibrvjweb.jar:\

com.cisco.vpnsc.install.RvrdCfg <tibco_port> <server> isc

where:

<tibco_port> is the desired port specified in Step 3.

<server> is the server name, for example: server1.cisco.com.

Known Installation Issues

Known issues and solutions are as follows:

Symptom 1

Out of disk space.

Recommended Action

The error looks something like the following:
ISC 3.2 will be installed in /var/isc-3.2
>Copying files ...
>Copying sybase...
>tar:./shared/jre_1.3.1_solaris_sun_sparc/lib/rt.jar: HELP - extract
>write error
>Error copying Sybase
If you see an error like this, it is likely due to the server running out of disk space.

To verify what space is available, run the command df -k <install directory>.

See Cisco IP Solution Center Installation Guide for the disk drive space recommendation:

http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/isc/3_2/install/index.htm

Symptom 2

The Installation utility GUI never displays.

Recommended Action

This problem should be accompanied with a Java stack dump.

Step 1 Run the following command to check for the $DISPLAY environment variable being set:

echo $DISPLAY.

If you use the secure shell (ssh), then this will be set up and managed for you.

If you manually change the $DISPLAY environment variable in an SSH environment, the easiest recovery method is to log off and reestablish the SSH connection.

Step 2 To set the DISPLAY environment variable do the following:

a. For the K or Bourne shell:
export DISPLAY=<machine name>:0.0
b. For the C-shell:

setenv DISPLAY=<machine name>:0.0

Symptom 3

Cannot run command scripts.

Recommended Action

If the command scripts are not running or cannot be found, it usually means that the ISC environment has not been sourced.

•For the C-shell: source $ISC_HOME/bin/vpnenv.csh

•For the K-shell and Bourne-shell: . $ISC_HOME/bin/vpnenv.sh

Symptom 4

Could not find temporary files.

Recommended Actions

If you receive an error that says the temporary file could not created or found, it usually means the location used to write the temporary is write-protected or out of disk space.

The two places that ISC uses for temporary files are /tmp and /var/tmp.

•Make sure both locations have write permission by doing a long list on the directories (ls -la). The directory should have wide open permissions: drwxrwxrwx.

•There is another temporary file problem that can arise, especially in cases where there have been previous aborted installation attempts—existing temp files might be left by previous installations. If this is the case, it is best to clean out all the files in the temp directories after aborted installation attempts.

Symptom 5

Running install.sh fails.

Recommended Action

Running install.sh can fail due to the following reasons:

1. You are not root.

Although it is possible to install as non-root if you have appropriate permissions in the target directory, this will still have problems since only root can write to /etc/init.d where the startup scripts reside. Therefore, it is easier to install as root.

2. You do not have enough disk space in the target directory. To find out the available disk space, issue the following command:

df -k <target directory>

3. You do not have enough disk space in the /tmp directory. Issue the command df -k /tmp to determine the available disk space for /tmp.

4. The PATH and LD_LIBRARY_PATH environment variables are incorrect.

Make sure your PATH and LD_LIBRARY_PATH environment variables are correct.

Example:
PATH=/usr/bin:/usr/local/bin
LD_LIBRARY_PATH=/usr/lib:/usr/local/lib
export PATH LD_LIBRARY_PATH
a. Alternatively, start a clean root shell with this command:

env - ksh

b. Then issue this command:

./install.sh /opt/isc32 master

Symptom 6

ISC does not start on reboot.

Recommended Action

Do the following:

Step 1 Install ISC as the root user.

If you install as root, init.d has a script to start the Watchdog.

If you do not install as root, you do not get the startup on reboot feature.

Step 2 To become root, enter the following command:

su root

Step 3 Get the isc.tmpl file from the installation media.

Step 4 Edit the following fields in isc.tmpl:

OWNER=_owner - replace _owner with the username whom owns isc

ISC_HOME=_vpnsc_home - replace _vpnsc_home with the isc directory

Step 5 Rename isc.tmpl as isc and then enter the following commands:

mv isc /etc/init.d

chmod 744 /etc/init.d/isc

Step 6 Create the following symbolic links to isc:

a. cd /etc/rc1.d

ln -s /etc/init.d/isc K98ISC

b. cd to /etc/rc2.d

ln -s /etc/init.d/isc K98ISC

c. cd to /etc/rc3.d

ln -s /etc/init.d/isc S99ISC

	Cisco IP Solution Center Installation Guide, 3.2
	Troubleshooting
Cisco IP Solution Center Installation Guide, 3.2 Index About This Guide System Recommendations Installing and Logging Into ISC Setting Up Oracle for ISC Setting Up Cisco CNS IE2100 Appliances Running Cisco CNS Configuration Engine 1.3.x and 1.4 Software with ISC Backup and Restore of ISC Repository and Standby System Troubleshooting	Download this chapter Troubleshooting Download the complete book Cisco IP Solution Center Installation Guide, 3.2 - Entire Book in PDF (PDF - 2 MB) Feedback Table Of Contents Troubleshooting Unable to Find the Hostname Multiple ISC Instances with the Same TIBCO Rendezvous Port Known Installation Issues Troubleshooting The following sections describe the major areas in the Cisco IP Solution Center installation in which troubleshooting might be necessary: •Unable to Find the Hostname •Multiple ISC Instances with the Same TIBCO Rendezvous Port •Known Installation Issues Unable to Find the Hostname Symptom Cannot find hostname. Recommended Action Step 1 If you cannot find the hostname, check the /etc/nsswitch.conf file to determine how the hostname is resolved. Step 2 If you are using DNS, use nslookup <machine name> to check if it is working properly. Step 3 If it is not working properly, you need a system administrator to fix the DNS entry. Step 4 If you are not using DNS, be sure there is an entry for your machine in the hosts file in the /etc directory. Multiple ISC Instances with the Same TIBCO Rendezvous Port Symptom You might not see any error messages, but you might see inconsistencies with events and tasks that you have just created. Recommended Action You might have more than one ISC server on the same subnet of a LAN, in which case, multiple instances of the ISC server will have the same TIBCO Rendezvous port. To fix this problem, you must ensure that the TIBCO port has a unique value. To change the value for the TIBCO port, follow these steps: Step 1 From the terminal window where the WatchDog is running, stop the WatchDog with the following command: stopwd -y Step 2 Use a text editor to open the etc/install.cfg file. Step 3 Change the TIBCO_PORT variable to the desired value. The default value for the TIBCO_PORT variable is 7530. Step 4 To update all the dependent files with the new TIBCO port value, run the applycfg.sh command. Step 5 startdb Step 6 initdb.sh Step 7 stopdb -y Step 8 ps -e \| grep rvrd The returned result is the process id for the rvrd process. Step 9 kill -9 <process id> where: <process id> is the returned process from Step 8. Step 10 rm -f $ISC_HOME/tmp/rvrd.isc.store Step 11 rvrd -store $ISC_HOME/tmp/rvrd.isc.store Step 12 startwd Step 13 Run the following multiple line Java command: java -classpath $VPNSC_HOME/resources/java/classes/common:\ $VPNSC_HOME/thirdparty/rv/lib/rvconfig.jar:\ $VPNSC_HOME/thirdparty/rv/lib/tibrvj.jar:\ $VPNSC_HOME/thirdparty/rv/lib/tibrvjweb.jar:\ com.cisco.vpnsc.install.RvrdCfg <tibco_port> <server> isc where: <tibco_port> is the desired port specified in Step 3. <server> is the server name, for example: server1.cisco.com. Known Installation Issues Known issues and solutions are as follows: Symptom 1 Out of disk space. Recommended Action The error looks something like the following: ISC 3.2 will be installed in /var/isc-3.2 >Copying files ... >Copying sybase... >tar:./shared/jre_1.3.1_solaris_sun_sparc/lib/rt.jar: HELP - extract >write error >Error copying Sybase If you see an error like this, it is likely due to the server running out of disk space. To verify what space is available, run the command df -k <install directory>. See Cisco IP Solution Center Installation Guide for the disk drive space recommendation: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/isc/3_2/install/index.htm Symptom 2 The Installation utility GUI never displays. Recommended Action This problem should be accompanied with a Java stack dump. Step 1 Run the following command to check for the $DISPLAY environment variable being set: echo $DISPLAY. If you use the secure shell (ssh), then this will be set up and managed for you. If you manually change the $DISPLAY environment variable in an SSH environment, the easiest recovery method is to log off and reestablish the SSH connection. Step 2 To set the DISPLAY environment variable do the following: a. For the K or Bourne shell: export DISPLAY=<machine name>:0.0 b. For the C-shell: setenv DISPLAY=<machine name>:0.0 Symptom 3 Cannot run command scripts. Recommended Action If the command scripts are not running or cannot be found, it usually means that the ISC environment has not been sourced. •For the C-shell: source $ISC_HOME/bin/vpnenv.csh •For the K-shell and Bourne-shell: . $ISC_HOME/bin/vpnenv.sh Symptom 4 Could not find temporary files. Recommended Actions If you receive an error that says the temporary file could not created or found, it usually means the location used to write the temporary is write-protected or out of disk space. The two places that ISC uses for temporary files are /tmp and /var/tmp. •Make sure both locations have write permission by doing a long list on the directories (ls -la). The directory should have wide open permissions: drwxrwxrwx. •There is another temporary file problem that can arise, especially in cases where there have been previous aborted installation attempts—existing temp files might be left by previous installations. If this is the case, it is best to clean out all the files in the temp directories after aborted installation attempts. Symptom 5 Running install.sh fails. Recommended Action Running install.sh can fail due to the following reasons: 1. You are not root. Although it is possible to install as non-root if you have appropriate permissions in the target directory, this will still have problems since only root can write to /etc/init.d where the startup scripts reside. Therefore, it is easier to install as root. 2. You do not have enough disk space in the target directory. To find out the available disk space, issue the following command: df -k <target directory> 3. You do not have enough disk space in the /tmp directory. Issue the command df -k /tmp to determine the available disk space for /tmp. 4. The PATH and LD_LIBRARY_PATH environment variables are incorrect. Make sure your PATH and LD_LIBRARY_PATH environment variables are correct. Example: PATH=/usr/bin:/usr/local/bin LD_LIBRARY_PATH=/usr/lib:/usr/local/lib export PATH LD_LIBRARY_PATH a. Alternatively, start a clean root shell with this command: env - ksh b. Then issue this command: ./install.sh /opt/isc32 master Symptom 6 ISC does not start on reboot. Recommended Action Do the following: Step 1 Install ISC as the root user. If you install as root, init.d has a script to start the Watchdog. If you do not install as root, you do not get the startup on reboot feature. Step 2 To become root, enter the following command: su root Step 3 Get the isc.tmpl file from the installation media. Step 4 Edit the following fields in isc.tmpl: OWNER=_owner - replace _owner with the username whom owns isc ISC_HOME=_vpnsc_home - replace _vpnsc_home with the isc directory Step 5 Rename isc.tmpl as isc and then enter the following commands: mv isc /etc/init.d chmod 744 /etc/init.d/isc Step 6 Create the following symbolic links to isc: a. cd /etc/rc1.d ln -s /etc/init.d/isc K98ISC b. cd to /etc/rc2.d ln -s /etc/init.d/isc K98ISC c. cd to /etc/rc3.d ln -s /etc/init.d/isc S99ISC
	Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks