TIBCO Business Studio™ Installation · PDF fileTIBCO Business Studio Installation...

Two-Second Adv

TIBCO Business Studio™

InstallationSoftware Version 3.5.20February 2013

antage®

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 © 2004-2013 TIBCO Software Inc. ALL RIGHTS RESERVED.TIBCO Software Inc. Confidential Information

| iii

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

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

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Install TIBCO Business Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Perform Post Installation/Upgrade Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Chapter 2 Removing TIBCO Business Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Uninstalling TIBCO Business Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Appendix A TIBCO Business Studio Asset Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Installing Asset Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Configuring Asset Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Testing the HTTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Stopping the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Removing Asset Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

TIBCO Business Studio Installation

iv | Contents


| v

Preface

This guide explains how to install and remove TIBCO Business Studio™.

Topics

• Typographical Conventions, page vi

• Connecting with TIBCO Resources, page ix

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.


vi | Typographical Conventions

Typographical Conventions

The following typographical conventions are used in this manual.

Table 1 General Typographical Conventions

Convention Use

TIBCO_HOME

STUDIO_HOME

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


Preface | vii

Key combinations

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

Table 1 General Typographical Conventions (Cont’d)

Convention Use


viii | Typographical Conventions

{ } 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}

Table 2 Syntax Typographical Conventions

Convention Use


Preface | ix

Connecting with TIBCO Resources

How to Join TIBCOmmunity

TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to http://www.tibcommunity.com.

How to Access TIBCO Documentation

You can access TIBCO documentation here:

http://docs.tibco.com

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, 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:

https://support.tibco.com

Entry to this site requires a user name and password. If you do not have a user name, you can request one.


http://www.tibcommunity.com

http://docs.tibco.com

http://www.tibco.com/services/support

https://support.tibco.com

x |


| 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 9


2 | 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:

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.

Persona Description

Business Analyst Documenting, modeling and simulating systems.

SOA Developer Composing solutions from pre-built components, orchestrating the SOA Developer's services and making the Analyst's work into an executable implementation.

Solution Designer Creating individual services and applications in a variety of programming languages.

Feature Business Analyst SOA Developer Solution

Designer

Process Modeling Yes No Yes

Process Simulation Yes No No

Process Implementation for BPM No No Yes

Forms Design Yes No Yes


Installation Overview | 3

System Requirements

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

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.

Object Modeling Yes Yes Yes

Organization Modeling Yes No Yes

SOA Debugging Tools No Yes Yes

Mediation Development Tools No Yes Yes

SOA Developer Tools No Yes Yes

Workspace Client Components No Yes Yes

Asset Central No No No

Feature Business Analyst SOA Developer Solution

Designer



Supported Platforms

Microsoft Windows 7:

• 32-bit on x86

• 64-bit on x86-64

Microsoft Windows Server:

• Windows Server 2008 32-bit on x86

• Windows Server 2008 64-bit on x86-64

• Windows Server 2008 R2 64-bit on x86-64

Linux software distribution packages and supported versions:

Novell SUSE Linux Enterprise Server

• 10.x, 11.0,11.x 32-bit on x86

• 10.x, 11.0,11.2,11.x 64-bit on x86-64

Red Hat Enterprise Linux Server

• 5.7, 6.2 32-bit on x86

