Ce contenu n'est pas disponible dans la langue sélectionnée.
Installing on JBoss EAP
Install Fuse 7.3 on JBoss EAP 7.2
Abstract
Chapter 1. Install Fuse on JBoss EAP Copier lienLien copié sur presse-papiers!
1.1. Prerequisites Copier lienLien copié sur presse-papiers!
Before you install Fuse on JBoss EAP:
- You must have installed a supported version of a Java runtime. For details of which Java runtimes are supported on different operating systems, see Red Hat Fuse Supported Configurations.
- (Optional) We recommend that you use Maven with Red Hat Fuse projects. For information about preparing to use Maven, see Appendix A, Preparing to use Maven.
Fuse on JBoss EAP is not supported with Domain mode.
1.2. Install JBoss EAP using the Installer Copier lienLien copié sur presse-papiers!
Download the Red Hat JBoss Enterprise Application Platform 7.2.0 on EAP Installer package:
- Browse to the Enterprise Application Platform Software Downloads page on the Red Hat Customer Portal and, when prompted, log in to your customer account.
-
Select version
7.2from theVersiondropdown menu and click theDownloadlink for the Red Hat JBoss Enterprise Application Platform 7.2.0 Installer package.
Run the downloaded installer with the following command:
java -jar DOWNLOAD_LOCATION/jboss-eap-7.2.0-installer.jar
java -jar DOWNLOAD_LOCATION/jboss-eap-7.2.0-installer.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow During installation:
- Accept the terms and conditions.
-
Choose your preferred installation path,
EAP_HOME, for the JBoss EAP runtime. - Create an administrative user and make a careful note of these administrative user credentials for later.
- You can accept the default settings on the remaining screens.
- Check the Enterprise Application Platform Software Downloads page for any recent patches that might need to be applied to JBoss EAP 7.2. Check also the Red Hat Fuse Supported Configurations page for any notes or advice on the compatibility of JBoss EAP patches with Red Hat Fuse. If appropriate, install the relevant JBoss EAP patch.
For more detailed instructions on installing JBoss EAP, see JBoss EAP 7.2 Installation Guide.
1.3. Install Fuse on JBoss EAP using the Installer Copier lienLien copié sur presse-papiers!
Download the Red Hat Fuse 7.3 on EAP Installer package:
- Browse to the Red Hat Fuse Software Downloads page on the Red Hat Customer Portal and, when prompted, log in to your customer account.
-
Select version
7.3.0from theVersiondropdown menu and click theDownloadlink for the Red Hat Fuse 7.3.0 on EAP Installer package.
-
Open a shell prompt (or a command prompt on Windows) and change directory to
EAP_HOME, the root directory of the fresh Red Hat JBoss Enterprise Application Platform installation. Run the downloaded installer with the following command (this command must run in the
EAP_HOMEdirectory):java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.3.0.fuse-730055-redhat-00001.jar
java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.3.0.fuse-730055-redhat-00001.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow - The installer runs without prompting and logs its activity to the screen.
Chapter 2. Start and Stop the Application Server Copier lienLien copié sur presse-papiers!
You need to start the JBoss Enterprise Application Platform instance for Fuse to run. This is because the Fuse components run on the JBoss Enterprise Application Platform container.
Fuse on JBoss EAP is not supported with Domain mode.
For more information about starting and stopping JBoss Enterprise Application Platform using alternative and more advanced methods, see the Red Hat JBoss Enterprise Application Platform Configuration Guide.
2.1. Start JBoss EAP 7.2 Copier lienLien copié sur presse-papiers!
Start JBoss EAP 7.2 as a standalone server.
Start the Platform Service as a Standalone Server
For Red Hat Enterprise Linux:
Run the command:
EAP_HOME/bin/standalone.shFor Microsoft Windows Server:
Run the command:
EAP_HOME\bin\standalone.batOptionally specify additional parameters:
To print a list of additional parameters to pass to the start-up scripts, use the
-hparameter.
2.2. Stop JBoss EAP 7.2 Copier lienLien copié sur presse-papiers!
Stop JBoss EAP using the Management CLI or by pressing CTRL+C in the terminal.
To stop JBoss EAP using the Management CLI:
Launch the Management CLI by running the
EAP_HOME/bin/jboss-cli.shcommand:EAP_HOME/bin/jboss-cli.sh
$ EAP_HOME/bin/jboss-cli.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow Connect to the server by running the
connectcommand:[disconnected /] connect
[disconnected /] connectCopy to Clipboard Copied! Toggle word wrap Toggle overflow Stop the server by running the
shutdowncommand:[standalone@localhost:9999 /] shutdown
[standalone@localhost:9999 /] shutdownCopy to Clipboard Copied! Toggle word wrap Toggle overflow Close the Management CLI by running the
quitcommand:[standalone@localhost:9999 /] quit
[standalone@localhost:9999 /] quitCopy to Clipboard Copied! Toggle word wrap Toggle overflow
To stop JBoss EAP by pressing CTRL+C:
- Navigate to the terminal where JBoss EAP is running.
- Press Ctrl+C to stop JBoss Enterprise Application Platform.
Chapter 3. Verify Your Red Hat Fuse Installation Copier lienLien copié sur presse-papiers!
After completing the Fuse installation, you can verify the installation by performing the following steps:
Start the JBoss EAP server:
./bin/standalone.sh
./bin/standalone.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
Open the
standalone/log/server.logfile to check if any error messages have been logged. Open the Fuse Management Console (http://localhost:8080/hawtio) in a browser.
- Sign in using the administrative user that you set up on the JBoss EAP installer.
- If the Fuse Management Console runs and you can log in then the installation has been successful.
Chapter 4. Adding Users Copier lienLien copié sur presse-papiers!
To add new users to Fuse on JBoss EAP, use the add-user utility script provided with JBoss EAP.
-
Navigate to
EAP_HOME/bin. -
Run the
add-userutility script. Follow the on-screen instructions to create a new user, noting that:
- Management User is an administrative user of Fuse on JBoss EAP.
- Application User is a regular user of Fuse on JBoss EAP.
Appendix A. Preparing to use Maven Copier lienLien copié sur presse-papiers!
A.1. Overview Copier lienLien copié sur presse-papiers!
This section gives a brief overview of how to prepare Maven for building Red Hat Fuse projects and introduces the concept of Maven coordinates, which are used to locate Maven artifacts.
A.2. Prerequisites Copier lienLien copié sur presse-papiers!
In order to build a project using Maven, you must have the following prerequisites:
- Maven installation — Maven is a free, open source build tool from Apache. You can download the latest version from the Maven download page.
Network connection — whilst performing a build, Maven dynamically searches external repositories and downloads the required artifacts on the fly. By default, Maven looks for repositories that are accessed over the Internet. You can change this behavior so that Maven will prefer searching repositories that are on a local network.
NoteMaven can run in an offline mode. In offline mode Maven only looks for artifacts in its local repository.
A.3. Adding the Red Hat Maven repositories Copier lienLien copié sur presse-papiers!
In order to access artifacts from the Red Hat Maven repositories, you need to add them to Maven’s settings.xml file. Maven looks for your settings.xml file in the .m2 directory of the user’s home directory. If there is not a user specified settings.xml file, Maven will use the system-level settings.xml file at M2_HOME/conf/settings.xml.
To add the Red Hat repositories to Maven’s list of repositories, you can either create a new .m2/settings.xml file or modify the system-level settings. In the settings.xml file, add repository elements for the Red Hat repositories as shown in Adding the Red Hat Fuse Repositories to Maven.
Adding the Red Hat Fuse Repositories to Maven
A.4. Artifacts Copier lienLien copié sur presse-papiers!
The basic building block in the Maven build system is an artifact. The output of an artifact, after performing a Maven build, is typically an archive, such as a JAR or a WAR.
A.5. Maven coordinates Copier lienLien copié sur presse-papiers!
A key aspect of Maven functionality is the ability to locate artifacts and manage the dependencies between them. Maven defines the location of an artifact using the system of Maven coordinates, which uniquely define the location of a particular artifact. A basic coordinate tuple has the form, {groupId, artifactId, version}. Sometimes Maven augments the basic set of coordinates with the additional coordinates, packaging and classifier. A tuple can be written with the basic coordinates, or with the additional packaging coordinate, or with the addition of both the packaging and classifier coordinates, as follows:
groupdId:artifactId:version groupdId:artifactId:packaging:version groupdId:artifactId:packaging:classifier:version
groupdId:artifactId:version
groupdId:artifactId:packaging:version
groupdId:artifactId:packaging:classifier:version
Each coordinate can be explained as follows:
- groupdId
-
Defines a scope for the name of the artifact. You would typically use all or part of a package name as a group ID — for example,
org.fusesource.example. - artifactId
- Defines the artifact name (relative to the group ID).
- version
-
Specifies the artifact’s version. A version number can have up to four parts:
n.n.n.n, where the last part of the version number can contain non-numeric characters (for example, the last part of1.0-SNAPSHOTis the alphanumeric substring,0-SNAPSHOT). - packaging
-
Defines the packaged entity that is produced when you build the project. For OSGi projects, the packaging is
bundle. The default value isjar. - classifier
- Enables you to distinguish between artifacts that were built from the same POM, but have different content.
The group ID, artifact ID, packaging, and version are defined by the corresponding elements in an artifact’s POM file. For example:
For example, to define a dependency on the preceding artifact, you could add the following dependency element to a POM:
It is not necessary to specify the bundle package type in the preceding dependency, because a bundle is just a particular kind of JAR file and jar is the default Maven package type. If you do need to specify the packaging type explicitly in a dependency, however, you can use the type element.