Open topic with navigation

TIBCO GridServer® 7.1.0

# 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

| 1. | 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
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO GridServer®

Copyright © 2001-2022. TIBCO Software Inc. All Rights Reserved.