Installing the TIBCO Business Studio - Cloud Edition

You must download the TIBCO Business Studio - Cloud Edition to your local machine and install it. See Downloading TIBCO® Cloud Integration Tools.

Installation Requirements

Before installing the product on your system, ensure that you can log in to the system with appropriate permissions, and your system meets the hardware and software requirements. Refer to the system requirements for the system requirements. If you plan to install in an existing installation environment, stop all running processes in TIBCO_HOME.

Installation Account The privileges required to install the product differ for Windows and UNIX platforms. Ensure that you have the appropriate privileges to install on the target platform.

Microsoft Windows: You must have administrator privileges for the machine on which you want to install the software. If you do not have administrator privileges, the installer exits. If you want to install the product on a network drive, ensure that the account used for installation has permission to access the network drive.

Mac and UNIX: Any user, regular user (non-root) or super-user (root), can perform the installation.

On UNIX systems, a graphics environment such as CDE or X Windows is required to run the installer in GUI mode.

On Linux systems, install the libwebkitgtk-1.0-0 library. This is needed in order to access the online help in TIBCO Business Studio.

  1. Run the following command to install it: sudo apt-get install libwebkitgtk-1.0-0
  2. Restart TIBCO Business Studio if it is open.

Hardware and Software Requirements

Review the system memory and disk space requirements before you start the installation. Requirements for installation can be found in the system requirements.

While installing the product, avoid running other processes that consume disk space in the installation environment directory. If another process consumes disk space while the installer is copying the files, the installer might fail and display a failure message.

System and Disk Space Requirements

The system requirements specify the system memory and disk space required for installation. In addition to the disk space in the temporary directory before installation, the installer requires additional space in the temporary directory to copy files during installation. Ensure that sufficient space is available in the directory you want to use as the installation environment (TIBCO_HOME).

Software Requirements

Before running the installer on a target platform, ensure that the platform is supported and your system meets the software requirements.

Unless indicated otherwise, see the system requirements for the supported products and versions.

Required Software

Software Required?
Eclipse components Required. On some operating system platforms, TIBCO Universal Installer automatically downloads certain Eclipse LGPL components during installation, if necessary. However, on the Linux platform, you must download the Eclipse LGPL software assembly for your target platform before installing the software.
Sunec LGPL Optional. The software requires the Sunec LGPL library only if you want to use the ECC ciphers with SSL/TLS configurations. Without the ECCL library, the SSL/TLS functionality is still available, but without ECC ciphers. You must download the Sunec LGPL software assembly for your target platform before installing the software.

Pre-Installation Tasks

Pre-installation tasks include the tasks that you must complete before you start the installer. For example, ensure that your system meets the system requirements and customize your environment for certain platforms.

  1. Download the TIBCO Business Studio - Cloud Edition from the TIBCO Cloud Integration web site. For details on how to do this, see Downloading TIBCO® Cloud Integration Tools
  2. Download Eclipse LGPL Software Assembly (Required on Linux) If the Eclipse LGPL software assembly (product\_tibco\_eclipse_lgpl) is not present in the temporary directory where you extracted the product archive file, and the machine on which you will be running the TIBCO Business Studio installer is not connected to the internet, download the Eclipse LGPL software assembly for your target platform before you install TIBCO Business Studio - Cloud Edition.

    Save the downloaded assembly in a temporary directory accessible to the machine on which you will run the installer. During installation, provide the location of the temporary directory where the downloaded software assembly is available.

    If the machine is connected to the internet, you can download the Eclipse LGPL software assembly file for your target platform from the TIBCO Software Product Download Site during installation. The product\_tibco\_eclipse\_lgpl\_4.4.1.001_OSplatform.zip is downloaded to the location you select.

  3. Download Sunec LGPL (Oracle Elliptic Curve Cryptography Library) Software Assembly (Optional.)

    The software requires the Sunec LGPL library only if you want to use the ECC ciphers with SSL/TLS configurations. Without the ECCL library, the SSL/TLS functionality is still available, but without ECC ciphers.

    If the Sunec LGPL software assembly (product\_tibco\_sunec) is not present in the temporary directory where you extracted the product archive file, and the machine on which you will run the installer is not connected to the internet, download the Sunec LGPL software assembly for your target platform before you install TIBCO Business Studio - Cloud Edition.

    Save the downloaded assembly in a temporary directory accessible to the machine on which you will run the installer. During installation, provide the location of the temporary directory where the downloaded software assembly is available.

    If the machine is connected to the Internet, you can download the Eclipse LGPL software assembly file for your target platform from the TIBCO Software Product Download Site during installation. The product\_tibco\_sunec\_1.7.0.091_OSplatform.zip is downloaded to the location you select.

  4. On UNIX systems, a graphics environment such as CDE or X Windows is required to run the installer in GUI mode. If you do not have a graphics environment already installed, do so before you run the TIBCO Business Studio - Cloud Edition installer.

