Fuse ESB Enterprise 7.0 Installation Guide

Fuse ESB Enterprise 7.0 Installation Guide Installing and uninstalling Fuse ESB Enterprise 7.0 Edition 1 Red Hat Inc.

Fuse ESB Enterprise 7.0 Installation Guide Installing and uninstalling Fuse ESB Enterprise 7.0 Edition 1 Red Hat Inc.

Legal Notice Copyright 2012 Red Hat, Inc. T his document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark of Oracle and/or its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. T he OpenStack Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Abstract T his manual describes installation prerequisites, installation using the installer, installation using an archive file, adding a console user, and uninstallation.

Table of Contents Table of Contents. Preface........................................................................................... 3.......... 1. Document Conventions 3 1.1. T ypographic Conventions 3 1.2. Pull-quote Conventions 4 1.3. s and Warnings 5. Chapter......... 1... Installation............ Prerequisites.................................................................... 6.......... 1.1. Supported platforms 6 1.2. Java Runtime 6 1.3. Hardware requirements 6. Chapter......... 2... Installing.......... Fuse...... ESB..... Enterprise........... Using...... the.... Installer...................................... 7.......... 2.1. Installing in GUI Mode 7 2.1.1. Overview 7 2.1.2. Procedure 7 2.2. Installing in Text Mode 8 2.2.1. Overview 8 2.2.2. Procedure 9 2.3. Getting the installer 10 2.4. Installer modes 10 2.5. Installation T ypes 11. Chapter......... 3... Installing.......... Fuse..... ESB..... Enterprise............ from..... an... Archive........ File............................... 12........... 3.1. Getting the archive 12 3.2. Unpacking the archive 12. Chapter......... 4.. Adding........ a.. Remote........ Console......... User.................................................... 13........... 4.1. Overview 13 4.2. Procedure 13. Chapter......... 5... Uninstalling............. Fuse..... ESB..... Enterprise....................................................... 14............ 5.1. Overview 14 5.2. Procedure 14 1

2 Fuse ESB Enterprise 7.0 Installation Guide

Preface Preface 1. Document Conventions T his manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. In PDF and paper editions, this manual uses typefaces drawn from the Liberation Fonts set. T he Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. : Red Hat Enterprise Linux 5 and later include the Liberation Fonts set by default. 1.1. Typographic Conventions Four typographic conventions are used to call attention to specific words and phrases. T hese conventions, and the circumstances they apply to, are as follows. Mono-spaced Bold Used to highlight system input, including shell commands, file names and paths. Also used to highlight keys and key combinations. For example: T o see the contents of the file m y_next_bestselling_novel in your current working directory, enter the cat m y_next_bestselling_novel command at the shell prompt and press Enter to execute the command. The above includes a file name, a shell command and a key, all presented in mono-spaced bold and all distinguishable thanks to context. Key combinations can be distinguished from an individual key by the plus sign that connects each part of a key combination. For example: Press Enter to execute the command. Press Ctrl+Alt+F2 to switch to a virtual terminal. T he first example highlights a particular key to press. T he second example highlights a key combination: a set of three keys pressed simultaneously. If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in m ono-spaced bold. For example: File-related classes include filesystem for file systems, file for files, and dir for directories. Each class has its own associated set of permissions. Proportional Bold T his denotes words or phrases encountered on a system, including application names; dialog-box text; labeled buttons; check-box and radio-button labels; menu titles and submenu titles. For example: Choose System Preferences Mouse from the main menu bar to launch Mouse Preferences. In the Buttons tab, select the Left-handed m ouse check box and click Close to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand). 3

Fuse ESB Enterprise 7.0 Installation Guide T o insert a special character into a gedit file, choose Applications Accessories Character Map from the main menu bar. Next, choose Search Find from the Character Map menu bar, type the name of the character in the Search field and click Next. T he character you sought will be highlighted in the Character T able. Double-click this highlighted character to place it in the T ext to copy field and then click the Copy button. Now switch back to your document and choose Edit Paste from the gedit menu bar. T he above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all distinguishable by context. Mono-spaced Bold Italic or Proportional Bold Italic Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variable text. Italics denotes text you do not input literally or displayed text that changes depending on circumstance. For example: T o connect to a remote machine using ssh, type ssh username@ domain.name at a shell prompt. If the remote machine is example.com and your username on that machine is john, type ssh john@ exam ple.com. T he m ount -o rem ount file-system command remounts the named file system. For example, to remount the /home file system, the command is mount -o remount /home. T o see the version of a currently installed package, use the rpm -q package command. It will return a result as follows: package-version-release. the words in bold italics above: username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system. Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example: Publican is a DocBook publishing system. 1.2. Pull-quote Conventions T erminal output and source code listings are set off visually from the surrounding text. Output sent to a terminal is set in mono-spaced roman and presented thus: books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs Source-code listings are also set in m ono-spaced rom an but add syntax highlighting as follows: 4

