TIBCO BW Installation Notes

These are some notes I have written in order to help myself to get ready to clear the TIBCO ActiveMatrix BusinessWorks 5 Certification Exam (TB0-123). More details about the exam, click here. This entry is about TIBCO ActiveMatrix BusinessWorks installation. Any comment or suggestion, please write to luisagcenteno@gmail.com. Further details can be found at TIBCO Documentation. I hope these notes can help you as well as they did to me...

TIBCO BW Installation Notes
- Installation modes
    GUI mode
    Console mode
    Silent mode
- Uninstallation methods
    Windows
    - Click on Start>Programs>TIBCO>TIBCO BusinessWorks 5.4>Uninstall
    - Use Add-Remove Programs from Control Panel
    - Navigate to _uninst folder and invoke the TIBuninstall.exe.
    UNIX
- Navigate to the _uninst directory located in the TIBCO ActiveMatrix BusinessWorks home directory and invoke the Tibuninstall script.
- TIBCO ActiveMatrix BusinessWorks manages vpd files (user’s home directory must have at least 500 KB of free disk space)
    Windows
        %SystemRoot%/vpd.properties
        %SystemRoot%/vpd.properties.tibco.systemName
    UNIX
        If installation is performed by a user other than root
        User_Home_Directory/vpd.properties
            User_Home_Directory/vpd.properties.tibco.systemName
        If installation is performed by root user
            - Solaris and HP-UX
            /
            - Linux
            /root
            - AIX
            /usr/lib/objrepos
- Installer free-space requirements in temp area
    Windows
        60 MB in temp directory
    UNIX
        Solaris. 75 MB in /var/tmp
        HP-UX. 85 MB in /var/tmp
        AIX. 75 MB in /tmp
        Linux. 75 MB in /tmp
- Run installer using another directory as temp area
    <>.bin -is:<> /new_temp
- Installer creates TIBCOInstallationHistory.xml with all installation. Each time installation or uninstallation are performed, a new entry is appended to the installation history file.
Windows
    %SystemRoot%/TIBCOInstallationHistory.xml
UNIX
    User_Home_Directory/TIBCOInstallationHistory.xml

- Required TIBCO Products
- TIBCO Runtime Agent 5.6.0. Supplies a number of third party libraries used by TIBCO BusinessWorks at design-time and runtime. It must be installed on each machin that hosts a TIBCO ActiveMatrix BusinessWorks process engine. TRA must be installed before BW.
- TIBCO Designer 5.6. Easy-to-use GUI used to configure TIBCO ActiveMatrix BusinessWorks. TIBCO Designer is installed as part of TRA.
- TIBCO Administrator 5.4.0. Available in two editions: Repository Edistion and Enterprise Edition. Enterprise Edition is required for TIBCO ActiveMatrix BusinessWorks. Administrator modules:
- User Management. Management of authentication, roles and users, that is, connection roles (groups) and users to Access Control Lists (ACLs). This includes security for deployed applications at runtime
- Resource Management. Monitoring of machines and of all running applications in a TIBCO administration domain. Alerts can be created.
- Application Management. Uploading of EAR files, creation, configuration, deployment and monitoring of applications. This console is also used to start and stop applications.
TIBCO Administrator is available as a separate installation and can be installed after installing TIBCO ActiveMatrix BusinessWorks
- Optional TIBCO Products
- TIBCO Enterprise Message Service. Allows message sending from application in a format according to JMS specification. Provides a reliable delivery mode and no-acknowledgement aknowledgement mode. It is a separate installation and can be installed after TIBCO ActiveMatrix BusinessWorks is installed.

- Installation requirements
Windows 2000. Service Pack 2. 80 MB of free disk space
Windows XP.     Professional Edition. 80 MB of free disk space.
Windows Server 2003. Enterprise Edition for server-class hardware, Standard Edition for desktops. 80 MB of free disk space.
Solaris 10. 80 MB free disk space.
Solaris 9. 80 MB free disk space.
Solaris 8. 80 MB free disk space.
HP-UX 11i. HP-UX 11i v2/11.23 on IA-64/Itanium | HP-UX 11i/11.11 on PA-RISC. 80 MB free disk space.
AIX 5.2, 5.3. 80 MB free disk space.
Linux. Requires kernel 2.4.6 or later gclib 2.2.2 or later


