第 19 章 参考
19.1. Data Grid Server 8.2.3 Readme
有关 Data Grid Server 12.1.11.Final-redhat-00001 发行版的信息。
19.1.1. 要求
Data Grid Server 需要 JDK 11 或更高版本。
19.1.2. 启动服务器
使用 服务器
脚本运行 Data Grid 服务器实例。
Unix / Linux
$RHDG_HOME/bin/server.sh
Windows
$RHDG_HOME\bin\server.bat
包含 --help
或 -h
选项以查看命令参数。
19.1.3. 停止服务器
使用 shutdown
命令和 CLI 执行安全关闭。
或者,从终端输入 Ctrl-C 以中断服务器进程或通过 TERM 信号终止它。
19.1.4. Configuration
服务器配置通过以下特定于服务器的元素扩展了数据网格配置:
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
19.1.5. 绑定地址
默认情况下,Data Grid 服务器绑定到网络上的 loopback 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
19.1.6. 绑定端口
默认情况下,Data Grid 服务器侦听端口 11222
。
使用 -p
参数设置替代端口:
Unix / Linux
$RHDG_HOME/bin/server.sh -p 30000
Windows
$RHDG_HOME\bin\server.bat -p 30000
19.1.7. 集群地址
Data Grid Server 配置定义了集群传输,以便同一网络上的多个实例相互发现并自动组成集群。
使用 -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
19.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
19.1.9. 身份验证
Data Grid Server 需要身份验证。
使用 CLI 创建用户名和密码,如下所示:
Unix / Linux
$RHDG_HOME/bin/cli.sh user create username -p "qwer1234!"
Windows
$RHDG_HOME\bin\cli.bat user create username -p "qwer1234!"
19.1.10. 服务器主目录
Data Grid 服务器使用 infinispan.server.home.path
来查找主机文件系统上服务器分发的内容。
服务器主目录,称为 $RHDG_HOME
,包含以下文件夹:
├── bin ├── boot ├── docs ├── lib ├── server └── static
目录 | 描述 |
---|---|
| 包含用于启动服务器和 CLI 的脚本。 |
|
包含用于引导服务器的 |
| 提供配置示例、架构、组件许可证和其他资源。 |
|
包含服务器内部需要的 |
| 为 Data Grid 服务器实例提供根文件夹。 |
| 包含 Data Grid 控制台的静态资源。 |
19.1.11. 服务器根目录
Data Grid 服务器使用 infinispan.server.root.path
来查找 Data Grid 服务器实例的配置文件和数据。
您可以在相同目录或不同的目录中创建多个服务器根文件夹,然后使用 -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
目录 | 描述 | 系统属性覆盖 |
---|---|---|
| 包含服务器配置文件。 |
|
| 包含按容器名称组织的数据文件。 |
|
|
包含服务器扩展文件。 |
|
| 包含服务器日志文件。 |
|
19.1.12. 日志记录
使用 server/conf
文件夹中的 log4j2.xml
文件配置 Data Grid 服务器日志。
使用 --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