tibco business studio™ · pdf fileinstalling tibco business studio | 3. installation...

38
TIBCO Business Studio™ Installation Software Version 3.6.0 September 2013 Two-Second Advantage ®

Upload: lehuong

Post on 14-Mar-2018

222 views

Category:

Documents


4 download

TRANSCRIPT

Page 1: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Two-Second Adv

TIBCO Business Studio™

InstallationSoftware Version 3.6.0September 2013

antage®

Page 2: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

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

Page 3: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Contents

Installing TIBCO Business Studio.........................................................................3Installation Features.................................................................................................................4

System Requirements..............................................................................................................5

Supported Platforms......................................................................................................5

Minimum Disk Space and Memory Requirements........................................................6

Third-party Software Requirements.........................................................................................7

TIBCO Business Studio Asset Central Requirements..............................................................8

Compatibility.............................................................................................................................9

Installer Accounts...................................................................................................................10

Installation Directories............................................................................................................11

Installer Log File.....................................................................................................................12

Environment Information........................................................................................................13

Installing in GUI Mode on Windows........................................................................................14

Completing a Custom Installation on Windows......................................................................16

Installing in GUI Mode on Linux/UNIX....................................................................................18

Installing in GUI Mode on Apple Mac.....................................................................................20

Installing in Silent Mode (All Platforms)..................................................................................22

Perform Post Installation/Upgrade Tasks...........................................................23Deletion of the Temporary Installation Files............................................................................24

Issues to be Aware of when Running on Linux......................................................................25

Running on Windows 7...........................................................................................................26

How to Access the Internet when using a Proxy Server........................................................27

Uninstalling TIBCO Business Studio..................................................................28Using the Uninstaller..............................................................................................................29

Using Add/Remove Programs (Windows Only)......................................................................30

TIBCO Business Studio Asset Central...............................................................31Installing Asset Central...........................................................................................................32

Configuring Asset Central......................................................................................................33

Configuring Java..........................................................................................................33

Running the Configuration Utility.................................................................................33

Testing the HTTP Server........................................................................................................35

Stopping the Server................................................................................................................36

Removing Asset Central.........................................................................................................37

2 | TOC

Page 4: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installing TIBCO Business Studio

When you install TIBCO Business Studio, two installation modes are available: GUI and silent.

Installing TIBCO Business Studio | 3

Page 5: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installation FeaturesDifferent installation features are available that allow you to customize the installation of TIBCO BusinessStudio components.

The table lists the features you can select. To install additional features, select Customize Installation andselect additional features.

If you install the Process Simulation feature or the Openspace Gadget Development feature, you must haveBPM Development Tools selected.

Selected by DefaultFeature

YesBPM Development Tools

NoProcess Simulation

NoWorkspace Client Components

NoOpenspace Gadget Development

YesApache Directory Studio (LDAP Tools)

NoAsset Central

4 | Installing TIBCO Business Studio

Page 6: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

System RequirementsMake sure that your target computer meets the necessary system requirements to install TIBCO BusinessStudio.

The 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 PlatformsTIBCO Business Studio is supported on Windows, Apple Mac OS X and Linux platforms, which are listedin detail in this section.

The 32 bit Windows version of TIBCO Business Studio is supported on both 32 and 64 bit Windowsplatforms; Linux has x86 and x64 (32 bit and 64 bit) distributions.

Microsoft have discontinued standard support for Windows XP. (Extended support is still availablebut must be purchased from Microsoft.)

TIBCO will continue to support TIBCO Business Studio on Windows XP. However, if a problem withTIBCO Business Studio is reported to TIBCO Support, and the problem is traced to the Windows XPoperating 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 8 instead of Windows XP on anysystem that runs TIBCO Business Studio.

For full details of the platform variants supported, please refer to the README supplied with theproduct.

Microsoft Windows:• Windows 7• Windows 8

Microsoft Windows Server:• Windows Server 2008• Windows Server 2008 R2, 2012

Windows 7 Professional is the minimum level supported by TIBCO.

Apple Mac OS X:• 10.8.x

Linux/UNIX software distribution packages and supported versions:

HP HP-UX• 11i v3 (B.11.31) on Itanium This platform is only available for the Command Line Interface (Headless)

variant.

IBM AIX• 6.1, 7.1 on pSeries This platform is only available for the Command Line Interface (Headless) variant.

Novell SUSE Linux Enterprise Server• 10.x, 11.x

Installing TIBCO Business Studio | 5

