TIBCO Business Studio Community Edition Installation

Software Version 3.5.3 April 2012

Important Information
SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE. USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE LICENSE FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME. This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc. TIBCO, The Power of Now, TIBCO Enterprise Message Service, TIBCO ActiveMatrix and TIBCO Silver are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM. THIS DOCUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME. THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright 2005-2012 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information

| iii

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi How to Contact TIBCO Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Chapter 1 Installing TIBCO Business Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Install TIBCO Business Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Perform Post Installation/Upgrade Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Chapter 2 Removing TIBCO Business Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Uninstalling TIBCO Business Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Appendix A Additional Eclipse Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Additional Eclipse Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

TIBCO Business Studio Installation

iv

| Contents

TIBCO Business Studio Installation

|v

Preface

This software may be available on multiple operating systems. However, not all operating system platforms for a specific software version are released at the same time. Please see the readme file for the availability of this software version on a specific operating system platform. TIBCO Business Studio - Community Edition Release Notes lists the features that are only available in the commercial editions of TIBCO Business Studio. However, these features have been documented in the online help and user guides. This guide explains how to install and remove TIBCO Business Studio.

Topics
Typographical Conventions, page vi How to Contact TIBCO Support, page ix

TIBCO Business Studio Installation

vi

| Typographical Conventions
Typographical Conventions
The following typographical conventions are used in this manual. Table 1 General Typographical Conventions Convention
TIBCO_HOME STUDIO_HOME

Use Many TIBCO products must be installed within the same home directory. This directory is referenced in documentation as TIBCO_HOME. The default value of TIBCO_HOME depends on the operating system. For example, on Windows 7 systems, the default value is C:\Program Files (x86)\tibco TIBCO Business Studio installs into a directory within <TIBCO_HOME>. This directory is referenced in documentation as STUDIO_HOME. The default value of STUDIO_HOME depends on the operating system. For example on Windows 7 systems, the default value is C:\Program Files
(x86)\TIBCO\studio-bpm-35.

code font

Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window. For example: Use MyCommand to start the foo process.

bold code font

Bold code font is used in the following ways: In procedures, to indicate what a user types. For example: Type admin. In large code samples, to indicate the parts of the sample that are of particular interest. In command syntax, to indicate the default parameter for a command. For example, if no parameter is specified, MyCommand is enabled:
MyCommand [enable | disable]

italic font

Italic font is used in the following ways: To indicate a document title. For example: See TIBCO ActiveMatrix BusinessWorks Concepts. To introduce new terms For example: A portal page may contain several portlets. Portlets are mini-applications that run in a portal. To indicate a variable in a command or code syntax that you must replace. For example: MyCommand pathname

TIBCO Business Studio Installation

Preface vii

Table 1 General Typographical Conventions (Contd) Convention Key combinations Use Key name separated by a plus sign indicate keys pressed simultaneously. For example: Ctrl+C. Key names separated by a comma and space indicate keys pressed one after the other. For example: Esc, Ctrl+Q. The note icon indicates information that is of special interest or importance, for example, an additional action required only in certain circumstances. The tip icon indicates an idea that could be useful, for example, a way to apply the information provided in the current section to achieve a specific result. The warning icon indicates the potential for a damaging situation, for example, data loss or corruption if certain steps are taken or not taken.

Table 2 Syntax Typographical Conventions Convention

[ ]

Use An optional item in a command or code syntax. For example:

MyCommand [optional_parameter] required_parameter

A logical OR that separates multiple items of which only one may be chosen. For example, you can select only one of the following parameters:
MyCommand para1 | param2 | param3

TIBCO Business Studio Installation

viii

| Typographical Conventions
Table 2 Syntax Typographical Conventions Convention
{ }

Use A logical group of items in a command. Other syntax notations may appear within each logical group. For example, the following command requires two parameters, which can be either the pair param1 and param2, or the pair param3 and param4.
MyCommand {param1 param2} | {param3 param4}

In the next example, the command requires two parameters. The first parameter can be either param1 or param2 and the second can be either param3 or param4:
MyCommand {param1 | param2} {param3 | param4}

In the next example, the command can accept either two or three parameters. The first parameter must be param1. You can optionally include param2 as the second parameter. And the last parameter is either param3 or param4.
MyCommand param1 [param2] {param3 | param4}

