Copyright © Cloud Software Group, Inc. All Rights Reserved

Installing BusinessWorks FormBuilder

This section describes the installation modes, how to start the installer program, and how to specify required information during installation.

Installation Modes

The installation modes are such as the following:

•	GUI mode    When you invoke the installer, GUI mode is used by default. Use this mode if you have a GUI (both on Windows or UNIX).

•	Console mode   Console mode allows you to run the installer from a console. Use this mode if you don’t have a GUI (on UNIX).

•	Silent mode   Silent mode installs without prompting the user for information, or with a limited user input.

This mode is used such as the following:

−	To install all defaults, with no user interaction.

−	To install the application based on a previously recorded file responseFile, with no user interaction.

−	To install the application based on the file templateFile, with limited user input. In this case, some information (such as domain structure) is available from the file, and the remaining information is supplied by the user.

The TIBCO BusinessWorks FormBuilder installer contains online help, where you can get all information about the installation modes.

Before Installing on UNIX Platforms

The following procedure is required before installing TIBCO BusinessWorks FormBuilder on UNIX platforms. If an NIS master server is used, perform the steps described in this section on this machine. Otherwise, perform the steps on every machine where TIBCO product components are installed.

1.	Log in as root.

2.	If no group for users of TIBCO products already exists, create a new group. This must be the primary group for all TIBCO users.

3.	Create a user account for running the installer program, and add the user to the TIBCO users group.

4.	Define the full path of the home directory for this user, and specify a non-default password. If an NIS master server is used, rebuild the NIS password map.

TIBCO BusinessWorks FormBuilder, as well as all required TIBCO software components, must be installed by the same user.

5.	Set the umask value for the user to 002 by adding a line to the .login or .profile file. For example: $ umask 002. This gives all users in the TIBCO users group write permission on resources created by the user.

Starting the Installer Program

The procedure for starting the installer program varies based on your operating system. Once the installer program is running, however, screens and fields are virtually identical on all platforms.

To see the exact executable names, refer to the file readme.txt.

UNIX

To start the installer program:

1.	Log in to the system as the user created for running the installer program.

This user must be a member of the TIBCO users group. For details, see the section Before Installing on UNIX Platforms.

2.	Locate the tar file named TIB_bwfb-suite_n.n.n_unix-platform.tar

3.	Expand this tar file and locate the executable name (such as TIB_bwfb-suite_5.3.0_linux24gl23_x86.bin)

4.	Run this executable.

Windows

To start the installer program:

1.	Log into the machine as a user with administrative privileges.

2.	Navigate to the installer directory on the installation media.

3.	Locate the file TIB_bwfb-suite_n.n.n_windows-platform.exe.

4.	Double-click this file.

To Specify Required Information

This section describes how to specify required information on all platforms.

1.	In the Welcome screen, read the introductory information and click Next.

2.	Review the license text, select I accept the terms of the License Agreement, and click Next.

3.	You will see the Important Notice dialog.

Review any notices and click Next.

4.	In the next screen, you need to choose one of the two setup types:

−	Typical setup, where the product is installed using the default configuration

−	Custom setup, where the installer prompts you for product components and other information

Click Next to continue.

The BusinessWorks FormBuilder installer will install two components:

−	TIBCO Presentation Services n.n.n

−	TIBCO BusinessWorks FormBuilder n.n.n

If the Presentation Services n.n.n is already installed on the system, the installer will only list the Form Builder component.

5.	A screen appears with the following data (that depends on the selected setup):

−	Location where BusinessWorks FormBuilder will be installed. The default is C:\tibco\bwfb_install_dir\version on Windows and /local/tibco/bwfb_install_dir/version on UNIX.

−	Components that are installed

−	Total disk space size for the installation

Click Next to start installation.

6.	After the installation is finished, a screen appears to confirm that BusinessWorks FormBuilder was successfully installed in a named directory.

7.	Click Finish to exit the installation wizard.

BusinessWorks FormBuilder Components

The following table describes the components.

 

Table 2 TIBCO BusinessWorks FormBuilder Components

Component Name	Description
TIBCO BusinessWorks FormBuilder Application	This option includes TIBCO Designer palettes for building formflows, forms, automated processes that communicate with a formflow application, and FormBuilder Desktop (the component that communicates with a web browser and runs formflow processes).
Documentation	HTML and PDF files for online documentation and online help

File designer.tra

BusinessWorks FormBuilder installation

•	updates Classpath with the BusinessWorks FormBuilder .jar files

•	updates Palette classpath with BusinessWorks FormBuilder palettes .jar files

It adds the following properties to the file designer.tra:

java.property.BW_HOME=C:/tibco/bw/5.3

java.property.FORMBUILDER_HOME=C:/tibco/bwfb/5.3

java.property.TIBCO_DOMAIN_NAME=TestDomain

java.property.TIBCO_DOMAIN_HOME=C:/tibco/bwfb/5.3/debugger/domain

java.property.DEBUGGER_WEBAPP_PATH=C:/tibco/bwfb/5.3/bui/archive

java.property.FORMFLOW_PROPERTIES=C:/tibco/bwfb/5.3/bin/Properties.cfg

java.property.FORMBUILDER_TOMCAT_HOME=C:/tibco/bwfb/5.3/tomcat

java.property.FORMBUILDER_DEBUG_MODE=true

java.property.TIBCO_RV_HOME=C:/tibco/tibrv

java.property.TIBCO_HAWK_HOME=C:/tibco/hawk

java.property.TOMCAT_PLUGIN_CLASS=com.tibco.tomcatPlugins.tomcat4.ServerPlugin

The BusinessWorks FormBuilder tester uses the attributes TIBCO_DOMAIN_HOME and TIBCO_DOMAIN_NAME.

First time the BusinessWorks FormBuilder tester is started, it copies domain and contents from TIBCO_DOMAIN_HOME (default is bwfb/version/debugger/domain/TestDomain) to the user's home directory, for example:
C:\Documents and settings\user_name\.TIBCO\.formflow\domain\TestDomain

The designer.tra parameters for BusinessWorks FormBuilder are design time only properties and they are not carried over to deployed applications. If the attribute TIBCO_DOMAIN_NAME is later changed in the file designer.tra, this changes has no effect.

Copyright © Cloud Software Group, Inc. All Rights Reserved