Installing the Studio

TIBCO provides product archive files that can be downloaded and installed using TIBCO Universal Installer.

Extract the downloaded product archive file to a temporary directory, and then run the TIBCO Universal Installer executable from that directory.

Installation Modes

You can run the installer in one of the following modes. Each mode is supported on all platforms.

GUI Mode: In GUI mode, invoke the installer by double-clicking the executable file, TIBCOUniversalInstaller. The installer presents windows that you can use to select the product components, its location, and so on. Proceed through the installation process by providing your input.

Console Mode: In console mode, you invoke the installer from a command prompt or a terminal window, and the installer prompts for values on the console. You can move through the installation process by responding to the prompts. This mode is useful if your machine does not have a GUI interface environment

Silent Mode: In silent mode, the installer installs without prompting you for information. Silent mode either installs using the default settings or uses a response file that was saved during an earlier installation. In this mode:

  • If no response file has been recorded earlier, invoke the installer with the -silent argument to use the default installation parameters.
  • If a response file exists, invoke the installer with the arguments -silent -V - responseFile=responseFileName” to use the values specified in the response file.

Installing in GUI Mode

When you run the installer in GUI mode, the installer presents panels that you can use to choose the installation environment and customize your installation.

  1. Run the TIBCOUniversalInstaller executable.

    On Microsoft Windows: TIBCOUniversalInstaller-x86-64.exe

    On Linux: TIBCOUniversalInstaller-lnx-x86-64.bin

    On Mac OS: TIBCOUniversalInstaller-mac.command

  2. On the Welcome screen, click Next.

  3. Read through the license agreement, select I accept the terms of the license agreement if you agree to the terms, and click Next.

  4. Choose to create a new installation environment (TIBCO_HOME) and specify the directory and name for the new environment. Then click Next.

    To create a new TIBCO_HOME, specify the following properties:

    Property Description
    Directory The directory into which the product is installed. The directory cannot be the same as the directory of an existing installation environment. The directory path cannot contain the following special characters: # $ % & * < > ? ` |
    Name Identifies the installation environment. The name cannot contain the following special characters: “ * / : < > ? | \

    To use an existing TIBCO_HOME, select an existing installation environment from the list.

  5. On the Installation Profile Selection screen, select the pre-configured profile (Typical), or click Customize Installation, and explicitly select the components you want to install. By default, the pre-configured profiles include the Oracle Elliptic Curve Cryptography Library (ECCL) component. The software requires the ECCL library only if you want to use the ECC ciphers with SSL/TLS configurations. Without the ECCL library, the SSL/TLS functionality is still available, but without the ECC ciphers.

    • To continue with the default selection, click Next.
    • If you do not plan to use the ECC ciphers, you do not need to download and install the ECCL library. Select the Customize Installation check box and clear the check box for the Oracle Elliptic Curve Cryptography Library component. Then click Next.
  6. On Linux and Solaris, the design feature requires Eclipse LGPL assembly to be available in the temporary directory prior to installation. See the section on Software Requirements above for details. The installer opens the LGPL License Agreement screen for the Eclipse LGPL assembly. Read through the license agreement, select I accept the terms of the license agreement if you agree to the terms, and click Next to proceed.

  7. On the LGPL Assembly Download screen, select one of the following download options and click Next.

    • Download Gnome Binding assembly from TIBCO: Select this option if you are connected to the internet or do not want to use a previously downloaded assembly. The assembly is automatically downloaded and stored in the assemblies sub-directory of the directory where you extracted the installer.
    • Provide the location for the assembly previously downloaded from TIBCO: Select this option if you are not connected to the internet. Click Browse to navigate to the directory where the previously downloaded LGPL assembly is stored. Select the directory, and click Open.

    Note: Skip this step if the Oracle Elliptic Curve Cryptography Library component was not selected in the Installation Profile Selection screen.

    If you choose to install the Oracle Elliptic Curve Cryptography Library component, the design feature requires the Sunec LGPL assembly to be available in the temporary directory prior to installation. See the section on Software Requirements above for details. The installer prompts the LGPL License Agreement screen for the Sunec LGPL assembly. To download the Oracle Elliptic Curve Cryptography Library, select I accept the terms of the license agreement, and click Next. If you do not want to download the Oracle Elliptic Curve Cryptography Library, click Cancel to exit.

  8. On the Pre-Install Summary screen, verify the list of products and components selected for installation, and click Install.

  9. Verify the Post-Install Summary, click Finish to complete the installation process, and close the installer window.