TIBCO Business Studio Installation

Preface ix

How to Contact TIBCO Support

If you have purchased another TIBCO product that includes support for TIBCO Business Studio and have comments or problems with this manual or the software it addresses, please contact TIBCO Support as follows. For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site: http://www.tibco.com/services/support/ If you already have a valid maintenance or support contract, visit this site: http://support.tibco.com Entry to this site requires a username and password. If you do not have a username, you can request one. The community edition of TIBCO Business Studio is unsupported. For self-service support, education, and access to the TIBCO Developer Network, visit http://www.tibco.com/devnet/index.html.

TIBCO Business Studio Installation

TIBCO Business Studio Installation

|1
Chapter 1

Installing TIBCO Business Studio

This chapter explains how to install and configure TIBCO Business Studio.

Topics
Installation Overview, page 2 Install TIBCO Business Studio, page 8 Perform Post Installation/Upgrade Tasks, page 12

TIBCO Business Studio Installation

| Chapter 1

Installing TIBCO Business Studio

Installation Overview
This manual explains how to install TIBCO Business Studio.

Installation Modes
Two installation modes are available: GUI and silent.

Installation Personas
There are different installation personas available that allow you to customize the installation of TIBCO Business Studio components. Selecting one of these personas installs a subset of TIBCO Business Studio features. The following table describes the personas available: Persona Business Analyst Description Documenting, modeling and simulating systems.

Using a persona results in an installation with the fewest possible steps, as it tailors the installation of features to particular roles. If you want to add or remove individual features, you should select Customize Installation. The following table describes the features that are selected for each persona. Feature Process Modeling Process Simulation Object Modeling Organization Modeling Studio for Analyst Business Analyst Yes Yes Yes Yes Yes

System Requirements
Make sure that your target computer meets the necessary system requirements to install TIBCO Business Studio.

TIBCO Business Studio Installation

Installation Overview 3

The following system requirements are also listed in the readme file, which is available on the product DVD in the \docs folder or from the TIBCO download site. Supported Platforms The 32 bit Windows version of TIBCO Business Studio is supported on both 32 and 64 bit Windows platforms; Linux has separate 32 and 64 bit distributions. Microsoft have discontinued standard support for Windows XP and Windows Server 2003. (Extended support is still available but must be purchased from Microsoft.) TIBCO will continue to support TIBCO Business Studio on Windows XP and Windows Server 2003. However, if a problem with TIBCO Business Studio is reported to TIBCO Support, and the problem is traced to the Windows XP or Windows Server 2003 operating system, TIBCO Support will be unable to assist further in the resolution of that problem. TIBCO therefore recommend that you use Windows 7 or Windows Server 2008 instead of Windows XP or Windows Server 2003 on any system that runs TIBCO Business Studio. Microsoft Windows: Windows Server 2008 R2 Windows Server 2008 SP2 Windows Server 2003 SP2 Windows 7 Windows Vista SP1 Windows XP Professional SP3

Windows 7 Professional is the minimum level we support.

Linux software distribution packages and supported versions: Linux x86 and x64 (32 bit and 64 bit) Red Hat Enterprise Linux Server v5.5 x64 (64 Bit) Red Hat Enterprise Linux Server v5.7 x64 (64 Bit) SUSE Linux Enterprise Server 11 x64 (64 Bit)

TIBCO Business Studio Installation

| Chapter 1

Installing TIBCO Business Studio

SUSE Linux Enterprise Server 11 x86 64bit SP1

The maximum number of open files/file descriptors that a user can open is controlled by the operating system. The threshold on Linux is typically too low for use with TIBCO Business Studio and has to be increased. The exact number depends on the features selected during installation and the size of the workspace but our experience is that 10000 is plenty. You can find out the number on your system using ulimit -n from a Terminal window. Minimum Disk Space and Memory Requirements Free disk space: 700MB. Memory: 512 MB RAM; more depending on project sizes

Eclipse Requirements If you are installing into your own Eclipse platform rather than the Eclipse platform provided by TIBCO Business Studio, TIBCO recommends you use Eclipse JEE Ganymede Version 3.4 SR 2. If you do not use this version of Eclipse, you must also install additional Eclipse plugins before installation of TIBCO Business Studio, as described in Additional Eclipse Plugins on page 21.