The 32 bit Windows version of TIBCO Business Studio is supported on both 32 and 64 bit Windows platforms; Linux has x86 and x64 (32 bit 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.

Windows 7 Professional is the minimum level supported by TIBCO.



• 5.7, 6.2 64-bit on x86-64

Minimum Disk Space and Memory Requirements

• Free disk space: from 925Mb to 1.8 GB depending on options selected for installation.

• Memory: minimum 1 GB RAM; the recommended level is 2 GB, or more depending on project sizes.

Software Requirements

The following section lists software requirements.

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.

• Hibernate Version 3.2.7 is required (assembly_tibco_com_tibco_tpcl_org_hibernate_feature_3.2.400.001.zip).

These are the versions that have been tested on. TIBCO would expect subsequent Red Hat 5.x. Red Hat 6.x and SUSE 11 Service Packs to be compatible.

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.

You must use a Hibernate Assembly that you have downloaded from TIBCO or the installation will fail.



During the installation process for TIBCO Business Studio, you can do one of the following:

— Allow the TIBCO Business Studio installer to automatically download and install Hibernate.

— Install TIBCO Business Studio using a Hibernate assembly that you have previously downloaded from TIBCO. During installation, you will be asked to specify the directory where you downloaded Hibernate.

• Eclipse SWT (Standard Web Toolkit) GTK

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

During the installation process for TIBCO Business Studio the steps are very similar to using Hibernate. An installation dialog comes up for accepting the license and then gives an option to download the assembly from the TIBCO public website or select it from the disk.

TIBCO Business Studio Asset Central Requirements

There are no additional requirements beyond those for TIBCO Business Studio. However, you cannot configure Asset Central unless the PATH environment variable points to Version 1.5 or later of the Java Runtime Environment (JRE). If you plan to configure Asset Central during the installation, you must first configure Java.

If you want the installer to automatically install Hibernate 3.2.7, make sure you are online.

If you have previously installed Asset Central and are planning to install it again, either ensure the Asset Central services are not running, or remove any services created by the previous version.



Compatibility

TIBCO Business Studio version 3.5.20 (including Forms version 2.4.0) is compatible with:

• TIBCO ActiveMatrix BPM version 2.1.0

• TIBCO ActiveMatrix Service Bus version 3.1.5

• TIBCO ActiveMatrix Service Grid version 3.1.5

Installer Account

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.

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.

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).

To do this, install TIBCO Business Studio as described in Install TIBCO Business Studio on page 9. 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.

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.

You should create a new workspace for each installation of TIBCO Business Studio.



• 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 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

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


Install TIBCO Business Studio | 9

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 Windows on page 9

• Install in GUI Mode on Linux on page 15

• Install in Silent Mode (All Platforms) on page 16

Install in GUI Mode on Windows

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 7).

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.

5. Review the information in the Welcome dialog and click Next. The TIBCO Business Studio - BPM Edition 3.5.20 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. See Complete a Custom

If you want the installer to automatically install Hibernate 3.2.7, make sure you are online. See Software Requirements on page 5 for more information.

On non-Windows systems the installation launcher must be run from the command line.



Installation on page 11 for information on additional steps in the custom installation.

7. The right hand pane displays the features that are selected for each profile. Click Next.

8. The TIBCO Installation Home 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.


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.

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

Complete a Custom Installation

This section describes how to complete a custom installation. The steps described in this section are only displayed if you select Customize Installation in the Installation Profile Selection dialog.

1. On the Installation Profile Selection dialog, select Customize Installation in the left hand pane. In the right hand pane, all the features are selected except Process Simulation and Asset Central. You can add or remove individual features, depending on your requirements.

Click Next.

2. The TIBCO Installation Home 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.

If you are installing on Windows 7, 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 strongly recommend not to install on a customized Eclipse. TIBCO Business Studio and other dependent components often use very specific versions of Eclipse frameworks which TIBCO provide in the installation process. Therefore if you cannot install a required plug-in(s) on top of TIBCO Business Studio it is unlikely they will work with TIBCO Business Studio at all.

If you require to use a custom installation then TIBCO strongly recommends you use Eclipse JEE Ganymede Version 3.4 SR 2..



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 second installation of TIBCO software from the first.

Click Next. The Hibernate License Agreement dialog is displayed.

3. 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.


4. The Eclipse Location dialog is displayed. TIBCO recommends that you use the Eclipse platform provided with TIBCO Business Studio; to do this, just click Next. However you can install TIBCO Business Studio into your own Eclipse installation. If you want to do this, select the Use my own Eclipse installation check box, specify the location of your Eclipse installation in the Eclipse Installation Location field, and click Next.

