Installation FAQs and Troubleshooting


This section lists some common errors along with their causes and solutions.

Frequently Asked Questions

Where is the installation log file located?

Install and uninstall log files are created in the TIBCO_HOME\log directory.

What should I do if the JVM crashes when I run the installer?

The installer first extracts the bundled JVM into a temporary area and then uses it to launch itself. It for some reason, the JVM crashes, you can still run the installer using another JVM, preferably JVM 1.4.2 or higher. The syntax is:

Example 1
TIB_bcremote-suite_5.0.0_win_x86.exe -is:javahome C:\j2sdk1.4.2 
TIB_bcremote-suite_5.0.0_linux24gl22_x86.bin -is:javahome 
/opt/jre1.4.2 

The javahome directory must contain bin/java.exe or bin/java.

The installer will use the externally supplied JRE to launch itself.

What is uninst2 directory?

If the original uninstall directory is in use at uninstall time, it cannot be removed by the installer program. The installer then creates a second uninstall directory for the second installation. To remove the second installation, you must invoke the uninstall program from the second uninstall directory. The original uninstall directory can also be manually removed, if empty.

Speeding Up Installation

The installer is Java-based and requires a Java Virtual Machine (JVM) to launch. If the installer can use a JVM already on your system, installation is faster and uses less disk space. Otherwise, the installer extracts JVM from the installation package. This section explains where the installer searches for JVM, and how you can add a different location to the search path.

Every product installer is bundled with the appropriate platform-specific JVM version. When launched, the installer first searches for the appropriate JVM version on the target system.

How the Installer Searches for JVM

The installer by default searches for an appropriate JVM version in a set of standard locations. These standard locations are platform specific and are listed in JVM Search Locations. On each platform, the installer searches for JVM 1.4.2 only.

Speeding the JVM Search

You can speed up the JVM search by taking one of these actions before you launch the installer:

Benefits of Using Available JVM over Extracting Bundled JVM

JVM Search Locations

The following tables list the search locations for the different platforms.  

The installer only searches for JVM version 1.4.2. If a different JVM version exists in the system, or is passed in using the environment variable or command-line option, the installer ignores that JVM and extracts the bundled JVM.

  

Table 3 Windows
Location
Description
Environment
Set in Control Panel, not in command prompt
JAVA_HOME 
JDKHOME 
Registry
\HKEY_LOCAL_MACHINE\SOFTWARE\    
JavaSoft\Java Runtime Environment\    
1.4.2\JavaHome \HKEY_LOCAL_MACHINE\SOFTWARE\   
JavaSoft\  Java DevelopmentKit\1.4.2\JavaHome  
Directory
\Program Files\JavaSoft\JRE\1.4.2 
\JavaSoft\JRE\1.4.2  
\Java\JRE\1.4.2  

  

Table 4 Linux
Location
Description
Environment
JAVA_HOME  
JDKHOME  
Path
/usr/jre1.4.2 
/usr/local/jre1.4.2  
/opt/jre1.4.2 
/opt/j2re1.4.2 

 

Running Out of Disk Space

The installer calculates the disk space required in product home location for the selected components. The calculation is done before the actual installation (copying of files to system) begins. The installer will proceed only if sufficient free disk space is available in product home location.

However, if disk space is consumed by another process while the installer is copying the files, and if the required disk space is thereby reduced, the installer may fail and will then give a failure message.

Solution

While performing installation, avoid running other processes that consume disk space in product home location.


TIBCO BusinessConnect™ Remote Installation
Software Release 5.0, July 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com