Software Requirements
The following section lists software requirements. TIBCO Software: TIBCO ActiveMatrix BPM is required if you wish to execute your BPM and SOA applications. Third-party Software: The following third-party software is required: JRE 1.6.0 (included in installation). We recommend that users stay up to date with Java patches issued by Oracle. Eclipse SWT (Standard Web Toolkit) GTK

TIBCO Business Studio Installation

Installation Overview 5

The TIBCO Business Studio installer for Linux 32 and 64 bit distributions downloads the Eclipse SWT GTK module which contains the following two items: The Free Software Foundation, Gnome Binding The Free Software Foundation, GTK+ Binding The zip files required are as follows: product_tibco_eclipse_lgpl_3.4.2.001_linux24gl23_x86.zip product_tibco_eclipse_lgpl_3.4.2.001_linux24gl23_x86_64.zip

Compatibility
TIBCO Business Studio version 3.5.3 (including Forms version 2.2.3) is compatible with: TIBCO ActiveMatrix BPM version 1.3 TIBCO ActiveMatrix Service Bus version 3.1.5 TIBCO ActiveMatrix Service Grid version 3.1.5

Installer Account
Microsoft Windows You must have administrator privileges for the machine on which TIBCO Business Studio is installed. If you do not have administrator privileges, the installer exits. You must then log out of the system and log in as a user with the required privileges, or request your system administrator to assign the privileges to your account. After installing TIBCO Business Studio with administrator privileges, do not use the same account to create a workspace for the user. Instead, individual users should start TIBCO Business Studio from the account with which they intend to use TIBCO Business Studio, and create their own workspace to avoid potential issues with permissions. If you intend to install the product on a network drive, you must ensure that the account used for installation has permission to access the network drive.

TIBCO Business Studio Installation

| Chapter 1

Installing TIBCO Business Studio

Linux TIBCO Business Studio can be installed either as a root or a local user. TIBCO recommends that you install as the user you plan to use for TIBCO Business Studio to avoid any potential permissions issues.

Installation Directory
TIBCO recommends that you install each version of TIBCO Business Studio into a new, empty installation environment (separate from earlier versions of TIBCO Business Studio or other TIBCO products). You should create a new workspace for each installation of TIBCO Business Studio. To do this, install TIBCO Business Studio as described in Install TIBCO Business Studio on page 8. Specify a new, empty directory or create a new, empty directory as the environment location. You may install TIBCO Business Studio into an existing installation environment if: you are reinstalling the same edition and version of TIBCO Business Studio in order to repair a corrupt installation. you are sure none of the existing products in that installation environment conflict with the edition and version of TIBCO Business Studio that you are installing.

Installer Log File

The installer log file is written to the following locations. Windows Server 2003, Windows XP Professional, Windows Vista, Windows 7 and Windows Server 2008 R2
User_Home\.TIBCO\install_identifier directory where identifier is in the form of the date and time TIBCO Business Studio was installed and a unique number used to identify this particular installation of TIBCO Business Studio.

For example, C:\Documents and Settings\user-name\.TIBCO\install_03-02-2010.132827

TIBCO Business Studio Installation

Installation Overview 7

Linux $HOME/.TIBCO/install_identifier directory where identifier is in the form of the date and time TIBCO Business Studio was installed and a unique number used to identify this particular installation of TIBCO Business Studio. For example, /home/user1/.TIBCO/install_03-02-2010.132827

Environment Information
The file _envInfo.xml is written to the following locations: Windows
C:\Program Files\Common Files\InstallShield\Universal\TIBCO\Gen1\_vpddb

TIBCO Business Studio Installation

| Chapter 1

Installing TIBCO Business Studio

Install TIBCO Business Studio

This section describes how to install TIBCO Business Studio. Install TIBCO Business Studio using one of the following modes: Install in GUI Mode on page 8 Install in Silent Mode (Windows Platforms) on page 10 Install in Silent Mode (Linux Platforms) on page 11

Install in GUI Mode

