Task A: Copy Files Before Installation

Before you install TIBCO GridServer®, you must decide where to install the Manager. TIBCO software is installed in a TIBCO home directory, which is referred to in this documentation as TIBCO_HOME and is typically c:\TIBCO for Windows, or /opt/TIBCO for UNIX. TIBCO GridServer® is installed in an installation directory within this, which is referred to as DS_INSTALL and is typically TIBCO_HOME/datasynapse. A Manager installation has files in two locations:

• The Manager directory is the location of all static, non-volatile files, and is referred to as DS_MANAGER. The recommended Manager directory location is DS_INSTALL/manager. Do not install the Manager in a directory with a name containing a space, such as c:\Program Files. Also, do not install the Manager in a directory that is a symbolic link to another directory.

• The data directory is the location of all volatile files used by the application server, such as server properties and configuration. This is referred to as DS_DATA. By default, these files are installed in a directory created at DS_INSTALL/manager-data. To change this location, see Running Managers With a Different Data Directory.

On UNIX systems, the server.sh script attempts to create the data directory if it does not already exist. If this script fails because it can’t create the data directory, you must either run the script as root, create the data directory with write permissions for the installation user before you run the script, or set the data directory to another location.

Warning

Do not set the data directory to be the same as the installation directory.

To copy files used to install TIBCO GridServer®:

1. The software ships as a gzipped TAR archive and a JAR file of third-party libraries. The gzipped TAR archive is unpacked in the installation directory. To unpack it on a Windows system, use WinZip or a similar tool. On a UNIX system, use tar. For UNIX, use the following command:

   tar -xvzf TIB_GridServer*gz

Note	The TAR file contains the `datasynapse` directory. If you, for example, would like your installation directory to be `/opt/TIBCO/datasynapse`, expand the archive in `/opt/TIBCO`.

2. If you plan on using Windows Authentication, after unarchiving the installation archive, install the third-party library JAR with the following command, where version is the version of GridServer you are installing, and path is the DS_MANAGER path:

   java -jar TIB_gridserver_version-lgpl.jar path

3. Install the unlimited strength JCE for your Java SDK. The files reside in DS_MANAGER/webapps/livecluster/WEB-INF/etc/jce. Follow the instructions in the README.txt for your SDK to install the files.

Running Managers With a Different Data Directory

All volatile files used by GridServer are stored in the data directory, which by default is DS_INSTALL/manager-data. You can change this location by setting the data directory.

To set your data directory:

Procedure

Unpack the installation in the installation directory.

2. Prior to running your Manager for the first time, set the DS_DATA_DIR environment variable to the location of the data directory.

3. Run the server.bat or server.sh script with the prepare argument to copy volatile files into the data directory.

When specifying a data directory, it cannot contain any spaces in its name, be the same directory as the installation directory, or be a child directory of the DS_MANAGER/webapps/livecluster directory. Also, the installation and data directory cannot be on two different Windows drives (for example, C: and T:).

Did you find this helpful?

Yes No