3.4. 管理接口

3.4.1. 管理 CLI

管理命令行界面(CLI)是 JBoss EAP 的命令行管理工具。

使用管理 CLI 启动和停止服务器、部署和取消部署应用、配置系统设置,以及执行其他管理任务。操作可以在批处理模式下执行,允许以组形式运行多个任务。

许多常见的终端命令可用,如 lscdpwd。管理 CLI 也支持 tab 自动完成功能。

有关使用管理 CLI 的详细信息,包括命令和操作、语法以及批处理模式下运行,请参阅 JBoss EAP 管理 CLI 指南

启动管理 CLI
$ EAP_HOME/bin/jboss-cli.sh
注意

对于 Windows Server,请使用 EAP_HOME\bin\jboss-cli.bat 脚本。

连接到正在运行的服务器
connect

或者,您可以使用 EAP_HOME/bin/jboss-cli.sh --connect 命令启动管理 CLI 并在一个步骤中进行连接。

显示帮助

使用以下命令获取一般帮助:

help

在命令中使用 --help 标志,以接收有关使用该特定命令的说明。例如,若要接收关于使用 deploy 的信息,请执行以下命令:

deploy --help
退出管理 CLI
quit
查看系统设置

以下命令使用 read-attribute 操作来显示是否启用了示例数据源:

/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)
{
    "outcome" => "success",
    "result" => true
}

在受管域中运行时,您必须通过 /profile=PROFILE_NAME 命令指定要更新的配置集。

/profile=default/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)
更新系统设置

以下命令使用 write-attribute 操作来禁用示例数据源。

/subsystem=datasources/data-source=ExampleDS:write-attribute(name=enabled,value=false)
启动服务器

管理 CLI 也可用于在受管域中运行时启动和停止服务器。

/host=HOST_NAME/server-config=server-one:start

3.4.2. 管理控制台

管理控制台是用于 JBoss EAP 的基于 Web 的管理工具。

使用管理控制台启动和停止服务器、部署和取消部署应用、调优系统设置,以及对服务器配置进行持续修改。管理控制台还具备执行管理任务的功能,当当前用户执行的任何更改都要求重新启动或重新加载服务器实例时,实时通知功能。

在受管域中,可以从域控制器的管理控制台集中管理同一域中的服务器实例和服务器组。

对于使用默认管理端口在本地主机上运行的 JBoss EAP 实例,可通过位于 http://localhost:9990/console/index.html 的 Web 浏览器访问管理控制台。您将需要使用具有访问管理控制台权限的用户进行身份验证。

管理控制台提供下列选项卡,用于浏览和管理 JBoss EAP 单机服务器或受管域。

Home
了解如何完成几个常见配置和管理任务。参加导览,熟悉 JBoss EAP 管理控制台。
Deployments
添加、移除和启用部署。在受管域中,将部署分配到服务器组。
Configuration
配置可用的子系统,提供 Web 服务、消息传递或高可用性等功能。在受管域中,管理包含不同子系统配置的配置文件。
Runtime
查看运行时信息,如服务器状态、JVM 使用量和服务器日志。在受管域中,管理您的主机、服务器组和服务器。
Patching
将补丁应用到您的 JBoss EAP 实例。
Access Control
在使用基于角色的访问控制时,将角色分配给用户和组。

3.4.2.1. 在管理控制台中更新属性

导航到管理控制台中相应部分以用于要修改的资源后,只要您拥有适当的权限,即可编辑其属性。

  1. 单击 编辑 链接。
  2. 进行所需的更改。

    必填字段标有星号(*)。您可以通过单击 Help 链接来查看属性描述。

    注意

    根据属性类型,输入字段可以是文本字段、ON/OFF 字段,或者下拉字段。在某些文本字段中,正如您键入的,配置的其他位置中的值可能显示为建议。

  3. 单击 Save 以保存更改。
  4. 如有必要,重新加载服务器以使更改生效。

    保存需要重新加载才能生效的更改时会出现弹出窗口。若要重新加载单机服务器,可在弹出窗口中单击 Reload 链接。若要重新加载受管域中的服务器,可单击 Topology 链接,选择相应的服务器,然后单击 Reload 下拉列表。

要查看您最近执行的配置操作的历史记录,请单击管理控制台右上角的通知图标。

3.4.2.2. 启用/禁用管理控制台

您可以通过设置 /core-service=management/management -interface=http-interface=http-interface=http-interface=http-interface 属性来启用或禁用管理控制台。对于域模式中的 master 主机,请使用 /host=master/core-service=management/management-interface=http-interface

例如,要启用:

/core-service=management/management-interface=http-interface:write-attribute(name=console-enabled,value=true)

例如,要禁用:

/core-service=management/management-interface=http-interface:write-attribute(name=console-enabled,value=false)

3.4.2.3. 更改管理控制台的语言

默认情况下,管理控制台的语言设置为英文。您可以选择使用以下语言之一:

  • 德语(de)
  • 简体中文(zh-Hans)
  • 巴西葡萄牙语(pt-BR)
  • 法语(fr)
  • 西班牙语(es)
  • 日语(Jab)
更改管理控制台的语言
  1. 登录管理控制台。
  2. 单击管理控制台右下角的 Settings 链接。
  3. Locale 选择框中选择所需的语言。
  4. 选择 Save。确认框通知您需要重新加载应用。
  5. 单击 Yes。系统会自动刷新 Web 浏览器以使用所选区域设置。

3.4.2.4. 自定义管理控制台标题

您可以自定义管理控制台标题,以便快速识别每个 JBoss EAP 实例。

自定义管理控制台标题:

  1. 登录管理控制台。
  2. 单击管理控制台右下角的 Settings
  3. Settings 窗口中,修改 标题字段中的标题
  4. Save

    确认框通知您必须重新加载管理控制台。

  5. 单击 Yes

    系统会自动刷新 Web 浏览器,新的标题会显示在标签页标头中。