The following procedure explains how to install TIBCO Business Studio in GUI mode. Hibernate is also installed as part of the installation process. 1. Log in to the system on which you want to install TIBCO Business Studio (for more information, see Installer Account, page 5). If you want the installer to automatically install Hibernate 3.2.7, make sure you are online. See Software Requirements on page 4 for more information. 2. Open the physical media or download the TIBCO Business Studio package to the machine on which you want to install TIBCO Business Studio. 3. Extract the installation files to a temporary directory. 4. Double-click TIBCOUniversalInstaller. The Welcome dialog is displayed. On non-Windows systems the installation launcher must be run from the command line. 5. Review the information in the Welcome dialog and click Next. The TIBCO Business Studio 3.5.3 - BPM Edition License Agreement dialog is displayed. Review the terms of the license agreement and, if you agree to them, click I accept the terms of the license agreement. Then click Next to continue with the installation. The Installation Profile Selection dialog is displayed. If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process. 6. Choose a profile from the list in the left hand pane (see Installation Personas on page 2) or select Customize Installation. 7. The right hand pane displays the features that are selected for each profile. Click Next.
TIBCO Business Studio Installation

Install TIBCO Business Studio 9

8. The TIBCO Installation Home dialog appears. TIBCO_HOME is the preferred top level installation directory for all TIBCO products on your system. If you selected a persona, the Destination dialog appears. TIBCO_HOME is the preferred top level installation directory for all TIBCO products on your system. Select either: Create a new TIBCO_HOME. Click Browse to specify an environment location (a directory path to an empty folder into which the software will be installed), or accept the default environment location (which is the last directory in the path selected). Use an existing TIBCO_HOME. Select an existing TIBCO_HOME from the drop-down list. The installer automatically creates an environment name for the location you specify. The default environment name is studio-bpm-3.5. If this is not the first installation of TIBCO software, you can edit the environment name to differentiate this subsequent installation of TIBCO software from the first. Click Next. The Hibernate License Agreement dialog is displayed. 9. Review the terms of the license agreement and, if you agree to them, click I accept the terms of the license agreement. Then click Next to continue with the installation. The Hibernate assembly is then downloaded from TIBCO. If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process. 10. After the installer configures your installation choices, the Pre-Install Summary dialog is displayed. Review the information displayed in the dialog and make sure that it is correct. If you want to change any of your choices, click Back to step back through the dialogs to the appropriate point and make your choices again. 11. When you are satisfied with your choices, click Install. The installer now performs the necessary installation tasks. 12. Once the installer has finished the installation tasks, the Running Product ANT Tasks dialog is displayed. The installer now performs the necessary tasks to initialize the installation. Click Show Details to see the tasks that the installer is performing. 13. The Post-Install Summary dialog is displayed. Click Finish to exit from the installer. There is a slight delay while the installer deletes temporary files. You may see a pop-up stating "This program might not have installed corrrectly". This is due to an incompatibility between InstallShield and Windows 7, but should not affect your TIBCO Business Studio installation.

TIBCO Business Studio Installation

10

| Chapter 1

Installing TIBCO Business Studio

14. Complete the post-installation tasks described in Perform Post Installation/Upgrade Tasks on page 12.

Install in Silent Mode (Windows Platforms)

The following procedure explains how to install TIBCO Business Studio in silent mode on Windows platforms. The TIBCOUniversalInstaller.silent file is packaged in the directory that contains the universal installer. You must 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.silent file, its 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 (see the User_Home/.TIBCO directory). 1. Open the distribution DVD or download the TIBCO Business Studio product package. 2. Extract the TIBCO Business Studio product archive file to a temporary directory. 3. Using a console window, navigate to the temporary directory that contains the universal installer. 4. Copy the TIBCOUniversalInstaller.silent file and name the file. 5. Using a text editor, open the copied file and update the install location, and the list of features to install. 6. Run the installer:
TIBCOUniversalInstaller -silent -V responseFile="myfilename.silent"

If you are using the TIBCOUniversalInstaller.silent file, you need not supply the file name and can run: TIBCOUniversalInstaller -silent. A line similar to the following is written to the installer log file when installation completes:
Install, com.tibco.installer.util.TIBCOInstaller, dbg.Debug, The installation has completed. Please check the log file for additional information.

7. Complete the post-installation tasks described in Perform Post Installation/Upgrade Tasks on page 12.

TIBCO Business Studio Installation

Install TIBCO Business Studio 11

