Version 7.1
Copyright © 2012 Red Hat, Inc. and/or its affiliates.
Updated: 07 Jan 2014
Table of Contents
List of Examples
The Fuse products are tested and supported on the platforms listed at http://fusesource.com/downloads/platforms-supported/.
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.
![]() | Non-Oracle Java distributions |
|---|---|
Fuse products are 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 |
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 |
|---|---|
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:
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:
If you are installing on OS X, mount the installer's disk image.
Double-click the installer.
If a dialog appears asking whether the application is safe to open, authorize the application to run.
If prompted, enter your username and password.
If you encounter a warning about the system not meeting the recommended requirements, click .
![]() | 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.
Click .
![]() | Note |
|---|---|
On Linux systems is used in place of . |
Read the Red Hat license agreement.
Click the box next to I accept the agreement.
Click .
Read the third party license agreement.
Click the box next to I accept the agreement.
Click .
Enter a location for the installation.
The default locations are:
| OS X | /Applications/FuseMQEnterprise-7.1. |
| Unix/Linux | /opt/FuseMQEnterprise-7.1. |
![]() | Tip |
|---|---|
Clicking the folder icon will open a file explorer. |
Click .
Enter the name of the user who will own the installation.
The default user is fuse.
![]() | Note |
|---|---|
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. |
![]() | Warning |
|---|---|
On RHEL the default user name conflicts with the preconfigured
|
Enter the name of the user group who will have read, write, and execute privileges for the installation.
The default group is fusesource.
![]() | Note |
|---|---|
If the specified group does not exist, the installer will create it and add the owner to it. |
Click .
Select whether or not to install server as a system service.
Click .
If installing on Windows, enter the password for the user you specified in Step 12.
Click .
When the installation completes, you can choose to view the README file.
Click to exit the installer.
![]() | Note |
|---|---|
Text mode is not available on Windows. |
To install in a command terminal:
Open a command terminal.
If you are using OS X, mount the installer's disk image.
If you are using Unix or Linux, change to the directory into which you downloaded the installer.
Enter the appropriate command for your platform:
sudo /Volumes/Fuse-MQ-Enterprise-X.X.X.fuse-xxx-osx-installer.dmg/Fuse-ESB-Enterprise-7.0.0.fuse-00-061-osx-installer.app/Contents/MacOS/osx-intel --mode text./Fuse-MQ-Enterprise-X.X.X.fuse-xxx-linux-installer.run --mode text./Fuse-MQ-Enterprise-X.X.X.fuse-xxx-linux-x64-installer.run --mode textIf you encounter a warning about recommended system requirements, press Enter to continue.
![]() | Note |
|---|---|
You should evaluate the decision to install on this system. It is likely not going to perform well for mission critical applications. |
Read the Red Hat license agreement.
Press Enter for a new screen of text. Repeat this until you reach the end of the license.
Enter y when asked to accept the license agreement.
Press Enter to accept the agreement and continue with the installation.
Read the Third Party license agreement.
Press Enter for a new screen of text. Repeat this until you reach the end of the license.
Enter y when asked to accept the license agreement.
Press Enter to accept the agreement and continue with the installation.
Specify the location for the installation.
The default locations are:
| OS X | /Applications/FuseMQEnterprise-7.1. |
| Unix/Linux | /opt/FuseMQEnterprise-7.1. |
Specify the user account that will own the installation.
The default user is fuse.
![]() | Note |
|---|---|
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 MQ Enterprise. |
![]() | Warning |
|---|---|
On RHEL the default user name conflicts with the preconfigured
|
Enter the name of the user group who will have read, write, and execute privileges for the installation.
The default group is fusesource.
![]() | Note |
|---|---|
If the specified group does not exist, the installer will create it and add the owner to it. |
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.
Press Enter to confirm your choice.
Press Enter to start installing on your computer.
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 |
|---|---|
Installing with the archive does not ensure that your environment is properly configured or install Fuse MQ Enterprise as a system service. |
Fuse MQ 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 MQ 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
|
Fuse MQ 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 |
|---|---|
The information in this file is unencrypted so it is not suitable for environments that require strict security. |
To add a user:
Open
in your favorite text editor.InstallDir/etc/users.properties
Locate the line # admin=somepass,admin.
This line specifies a user admin with the password
somepass and the role admin.
Uncomment the line by removing the leading #.
Change the first admin to the desired user name.
Change the somepass to the desired password.
Save the changes.
If you intend to use the ActiveMQ Web console, you must specify the credentials for it.
Open in
your favorite text editor and search for the following lines:InstallDir/etc/system.properties
# # Authentication - must match an entry in user.properties with the admin privilege # #activemq.jmx.user=admin #activemq.jmx.password=admin
Uncomment the activemq.jmx.user and activemq.jmx.password
settings (by removing the leading #) and change the username and password
values to be the same as the values you just defined in the
etc/users.properties file.
Fuse MQ Enterprise ships with a simple client utility that can be used to verify that the software was successfully installed. You use it to create a message producer and a message consumer that connect to the broker. If they run successfully, and you see—by checking the Web console—that the broker processed the messages, then you can be confident that Fuse MQ Enterprise was installed successfully.
To verify that Fuse MQ Enterprise is properly installed:
Log in as the user with ownership permissions for the Fuse MQ Enterprise installation.
Open a command shell at
.InstallDir
Start the broker using the start command.
| Windows | bin\start.bat |
| Unix | ./bin/start |
Run the producer client using
java -jar lib/mq-client.jar producer.
The producer will connect to the broker and produce 100 messages. Example 4.1 shows the producer's output.
Example 4.1. Test Producer Output
$java -jar lib/mq-client.jar producerUsing destination: queue://TEST, on broker: failover://tcp://localhost:61616 [org.apache.activemq.transport.failover.FailoverTransport] : Successfully connected to tcp://localhost:61616 [org.fusesource.mq.ProducerThread] : Sent 'test message: 0' [org.fusesource.mq.ProducerThread] : Sent 'test message: 1' [org.fusesource.mq.ProducerThread] : Sent 'test message: 2' [org.fusesource.mq.ProducerThread] : Sent 'test message: 3' [org.fusesource.mq.ProducerThread] : Sent 'test message: 4' ... [org.fusesource.mq.ProducerThread] : Sent 'test message: 99' [org.fusesource.mq.ProducerThread] : Producer thread finished Produced: 100$
Run the consumer client using
java -jar lib/mq-client.jar consumer.
The consumer will connect to the broker and consume 100 messages. Example 4.2 shows the consumer's output.
Example 4.2. Test Consumer Output
$java -jar lib/mq-client.jar consumerUsing destination: queue://TEST, on broker: failover://tcp://localhost:61616 [org.apache.activemq.transport.failover.FailoverTransport] : Successfully connected to tcp://localhost:61616 Waiting for: 100 messages [org.fusesource.mq.ConsumerThread] : Received test message: 0 [org.fusesource.mq.ConsumerThread] : Received test message: 1 [org.fusesource.mq.ConsumerThread] : Received test message: 2 [org.fusesource.mq.ConsumerThread] : Received test message: 3 [org.fusesource.mq.ConsumerThread] : Received test message: 4 ... [org.fusesource.mq.ConsumerThread] : Received test message: 99 [org.fusesource.mq.ConsumerThread] : Consumer thread finished Consumed: 100 messages$
In a Web browser, navigate to http://localhost:8181/activemqweb to open the
Fuse MQ Enterprise Web console.
Select from the main menu.
If Fuse MQ Enterprise was successfully installed, the console lists one queue named
TEST with 100 messages enqueued and 100 messages dequeued.
If you used the installer, you can run the uninstaller in GUI or console mode to automate the removal of Fuse MQ Enterprise.
If you installed from an archive file, you can simply delete the installation directory from your system.
![]() | Caution |
|---|---|
Removing Fuse MQ Enterprise from a system also removes all data associated with the Fuse MQ Enterprise installation, including persistence stores and log files. |
To uninstall:
Run the uninstaller.
In GUI mode:
Locate the uninstaller in
.installDir/FuseMQEnterprise-X.X.X
Double-click the uninstaller.
In text mode enter the appropriate command for your platform:
| OS X | sudo |
| Unix/Linux | sudo |
If prompted, provide the necessary credentials to run the uninstaller.
Confirm that you want to uninstall Fuse MQ Enterprise and all of its modules.
In GUI mode, click .
In text mode:
Press y.
Press Enter.