Installing in Console Mode

When you run the installer in console mode, the installer prompts for values on a console window and you can move through the installation by responding to the prompts. Console mode can be used to install the software in a non-GUI environment.

Prerequisite: Prepare your system and the installation media before running the installer in console mode.

  1. Open a console window and navigate to the temporary directory where you extracted the product archive file.

  2. Run TIBCOUniversalInstaller -console.

    The installer launches a second console window.

  3. Complete the installation by responding to the console window prompts, which are similar to those described in the section, Installing in GUI Mode. The console also provides an option to return to a previous selection periodically.
  4. When the installation is completed, press Enter to exit the installer.

Installing in Silent Mode

When you run the installer in silent mode, the installer does not prompt for your input. Instead, the values specified in a response file are used to complete the installation. You can use a default pre-configured response file or create your own response file.

By default, the installer uses the TIBCOUniversalInstaller\_BW\_<version\>.silent file, which is included in the directory that contains the universal installer.

To customize the silent installer:

  1. Make a backup copy of TIBCOUniversalInstaller\_BW\_<version\>.silent file and rename the file, for example, newfile.silent.

    Edit the TIBCOUniversalInstaller\_BW\_<version\>.silent file itself. You can then run the silent installer with or without the response file argument.

  2. Using a text editor, open the copied file and update the installation location and features to install.
  3. Open a console window, and navigate to the temporary directory where you extracted the product archive file and run the silent installer using one of the following commands:

    On Windows: TIBCOUniversalInstaller.cmd -silent [-V responseFile="newfile.silent"]

    On UNIX: TIBCOUniversalInstaller.bin -silent [-V responseFile='newfile.silent']

    On Mac OS: TIBCOUniversalInstaller-mac.command -silent [-V responseFile='newfile.silent']

Troubleshooting the Installation

If you encounter problems during installation, ensure that your system meets all prerequisites, and then check the installer log for potential problems.

Installer Log File

The installer log file captures information such as:

  • Environment details such as the user that invoked the installer, host name, operating system details, and so on.
  • List of assemblies installed.
  • Information related to the Ant scripts executed by the installer.

The installer log file, tibco\_universal\_installer.username\_install.log is available in the following locations:

    On Windows: C:\Users\username\.TIBCO\install\_timestamp

    On Linux: user\_home\_dir/.TIBCO/install\_timestamp

To change the location of the installer log file, specify the option -V logFile="myLogFile" when running the installer.

Starting TIBCO Business Studio

To start the TIBCO Business Studio do the following:
On Windows:

  • Click Start > All Programs > TIBCO > TIBCO_HOME > TIBCO Business Studio version_number > Studio for Designers

On Linux and Mac OS:

  • Run the TIBCO Business Studio executable located in the TIBCO_HOME/studio/version_number/eclipse directory.

Note: If you are upgrading your installation of TIBCO Business Studio, make sure that you use a new workspace when you start the Studio after the upgrade.

Installing Plug-ins

You can optionally install plug-ins for TIBCO Business Studio. To install plug-ins, refer to the “Installation” topic under the Plug-In List section.

Uninstalling TIBCO Business Studio

TIBCO Universal Installer can be used to uninstall the software. Using the Universal Installer, you can choose to uninstall either all products installed in the TIBCO_HOME directory or just the selected products.

Prerequisites:

Before uninstalling the product, stop all running appnodes, the ActiveMatrix BusinessWorks engine, and the bwagents on the machine on which you want to uninstall the product. Also, close TIBCO Business Studio.

To uninstall the product:

  1. Run the TIBCO Universal Installer (TIBCOUniversalInstaller) from the TIBCO_HOME/tools/universal_installer/ directory.

  2. In the TIBCO Installation Manager screen, select Uninstall Products from a TIBCO Home Location, and select the TIBCO_HOME location from the drop-down list. Then click Next.

  3. Click Next on the Welcome screen.

  4. On the Uninstallation Type screen, choose the type of uninstall from the following options and then click Next.

    • Custom Uninstall - Select the products to be removed.
    • Typical Uninstall - Removes all the products in the selected TIBCO_HOME folder.
  5. If you selected Custom Uninstall, select the products you want to uninstall on the Product Uninstall Selection screen. Then click Next.

  6. Review the product to be uninstalled in the Pre-Uninstall Summary screen, and click Uninstall to proceed.

    The installer uninstalls the selected products.

  7. When prompted to clean up the /tools directory, click Yes, clean it up.

  8. Click Finish in the Post Uninstall Summary screen to exit the uninstall wizard.

  9. If you have uninstalled all the software under TIBCO_HOME, delete the folders under the TIBCO_HOME directory.