Install in Silent Mode (Linux Platforms)

The following procedure explains how to install TIBCO Business Studio in silent mode on Linux platforms. The TIBCOUniversalInstaller.silent file is packaged in the directory that contains the universal installer. You must 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.silent file, its 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 (see the User_Home/.TIBCO directory). 1. Open the distribution DVD or download the TIBCO Business Studio product package. 2. Extract the TIBCO Business Studio product archive file to a temporary directory. 3. Using a console window, navigate to the temporary directory that contains the universal installer. 4. Copy the TIBCOUniversalInstaller.silent file and name the file. 5. Using a text editor, open the copied file and update the install location, and the list of features to install. 6. Run the installer:
./TIBCOUniversalInstaller-lnx-x86.bin -silent -V responseFile="myfilename.silent"

7. If you are using the TIBCOUniversalInstaller.silent file, you need not supply the file name and can run: ./TIBCOUniversalInstaller-lnx-x86.bin -silent. A line similar to the following is written to the installer log file when installation completes:
Install, com.tibco.installer.util.TIBCOInstaller, dbg.Debug, The installation has completed. Please check the log file for additional information.

8. Complete the post-installation tasks described in Perform Post Installation/Upgrade Tasks on page 12.

TIBCO Business Studio Installation

12

| Chapter 1

Installing TIBCO Business Studio

Perform Post Installation/Upgrade Tasks

After the installation completes, perform the tasks described in this section as applicable.

Delete the Temporary Installation Files

If you want to recover the disk space used by the installation files that you extracted to a temporary directory in step 3 of the installation, delete them.

Configure Subversion (SVN)

If you plan on using SVN, after you start TIBCO Business Studio, you must change the SVN settings for your workspace as follows: You must also perform this procedure when you switch to a new workspace. This setting is saved for the workspace, so you need only do this once on each workspace. 1. Select Window > Preferences. 2. Expand Team and select SVN. 3. Change the SVN interface: setting to SVNKit(Pure Java) and click Apply and OK to exit the dialog.

Windows 7
If you are not in the local Administrators group, you must change the privilege level for TIBCO Business Studio to Run this program as Administrator in order for TIBCO Business Studio to run properly in Windows 7. To do this: 1. Browse to the location of your TIBCO Business Studio.exe, for example TIBCO_HOME\studio\3.5\eclipse. 2. Right-click TIBCO Business Studio.exe and select Properties. The Properties dialog is displayed. 3. Select Compatibility. In Privilege Level, select Run this program as Administrator.

TIBCO Business Studio Installation

Perform Post Installation/Upgrade Tasks 13

Migrate Existing Processes

If you have upgraded from a previous version of TIBCO Business Studio, migrate your existing Processes to the current version (for more information, see TIBCO Business Studio Release Notes).

Migrate Existing Forms

If you have created forms using a previous version of TIBCO Business Studio Forms, migrate your Forms to the current version (for more information, see TIBCO Business Studio Forms Users Guide).

Delete Old Forms WebDAV Servers

Version 1.x deployment servers of the type Forms WebDAV Deployment can be deleted. This type of server has been superseded by the type iProcess Workspace (Browser) Server.

Create Link Files (Optional)

The TIBCO Business Studio installation creates files called "link files" in the following directory:
STUDIO_HOME\eclipse-platform\ganymede\eclipse\links

A link file provides the path for any additional plugins that you want to include in your Eclipse or TIBCO Business Studio environment. If you have other plugins that you want to link to your TIBCO Business Studio environment, create a link file in the previously mentioned directory. The file extension must be .link, and the file must contain the path to the parent directory of the eclipse directory, which in turn must contain plugins and features directories. For example, a link file could contain the following path (note that the directory delimiters must be forward slashes):
path=C:/ganymede

TIBCO Business Studio Installation

14

| Chapter 1

Installing TIBCO Business Studio

In this case there must be an eclipse directory below ganymede, and the eclipse directory must contain plugins and features directories:

For more information about link files, see: http://help.eclipse.org/ganymede/index.jsp?topic=/org.eclipse.platform.doc.is v/guide/product_extension.htm

Configure Eclipse Memory Settings