Page 7: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Oracle Solaris• 11 on x86-64. This platform is only available for the Command Line Interface (Headless) variant.• 11 on SPARC. This platform is only available for the Command Line Interface (Headless) variant.

Red Hat Enterprise Linux Advanced Platform• 5.x

Red Hat Enterprise Linux Server• 5.x, 6.xSun Solaris• 10 on x86-64. This platform is only available for the Command Line Interface (Headless) variant.• 10 on SPARC. This platform is only available for the Command Line Interface (Headless) variant.

The maximum number of open files/file descriptors that a user can open is controlled by the operatingsystem. The threshold on Linux is typically too low for use with TIBCO Business Studio and has tobe increased. The exact number depends on the features selected during installation and the size ofthe workspace but our experience is that 10000 is plenty. You can find out the number on your systemusing ulimit -n from a Terminal window.

Other Linux implementations detailed in the following link have not been formally validated, but have noknown incompatibilities with this version of TIBCO Business Studio.

http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_4.html#TargetOperatingEnvironments

Operating systems other than Linux, Apple Mac OS and Windows are not supported.

Minimum Disk Space and Memory RequirementsTIBCO Business Studio requires minimum disk space for installation and minimum memory requirementsin order to run efficiently.• Free disk space: from 2 GB to 3 GB depending on options selected for installation.• Memory: minimum 4 GB RAM; the recommended level is 8 GB, or more depending on project sizes.

6 | Installing TIBCO Business Studio

Page 8: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Third-party Software RequirementsAdditional third-party software is required when you install TIBCO Business Studio.

The following software and assemblies are required:• JRE 1.7.x (included in installation). We recommend that users stay up to date with Java patches issued by

Oracle.• Hibernate Version 3.2.7 (assembly_tibco_com_tibco_tpcl_org_hibernate_feature_3.2.400.001.zip).

You must use a Hibernate Assembly that you have downloaded from TIBCO or the installationwill 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.

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

• Oracle Elliptic Curve Cryptography Library (TIB_product_tibco_sunec_1.7.0.021_<platform>.zip)

• Eclipse SWT (Standard Web Toolkit) GTK

The TIBCO Business Studio installer for Linux 32 and 64 bit distributions downloads the Eclipse SWTGTK module which contains these 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 theassembly from the TIBCO public website or select it from the disk.

Installing TIBCO Business Studio | 7

Page 9: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

TIBCO Business Studio Asset Central RequirementsThere are no additional requirements beyond those for TIBCO Business Studio, but if you plan to configureAsset Central during the installation, you must first configure Java.

You cannot configure Asset Central unless the PATH environment variable points to Version 1.5 or later ofthe Java Runtime Environment (JRE).

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

After installation, if you have installed and configured TIBCO Business Studio Asset Central, you can testthe server (see Testing the HTTP Server on page 35).

8 | Installing TIBCO Business Studio

Page 10: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

CompatibilityTIBCO Business Studio version 3.6.0 is compatible with specific versions of other TIBCO products.

The products that TIBCO Business Studio version 3.6.0 (including Forms version 2.5.0) is compatible withare as follows:• TIBCO ActiveMatrix BPM version 2.2.0• TIBCO ActiveMatrix Service Bus version 3.3.0• TIBCO ActiveMatrix Service Grid version 3.3.0• TIBCO Nimbus version 8.1.2 - 8.1.x• ARIS Business Designer 7.2

Installing TIBCO Business Studio | 9

Page 11: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installer AccountsYou require certain privileges to install TIBCO Business Studio on Windows and Linux/UNIX platforms.

Microsoft Windows

You must have administrator privileges for the machine on which TIBCO Business Studio is installed. If youdo not have administrator privileges, the installer exits. You must then log out of the system and log in as auser with the required privileges, or request your system administrator to assign the privileges to youraccount.

After installing TIBCO Business Studio with administrator privileges, do not use the same account tocreate a workspace for the user. Instead, individual users should start TIBCO Business Studio fromthe account with which they intend to use TIBCO Business Studio, and create their own workspaceto avoid potential issues with permissions.

If you intend to install the product on a network drive, you must ensure that the account used for installationhas permission to access the network drive.

Linux/UNIX

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

10 | Installing TIBCO Business Studio

