PK
anLAoa, mimetypeapplication/epub+zipPK
anLA META-INF/PK
anLA OEBPS/PK
anLA
OEBPS/images/PK
anLA OEBPS/imagesdb/PK
`nLAh h META-INF/container.xml
To ensure that Fuse MQ Enterprise is as secure as possible, it is not installed with a default user for the remote console. This means that you cannot remotely access the broker's command console unless you add a user to the security configuration before launching a broker instance.
The default user is configured by editing the
file.
The information in this file is unencrypted so it is not suitable for environments that
require strict security.InstallDir/etc/user.properties
To add a default user:
Open
in your favorite text editor.InstallDir/etc/user.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.
Once the installer has completed running it is a good idea to run a simple test to ensure that Fuse MQ Enterprise was properly installed.
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 5.1 shows the producer's output.
Example 5.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 5.2 shows the consumer's output.
Example 5.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.
You can download the Fuse MQ Enterprise installer from the FuseSource Web site at http://fusesource.com/products/fuse-mq-enterprise.
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. |
Fuse MQ 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
Text mode—useful when you do not have a windowing system available because the installer runs in the command terminal
![]() | Note |
|---|---|
Text mode is not available on Windows. |
Alternatively, you can download the Fuse MQ Enterprise archive file and unpack it onto your system. This is a useful approach for developer installations. See Installing Fuse MQ Enterprise from an Archive File.
On Unix, Linux, and OS X you can run the Fuse MQ 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.
![]() | Note |
|---|---|
Text mode is not available on Windows. |
To install Fuse MQ Enterprise 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:
| OS X | sudo /Volumes/Fuse-MQ-Enterprise- |
| Unix/Linux 32-bit | ./Fuse-MQ-Enterprise- |
| Unix/Linux 64-bit | ./Fuse-MQ-Enterprise- |
If you encounter a warning about recommended system requirements, press Enter to continue.
![]() | Note |
|---|---|
You should evaluate the decision to install Fuse MQ Enterprise on this system. It is likely not going to perform well for mission critical applications. |
Read the FuseSource 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 where Fuse MQ Enterprise will be installed.
The default locations are:
| OS X | /Applications/FuseMQEnterprise-7.0.1 |
| Unix/Linux | /opt/FuseMQEnterprise-7.0.1 |
Specify the user account that will own the Fuse MQ Enterprise 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. |
Enter the name of the user group who will have read, write, and execute privileges for the Fuse MQ Enterprise 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. |
Press y.
Press Enter to start installing Fuse MQ Enterprise 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.
You can download the Fuse MQ Enterprise archive from the FuseSource Web site at http://fusesource.com/products/fuse-mq-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 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
|
After unpacking Fuse MQ Enterprise and checking the prerequisites, you are now ready to use the product. See Product Introduction for more details.
FuseSource tests and supports Fuse products on the platforms listed at http://fusesource.com/downloads/platforms-supported/.
To run Fuse MQ Enterprise, you need Java 6, JRE 1.6.0_18 or later.
To develop applications for Fuse MQ Enterprise, you need Java 6, JDK 1.6.0_18 or later.
![]() | Non-Oracle Java distributions |
|---|---|
Fuse MQ 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 |
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 Fuse MQ Enterprise by unpacking an archive file, you can simply delete Fuse MQ Enterprise's 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 Fuse MQ Enterprise:
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.
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 MQ Enterprise. It then installs Fuse MQ Enterprise using the information provided.
To install Fuse MQ Enterprise 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 Fuse MQ 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.
Click .
![]() | Note |
|---|---|
On Linux systems is used in place of . |
Read the FuseSource 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 Fuse MQ Enterprise to be installed.
The default locations are:
| OS X | /Applications/FuseMQEnterprise-7.0.1 |
| Unix/Linux | /opt/FuseMQEnterprise-7.0.1 |
![]() | Tip |
|---|---|
Clicking the folder icon will open a file explorer. |
Click .
Enter the name of the user who will own the Fuse MQ Enterprise 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. |
Enter the name of the user group who will have read, write, and execute privileges for the Fuse MQ Enterprise 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 .
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.
Table of Contents
List of Examples