If you installed TIBCO Business Studio into your own Eclipse platform, you must modify the Eclipse initialization file (eclipse.ini) located in the Eclipse installation directory. Change the memory settings to those listed in the following table. Default Eclipse Value -Xms40m -Xmx256m --launcher.XXMaxPermSize 256m ...change to -Xms512m -Xmx640m No change

In addition, TIBCO recommends copying the other initialization settings from the file TIBCOBusinessStudio.ini and adding them to your eclipse.ini file.

Validate the Eclipse Installation

After you install TIBCO Business Studio, especially if you installed the product into your own Eclipse platform, you should validate the installation. 1. Start TIBCO Business Studio or Eclipse (depending on where you installed TIBCO Business Studio). 2. Select Help > Validate TIBCO Business Studio Configuration. The resulting dialog reports any problems with the TIBCO or Eclipse plugins.

TIBCO Business Studio Installation

Perform Post Installation/Upgrade Tasks 15

3. Take action according to the messages displayed in the dialog (for example, upgrade or download plugins that are not present or not of the required version).

Accessing the Internet when using a Proxy Server

If you are using a proxy server, when TIBCO Business Studio is set up you need to configure it to use your proxy. 4. By default Direct Connection to the Internet is selected. If you are using a proxy server, you should instead choose one of the following: Choose "System proxy configuration (if available)" to get the correct settings set automatically. If you are familiar with the proxy server, you can use "Manual proxy configuration", and use information provided to you by your administrator to create the settings yourself. For more information, search for Network Connections in the TIBCO Business Studio help. You can edit the TIBCOBusinessStudio.ini file to add lines for http.proxyHost and http.proxyPort. However, these settings only configure the Java runtime and not the Eclipse runtime that sits on top, so you need to use the method described above instead.

TIBCO Business Studio Installation

16

| Chapter 1

Installing TIBCO Business Studio

TIBCO Business Studio Installation

| 17
Chapter 2

Removing TIBCO Business Studio

This chapter explains how to remove TIBCO Business Studio from your computer.

Topics
Uninstalling TIBCO Business Studio, page 18

TIBCO Business Studio Installation

18

| Uninstalling TIBCO Business Studio

Uninstalling TIBCO Business Studio
If you want to uninstall TIBCO Business Studio from your system, perform the following steps: When you uninstall, some files are currently left behind that are not user data. You can remove these files manually if required. Linux 1. Open a terminal. 2. Navigate to STUDIO_HOME/_uninstall. 3. Run the uninstaller named universal_uninstall.bin. Windows Either: use the uninstaller provided with TIBCO Business Studio or remove the installation using the Add/Remove Programs option on your PC (Programs and Features on Windows Vista, Windows 7 and Windows Server 2008).

When you installed TIBCO Business Studio, if the installer detected a suitable Java Virtual Machine (JVM), that JVM is used by TIBCO Business Studio. The uninstallation will fail if you remove the JVM used by TIBCO Business Studio before removing TIBCO Business Studio. If this happens, you can use the command line to uninstall with the -is:javahome option. To do this, navigate to the installation_environment\_uninstall folder and enter the following command:
universal_uninstall.exe -is:javahome

Using the Uninstaller

To use the uninstaller: 1. Log in to the system on which you want to uninstall software. 2. The Welcome dialog is displayed. Click Next. 3. Select either Custom (to choose products in this environment to uninstall) or Typical to uninstall all products in the environment.

TIBCO Business Studio Installation

| 19
If you selected Typical, continue with step 5. If you selected Custom, continue with the next step. 4. The Product Uninstall Selection dialog is displayed. Select the products (for example, TIBCO Business Studio 3.5) you want to uninstall and click Next. 5. The Ready to Uninstall dialog is displayed. If you want to change any of your choices, click Back to step back through the dialogs to the appropriate point. You can then restart the uninstallation process from that point. 6. When you are satisfied with your choices, click Uninstall. The uninstaller removes the software product you specified. The TIBCO Business Studio entries in the Start menus may appear after the uninstallation. To correct this log out, then log in again.

Using Add/Remove Programs (Windows Only)