Page 12: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installation DirectoriesTIBCO recommends that you install each version of TIBCO Business Studio into a new, empty installationenvironment (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 Installing in GUI Mode on Windows. 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.

Installing TIBCO Business Studio | 11

Page 13: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installer Log FileThe installer log file is written to specific locations for Windows and Linux.

Windows 7, Windows 8, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012

User_Home\.TIBCO\install_identifier directory where identifier is in the form of the date and time TIBCOBusiness Studio was installed and a unique number used to identify this particular installation of TIBCOBusiness Studio.

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

Linux/UNIX

$HOME/.TIBCO/install_identifier directory where identifier is in the form of the date and time TIBCO BusinessStudio was installed and a unique number used to identify this particular installation of TIBCO BusinessStudio.

For example, /home/user1/.TIBCO/install_03-02-2010.132827

12 | Installing TIBCO Business Studio

Page 14: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Environment Information

The file _envInfo.xml is written to this location for Windows: C:\Program Files\CommonFiles\InstallShield\Universal\TIBCO\Gen1\_vpddb.

Installing TIBCO Business Studio | 13

Page 15: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installing in GUI Mode on WindowsThis procedure explains how to install TIBCO Business Studio in GUI mode. Hibernate is also installed aspart of the installation process.

Before you begin

Log in to the system on which you want to install TIBCO Business Studio (for more information, see InstallerAccounts). If you want the installer to automatically install Hibernate 3.2.7, make sure you are online. SeeThird-party Software Requirements for more information.

Open the physical media or download the TIBCO Business Studio package to the machine on which youwant to install TIBCO Business Studio.

Extract the installation files to a temporary directory.

Procedure

1. Double-click TIBCOUniversalInstaller.2. Review the information in the Welcome dialog and click Next.

Review the terms of the license agreement and, if you agree to them, click I accept the terms of the licenseagreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

3. From the TIBCO Installation Home dialog, TIBCO_HOME is the preferred top level installation directoryfor all TIBCO products on your system. Select either:

– Create a new TIBCO_HOME. Click Browse to specify an environment location (a directory path toan 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 defaultenvironment name is studio-bpm-3.6. If this is not the first installation of TIBCO software, you can editthe environment name to differentiate this subsequent installation of TIBCO software from the first.

Click Next.

4. On the Installation Profile Selection dialog, accept the selection of Solution Designer profile in the listin the left hand pane (see Installation Personas) or select Customize Installation. See Completing a CustomInstallation on Windows for information on additional steps in the custom installation. The right handpane displays the features that are selected for each profile. Click Next

5. Review the terms of the LGPL License Agreement and, if you agree to them, click I accept the terms ofthe license agreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

6. On the LGPL Assembly Download dialog, select 'Download Hibernate Assembly from TIBCO' or 'Providethe location for the assembly previously downloaded from TIBCO'.

7. Review the terms of the LGPL License Agreement and, if you agree to them, click I accept the terms ofthe license agreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

8. On the LGPL Assembly Download dialog, select 'Download Oracle Elliptic Curve Cryptography Libraryas ...' or 'Provide the location for the assembly previously downloaded from TIBCO'.

14 | Installing TIBCO Business Studio

Page 16: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

9. 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 appropriatepoint and make your choices again.

When you are satisfied with your choices, click Install. The installer now performs the necessary installationtasks.

10. 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 thetasks that the installer is performing. Click Finish to exit from the installer. There is a slight delay whilethe installer deletes temporary files.

If you are installing on Windows 7, you may see a pop-up stating "This program might not haveinstalled corrrectly". This is due to an incompatibility between InstallShield and Windows 7, butshould not affect your TIBCO Business Studio installation.

What to do next

Complete the post-installation tasks described in Perform Post Installation/Upgrade Tasks

Installing TIBCO Business Studio | 15

Page 17: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Completing a Custom Installation on WindowsTIBCO strongly recommend not to install on a customized Eclipse.

Before you begin

Log in to the system on which you want to install TIBCO Business Studio (for more information, see InstallerAccounts). If you want the installer to automatically install Hibernate 3.2.7, make sure you are online. SeeThird-party Software Requirements for more information.

Open the physical media or download the TIBCO Business Studio package to the machine on which youwant to install TIBCO Business Studio.

Extract the installation files to a temporary directory.

Procedure

1. Double-click TIBCOUniversalInstaller.2. Review the information in the Welcome dialog and click Next.

Review the terms of the license agreement and, if you agree to them, click I accept the terms of the licenseagreement. Then click Next to continue with the installation. If you do not agree to the terms of the licenseagreement, click Cancel to exit from the installation process.

3. The TIBCO Installation Home dialog appears. TIBCO_HOME is the preferred top level installationdirectory for all TIBCO products on your system. Select either:

– Create a new TIBCO_HOME. Click Browse to specify an environment location (a directory path toan 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 defaultenvironment name is studio-bpm-3.6. If this is not the first installation of TIBCO software, you canedit the environment name to differentiate this second installation of TIBCO software from the first.

Click Next

4. On the Installation Profile Selection dialog, select Customize Installation in the left hand pane. In theright hand pane, all the features are selected except Process Simulation, Workspace Client Components,Openspace Gadget Development and Asset Central. You can add or remove individual features,depending on your requirements. Click Next.

5. Review the terms of the LGPL License Agreement and, if you agree to them, click I accept the terms ofthe license agreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

6. On the LGPL Assembly Download dialog, select 'Download Hibernate Assembly from TIBCO' or 'Providethe location for the assembly previously downloaded from TIBCO'.

7. Review the terms of the LGPL License Agreement and, if you agree to them, click I accept the terms ofthe license agreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

8. On the LGPL Assembly Download dialog, select 'Download Oracle Elliptic Curve Cryptography Libraryas ...' or 'Provide the location for the assembly previously downloaded from TIBCO'.

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

16 | Installing TIBCO Business Studio

Page 18: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

any of your choices, click Back to step back through the dialogs to the appropriate point. You can thenrestart the installation process from that point. When you are satisfied with your choices, click Install

10. If you elected to install the Asset Central feature (available only on Windows platforms and commercialeditions), a dialog is displayed:

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 pointto 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 describedin this step, or click Cancel to continue the installation and configure Asset Central after theinstallation.

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 andselects it to be the port for the HTTP server.

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

– Run as service - It is recommended that you leave this option selected. This creates a service that startsautomatically and runs the HTTP server. Only deselect this checkbox if you are an experienced Apacheuser 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 TIBCOBusiness Studio installation directory.

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

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

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

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

11. 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 thetasks that the installer is performing. Click Finish to exit from the installer.

What to do next

Complete the post-installation tasks described in Perform Post Installation/Upgrade Tasks

Installing TIBCO Business Studio | 17

Page 19: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installing in GUI Mode on Linux/UNIXYou can install in GUI mode on Linux/UNIX using a similar procedure to that used for installing on Windows,with the addition of acceptance of an extra licence file.

Before you begin

Log in to the system on which you want to install TIBCO Business Studio (for more information, see InstallerAccounts). If you want the installer to automatically install Hibernate 3.2.7, make sure you are online. SeeThird-party Software Requirements for more information.

Open the physical media or download the TIBCO Business Studio package to the machine on which youwant to install TIBCO Business Studio.

Extract the installation files to a temporary directory.

Procedure

1. Run the shell script TIBCOUniversalInstaller-lnx-x nn.bin.

2. Double-click TIBCOUniversalInstaller.3. Review the information in the Welcome dialog and click Next.

Review the terms of the license agreement and, if you agree to them, click I accept the terms of the licenseagreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

4. From the TIBCO Installation Home dialog, TIBCO_HOME is the preferred top level installation directoryfor all TIBCO products on your system. Select either:

– Create a new TIBCO_HOME. Click Browse to specify an environment location (a directory path toan 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 defaultenvironment name is studio-bpm-3.6. If this is not the first installation of TIBCO software, you can editthe environment name to differentiate this subsequent installation of TIBCO software from the first.

Click Next.

5. Choose a profile from the list in the left hand pane (see Installation Personas).The right hand pane displaysthe features that are selected for each profile. Click Next.

6. Review the terms of the LGPL License Agreement and, if you agree to them, click I accept the terms ofthe license agreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

7. Accept the Gnome License Agreement which uses the LGPL License. Click on Download Gnome Bindingassembly from TIBCO

8. 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 appropriatepoint and make your choices again.

When you are satisfied with your choices, click Install. The installer now performs the necessary installationtasks.

18 | Installing TIBCO Business Studio

Page 20: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

9. 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 thetasks that the installer is performing. Click Finish to exit from the installer. There is a slight delay whilethe installer deletes temporary files.

Installing TIBCO Business Studio | 19

Page 21: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installing in GUI Mode on Apple MacThis procedure explains how to install TIBCO Business Studio in GUI mode on an Apple Mac. Hibernate isalso installed as part of the installation process.

Before you begin

Log in to the system on which you want to install TIBCO Business Studio (for more information, see InstallerAccounts). If you want the installer to automatically install Hibernate 3.2.7, make sure you are online. SeeThird-party Software Requirements for more information.

Open the physical media or download the TIBCO Business Studio package to the machine on which youwant to install TIBCO Business Studio.

Extract the installation files to a temporary directory.

Procedure

1. Open a terminal window, go to the temporary directory you have created, and type./TIBCOUniversalInstaller-mac.bin.

2. Review the information in the Welcome dialog and click Next.

Review the terms of the license agreement and, if you agree to them, click I accept the terms of the licenseagreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

3. TIBCO_HOME is the preferred top level installation directory for all TIBCO products on your system.From the TIBCO Installation Home dialog, select either:

– Create a new TIBCO_HOME. Click Browse to specify an environment location (a directory path toan 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 defaultenvironment name is studio-bpm-3.6. If this is not the first installation of TIBCO software, you can editthe environment name to differentiate this subsequent installation of TIBCO software from the first.

Click Next.

4. Review the terms of the LGPL License Agreement and, if you agree to them, click I accept the terms ofthe license agreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

5. On the LGPL Assembly Download dialog, select 'Download Hibernate Assembly from TIBCO' or 'Providethe location for the assembly previously downloaded from TIBCO'.

6. Review the terms of the LGPL License Agreement and, if you agree to them, click I accept the terms ofthe license agreement. Then click Next to continue with the installation.

If you do not agree to the terms of the license agreement, click Cancel to exit from the installation process.

7. On the LGPL Assembly Download dialog, select 'Download Oracle Elliptic Curve Cryptography Libraryas ...' or 'Provide the location for the assembly previously downloaded from TIBCO'.

8. 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 appropriatepoint and make your choices again.

20 | Installing TIBCO Business Studio

Page 22: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

When you are satisfied with your choices, click Install. The installer now performs the necessary installationtasks.

9. 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 thetasks that the installer is performing. Click Finish to exit from the installer. There is a slight delay whilethe installer deletes temporary files.

What to do next

Complete the post-installation tasks described in Perform Post Installation/Upgrade Tasks

Installing TIBCO Business Studio | 21

Page 23: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installing in Silent Mode (All Platforms)You can install TIBCO Business Studio in silent mode on all platforms.

Before you begin

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. Thefile 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 differentname 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/.TIBCOdirectory).

Procedure

1. Open the physical media 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 canrun: 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.

What to do next

Complete the post-installation tasks described in Perform Post Installation/Upgrade Tasks

22 | Installing TIBCO Business Studio

Page 24: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Perform Post Installation/Upgrade Tasks

After installation, there are a number of tasks you can perform to ensure that your system runs efficiently.

Perform Post Installation/Upgrade Tasks | 23

Page 25: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Deletion of the Temporary Installation FilesIf you want to recover the disk space used by the installation files that you extracted to a temporary directoryin step 3 of the installation, delete them.

24 | Perform Post Installation/Upgrade Tasks

Page 26: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Issues to be Aware of when Running on LinuxIf you are running on Linux, you should be aware of the following notes.

If you want to run TIBCO Business Studio in "headless" mode on Linux for command line build anddeploy, it is necessary to have the Xvfb service running as some of the underlying eclipse componentsrequire 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 WindowVirtual 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=:13. xvfb-run <your ant script

Or alternatively:

4. yum install xorg-x11-server-Xvfb.x86_645. export DISPLAY=:16. Xvfb :1/dev/null 2&1 &7. ....<run your ant script

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

Perform Post Installation/Upgrade Tasks | 25

Page 27: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Running on Windows 7If you are not in the local Administrators group, you must change the privilege level for TIBCO BusinessStudio to Run this program as Administrator in order for TIBCO Business Studio to run properly in Windows7. To do this:

About this task

Procedure

1. Browse to the location of your , for example TIBCO_HOME\studio\3.6\ > eclipse .2. Right-click and select Properties. The Properties dialog is displayed.3. Select Compatibility. In Privilege Level, select Run this program as Administrator.

26 | Perform Post Installation/Upgrade Tasks

Page 28: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

How to Access the Internet when using a Proxy ServerIf you are using a proxy server, when TIBCO Business Studio is set up you need to configure it to use yourproxy.

Perform Post Installation/Upgrade Tasks | 27

Page 29: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Uninstalling TIBCO Business Studio

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 thesefiles manually if required.

Linux\UNIX1. Open a terminal.2. Navigate to STUDIO_HOME/_uninstall

3. Run the uninstaller named TIBCOUniversalInstaller-lnx-x86.bin.

Linux\UNIX

Use the uninstaller provided with TIBCO Business Studio.

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 7, Windows 8, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012).

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 theJVM 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 tothe installation_environment\_uninstall folder and enter the following command:universal_uninstall.exe -is:javahome

28 | Uninstalling TIBCO Business Studio

Page 30: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Using the UninstallerUninstall TIBCO Business Studio using the uninstaller.

About this task

Procedure

1. Log in to the system on which you want to uninstall software.2. The Welcome dialog is displayed. Click Next.3. Do one of the following:

– Select Typical to uninstall all products in the environment, and omit the next step.

– Select Custom to choose products in this environment to uninstall , and continue with the next step.

4. The Product Uninstall Selection dialog is displayed. Select the products (for example, TIBCO BusinessStudio 3.6) 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 stepback through the dialogs to the appropriate point. You can then restart the uninstallation process fromthat point. When you are satisfied with your choices, click Uninstall.

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

Uninstalling TIBCO Business Studio | 29

Page 31: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Using Add/Remove Programs (Windows Only)You can remove the installation using the Add/Remove Programs option on your PC.

Procedure

1. Log in to Windows as a user with system administrator privileges. You must have system administratorprivileges 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 environmentyou want to uninstall. If you have installed more than one TIBCO product, there will be multiple entriesin Add/Remove programs (for example, TIBCO Universal Installer (c:\tibco\env_1), TIBCO UniversalInstaller (c:\tibco\env_2), and so on).

4. Click Change/Remove.

The uninstaller launches. Follow the uninstallation steps in Using the Uninstaller.

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.

30 | Uninstalling TIBCO Business Studio

Page 32: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

TIBCO Business Studio Asset Central

TIBCO Business Studio Asset Central allows you to configure a Subversion server to allow you to servedocuments on an intranet and take advantage of Subversion source control.

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 toserve documents on an intranet and take advantage of Subversion source control. Seehttp://subversion.tigris.org/ for more information about Subversion. This section describes how to configurea Subversion server using the TIBCO Business Studio Asset Central Configuration Utility. For more informationabout using source control, see the TIBCO Business Studio Modeling Guide.

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

TIBCO Business Studio Asset Central | 31

Page 33: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Installing Asset CentralTIBCO Business Studio Asset Central can be installed as part of the TIBCO Business Studio custom installation.

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 inthe Community Edition of TIBCO Business Studio).

32 | TIBCO Business Studio Asset Central

Page 34: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Configuring Asset CentralYou can 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 makeany configuration changes that are necessary (to change the Document root, for example)

To set up a Subversion server, you must have installed the optional Asset Central part of TIBCOBusiness Studio.

Configuring JavaTo 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 environmentvariable as described in the following section, but ensuring that PATH points to the \jre\bin sub-directoryof the TIBCO Business Studio installation directory.

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

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

Configuring the PATH Variable1. Right-click My Computer and select Properties.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

Procedure

1. From the Windows Start menu, select Programs > TIBCO > installation_environment > TIBCO BusinessStudio 3.6 BPM Edition > . A 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 andselects it to be the port for the HTTP server.

TIBCO Business Studio Asset Central | 33

Page 35: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

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

– Run as service - It is recommended that you leave this option selected. This creates a service that startsautomatically and runs the HTTP server. Only deselect this checkbox if you are an expert Apache userand 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 TIBCOBusiness Studio installation directory.

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

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

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

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

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

34 | TIBCO Business Studio Asset Central

Page 36: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Testing the HTTP ServerAfter you have installed and configured Asset Central, you can access the HTTP server.

You can access the HTTP server by entering the following URL: http://localhost:portwhere port is the portnumber that the installer selected for you during the installation. If port 80 was selected, you do not need tospecify the port and can enter (http://localhost/). Depending on whether you accepted the default Documentroot, or selected your own location, the 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 followingURL: http://localhost:port/svn where port is the port number that the installer selected for you during theinstallation. 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.

TIBCO Business Studio Asset Central | 35

Page 37: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Stopping the ServerYou can stop the Asset Central server from the Windows control panel.

About this task

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

Procedure

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.

36 | TIBCO Business Studio Asset Central

Page 38: TIBCO Business Studio™ · PDF fileInstalling TIBCO Business Studio | 3. Installation Features Different installation features are available that allow you to customize the installation

Removing Asset CentralYou can remove Asset Central as part of the uninstallation procedure for TIBCO Business Studio.

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

TIBCO Business Studio Asset Central | 37