Preface package org.jboss.book.jca.ex1; import javax.naming.initialcontext; public class ExClient { public static void main(string args[]) throws Exception { InitialContext inictx = new InitialContext(); Object ref = inictx.lookup("echobean"); EchoHome home = (EchoHome) ref; Echo echo = home.create(); System.out.println("Created Echo"); } } System.out.println("Echo.echo('Hello') = " + echo.echo("hello")); 1.3. s and Warnings Finally, we use three visual styles to draw attention to information that might otherwise be overlooked. s are tips, shortcuts or alternative approaches to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier. Important Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring a box labeled Important will not cause data loss but may cause irritation and frustration. Warning Warnings should not be ignored. Ignoring warnings will most likely cause data loss. 5

Fuse ESB Enterprise 7.0 Installation Guide Chapter 1. Installation Prerequisites 1.1. Supported platforms FuseSource tests and supports Fuse products on the platforms listed at http://fusesource.com/downloads/platforms-supported/. 1.2. Java Runtime To run Fuse ESB Enterprise, you need Java 6 and JRE 1.6.0_18 or later. To develop applications for Fuse ESB Enterprise, you need Java 6, JDK 1.6.0_18 or later. Non-Oracle Java distributions Fuse ESB Enterprise is only guaranteed to run with Java runtimes distributed by, or OEMed from, Oracle and IBM. 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. 1.3. Hardware requirements T he minimum hardware specifications to install Fuse ESB Enterprise are: 100MB of free disk space 2GB of RAM In addition to the disk space required for the base installation, a running system will require space for caching, persistent message stores, and other functions. 6

Chapter 2. Installing Fuse ESB Enterprise Using the Installer Chapter 2. Installing Fuse ESB Enterprise Using the Installer 2.1. Installing in GUI Mode 2.1.1. Overview GUI mode is the installer's default mode. In this mode, the installer runs as a wizard that asks you questions about the system and how you would like the system set up for Fuse ESB Enterprise. It then installs Fuse ESB Enterprise using the information provided. 2.1.2. Procedure To install Fuse ESB Enterprise in GUI mode: 1. If you are installing on OS X, mount the installer's disk image. 2. Double-click the installer. a. If a dialog appears asking whether the application is safe to open, authorize the application to run. b. If prompted, enter your username and password. c. If you encounter a warning about the system not meeting the recommended requirements, click OK. You should evaluate the decision to install Fuse ESB Enterprise 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>. On Linux systems Forward is used in place of Next>. 4. Read the FuseSource license agreement. 5. Click the box next to I accept the agreem ent. 6. Click Next>. 7. Read the third party license agreement. 8. Click the box next to I accept the agreem ent. 9. Click Next>. 10. Enter a location for Fuse ESB Enterprise to be installed. T he default locations are: OS X Tip Unix/Linux /Applications/FuseESBEnterprise- 7.0.1 /opt/fuseesbenterprise-7.0.1 7

Fuse ESB Enterprise 7.0 Installation Guide Clicking the folder icon will open a file explorer. 11. Click Next>. 12. Select the installation type. For more information on installation types see Section 2.5, Installation T ypes. 13. Click Next>. 14. Enter the name of the user who will own the Fuse ESB Enterprise installation. The default user is fuse. If the specified user does not exist, the installer will create it. 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. 15. Enter the name of the user group who will have read, write, and execute privileges for the Fuse ESB Enterprise installation. T he default group is fusesource. If the specified group does not exist, the installer will create it and add the owner to it. 16. Click Next>. 17. If installing on Windows, enter the password for the user you specified in Step 14. 18. Click Next>. 19. When the installation completes, you can choose to view the README file. 20. Click Finish to exit the installer. 2.2. Installing in Text Mode 2.2.1. Overview On Unix, Linux, and OS X you can run the Fuse ESB Enterprise installer in text mode. In this mode the installer runs in a terminal and does not require a windowing system. Text mode is fully interactive and requires some basic information about the system from the user. Text mode is not available on Windows. 8

Chapter 2. Installing Fuse ESB Enterprise Using the Installer 2.2.2. Procedure To install Fuse ESB Enterprise 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: OS X Unix/Linux 32-bit Unix/Linux 64-bit sudo /Volum es/fuse-esb- Enterprise-X.X.X.fuse-xxx-osxinstaller.dm g/fuse-esb-enterprise- 7.0.0.fuse-00-061-osxinstaller.app/Contents/MacOS/osxintel --m ode text./fuse-esb- Enterprise-X.X.X.fuse-xxx-linuxinstaller.run --m ode text./fuse-esb- Enterprise-X.X.X.fuse-xxx-linuxx64-installer.run --m ode text 5. If you encounter a warning about recommended system requirements, press Enter to continue. You should evaluate the decision to install Fuse ESB Enterprise on this system. It is likely not going to perform well for mission critical applications. 6. Read the FuseSource 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 T hird 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 where Fuse ESB Enterprise will be installed. T he default locations are: OS X Unix/Linux /Applications/FuseMQEnterprise- 7.0.1 /opt/fusemqenterprise-7.0.1 13. Select the installation type by entering the number for the desired type. For more information on installation types see Section 2.5, Installation T ypes. 14. Press Enter to accept the installation type. 15. Specify the user account that will own the Fuse ESB Enterprise installation. The default user is fuse. 9

