第 17 章 参考

17.1. Data Grid Server 8.3.1 Readme

有关数据网格服务器 13.0.10.Final-redhat-00001 分发的信息。

17.1.1. 要求

数据网格服务器需要 JDK 11 或更高版本。

17.1.2. 启动服务器

使用 服务器 脚本运行 Data Grid 服务器实例。

UNIX/ Linux

$RHDG_HOME/bin/server.sh

Windows

$RHDG_HOME\bin\server.bat

提示

包含 --help-h 选项以查看命令参数。

17.1.3. 停止服务器

使用带有 CLI 的 shutdown 命令执行安全关闭。

或者,从终端输入 Ctrl-C 以中断服务器进程或通过 TERM 信号将它终止。

17.1.4. Configuration

服务器配置通过以下特定于服务器的元素来扩展 Data Grid 配置:

cache-container
定义用于管理缓存生命周期的缓存容器。
端点
为客户端协议启用和配置端点连接器。
安全
配置端点安全域。
socket-bindings
将端点连接器映射到接口和端口。

默认配置文件为 $RHDG_HOME/server/conf/infinispan.xml

使用带有 -c 参数的不同配置文件,如下例所示,启动没有集群功能的服务器:

UNIX/ Linux

$RHDG_HOME/bin/server.sh -c infinispan-local.xml

Windows

$RHDG_HOME\bin\server.bat -c infinispan-local.xml

17.1.5. 绑定地址

默认情况下,Data Grid Server 绑定到您网络中的环回 IP 地址 localhost

使用 -b 参数设置不同的 IP 地址,如下例所示,绑定到所有网络接口:

UNIX/ Linux

$RHDG_HOME/bin/server.sh -b 0.0.0.0

Windows

$RHDG_HOME\bin\server.bat -b 0.0.0.0

17.1.6. 绑定端口

数据网格服务器默认侦听端口 11222

使用 -p 参数设置备选端口:

UNIX/ Linux

$RHDG_HOME/bin/server.sh -p 30000

Windows

$RHDG_HOME\bin\server.bat -p 30000

17.1.7. 集群地址

数据网格服务器配置定义了群集传输,因此同一网络上的多个实例可以互相发现,并自动组成集群。

使用 -k 参数更改集群流量的 IP 地址:

UNIX/ Linux

$RHDG_HOME/bin/server.sh -k 192.168.1.100

Windows

$RHDG_HOME\bin\server.bat -k 192.168.1.100

17.1.8. 集群堆栈

JGroups 堆栈配置群集传输协议。Data Grid 服务器默认使用 tcp 堆栈。

使用带有 -j 参数的替代集群堆栈,如下例所示,使用 UDP 进行集群传输:

UNIX/ Linux

$RHDG_HOME/bin/server.sh -j udp

Windows

$RHDG_HOME\bin\server.bat -j udp

17.1.9. 身份验证

数据网格服务器需要身份验证。

使用 CLI 创建用户名和密码,如下所示:

UNIX/ Linux

$RHDG_HOME/bin/cli.sh user create username -p "qwer1234!"

Windows

$RHDG_HOME\bin\cli.bat user create username -p "qwer1234!"

17.1.10. 服务器主目录

Data Grid Server 使用 infinispan.server.home.path 来查找主机文件系统上的服务器分发的内容。

服务器主目录称为 $RHDG_HOME,包含以下文件夹:

├── bin
├── boot
├── docs
├── lib
├── server
└── static
目录描述

/bin

包含启动服务器和 CLI 的脚本。

/boot

包含用于启动服务器的 JAR 文件。

/docs

提供配置示例、架构、组件许可证和其他资源。

/lib

包含服务器内部需要的 JAR 文件。
不要将自定义 JAR 文件放在此文件夹中。

/server

为 Data Grid Server 实例提供根文件夹。

/static

包含数据网格控制台的静态资源。

17.1.11. 服务器根目录

数据网格服务器使用 infinispan.server.root.path 来查找 Data Grid Server 实例的配置文件和数据。

您可以在同一目录或不同目录中创建多个服务器根文件夹,然后使用 -s--server-root 参数指定位置,如下例所示:

UNIX/ Linux

$RHDG_HOME/bin/server.sh -s server2

Windows

$RHDG_HOME\bin\server.bat -s server2

每个服务器根目录都包含以下文件夹:

├── server
│   ├── conf
│   ├── data
│   ├── lib
│   └── log
目录描述系统属性覆盖

/server/conf

包含服务器配置文件。

infinispan.server.config.path

/server/data

包含按容器名称组织的数据文件。

infinispan.server.data.path

/server/lib

包含服务器扩展文件。
该目录以递归方式扫描,并用作类路径。

Infinispan.server.lib.path
使用以下分隔符分隔多个路径
在 Unix / Linux
; on Windows

/server/log

包含服务器日志文件。

infinispan.server.log.path

17.1.12. 日志记录

使用 server/conf 文件夹中的 log4j2.xml 文件配置 Data Grid Server 日志。

使用 --logging-config=<path_to_logfile > 参数来使用自定义路径,如下所示:

UNIX/ Linux

$RHDG_HOME/bin/server.sh --logging-config=/path/to/log4j2.xml

提示

为确保自定义路径生效,请不要使用 ~ 快捷方式。

Windows

$RHDG_HOME\bin\server.bat --logging-config=path\to\log4j2.xml