Installation
- GUI mode
    Windows
        TIB_bw-simple_5.7.0_win_x86.exe
    UNIX (A windows environment such as CDE is required to run GUI mode)
        ./TIB_bw-simple_5.7.0_<>.bin
        
- Console mode
    Windows
        TIB_bw-simple_5.7.0_win_x86.exe -is:javaconsole -console
    UNIX
        TIB_bw-simple_5.7.0_<>.bin -is:javaconsole -console
- Silent mode
    Windows
        TIB_bw-suite_5.7.0_win_x86.exe -silent
    UNIX
        TIB_bw-simple_5.7.0_<>.bin -silent
- Generate response file (does not record selections at component level)
    Windows
        TIB_bw-simple_5.7.0_win_x86.exe -options-record <>
    UNIX
        TIB_bw-simple_5.7.0_<>.bin -options-record <>
- Using response file
    Windows
        TIB_bw-simple_5.7.0_win_86.exe -options <>
    UNIX
        TIB_bw-simple_5.7.0_<>.bin -options <>
Combining
    SIlent mode with response file
        TIB_bw-suite_5.7.0_win_x86.exe -silent -options <>
    Console mode and generate response file
TIB_bw-suite_5.7.0_win_x86.exe -is:javaconsole -console -options-record <>
        
    
- In UNIX,
- Installation directory for root users is /opt/tibco
- Installation directory for non-root users is /<>/tibco
- If installing on AIX, use a non-root account to install TIBCO ActiveMatrix BusinessWorks
- All TIBCO ActiveMatrix BusinessWorks users must have read, write and execute permissions to the following directories (chmod 777 to all directories)
    TIBCO_HOME/bw/5.7/bin
    TIBCO_HOME/bw/5.7/bin/logs
    TIBCO_HOME/bw/5.6/logs
- Also, TIBCO_HOME/bw/5.7/lib/palettes must be writable by all users who will use TIBCO Designer. This must be done for users to use Java activity’s Compile button. Alternatively, change the Java activity’s compilation directory by changing the value of java.property.javaCodeint the .tra file that is used to start TIBCO ActiveMatrix BusinessWorks (designer.tra for Designer GUI or the apropriate .tra file for the engine if running fro a deployment)

- To Configure TIBCO ACtiveMatrix BusinessWorks to run in 64-bit mode
    1. Change directory to BW_HOME/bin
        a. Copy bwengine to bwengine-bak
        b. Copy bwengine64 to bwengine
    2. Copy bwengine.tra to bwengine-bak.tra
a. Open bwengine.tra in a text editor
b. In the tibco.env.STD_EXT_CP property, find %RV_HOME%/lib/ and change it to
    %RV_HOME%/lib/tibrvj.jar%PSP%%RV_HOME%/lib/tibrvjsd.jar
c. Increase heap size by changing the tibco.env.HEAP_SIZE property and the memory usage of the Java VM using Java extended properties.
    tibco.env.HEAP_SIZE=19050M
    java.extended.properties= -XX:MinHeapFreeRatio=52 -XX:MaxHeapFreeRatio=90 -XX:GCTimeRatio=19
d. If using Solaris, HP-UX, IA-64/Itanium or Linux platforms change
    Solaris 10,9,8 on SPARC. From sparc to sparcv9
    Solaris 10 on x86. From i386 to amd64
    HP-UX 11i v2/11.23 and 11i v3/11.31 on IA-64/Itanium. From IA64N to IA64W
    Red Hat Linux on x86 or SUSE Linux on x86. From i386 amd64

- Install and uninstall log files are located in TIBCO_HOME/log
- In order to run installer with another JVM
    TIB_bw-simple_5.7.0_win_x86.exe -is:javahome c:\j2sdk1.5.0
    <>.bin -is:javahome /opt/jre150
    The java home must contain bin/java.exe or bin/java
- Display environment variable must be set on UNIX platforms for GUI mode
- uninst2 directory is created at uninstall time due to uninstall directory is in se and cannot be removed. To emove it, run uninstall program from second uninstall directory. It can be manually removed if empty.