Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

起步指南

JBoss 企业级应用程序平台 6.4

适用于红帽 JBoss 企业版应用程序平台 6

Nidhi Chaudhary

Lucas Costi

Russell Dickenson

Sande Gilda

Vikram Goyal

Eamon Logue

Darrin Mison

Scott Mumford

David Ryan

Misty Stanley-Jones

Keerat Verma

Tom Wells

摘要

本书提供了 JBoss EAP 6 起步的基本步骤。

第 1 章 介绍

1.1. 关于 Red Hat JBoss 企业版应用程序平台 6

Red Hat JBoss 企业版应用程序平台 6(JBoss EAP 6)s是一个构建在开放标准上并和 Java EE 6 规格兼容的中间件平台。它集成了 JBoss Application Server 7 和高可用性的群集、消息系统、分布式缓存以及其他技术。
JBoss EAP 6 使用了新的模块化结构,允许在有需要时才启用服务,从而提高了启动速度。
管理控制台和管理命令行界面使您不需要再编辑 XML 配置文件并增添了使用脚本和自动化任务的能力。
此外,JBoss EAP 6 包含了 API 和开放框架以用于快速开发安全和可扩充的 Java EE 应用程序。

1.2. 关于 Red Hat 客户门户网站

Red Hat 客户门户(Customer Portal)是一个用于 Red Hat 知识和订阅资源的集中式平台。你可以使用 Red Hat 客户门户来完成:
  • 管理和维护 Red Hat 权利和支持合约。
  • 下载官方支持的软件。
  • 访问产品文档和 Red Hat 知识库。
  • 联系全球支持服务。
  • 报告 Red Hat 产品的程序错误。
客户门户位于:https://access.redhat.com

1.3. 关于 Red Hat JBoss Developer Program