The installer performs some basic checks to try to ascertain whether a suitable copy of Eclipse is installed in the selected directory. If the installer finds any problems with the Eclipse configuration that you specified, it displays messages. If you are confident that the directory is correct or if you plan to manually configure Eclipse later, continue the installation.

5. 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. You can then restart the installation process from that point.

6. When you are satisfied with your choices, click Install.

The installation procedure checks certain aspects of the specified Eclipse installation, however, TIBCO recommends that after installation, you validate the configuration.



7. If you elected to install the Asset Central feature (available only on Windows platforms and commercial editions), the following dialog is displayed:

If you did not choose to install Asset Central, continue with step 8

Complete the dialog as follows:

— Port - When you click OK, the installer will find and use the first available port, starting with port 80. Optionally, you can click Find Port to do this. The installer searches for the first available Port and selects it to be the port for the HTTP server.

— Run as service - It is recommended that you leave this option selected. This creates a service that starts automatically and runs the HTTP server. Only

If Windows firewall alerts are displayed, click Unblock so Asset Central can be installed.

• This dialog will not be displayed if your PATH environment variable is not configured to point to a version 1.5 or later JRE. If this dialog is not displayed, after the installation, configure Java, and then run the Configuration Utility.

• If this dialog is displayed, you can configure TIBCO Business Studio Asset Central as described in this step, or click Cancel to continue the installation and configure Asset Central after the installation as described in Configuring Asset Central on page 28.

If you plan on running other servers on this machine, make sure they are started before doing this step to avoid a conflict.



deselect this checkbox if you are an experienced Apache user and want to start the server manually (for example, from the command line).

— Server root - You cannot change this setting. It is set to the \assetcentral subdirectory of the TIBCO Business Studio installation directory.

— Document root - It is recommended that you accept the default setting. Optionally, you can browse to select the location of the documents you want to display in the web server.

Click Apply to change the configuration, but leave the dialog open, or click OK to apply your changes and continue the installation.

8. The installer now performs the necessary installation tasks. 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.

9. 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.


TIBCO Business Studio does not provide any special security for documents that you put on the web server created by Asset Central, and the documents you serve may be viewed by anyone. This means that you should work with your system administrator to determine the appropriate settings for your firewall and any applicable security software.

Because Asset Central is not secured by default, all users have both read and write access to asset versioning.



Install in GUI Mode on Linux

The following procedure explains how to install TIBCO Business Studio on Linux platforms.

If you want to run TIBCO Business Studio in "headless" mode on Linux for command line build and deploy, it is necessary to have the Xvfb service running as some of the underlying eclipse components require an X Window System running on *NX based operating systems.

The examples below are for Red Hat Linux (x86_64). You can tailor these steps to your own installation.

In text terminal mode (a default Red Hat 6 runlevel 3 for example) you can use Xvfb to run X Window Virtual Frame Buffer:

1. Install the Virtual Frame Buffer package for X11 if it is not already installed. If this is not available in the base repository of Red Hat you should enable one of Red Hat specific package repositories.

yum install xorg-x11-server-Xvfb.x86_64

2. export DISPLAY=:1

3. xvfb-run <your ant script>

Or alternatively:

1. yum install xorg-x11-server-Xvfb.x86_64

2. export DISPLAY=:1

3. Xvfb :1 > /dev/null 2>&1 &

4. ....<run your ant script>

The other solution is simply to start the X Window server.



1. Run the shell script TIBCOUniversalInstaller-lnx-xnn.bin.

2. Follow the installation steps which will be similar to those in Install in GUI Mode on Windows on page 9 other than the following:

— After accepting the Hibernate License Agreement, accept the Gnome License Agreement which uses the LGPL License

— Click on Download Gnome Binding assembly from TIBCO.

Install in Silent Mode (All Platforms)

