第 18 章 参考
18.1. Data Grid Server 8.5.2 Readme
有关 Data Grid Server 14.0.21.Final-redhat-00001 分发的信息。
18.1.1. 要求
Data Grid 服务器需要 JDK 11 或更高版本。
18.1.2. 启动服务器
使用 服务器
脚本运行 Data Grid 服务器实例。
Unix/Linux
$RHDG_HOME/bin/server.sh
Windows
$RHDG_HOME\bin\server.bat
包含用于查看命令参数的-- help
或 -h
选项。
18.1.3. 停止服务器
通过 CLI 使用 shutdown
命令来执行安全关闭。
或者,从终端输入 Ctrl-C,以中断服务器进程或通过 TERM 信号终止它。
18.1.4. 配置
服务器配置扩展了 Data Grid 配置,包括以下特定于服务器的元素:
cache-container
- 定义用于管理缓存生命周期的缓存容器。
端点
- 为客户端协议启用和配置端点连接器。
安全
- 配置端点安全域。
socket-bindings
- 将端点连接器映射到接口和端口。
默认配置文件为 $RHDG_HOME/server/conf/infinispan.xml
。
infinispan.xml
- 提供配置,以使用启用了统计信息和授权的默认缓存容器运行 Data Grid 服务器。演示如何使用安全域设置身份验证和授权。
Data Grid 提供其他随时可用的配置文件,它们主要用于开发和测试目的。
$RHDG_HOME/server/conf/
提供以下配置文件:
infinispan-dev-mode.xml
-
配置 Data Grid 服务器,专门用于使用 IP 多播发现的跨站点复制。该配置提供了
BASIC
身份验证,以连接到 Hot Rod 和 REST 端点。配置是为开发模式而设计的,不应在生产环境中使用。 infinispan-local.xml
- 在没有集群功能的情况下配置 Data Grid 服务器。
infinispan-xsite.xml
- 在单一主机上配置跨站点复制,并使用 IP 多播进行发现。
infinispan-memcached.xml
- 将 Data Grid 服务器配置为默认 Memcached 服务器,侦听端口 11221 且没有身份验证。
infinispan-resp.xml
- 将 Data Grid 服务器配置为的行为与默认 Redis 服务器类似,侦听端口 6379 且没有身份验证。
log4j2.xml
- 配置 Data Grid 服务器日志记录。
使用带有 -c
参数的不同配置文件,如下例所示:
Unix/Linux
$RHDG_HOME/bin/server.sh -c infinispan-local.xml
Windows
$RHDG_HOME\bin\server.bat -c infinispan-local.xml
18.1.5. 绑定地址
默认情况下,Data Grid 服务器绑定到网络上的环回 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
18.1.6. 绑定端口
默认情况下,Data Grid 服务器侦听端口 11222
。
使用 -p
参数设置替代端口:
Unix/Linux
$RHDG_HOME/bin/server.sh -p 30000
Windows
$RHDG_HOME\bin\server.bat -p 30000
18.1.7. 集群地址
Data Grid 服务器配置定义了集群传输,同一网络上的多个实例会互相发现,并自动组成集群。
使用 -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
18.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
18.1.9. 身份验证
Data Grid 服务器需要身份验证。
使用 CLI 创建用户名和密码,如下所示:
Unix/Linux
$RHDG_HOME/bin/cli.sh user create username -p "qwer1234!"
Windows
$RHDG_HOME\bin\cli.bat user create username -p "qwer1234!"
18.1.10. 服务器主目录
Data Grid 服务器使用 infinispan.server.home.path
来查找主机文件系统上服务器分发的内容。
服务器主目录称为 $RHDG_HOME
,包含以下文件夹:
├── bin ├── boot ├── docs ├── lib ├── server └── static
目录 | 描述 |
---|---|
| 包含用于启动服务器和 CLI 的脚本。 |
|
包含要引导服务器的 |
| 提供配置示例、架构、组件许可证和其他资源。 |
|
包含服务器在内部所需的 |
| 为 Data Grid 服务器实例提供根文件夹。 |
| 包含 Data Grid 控制台的静态资源。 |
18.1.11. 服务器根目录
Data Grid 服务器使用 infinispan.server.root.path
来查找 Data Grid 服务器实例的配置文件和数据。
您可以在同一目录或不同的目录中创建多个服务器根文件夹,然后使用 -s
or-- server-root
参数指定位置,如下例所示:
Unix/Linux
$RHDG_HOME/bin/server.sh -s server2
Windows
$RHDG_HOME\bin\server.bat -s server2
每个服务器根目录包含以下文件夹:
├── server │ ├── conf │ ├── data │ ├── lib │ └── log
目录 | 描述 | 系统属性覆盖 |
---|---|---|
| 包含服务器配置文件。 |
|
| 包含按容器名称组织的数据文件。 |
|
|
包含服务器扩展文件。 |
|
| 包含服务器日志文件。 |
|
18.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