Red Hat JBoss Developer Program ("the Program") 允许您免费地部署某些用于开放目的的红帽订阅。这个 Program 为您提供的红帽订阅是不享有支持服务的,可能也无法解决已知的安全性漏洞。它们只可以用于开发,不应用作其他用途(如产品环境或访问没有活动订阅的更新。关于 Red Hat JBoss Developer Program 的详情,请参考 http://www.jboss.org/developer-program/termsandconditions

1.4. 关于 Full Red Hat JBoss Commercial Program

Full Red Hat JBoss Commercial Program 允许您部署到产品环境。它为软件更新和补丁、支持服务、访问红帽知识库提供了额外的权利。要参与这个项目,您必须在客户门户 https://access.redhat.com/ 上创建一个帐号。关于这个项目的更多细节,请参考 第 1.2 节 “关于 Red Hat 客户门户网站”

1.5. 如何找到更多信息

本指南的目的是让您尽快熟悉并运行 Red Hat JBoss 企业级应用程序平台。如果您希望了解更多信息,请参考客户门户 https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform 上的 JBoss EAP 完整文档套件。

第 2 章 先决条件

2.1. JBoss EAP 6 的安装预备条件

概述

Red Hat JBoss Developer ProgramFull Red Hat JBoss Commercial Program 里 JBoss EAP 都是可用的。关于 Red Hat JBoss Developer Program 的更多信息,请参考 第 1.3 节 “关于 Red Hat JBoss Developer Program”。关于 Full Red Hat JBoss Commercial Program 的更多信息,请参考 第 1.4 节 “关于 Full Red Hat JBoss Commercial Program”。下列步骤描述了这两个项目的预备条件。

共同的预备条件

  • 请查看受支持的配置以确保您的系统是受支持的:https://access.redhat.com/site/articles/111663
  • 如果您在红帽客户门户上设立了一个帐号并参与了 Full Red Hat JBoss Commercial Program,请确保您的系统从红帽获得了最新的更新和勘误。

ZIP/安装程序的预备条件

  • 您必须具有对安装目录的管理权限。
  • 确保所选的 JDK 已解开(或已安装)。相关说明请参考 JDK 的文档。
  • 在 Microsoft Windows 里,确保设置了 JAVA_HOME 和 PATH 环境变量。
  • 在 Hewlett-Packard HP-UX 里,确保已经安装了unzip 工具。

第 3 章 下载和安装产品

3.1. JBoss EAP 安装概述

本指南提供了最简单的安装过程的说明,它可以帮助您尽快开始使用 JBoss EAP。你可以在《安装指南》里找到完整的安装说明。在安装了 JBoss EAP 后,您可以用管理 CLI 或管理控制台来配置服务器。关于如何配置 JBoss EAP 的信息,请参考《管理和配置指南》。这两本指南都位于客户门户 https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ 里。
您可以用下列方法之一安装 JBoss EAP:
  • 您可以使用图形化安装程序来安装 JBoss EAP。
  • 您也可以使用 ZIP 文件来安装 JBoss EAP。
根据您选定的安装方法进行安装。

3.2. 用图形化安装程序下载和安装 JBoss EAP

3.2.1. 下载 JBoss EAP 6 安装程序

概况

Red Hat JBoss Developer ProgramFull Red Hat JBoss Commercial Program 里 JBoss EAP 都是可用的。请按照符合您选择的项目的步骤进行安装。

过程 3.1. 从 Full Red Hat JBoss Commercial Program 里的客户门户下载 JBoss EAP 安装程序

如果您参与的是 Full Red Hat JBoss Commercial Program,请安装这个步骤进行。关于这个项目的详情,请参考 第 1.4 节 “关于 Full Red Hat JBoss Commercial Program”
  1. 打开浏览器并登录客户门户: https://access.redhat.com
  2. 点击 Downloads
  3. 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application Platform
  4. Version 下拉菜单里选择正确的 JBoss EAP 版本。
  5. 在列表里找到 Red Hat JBoss Enterprise Application Platform 6.x.x Installer 并点击 Download 选项。
  6. 系统会提示您保存 JAR 文件到所选的目录。选择一个目录并保存文件。

过程 3.2. 从 Red Hat JBoss Developer Program 里的 jboss.org 下载 JBoss EAP 安装程序

如果您参与的是 Red Hat JBoss Developer Program,请安装这个步骤进行。关于这个项目的详情,请参考 第 1.3 节 “关于 Red Hat JBoss Developer Program”
  1. 打开浏览器并访问这个 URL: http://www.jboss.org/products/eap
    • 要从当前的 GA 发布版本下载安装程序,请点击页面右侧的 Download 按钮。
    • 按照这些步骤来选择其他版本,如最新的 Alpha 和 Beta 版本,以及以前的版本。
      1. 点击页面左侧的 Download JBoss EAP 链接。
      2. 点击正确版本的 Download 下的 Installer 链接。
  2. 系统会提示您保存 JAR 文件到所选的目录。选择一个目录并保存文件。
结果

JBoss EAP 6 安装程序已成功下载到目标主机。

3.2.2. 运行 JBoss EAP 安装程序

JBoss EAP 安装程序可以以图形化或文本模式进行。本节介绍以图形模式运行安装程序的命令。
如果您不确定某个选项,请选择默认选项。之后您可以轻松修改服务器的配置。关于如何配置 JBoss EAP 服务器的更多信息,请参考客户门户 https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ 上的《管理和配置指南》

过程 3.3. 运行 JBoss EAP 安装程序

  1. 打开终端窗口并进入包含安装程序 JAR 文件的目录。
  2. 输入下列命令:
    java -jar jboss-eap-6.x.x-installer.jar
  3. 遵循下表中的说明。

表 3.1. JBoss EAP 安装程序屏幕

屏幕名称
何时出现
描述
总是
选择安装程序的语言并点击 OK
总是
用于 RED HAT JBOSS 中间件的 EULA。
选择 "I accept the terms of this license agreement" 并点击 Next
总是
选择安装路径并点击 Next。系统会提示您创建新的目录,或者是否覆盖已存在的目录。
总是
选择要安装的软件包。必需的软件包是禁止取消的。
总是
创建一个管理用户并设置密码。然后点击Next
总是
安装 Quickstart 例程。如果您要安装这些例程,请选择 Yes 以及安装路径。然后点击 Next
如果您选择安装 Quickstart 例程
保持默认的选择以自动配置默认的 Maven 选项并使用公开托管的 Maven 资料库。然后点击 Next
总是
保持默认的端口绑定,然后点击 Next
总是
选择完成安装过程后的首选启动选项。然后点击 Next
总是
选择 No 跳过日志级别的配置。然后点击 Next
总是
选择 Perform default configuration 并点击 Next 继续。
总是
复查您的选择并点击 Next
总是
当安装过程完成时,请点击 Next
总是
处理结束后,请点击 Next
总是
接受默认选项并点击 Next
总是
点击 Done
安装现已完成。
结果

安装完成,JBoss EAP 6 已安装在目标主机上。

3.3. 用 ZIP 方式下载和安装 JBoss EAP

3.3.1. 下载 JBoss EAP 6(ZIP 安装)

概况

Red Hat JBoss Developer ProgramFull Red Hat JBoss Commercial Program 里 JBoss EAP 都是可用的。请按照符合您选择的项目的步骤进行安装。

过程 3.4. 从 Full Red Hat JBoss Commercial Program 里的客户门户下载 ZIP 文件

如果您参与的是 Full Red Hat JBoss Commercial Program,请安装这个步骤进行。关于这个项目的详情,请参考 第 1.4 节 “关于 Full Red Hat JBoss Commercial Program”
  1. 打开浏览器并登录客户入口:https://access.redhat.com
  2. 点击 Downloads
  3. 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application Platform
  4. Version 下拉菜单里选择正确的 JBoss EAP 版本。
  5. 在列表里找到 Red Hat JBoss Enterprise Application Platform 6.x.x 并点击 Download 选项。
  6. 系统会提示您保存 ZIP 文件到所选的目录。选择一个目录并保存文件。

过程 3.5. 从 Full Red Hat JBoss Commercial Program 里的 jboss.org 下载 ZIP 文件

如果您参与的是 Red Hat JBoss Developer Program,请安装这个步骤进行。关于这个项目的详情,请参考 第 1.3 节 “关于 Red Hat JBoss Developer Program”
  1. 打开一个浏览器并访问这个 URL: http://www.jboss.org/products/eap/
  2. 点击页面左侧的 Download JBoss EAP 链接。
  3. 点击正确版本的 Download 下的 ZIP 链接。
  4. 系统会提示您保存 ZIP 文件到所选的目录。选择一个目录并保存文件。
结果

JBoss EAP 6 ZIP 文件已成功下载到目标主机。

3.3.2. 安装 JBoss EAP 6 的 ZIP 安装文件

概述

本节涵盖使用下载的 ZIP 文件安装 JBoss EAP 6 的步骤。

过程 3.6. 用 ZIP 文件安装

  1. 将 ZIP 归档移至到所需的位置。

    将 ZIP 文件移至您计划安装 EAP 6 的服务器和目录。将启动和停止平台的用户必须有这个目录的读和写权限。
  2. 使用合适的应用程序以解压 ZIP 归档文件到所选位置。

    在 Red Hat 企业版 Linux 环境下,请使用 unzip 工具来解压 ZIP 归档文件。
    在 Microsoft Windows 环境里,右击文件并选择 Extract All
    在 Hewlett-Packard HP-UX 环境下,请使用 unzip 工具来解压 ZIP 归档文件。
结果

JBoss EAP 6 安装已经成功安装。解压 ZIP 归档创建的目录是服务器的顶层目录,通常被称为 EAP_HOME/

3.4. 下载 Quickstart 例程

3.4.1. 下载 Quickstarts

概况

JBoss EAP 6 带有详尽的 quickstart 示例代码以帮助用户开始用 Java EE 6 技术编写应用程序。

如果您选择在安装 JBoss EAP 时就安装 Quickstart 例程,您可以跳过这个小节。否则,您现在可以在 Red Hat JBoss Developer ProgramFull Red Hat JBoss Commercial Program 里下载这些例程。请按照符合您选择的项目的步骤进行安装。

过程 3.7. 从 Full Red Hat JBoss Commercial Program 里下载 Quickstarts

如果您参与的是 Full Red Hat JBoss Commercial Program,请安装这个步骤进行。关于这个项目的详情,请参考 第 1.4 节 “关于 Full Red Hat JBoss Commercial Program”
  1. 打开浏览器并登录客户入口:https://access.redhat.com
  2. 点击 Downloads
  3. 点击 Product Downloads 列表里的 Red Hat JBoss Enterprise Application Platform
  4. Version 下拉菜单里选择正确的 JBoss EAP 版本。
  5. 在列表里找到 Red Hat JBoss Enterprise Application Platform 6.x.x Quickstarts 并点击 Download 选项。
  6. 系统会提示您保存 ZIP 文件到所选的目录。选择一个目录并保存文件。
  7. 解压归档文件到您选择的目录。

过程 3.8. 从 Red Hat JBoss Developer Program 里下载 Quickstarts

如果您参与的是 Red Hat JBoss Developer Program,请安装这个步骤进行。关于这个项目的详情,请参考 第 1.3 节 “关于 Red Hat JBoss Developer Program”
  1. 打开一个浏览器并访问这个 URL: http://www.jboss.org/products/eap/
  2. 点击页面左侧的 Download JBoss EAP 链接来显示产品下载信息。
  3. Download JBoss EAP 里,点击 Quickstarts 链接来下载包含例程的 ZIP 归档文件。
  4. 系统会提示您保存 ZIP 文件到所选的目录。选择一个目录并保存文件。
  5. 解压归档文件到您选择的目录。

第 4 章 Post-install 说明

4.1. 设立开发环境

4.1.1. Red Hat JBoss Developer Studio 安装概述

本指南提供了最简单的安装过程的说明,关于完整的安装过程,请参考 https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Developer_Studio/ 上 Red Hat JBoss Developer Studio 的 《安装指南》

4.1.2. 下载 Red Hat JBoss Developer Studio

  1. 点击 Download 按钮。系统会提示您保存 ZIP 文件到所选的目录。

4.1.3. 安装 Red Hat JBoss Developer Studio

  1. 打开终端窗口并进入包含下载的 .jar 文件的目录。
  2. 运行下列命令以启动 GUI 安装程序:
    java -jar jbdevstudio-build_version.jar

    注意

    或者,您可以双击 .jar 文件来启动安装程序。
  3. 点击 Next 来启动安装过程。
  4. 选择 I accept the terms of this license agreement 并点击 Next
  5. 调整安装路径并点击 Next

    注意

    如果安装路径文件夹不存在,将会有提示。请点击 Ok 创建这个文件夹。
  6. 选择 JVM,或者保留默认选择,然后点击 Next
  7. Red Hat JBoss Developer Studio 包含了 JBoss EAP。如果之前已安装它,请选择 No。否则,请选择 Yes 来安装和配置 JBoss EAP。
  8. 复查安装细节,然后点击 Next
  9. 当安装过程完成后点击 Next
  10. 为 Red Hat JBoss Developer Studio 配置快捷键,并点击 Next
  11. 点击 Done

4.1.4. 启动 Red Hat JBoss Developer Studio

要启动 Red Hat JBoss Developer Studio,您可以双击安装过程中创建的桌面快捷键,或者在命令行启动。本节将描述如何用命令行启动 Red Hat JBoss Developer Studio。

过程 4.1. 启动 Red Hat JBoss Developer Studio 的命令

  1. 打开终端窗口并进入 Red Hat JBoss Developer Studio 安装目录。
  2. 运行下列命令来启动 Red Hat JBoss Developer Studio:
    对于 Linux:
    [localhost]$ ./jbdevstudio
    对于 Microsoft Windows:
    C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

4.1.5. 通过『定义新服务器』添加 JBoss EAP 服务器

这些说明是假定您第一次使用 Red Hat JBoss Developer Studio 且没有添加任何 JBoss EAP 服务器。下面的过程将使用 Define New Server 向导来添加 JBoss EAP 服务器。

过程 4.2. 添加服务器

  1. 打开 Servers 标签页。如果没有 Servers 标签页,请用下列步骤添加至面板:
    1. 点击 WindowShow ViewOther...
    2. Server 文件夹选择 Servers 并点击 OK
  2. 点击 No servers are available. Click this link to create a new server...,或者如果需要的话,在 Server 面板空白处右击并选择 NewServer
    添加新的服务器 - 没有可用的服务器

    图 4.1. 添加新的服务器 - 没有可用的服务器

  3. 展开 JBoss Enterprise Middleware 并选择 JBoss Enterprise Application Platform 6.1+。输入服务器名称,如 "JBoss Enterprise Application Platform 6.4",然后点击 Next 来创建 JBoss runtime 并定义服务器。在下一次定义服务器的时候,这个对话框会显示Server runtime environment 下拉菜单,其中包含新的 runtime 定义。
    定义新的服务器

    图 4.2. 定义新的服务器

  4. 创建管理启动和停止服务器的服务器适配器。保持默认设置并点击 Next
    创建新的服务器适配器

    图 4.3. 创建新的服务器适配器

  5. 输入一个名称,如 "JBoss EAP 6.4 Runtime"。在 Home Directory 下,点击 Browse 并进入 JBoss EAP 的安装位置。然后点击 Next
    添加新的服务器 Runtime 环境

    图 4.4. 添加新的服务器 Runtime 环境

    注意

    某些 Quickstart 要求您用不同的配置集或其他参数来运行服务器。要部署要求 full 配置集的 Quickstart,您必须定义一个新的服务器并添加为 Configuration file 指定了 standalone-full.xmlServer Runtime Environment。请确保为新服务器取一个描述性的名字。
  6. 为新的服务器配置现有的项目。因为目前还没有任何项目,所以请点击 Finish
    修改新 JBoss 服务器的资源

    图 4.5. 修改新 JBoss 服务器的资源

结果

Servers 标签页里列出了 JBoss EAP Runtime 服务器。

服务器出现在服务器列表里。

图 4.6. 服务器出现在服务器列表里。

4.2. 配置 Maven

4.2.1. 关于 Maven

Maven 是一个在 Java 开发中创建、构建和管理软件项目的分布式自动构建工具。Maven 使用标准的配置文件(Project Object Model 或称为 POM)来定义项目和管理构建过程。POM 使用 XML 文件描述了模块和组件的依赖关系、构建顺序和结果项目软件包的目标及输出。这确保了项目以正确和统一的方式进行构建。
Maven 通过资料库(repository)来实现这一点。Maven 库存储了 Java 库、插件和其他构建 artifact。默认的公共库是 Maven 2 Central Repository,但库也可以是私有的,存在于公司内部并在开发团队间共享公用的 artifact。库也可以来自第三方。JBoss EAP 6 包含的 Maven Repsitory 包括了许多 Java EE 用来在 EAP 6 上构建应用程序所需的内容。
关于 Maven 的更多信息,请参考 Welcome to Apache Maven
关于 Maven Repository 的更多信息,请参考 Apache Maven Project - Introduction to Repositories
关于在 JBoss EAP 里使用 Maven 的更多信息,请参考客户门户 https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ 上的《开发指南》里的『Maven Guide』章节。

4.2.2. 配置 Maven

构建和部署应用程序所需的 Artifact 和依赖关系是保存在公共资料库里的。在构建应用程序时,您必须指示 Maven 使用这个资料库。如何实现则取决于您是计划使用 Red Hat JBoss Developer Studio 还是 Maven 命令行来构建和部署应用程序。
Red Hat JBoss Developer Studio 包含了 Maven,所以不需要单独下载和安装。如果您打算用 Red Hat JBoss Developer Studio 来构建和部署应用程序,请使用下列说明来配置 Maven: 第 4.2.3.1 节 “为 Red Hat JBoss Developer Studio 配置 Maven”
如果您计划用 Maven 命令行来构建和部署应用程序,您必须首先根据下列步骤下载和安装 Maven: 第 4.2.4.1 节 “下载和安装 Maven”。然后按照这些说明配置 Maven: 第 4.2.4.2 节 “配置 Maven 以用于命令行”

4.2.3. 为 Red Hat JBoss Developer Studio 配置 Maven

4.2.3.1. 为 Red Hat JBoss Developer Studio 配置 Maven

构建和部署应用程序所需的 Artifact 和依赖关系是保存在公共资料库里的。在构建应用程序时,您必须指示 Maven 使用这个资料库。本节涵盖了使用 Red Hat JBoss Developer Studio 构建和部署应用程序时 Maven 的配置步骤。
如果您计划用 Maven 命令行来构建和部署应用程序,您可以跳过这个主题,请按照这里的说明进行: 第 4.2.4.2 节 “配置 Maven 以用于命令行”
Maven 是随 Red Hat JBoss Developer Studio 发布的,您不需要单独安装它。然而,您需要用 Java EE Web Project 向导配置 Maven 以用于 JBoss EAP 6 的部署。下面的过程演示了通过如何编辑 Maven 配置文件配置 Maven 以用于 Red Hat JBoss Developer Studio。

过程 4.3. 在 Red Hat JBoss Developer Studio 里配置 Maven

  1. 点击 WindowPreferences,展开 JBoss Tools 并选择 JBoss Maven Integration
    Click Window→Preferences, expand JBoss Tools and select JBoss Maven Integration.

    图 4.7. Preferences 窗口里的 JBoss Maven Integration 面板

  2. 点击 Configure Maven Repositories
  3. 点击 Add Repository 来配置 JBoss GA Tech Preview Maven 资料库。像这样填写 Add Maven Repository 对话框:
    1. 设置 Profile IDRepository IDRepository Name 的值为 jboss-ga-repository
    2. 设置 Repository URL 的值为 http://maven.repository.redhat.com/techpreview/all
    3. 点击 Active by default 复选框来启用 Maven 资料库。
    4. 确定
    Enter Maven profile and repository values.

    图 4.8. 添加 Maven 资料库 - JBoss 技术预览

  4. 点击 Add Repository 来配置 JBoss Early Access Maven 资料库。请像这样填写 Add Maven Repository 对话框:
    1. 设置 Profile IDRepository IDRepository Name 的值为 jboss-earlyaccess-repository
    2. 设置 Repository URL 的值为 http://maven.repository.redhat.com/earlyaccess/all/
    3. 点击 Active by default 复选框来启用 Maven 资料库。
    4. 确定
    Enter Maven profile and repository values.

    图 4.9. 添加 Maven 资料库 - JBoss Early Access

  5. 复查资料库并点击 Finish
    Review Maven profile and repository values.

    图 4.10. 复查 Maven 资料库

  6. 您会看到提示 "Are you sure you want to update the file 'MAVEN_HOME/settings.xml'?"。请点击 Yes 来更新设置。然后点击 OK 关闭对话框。
    JBoss EAP Maven 资料库现在可用于 Red Hat JBoss Developer Studio 了。

4.2.4. 配置 Maven 以用于命令行

4.2.4.1. 下载和安装 Maven

如果您计划用 Maven 命令行来构建和部署应用程序到 JBoss EAP,你必须下载和安装 Maven。如果您计划用 Red Hat JBoss Developer Studio 来构建和部署应用程序,您可以跳过这个过程,因为 Maven 是随 Red Hat JBoss Developer Studio 发布的。
  1. 访问 Apache Maven Project - Download Maven 并下载适合您操作系统的最新版本。
  2. 关于如何下载和安装 Apache Maven 的说明,请参考 Maven 文档。

4.2.4.2. 配置 Maven 以用于命令行

构建和部署应用程序所需的 Artifact 和依赖关系是保存在公共资料库里的。如果您打算用 Red Hat JBoss Developer Studio 来构建和部署应用程序,您可以跳过这个过程。否则,请根据下列步骤进行:第 4.2.3.1 节 “为 Red Hat JBoss Developer Studio 配置 Maven”。然而,如果您计划用 Maven 命令行来构建和部署应用程序,对于所有使用 Maven 设置的项目,您都需要指示 Maven 使用 JBoss EAp 6 Maven 资料库。
配置 Maven 命令行有两种方法。
  • 您可以复制 Quickstarts 附带的预配置的 settings.xml 文件。
  • 您也可以手动编辑 Maven settings.xml 文件。
两种方法本节都会介绍。如果您已经下载了 Quickstarts,第一个是配置 Maven 最简单的方法。
前提条件

在进行配置前您必须安装 Maven。关于更多信息,请参考 第 4.2.4.1 节 “下载和安装 Maven”

过程 4.4. 用 Quickstarts 例程覆盖的设置来配置 Maven

JBoss EAP Quickstarts 附带的 settings.xml 会使用 Online JBoss EAP Maven 资料库。如果您已经下载了 Quickstarts,这是配置 Maven 最简单的方法。
  1. 这个过程会覆盖已有的 Maven 设置,所以您必须先备份现有的 Maven settings.xml 文件。
    1. 找到 Maven 安装目录,它通常位于 USER_HOME/.m2/
      • 对于 Linux 或 Mac,目录是 ~/.m2/
      • 对于 Windows,目录是 \Documents and Settings\USER_NAME\.m2\\Users\USER_NAME\.m2\
    2. 如果已存在 USER_HOME/.m2/settings.xml 文件,请将其重命名或备份以便以后恢复。
  2. 如果您还没有下载 Quickstarts,请按照下列步骤进行: 第 3.4.1 节 “下载 Quickstarts”
  3. 复制 QUICKSTART_HOME/settings.xml 文件到 USER_HOME/.m2/ 目录。
  4. 如果您在 Red Hat JBoss Developer Studio 运行时修改了 settings.xml 文件,请按照本节结尾的过程刷新设置:《刷新 Red Hat JBoss Developer Studio 用户设置》

过程 4.5. 手动编辑和配置 Maven 设置以使用 Online JBoss EAP Maven 资料库。

您可以手动添加 JBoss EAP 配置集到现有的 Maven 设置文件里。
  1. 找到 Maven 安装目录,它通常位于 USER_HOME/.m2/
    • 对于 Linux 或 Mac,它是 ~/.m2/
    • 对于 Windows,它是 \Documents and Settings\USER_NAME\.m2\\Users\USER_NAME\.m2\
  2. 如果您没有找到 settings.xml 文件,请从 USER_HOME/.m2/conf/ 目录复制 settings.xml 文件到 USER_HOME/.m2/ 目录。
  3. 复制下列 XML 到文件的 <profiles> 元素。
    <!-- Configure the JBoss GA Maven repository -->
    <profile>
      <id>jboss-ga-repository</id>
      <repositories>
        <repository>
          <id>jboss-ga-repository</id>
          <url>http://maven.repository.redhat.com/techpreview/all</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>jboss-ga-plugin-repository</id>
          <url>http://maven.repository.redhat.com/techpreview/all</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
    <!-- Configure the JBoss Early Access Maven repository -->
    <profile>
      <id>jboss-earlyaccess-repository</id>
      <repositories>
        <repository>
          <id>jboss-earlyaccess-repository</id>
          <url>http://maven.repository.redhat.com/earlyaccess/all/</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>jboss-earlyaccess-plugin-repository</id>
          <url>http://maven.repository.redhat.com/earlyaccess/all/</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
    
    
    复制下列 XML 到 settings.xml 文件的 <activeProfiles> 元素。
    <activeProfile>jboss-ga-repository</activeProfile>
    <activeProfile>jboss-earlyaccess-repository</activeProfile>
    
    
  4. 如果您在 Red Hat JBoss Developer Studio 运行时修改了 settings.xml 文件,请按照本节结尾的过程刷新设置:《刷新 Red Hat JBoss Developer Studio 用户设置》

过程 4.6. 刷新 Red Hat JBoss Developer Studio 用户设置

如果您在 Red Hat JBoss Developer Studio 运行时修改了 settings.xml 文件,您必须刷新用户设置。
  1. 从菜单里选择 WindowPreferences
  2. Preferences 窗口里,展开 Maven 并选择 User Settings
  3. 点击 Update Settings 按钮来刷新 Red Hat JBoss Developer Studio 里的 Maven 用户设置。
    更新 Maven 用户设置

    图 4.11. 更新 Maven 用户设置

重要

如果您的 Maven 资料库包含过期的 artifact,在构建或部署项目时您可能会遇到下列错误信息中的一个:
  • Missing artifact ARTIFACT_NAME
  • [ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve dependencies for PROJECT_NAME
要解决这个问题,请删除本地资料库的缓存版本来强制下载最新的 Maven artifacts。缓存资料库位于 ~/.m2/repository/(Linux)或%SystemDrive%\Users\USERNAME\.m2\repository\(Windows)。

第 5 章 运行 Quickstarts

5.1. 运行 Quickstarts

5.1.1. 在 Red Hat JBoss Developer Studio 里运行 Quickstarts

本节描述如何使用 Red Hat JBoss Developer Studio 来部署 Quickstart 并运行 Arquillian 测试。

过程 5.1. 将 Quickstarts 到 Red Hat JBoss Developer Studio

每个 Quickstart 都附带一个 POM(Project Object Model)文件,它包含这个 Quickstart 的项目和配置信息。用这个 POM 文件,您可以轻松地将 Quickstart 导入到 Red Hat JBoss Developer Studio 里。

重要

在导入到 Red Hat JBoss Developer Studio 时,如果您的 Quickstart 项目文件夹位于 IDE 工作区里,IDE 会生成一个无效的项目名及 WAR 归档名。在开始导入之前,请确定您的 Quickstart 项目文件夹在 IDE 工作区之外!
  1. 如果您还没有这样作, 请先进行 第 4.2.4.2 节 “配置 Maven 以用于命令行”
  2. 启动 Red Hat JBoss Developer Studio。
  3. 从菜单里选择 FileImport
  4. 在列表里选择 MavenExisting Maven Projects,然后点击 Next
    导入现有的 Maven 项目

    图 5.1. 导入现有的 Maven 项目

  5. 浏览您要测试的 Quickstart 的目录,例如 helloworld quickstart,然后点击 OKProjects 列表框将用所选的 Quickstart 项目的 pom.xml 文件填充。
    选择 Maven 项目

    图 5.2. 选择 Maven 项目

  6. 点击 Finish

过程 5.2. 构建和部署 helloworld Quickstart。

helloworld quickstart 是最简单的 Quickstarts 中的一个,它是检验 JBoss 服务器是否配置和运行正常的好方法。
  1. 如果您没有看到 Servers 标签页或者没有定义服务器,请遵照这里的说明:第 4.1.5 节 “通过『定义新服务器』添加 JBoss EAP 服务器”。如果您计划部署要求 full 配置集或其他启动参数的 Quickstart,请确保按照 Quickstart 说明创建服务器运行环境。
  2. 右击 Project Explorer 标签页里的 jboss-helloworld 项目并选择 Run As。您会看到一个列表。请选择 Run on Server
    Run As - Run on Server

    图 5.3. Run As - Run on Server

  3. 从服务器列表里选择 JBoss EAP 6.1+ Runtime Server 并点击 Next
    Run on Server

    图 5.4. Run on Server

  4. 下一个屏幕显示服务器上配置的资源。在这里为您配置了 jboss-helloworld quickstart 。请点击 Finish 部署这个 Quickstart。
    修改服务器上配置的资源

    图 5.5. 修改服务器上配置的资源

  5. 复查结果。
    • Server 标签页里,JBoss EAP 6.x Runtime Server 的状态将变成 [Started, Republish]
    • 服务器的 Console 标签页显示的信息详述了 JBoss EAP 6.x server 启动和 helloworld quickstart 部署。
    • helloworld 标签页会出现并显示 URL http://localhost:8080/jboss-helloworld/HelloWorld 和文本 "Hello World!"。
    • Console 里的下列信息确认了 jboss-helloworld.war 文件的部署:
      JBAS018210: Register web context: /jboss-helloworld
      JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
      
      注册的 Web 上下文附加在 http://localhost:8080 后面,这个 URL 可用来访问已部署的应用程序。
  6. 要检验 helloworld quickstart 是否已成功部署在 JBoss 服务器上,请打开浏览器并访问 http://localhost:8080/jboss-helloworld

过程 5.3. 运行 bean-validation Quickstart 的 Arquillian 测试

某些 Quickstart 没有提供用户接口层却提供 Arquilian 测试来演示代码示例。bean-validation Quickstart 就是一个提供 Arquilian 测试的 Quickstart。
  1. 按照上面的步骤将 bean-validation quickstart 导入到 Red Hat JBoss Developer Studio。
  2. Servers 标签页里,右击服务器并选择 Start 来启动 JBoss EAP 服务器。如果您没有看到 Servers 或还没有定义服务器,请按照这里的说明进行:第 4.1.5 节 “通过『定义新服务器』添加 JBoss EAP 服务器”
  3. 右击 Project Explorer 标签页里的 jboss-bean-validation 项目并选择 Run As。您会看到一个列表。请选择 Maven Build
  4. Edit Configuration 对话框的 Goals 输入字段里,输入:clean test -Parq-jbossas-remote
    然后点击 Run
    编辑配置

    图 5.6. 编辑配置

  5. 复查结果。
    服务器的 Console 标签页显示了 JBoss EAP 服务器启动的详细信息以及 bean-validation Quickstart 的 Arquillian 测试的输出。
    -------------------------------------------------------
     T E S T S
    -------------------------------------------------------
    Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
    Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec
    
    Results :
    
    Tests run: 5, Failures: 0, Errors: 0, Skipped: 0
    
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    

5.1.2. 用命令行运行 Quickstarts

过程 5.4. 用命令行构建和部署 Quickstarts

您可以用命令行轻易地构建和部署 Quickstarts。请注意,使用命令行时,您需要负责启动 JBoss 服务器。
  1. 如果您还没有这样作, 请先进行 第 4.2.4.2 节 “配置 Maven 以用于命令行”
  2. 复查 Quickstarts 根目录里的 README.html 文件。
    这个文件包含关于系统要求的基本信息、如何配置 Maven、如何添加用户及如何运行 Quickstarts。开始前请务必仔细阅读这个文件。
    它也包含一个列出所有可用 Quickstarts 的表。这个表列出了每个 Quickstart 的名称以及它展示的技术。它简短地描述了每个 Quickstart 以及设立该 Quickstart 所需的经验级别。关于 Quickstart 的详情,请点击它的名称。
    某些 Quickstart 的目的是增强和扩展其他 Quickstart。它们会在 Prerequisites 列里进行标注。如果某个 Quickstart 列出了预备条件,您必须在安装后才能运行它。
    某些 Quickstart 要求安装和配置可选的组件。除非是必需的,否则请不要安装这些组件。
  3. 运行 helloworld quickstart。
    helloworld quickstart 是最简单的 Quickstarts 中的一个,它是检验 JBoss 服务器是否配置和运行正常的好方法。打开 helloworld quickstart 根目录里的 README.html 文件。它包含了如何构建和部署 Quickstart 和访问运行的应用程序的细节。
  4. 运行其他 Quickstart。
    按照每个 Quickstart 根目录里的 README.html 文件里的步骤来运行示例程序。

附录 A. 安装程序截屏

A.1. 语言选择

Choose the desired language for the installation program.

图 A.1. JBoss EAP 安装程序的语言选择

A.2. 最终用户许可证协议

Agree to the End User License Agreement to continue.

图 A.2. JBoss EAP 安装程序的最终用户协议

A.3. 安装路径

Define the installation path for the JBoss EAP instance.

图 A.3. JBoss EAP 安装程序的安装路径

A.4. 选择要安装的软件包

选择或取消选择要安装的软件包。必需的软件包是禁止取消的。
JBoss EAP 安装程序选择要安装的软件包

图 A.4. JBoss EAP 安装程序选择要安装的软件包

A.5. 管理性用户创建

Create an administrative user.

图 A.5. JBoss EAP 安装程序创建管理型用户

A.6. Quickstart 的安装

Install the JBoss EAP quickstarts.

图 A.6. JBoss EAP 安装程序设置 Quickstart

A.7. Maven 资料库设置

JBoss EAP 安装程序设置 Maven 资料库

图 A.7. JBoss EAP 安装程序设置 Maven 资料库

A.8. 套接字绑定设置

确定是否使用默认绑定或配置自定义绑定。
Use the default bindings for standalone and domain mode.

图 A.8. JBoss EAP 安装程序的默认套接字绑定

A.9. 服务器启动

Select the startup option desired on completion of the installation process.

图 A.9. JBoss EAP 安装程序启动服务器

A.10. 配置日志级别

Choose No to skip configuration of logging level.

图 A.10. JBoss EAP 安装程序跳过了日志级别的配置

A.11. 配置 Runtime 环境

JBoss EAP 安装程序配置 Runtime 环境 - 默认

图 A.11. JBoss EAP 安装程序配置 Runtime 环境 - 默认

A.12. 复查安装组件

Review the list of selected components. Click the Next to continue or Previous to go back and make changes.

图 A.12. JBoss EAP 安装程序复查所选的组件

A.13. 安装进度

When the installation progress completes, click Next.

图 A.13. JBoss EAP 安装程序的组件安装进度

A.14. 安装过程完成

JBoss EAP 安装程序 - 安装过程完成

图 A.14. JBoss EAP 安装程序 - 安装过程完成

A.15. 创建快捷方式

Choose whether to create shortcuts and how to configure them. Then click Next.

图 A.15. JBoss EAP 安装程序 - 创建快捷方式

A.16. 生成安装脚本

Choose whether to generate an installation script containing the selected install options. Then click Done to finish.

图 A.16. JBoss EAP 安装程序生成安装脚本

附录 B. 修订记录

修订历史
修订 6.4.0-10Tuesday April 14 2015Lucas Costi
Red Hat JBoss 企业级应用程序平台 6.4.0.GA

法律通告

Copyright © 2015 Red Hat, Inc..
This 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, OpenShift, 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.
The 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.