The following procedure explains how to install TIBCO Business Studio in silent mode on all 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, 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 (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.

After a successful installation, TIBCO Business Studio occasionally fails to startup on Linux systems, with a blank popup presented and the following error: "Product com.tibco.xpd.branding.prod could not be found" is thrown in the STUDIO-HOME\eclipse-platform\ganymede\eclipse\configuration folder.

Workaround: Eclipse 3.4.2 is not compatible with Xulrunner 1.9 as reported by https://bugs.eclipse.org/bugs/show_bug.cgi?id=262929. Xulrunner is typically installed as part of the Firefox browser and v1.9 is used by Firefox v3.5 and above. The compatible versions of Xulrunner are shown here: http://www.eclipse.org/swt/faq.php#browserlinux.

The preferred workaround is to obtain a compatible version of xulrunner. You can configure TIBCO Business Studio to use it by adding this to the end of the TIBCOBusinessStudio.ini file: -Dorg.eclipse.swt.browser.XULRunnerPath=path_to_xulrunner_1_8


https://bugs.eclipse.org/bugs/show_bug.cgi?id=262929

http://www.eclipse.org/swt/faq.php#browserlinux


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 -VresponseFile="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.


If you are installing Asset Central and Windows firewall alerts are displayed, click Unblock so Asset Central can be installed.



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.

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.

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


Perform Post Installation/Upgrade Tasks | 19

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.isv/guide/product_extension.htm

Test Asset Central

If you have installed and configured TIBCO Business Studio Asset Central, you can test the server (see Testing the HTTP Server on page 31).

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:

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.

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.


http://help.eclipse.org/ganymede/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/product_extension.htm



| 21

Chapter 2 Removing TIBCO Business Studio

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

Topics

• Uninstalling TIBCO Business Studio, page 22


22 | Uninstalling TIBCO Business Studio

Uninstalling TIBCO Business Studio

If you want to uninstall TIBCO Business Studio from your system, perform the following steps:

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).

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.

When you uninstall, some files are currently left behind that are not user data. You can remove these files manually if required.

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


| 23

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.

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 22.

The TIBCO Business Studio entries in the Start menus may appear after the uninstallation. To correct this log out, then log in again.

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.


24 | Uninstalling TIBCO Business Studio


| 25

Appendix A TIBCO Business Studio Asset Central

This chapter explains how to configure TIBCO Business Studio Asset Central on your computer (only the commercial version of TIBCO Business Studio on Windows includes this).

Topics

• Overview, page 26

• Installing Asset Central, page 27

• Configuring Asset Central, page 28

• Testing the HTTP Server, page 31

• Stopping the Server, page 33

• Removing Asset Central, page 34


26 | Overview

Overview

TIBCO Business Studio provides built-in source control by providing a Subversion client and optionally, TIBCO Business Studio Asset Central, which allows you to configure a Subversion server to allow you to serve documents on an intranet and take advantage of Subversion source control. See http://subversion.tigris.org/ for more information about Subversion. This appendix describes how to configure a Subversion server using the TIBCO Business Studio Asset Central Configuration Utility. For more information about using source control, see the TIBCO Business Studio Process Modeling User’s Guide.


http://subversion.tigris.org/

http://subversion.tigris.org/

| 27

Installing Asset Central

TIBCO Business Studio Asset Central can be installed as part of the TIBCO Business Studio custom installation as described in Installing TIBCO Business Studio on page 1. When you perform the installation, make sure you select the Custom installation type and select Asset Central.

Asset Central is available only on Windows platforms and commercial editions (it is not available in the Community Edition of TIBCO Business Studio).


28 | Configuring Asset Central

Configuring Asset Central

This section describes how to use the TIBCO Business Studio Asset Central Configuration Utility to set up a Subversion server. You may have already done this configuration as part of the installation, but you can use this utility to make any configuration changes that are necessary (to change the Document root, for example).

Configuring Java

To ensure that the TIBCO Business Studio Asset Central Configuration Utility has access to the correct JRE, do the following:

Open a command window and enter:

java -version

— If the Java version returned is 1.5 or later, the utility will run correctly.

— If the Java command is unrecognized, and TIBCO Business Studio is installed on the same machine, you can point to the JRE used by TIBCO Business Studio by modifying the value for the PATH environment variable as described in the following section, but ensuring that PATH points to the \jre\bin sub-directory of the TIBCO Business Studio installation directory.

