LibraryPrintFeedback

Installation Guide

Version 7.1

December 2012
Trademark Disclaimer

Updated: 08 Jan 2014

Table of Contents

1. Installation Prerequisites
Supported Platforms
Java Runtime
Hardware requirements
2. Installing Fuse ESB Enterprise
Getting the Installer
Installation Types
Installer Modes
Installing in GUI Mode
Installing in Text Mode
Installing from an Archive File
3. Adding a Remote Console User
4. Uninstalling

Fuse runtime platforms need Java 6, JRE 1.6.0_18 or later.

To develop applications for Fuse runtime platforms, you need Java 6, JDK 1.6.0_18 or later.

[Important]Non-Oracle Java distributions

Fuse products are only guaranteed to run with Java runtimes distributed by, or OEMed from, Oracle and IBM.

[Note]Red Hat Linux

On Red Hat-derived Linux systems, gcj is the default Java distribution. In these cases, you must download and install an Oracle Java runtime and set the JAVA_HOME environment variable. You can also integrate the Oracle Java runtime into the alternatives(1) system. See the alternatives(1) man page for details.

You can download the installer from the Red Hat Web site at http://fusesource.com/products.

Be sure that you select the proper download for the intended platform.

[Note]Note

On Linux the installer may not download as an executable file. If that is the case, you can simply use the chmod command to make it executable.

The installer tests your system for minimum requirements and performs basic environment set up. The installer can run in one of the following modes:

  • GUI mode—useful when the system you are installing on has a windowing system

    [Note]Note

    This is the default installer mode.

  • Text mode—useful when you do not have a windowing system available because the installer runs in the command terminal

    [Note]Note

    Text mode is not available on Windows.

Alternatively, you can download the archive file and unpack it onto your system. This is a useful approach for developer installations. See Installing from an Archive File.

To install in GUI mode:

  1. If you are installing on OS X, mount the installer's disk image.

  2. Double-click the installer.

    1. If a dialog appears asking whether the application is safe to open, authorize the application to run.

    2. If prompted, enter your username and password.

    3. If you encounter a warning about the system not meeting the recommended requirements, click OK.

      [Note]Note

      You should evaluate the decision to install on this system. It is likely not going to perform well for mission critical applications.

    If the system meets the minimum installation requirements, the installer opens and displays a welcome page. Otherwise it displays a warning.

  3. Click Next>.

    [Note]Note

    On Linux systems Forward> is used in place of Next>.

  4. Read the Red Hat license agreement.

  5. Click the box next to I accept the agreement.

  6. Click Next>.

  7. Read the third party license agreement.

  8. Click the box next to I accept the agreement.

  9. Click Next>.

  10. Enter a location for the installation.

    The default locations are:

    OS X/Applications/FuseESBEnterprise-7.1.x
    Unix/Linux/opt/FuseESBEnterprise-7.1.x
    [Tip]Tip

    Clicking the folder icon will open a file explorer.

  11. Click Next>.

  12. Select the installation type.

    For more information on installation types see Installation Types.

  13. Click Next>.

  14. Enter the name of the user who will own the installation.

    The default user is fuse.

    [Note]Note

    If the specified user does not exist, the installer will create it.

    [Important]Important

    On OS X, you need to set the password for this user in System Preferences.

    [Warning]Warning

    On RHEL the default user name conflicts with the preconfigured fuse user. You will need to change the user name.

  15. Enter the name of the user group who will have read, write, and execute privileges for the installation.

    The default group is fusesource.

    [Note]Note

    If the specified group does not exist, the installer will create it and add the owner to it.

  16. Click Next>.

  17. Select whether or not to install server as a system service.

  18. Click Next>.

  19. If installing on Windows, enter the password for the user you specified in Step 14.

  20. Click Next>.

  21. When the installation completes, you can choose to view the README file.

  22. Click Finish to exit the installer.

[Note]Note

Text mode is not available on Windows.

To install in a command terminal:

  1. Open a command terminal.

  2. If you are using OS X, mount the installer's disk image.

  3. If you are using Unix or Linux, change to the directory into which you downloaded the installer.

  4. Enter the appropriate command for your platform:

  5. If you encounter a warning about recommended system requirements, press Enter to continue.

    [Note]Note

    You should evaluate the decision to install on this system. It is likely not going to perform well for mission critical applications.

  6. Read the Red Hat license agreement.

    Press Enter for a new screen of text. Repeat this until you reach the end of the license.

  7. Enter y when asked to accept the license agreement.

  8. Press Enter to accept the agreement and continue with the installation.

  9. Read the Third Party license agreement.

    Press Enter for a new screen of text. Repeat this until you reach the end of the license.

  10. Enter y when asked to accept the license agreement.

  11. Press Enter to accept the agreement and continue with the installation.

  12. Specify the location for the installation.

    The default locations are:

    OS X/Applications/FuseESBEnterprise-7.1.x
    Unix/Linux/opt/FuseESBEnterprise-7.1.x
  13. Select the installation type by entering the number for the desired type.

    For more information on installation types see Installation Types.

  14. Press Enter to accept the installation type.

  15. Specify the user account that will own the installation.

    The default user is fuse.

    [Note]Note

    If the specified user does not exist, the installer will create it.

    [Important]Important

    On OS X, you need to set the password for this user in System Preferences before this user can start up and run Fuse ESB Enterprise.

    [Warning]Warning

    On RHEL the default user name conflicts with the preconfigured fuse user. You will need to change the user name.

  16. Enter the name of the user group who will have read, write, and execute privileges for the installation.

    The default group is fusesource.

    [Note]Note

    If the specified group does not exist, the installer will create it and add the owner to it.

  17. Specify if you would like to install the server as a system service.

      • Press y to install the server as a system service.

      • Press N to install the server as a system service.

    1. Press Enter to confirm your choice.

  18. Press Enter to start installing on your computer.

  19. When the installer finishes:

    • Press y then Enter to exit the installer and view the README file.

    • Press n then Enter to exit the installer without viewing the README file.

[Important]Important

Installing with the archive does not ensure that your environment is properly configured or install Fuse ESB Enterprise as a system service.

Fuse ESB Enterprise is packaged either as a .zip file (Windows) or a .tar.gz file. Using a suitable archive tool, such as Zip or Gunzip, unpack Fuse ESB Enterprise into a directory to which you have full access.

[Warning]Warning

Do not unpack the archive file into a folder that has spaces in its path name. For example, do not unpack into C:\Documents and Settings\Greco Roman\Desktop\fusesrc.

Fuse ESB Enterprise is not installed with a default user for the remote console. Before you can remotely manage a server, you must add a user by editing InstallDir/etc/user.properties.

[Important]Important

The information in this file is unencrypted so it is not suitable for environments that require strict security.

To add a user:

If you used the installer, you can run the uninstaller in GUI or console mode to automate the removal of Fuse ESB Enterprise.

If you installed from an archive file, you can simply delete the installation directory from your system.

[Caution]Caution

Removing Fuse ESB Enterprise from a system also removes all data associated with the Fuse ESB Enterprise installation, including persistence stores and log files.

To uninstall: