Pre-Installation Tasks
Install Unlimited Strength JCE Policy Files
To use TIBCO BusinessConnect security features, you must download and install one of the following two JavaTM Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files:
• Java 1.7.0 Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 7.0. This is required for JRE 1.7.0.
To download and install the policy files, perform these steps:
1. Download the required files from the following web sites:
Windows, Sun Solaris, HP-UX, Linux:
http://www.oracle.com/technetwork/java/javase/downloads/index.html IBM AIX:
https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source
=jcesdk
2. Once you have downloaded the file jce_policy-7.zip, unzip it and place the files US_export_policy.jar and local_policy.jar into
TIBCO_HOME\tibcojre\1.7.0\lib\security
or
TIBCO_HOME\tibcojre64\1.7.0\lib\security (for the Windows 64 bit platform)
Install FESI EcmaScript Interpreter to Support Custom Scripts
If you plan to use custom scripts, perform these steps:
1. Download the FESI EcmaScript Interpreter version 1.1.5 from the following location:
http://www.lugrin.ch/fesi/download.html
2. Extract fesi.jar from fesikit-1.1.5.zip and store it in bc_HOME\lib\is.
Pre-Installation Tasks
|
9Set Up Database Information
TIBCO BusinessConnect uses a database to store the audit log, the non repudiation log, the runtime data store, and the configuration store. You can assign these logs/data stores to different databases, or you can use one database for all.
Configure Oracle, DB2, SQL Server, and MySQL
All databases except for MySQL are installed according to the corresponding software vendor’s instructions and contain the necessary drivers
Oracle Client Library Path Usage
If you are planning to use the Oracle OCI drivers, you must specify the Oracle Client Library path. When dealing with the TIBCO BusinessConnect
configuration UI, you must specify this path in the TIBCO Administrator .tra file.
Depending on the platform where TIBCO Administrator is installed, different library paths may need to be appropriately updated.
The drivers are stored under tibco\tpcl\version\jdbc.
JDBC (Type 4) drivers are needed for DB2, Oracle, and MSSQL databases.
To be consistent, you can define the following environmental variable as follows:
1. Set tibco.env.ORACLE_CLIENT_PATH=<OracleClientnativelibrary path>
2. Prepend %ORACLE_CLIENT_PATH% to the variables PATH, LD_LIBRARY_PATH,
SHLIB_PATH and LIBPATH.
The value should point to the Oracle native client libraries directory as follows:
• On Windows This is typically ORACLE_CLIENT_HOME/BIN directory, such as
C:\oracle\product\10.2.0\client\BIN
• On UNIX This is typically the directory ORACLE_CLIENT_HOME/lib or
ORACLE_CLIENT_HOME/lib32
The supported Checkpoint databases are Oracle, SQL Server, and DB2.
MySQL is not supported.
10
|
Chapter 2 InstallationConfiguration of Oracle, DB2, SQL Server, and MySQL Databases Table 3 Configure Oracle, DB2, SQL Server, and MySQL Databases
Database Configuration steps and other data to keep in mind Oracle Thin
Create regular and system temporary tablespaces each with a page size of 32 KB.
Set APPLHEAPSIZE to 4096
SQL Server jdbc:sqlserver://<host>:<port>;databaseName=<databaseName>
MySQL JDBC jdbc:mysql://[host]:[port]/[database]
To configure MySQL, set the maximum packet size variable on the client and the server to 64MB. See the MySQL documentation for instructions.
Make sure that you install the following software components:
• MySQL Database Server and Client
• Administrative tools (MySQL Administrator)
• MySQL Connector/J, a native Java driver that converts JDBC (Java Database Connectivity) calls into the network protocol used by the MySQL database. This driver must be present in the directory reserved for drivers, which is tibco\tpcl\version\jdbc.
Installation
|
11Installation
The following sections describe the installation process in the available installation modes:
• GUI Mode, page 14
• Console Mode, page 16
• Silent Mode, page 17
GUI Mode
To install this product in GUI mode:
1. Open the physical media or download the package.
2. Extract the contents of the package to a temporary directory.
3. Navigate to the temporary directory.
4. Run TIBCOUniversalInstaller. You can do so in one of the following ways:
— Double-click the installer icon.
— On the command prompt, provide the absolute path of the installer file on without specifying any options. The installer defaults to GUI mode.
5. Click the Next button on the Welcome dialog.
6. Read through the license text when the License Agreement dialog appears, select the I Accept the Terms of the License Agreement radio button and then click the Next button.
7. Select an installation profile from the list on the left. TIBCO Universal Installer The installers of some plugins and protocols for TIBCO BusinessConnect 6.1.0 require modification before they can be used to properly install such plugins and protocols. Contact TIBCO Support to obtain the PluginInstallerMigrator tool, which can modify these plugins and protocols. The plugins and protocols whose installers must be modified by the utility include, but are not limited to:
• TIBCO BusinessConnect ™ B2BPlugin for CMI 1.0.0
• TIBCO BusinessConnect™ ConfigStore Management Interface Protocol 6.0.0
• TIBCO BusinessConnect Plug-in for FTP Server™ 1.0.0
• TIBCO PartnerExpress™ 6.0.0
• TIBCO BusinessConnect Plug-in for SSH Server™ 1.0.0
• TIBCO BusinessConnect™ Trading Community Management 6.0.0
12
|
Chapter 2 InstallationGateway Only
This profile is intended for installation on the Gateway machine, which is located in the DMZ zone outside the company’s firewall. With this profile, the following pre-selected components will be installed:
— Gateway Documentation
— BusinessConnect Runtime: Gateway Interior Server Only
This profile is intended for the BusinessConnect administrator. With this profile, the following pre-selected components will be installed:
— Interior Server Documentation
— BusinessConnect Runtime: Interior Server
— BusinessConnect Tools: Interior Server Tools Typical
This profile is intended for the BusinessConnect administrator, same as the option Interior Server Only. However, in some cases a user would want to have all components on the same machine, such as for testing.
If you choose this installation profile, all components will be installed:
— Interior Server Documentation, Gateway Documentation
— BusinessConnect Runtime: Interior Server, Gateway
— Interior Server Tools
8. Click the Next button. The TIBCO Installation Home dialog displays.
An installation environment isolates product installations. A product installed into an installation environment does not access components in other
installation environments. An installation environment consists of a name and path. You can choose a new environment or an existing environment.
— Create a new TIBCO_HOME To install the product into a new installation environment, specify the following properties:
Directory The directory into which the product is installed. Type a path or click Browse to specify the path or accept the default location.
The path cannot contain special characters such as "*", "#", "?", ">", "<", "%",
"&", "$", "`", or "|". The path cannot be the same as the path of an existing environment.
To customize the profile feature settings, check the Customize Installation checkbox and use the feature tree on the right.
Installation
|
13Name Identifies the installation environment. The name cannot contain special characters such as "*", "?", ">", "<", ":", "|", "/", "\", or quotation marks("). The name is appended to the name of Windows services created by the installer and is a component of the path to the product in the Windows Start > All Programs menu.
— Use an existing TIBCO_HOME To install the product into an existing installation environment, select the environment from the drop-down list.
9. Click the Next button.
10. Verify the list of products selected for install in the Pre-Install Summary dialog.
11. Click the Install button to start the installation process.
12. Review the information listed in the Post-Install Summary dialog.
13. Click the Finish button to complete the installation process and exit the universal installer.
Console Mode
To install this product in console mode:
1. Open the physical media or download the package.
2. Extract the contents of the package to a temporary directory.
3. Using a console window, navigate to the temporary directory.
4. Run the following commands:
5. Complete the installation by responding to the console window prompts.
14
|
Chapter 2 InstallationSilent Mode
In silent mode, the universal installer does not prompt for any inputs during installation. Instead, the inputs are read from a response file that can be provided as a command-line parameter. If no value is specified, the installer uses the default TIBCOUniversalInstaller-bc.silent file.
The TIBCOUniversalInstaller.silent file is packaged in the directory that contains the universal installer. Edit the file with information for your
environment before launching the silent installation. The file includes comments that describe the installation properties you can set. While you can use the
TIBCOUniversalInstaller-bc.silent file, it’s good practice to copy the file to a different name and use that file for the silent install.
If errors occur during installation, they will be listed in the installation log file located in the User_Home/.TIBCO directory.
1. Open the physical media or download the package.
2. Extract the contents of the package to a temporary directory.
3. Using a console window, navigate to the temporary directory.
4. Make a copy of the TIBCOUniversalInstaller-bc.silent file and rename the file.
5. Using a text editor, open the copied file and update the install location and features to install.
6. Run the following:
Windows
TIBCOUniversalInstaller.cmd -silent -V responseFile="myfilename.silent"
UNIX
TIBCOUniversalInstaller.bin -silent -V responseFile="myfilename.silent"
Uninstallation
|
15Uninstallation
Uninstall Using the GUI
To uninstall this product on Windows:
1. Shut down all running TIBCO BusinessConnect applications.
2. Navigate to TIBCO_HOME\tools\universal_installer and run TIBCOUniversalInstaller.exe
or
select Start>All Programs>TIBCO>Uninstall.
3. Follow the steps as required by the Universal Installer Wizard.
4. Review the Post-Uninstall Summary and click the Finish button to exit the wizard.
Uninstall Using the Console Mode
To uninstall this product in Console mode:
:
1. Using a command window, navigate to the directory TIBCO_HOME\tools\universal_installer .
2. Type the following command at the command prompt:
Windows:
3. Complete the uninstallation by responding to the console window prompts.
16
|
Chapter 2 Installation|
17Chapter 3 Configuration
This chapter explains how to configure TIBCO BusinessConnect after the installation.
Topics
• Overview, page 18
• Manage Permissions for the Installation, page 19
• Create a New Installation, page 20
• Audit, Non-Repudiation and Runtime Database Configuration, page 28