— If the Java command is unrecognized and you have installed Asset Central on a different machine than TIBCO Business Studio, you must install Version 1.5 or later of the JRE before you can use the Asset Central Configuration Utility. For downloads and installation instructions, see the Sun website. Then ensure that the PATH environment variable is configured to point to the \jre\bin directory as described in the following section.

— If the Java version returned is earlier than 1.5 and you know that 1.5 is installed on the system, modify the value for the PATH environment variable to make sure that the 1.5 version is specified first as described in the following section.

Configuring the PATH Variable

1. Right-click My Computer and select Properties.

To set up a Subversion server, you must have installed the optional Asset Central part of TIBCO Business Studio (see Installing TIBCO Business Studio on page 1).


| 29

2. Click the Advanced tab and then click Environment Variables.

3. Locate PATH under System Variables and click Edit.

4. Modify the Variable Value so that the Version 1.5 or later appears

before any other JREs.

Click OK to leave the Edit System Variable dialog and previous dialogs.

Running the Configuration Utility

1. From the Windows Start menu, select Programs > TIBCO > installation_environment > TIBCO Business Studio 3.5 BPM Edition> TIBCO Business Studio Asset Central Configuration Utility. The following dialog is displayed:

2. Complete the dialog as follows:

— Port - When you click OK, the installer will find and use the first available port, starting with Port 80. Optionally, you can click Find Port to do this. The installer searches for the first available Port and selects it to be the port for the HTTP server.

— Run as service - It is recommended that you leave this option selected. This creates a service that starts automatically and runs the HTTP server. Only

If you plan on running other servers on this machine, make sure they are started before doing this step to avoid a conflict.


30 | Configuring Asset Central

deselect this checkbox if you are an expert Apache user and want to start the server manually (for example, from the command line).

— Server root - You cannot change this setting. It is set to the \assetcentral subdirectory of the TIBCO Business Studio installation directory.

— Document root - It is recommended that you accept the default setting. Optionally, you can browse to select the location of the documents you want to display in the web server.

Click Apply to change the configuration, but leave the dialog open, or click OK to apply your changes and continue the installation.

3. Test the HTTP server as described in Testing the HTTP Server on page 31.

• TIBCO Business Studio does not provide any special security for documents that you put on the web server created by Asset Central, and the documents you serve may be viewed by anyone. This means that you should work with your system administrator to determine the appropriate settings for your firewall and any applicable security software.

• Because Asset Central is not secured by default, all users have both read and write access to asset versioning.


| 31

Testing the HTTP Server

After you have installed and configured Asset Central, you can access the HTTP server by entering the following URL:

http://localhost:port/

where port is the port number that the installer selected for you during the installation. If port 80 was selected, you do not need to specify the port and can enter (http://localhost/). Depending on whether you accepted the default Document root, or selected your own location, the following welcome page or a page displaying your own content is displayed:

To go directly to the document root that you specified during Asset Central configuration, enter the following URL:

http://localhost:port/svn


32 | Testing the HTTP Server

where port is the port number that the installer selected for you during the installation. If port 80 was selected, you do not need to specify the port and can enter (http://localhost/svn). After installation, the subversion repository is empty and the revision is zero as shown in the following example:


| 33

Stopping the Server

To stop the Asset Central server, do the following:

1. From the Windows Start menu, select Settings > Control Panel.

2. Double-click Administrative Tools, then double-click Services.

3. Scroll down the list of services to locate the service TIBCO Business Studio Asset Central port, where port is the port number that you configured for the server.

4. Highlight the service and click Stop.

An alternative to the procedure described in this section is to use ApacheMonitor.exe in the installdir\assetcentral\bin directory.


34 | Removing Asset Central

Removing Asset Central

If you installed Asset Central as part of the TIBCO Business Studio installation, you can remove Asset Central using the uninstallation procedure (see Uninstalling TIBCO Business Studio on page 22).


Date post:	14-Mar-2018
Category:	Documents
Upload:	doque
View:	216 times
Download:	1 times