Fuse ESB Enterprise 7.0 Installation Guide If the specified user does not exist, the installer will create it. 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. 16. Enter the name of the user group who will have read, write, and execute privileges for the Fuse ESB Enterprise installation. T he default group is fusesource. If the specified group does not exist, the installer will create it and add the owner to it. 17. Press y. 18. Press Enter to start installing Fuse ESB Enterprise on your computer. 19. When the installer finishes: A. Press y then Enter to exit the installer and view the README file. B. Press n then Enter to exit the installer without viewing the README file. 2.3. Getting the installer You can download the Fuse ESB Enterprise installer from the FuseSource Web site at http://fusesource.com/products/fuse-esb-enterprise. Be sure that you select the proper download for the intended platform. 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. 2.4. Installer modes Fuse ESB Enterprise is installed using a smart installer that 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 T ext mode useful when you do not have a windowing system available because the installer runs in the command terminal 10

Chapter 2. Installing Fuse ESB Enterprise Using the Installer Text mode is not available on Windows. Alternatively, you can download the Fuse ESB Enterprise archive file and unpack it onto your system. T his is a useful approach for developer installations. See Chapter 3, Installing Fuse ESB Enterprise from an Archive File. 2.5. Installation Types T he installer allows you to choose the features included in the Fuse ESB Enterprise installation. You have three choices for the set of features initially installed: Minimal installs Apache Karaf, Apache Camel core, and selected Apache Camel components Medium installs Apache Karaf, Apache Camel, and Apache ActiveMQ Full installs Apache Karaf, Apache Camel, Apache ActiveMQ Apache CXF and the JBI components 11

Fuse ESB Enterprise 7.0 Installation Guide Chapter 3. Installing Fuse ESB Enterprise from an Archive File 3.1. Getting the archive You can download the Fuse ESB Enterprise archive from the FuseSource Web site at http://fusesource.com/products/fuse-esb-enterprise. Be sure that you select the proper download for the intended platform. Installing with the archive does not ensure that your environment is properly configured or install Fuse ESB Enterprise as a system service. 3.2. Unpacking the archive 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 Do not unpack the archive file into a folder that has spaces in its path name. For example, do not unpack into C:\Docum ents and Settings\Greco Rom an\desktop\fusesrc. After unpacking Fuse ESB Enterprise and checking the prerequisites, you are now ready to use the product. See Fuse ESB Enterprise 7.0 Product Introduction for more details. 12

Chapter 4. Adding a Remote Console User Chapter 4. Adding a Remote Console User 4.1. Overview To ensure that Fuse ESB Enterprise is as secure as possible, it is not installed with a default user for the remote console. T his means that you cannot remotely access the container's command console unless you add a user to the security configuration before launching a container. T he default user is configured by editing the InstallDir/etc/user.properties file. T he information in this file is unencrypted so it is not suitable for environments that require strict security. 4.2. Procedure To add a default user: 1. Open InstallDir/etc/user.properties in your favorite text editor. 2. Locate the line # adm in=som epass,adm in. This line specifies a user admin with the password somepass and the role admin. 3. Uncomment the line by removing the leading #. 4. Change the first admin to the desired user name. 5. Change the som epass to the desired password. 6. Save the changes. 13

Fuse ESB Enterprise 7.0 Installation Guide Chapter 5. Uninstalling Fuse ESB Enterprise 5.1. Overview 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 Fuse ESB Enterprise by unpacking an archive file, you can simply delete Apache ActiveMQ's Caution installation directory from your system. Removing Fuse ESB Enterprise from a system also removes all data associated with the Fuse ESB Enterprise installation, including persistence stores and log files. 5.2. Procedure T o uninstall Fuse ESB Enterprise: 1. Run the uninstaller. A. In GUI mode: a. Locate the uninstaller in installdir/fuseesbenterprise-x.x.x. b. Double-click the uninstaller. B. In text mode enter the appropriate command for your platform: OS X Unix/Linux 2. If prompted, provide the necessary credentials to run the uninstaller. sudo installdir/fuseesbenterprise-x.x.x /uninstall.app/contents/macos/uni nstall osx-intel --m ode text sudo installdir/fuseesbenterprise-x.x.x /uninstall --m ode text 3. Confirm that you want to uninstall Fuse ESB Enterprise and all of its modules. A. In GUI mode, click Yes. B. In text mode: a. Press y. b. Press Enter. 14