To remove the installation using the Add/Remove Programs option on your PC: 1. Log in to Windows as a user with system administrator privileges. You must have system administrator privileges to uninstall this software. 2. In the Control Panel, double-click Add or Remove Programs. 3. In the Add/Remove Programs dialog, select TIBCO Universal Installer (installation_environment_n), where installation_environment_n is the directory corresponding to the installation environment you want to uninstall. If you have installed more than one TIBCO product, there will be multiple entries in Add/Remove programs (for example, TIBCO Universal Installer (c:\tibco\env_1), TIBCO Universal Installer (c:\tibco\env_2), and so on). 4. Click Change/Remove. The uninstaller launches. Follow the uninstallation steps in Using the Uninstaller on page 18. The uninstaller may not completely remove files that have been modified since the initial installation (for example, the configuration directory). If you do not need any of the other remaining files, manually delete them.

TIBCO Business Studio Installation

20

| Uninstalling TIBCO Business Studio

TIBCO Business Studio Installation

| 21
Appendix A

Additional Eclipse Plugins

This appendix lists the extra Eclipse plugins you require if you are using an Eclipse platform other than Eclipse JEE Ganymede Version 3.4, SR2 and you want to install into your own Eclipse platform rather than the Eclipse platform provided by TIBCO Business Studio.

Topics
Additional Eclipse Plugins, page 22

TIBCO Business Studio Installation

22

| Appendix A

Additional Eclipse Plugins

Additional Eclipse Plugins

If you are using an Eclipse platform other than Eclipse JEE Ganymede Version 3.4, SR2 and you want to install into your own Eclipse platform rather than the Eclipse platform provided by TIBCO Business Studio, you must update your Eclipse installation with additional required plugins as described in this section. 1. Download the following archive files and extract them to the top-level directory of your Eclipse installation: Newer versions of these plugins may be available and can be installed instead of the versions in the following list.

TIBCO Business Studio Installation

Additional Eclipse Plugins 23

EMF Transaction Runtime (includes EMF Workspace) http://www.eclipse.org/downloads/download.php?file=/modeling/em f/transaction/downloads/drops/1.2.0/R200806091902/emf-transaction-r untime-1.2.0.zip EMF Query Runtime http://www.eclipse.org/downloads/download.php?file=/modeling/em f/query/downloads/drops/1.2.0/R200806091744/emf-query-runtime-1. 2.0.zip BIRT Report Framework http://www.eclipse.org/downloads/download.php?file=/birt/downloa ds/drops/R-R1-2_3_0-200806191030/birt-report-framework-2_3_0.zip Eclipse Data Tools Platform http://www.eclipse.org/downloads/download.php?file=/datatools/do wnloads/1.6/dtp_1.6.2.zip EMF Runtime http://www.eclipse.org/downloads/download.php?file=/modeling/em f/emf/downloads/drops/2.4.2/R200902171115/emf-runtime-2.4.2.zip EMF Validation Runtime http://www.eclipse.org/downloads/download.php?file=/modeling/em f/validation/downloads/drops/1.2.0/R200806091804/emf-validation-ru ntime-1.2.0.zip GEF http://www.eclipse.org/downloads/download.php?file=/tools/gef/do wnloads/drops/3.4.2/R200902171642/GEF-runtime-3.4.2.zip GMF http://www.eclipse.org/downloads/download.php?file=/modeling/gm f/gmf/downloads/drops/2.1.3/R200902181028/gmf-runtime-2.1.3.zip MDT XSD http://www.eclipse.org/downloads/download.php?file=/modeling/m dt/xsd/downloads/drops/2.4.2/R200902171115/xsd-runtime-2.4.2.zip MDT OCL http://www.eclipse.org/downloads/download.php?file=/modeling/m dt/ocl/downloads/drops/1.2.0/R200806091714/mdt-ocl-runtime-1.2.0.zi p

TIBCO Business Studio Installation

24

| Appendix A

Additional Eclipse Plugins

MDT UML2 http://www.eclipse.org/downloads/download.php?file=/modeling/m dt/uml2/downloads/drops/2.2.0/R200806091546/mdt-uml2-runtime-2. 2.0.zip Web Tools Platform http://www.eclipse.org/downloads/download.php?file=/webtools/do wnloads/drops/R3.0/R-3.0.5-20090521045405/wtp-R-3.0.5-200905210454 05.zip 2. Restart Eclipse and continue with the installation as described in Install TIBCO Business Studio on page 9.

TIBCO Business Studio Installation