下面显示了一个 9 节点 Edge 安装的完整静默配置文件示例。根据您的配置需要修改此文件。使用 -f
选项 setup.sh
即可包含此文件。如需查看每个拓扑的专用配置文件示例,请参阅安装 Edge 组件。
# IP address or DNS name of nodes. IP1=192.168.1.1 # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra (IP address only; do not use a DNS name) IP2=192.168.1.2 # ZooKeeper, Cassandra (IP address only; do not use a DNS name) IP3=192.168.1.3 # ZooKeeper, Cassandra (IP address only; do not use a DNS name) IP4=192.168.1.4 # Router, Message Processor IP5=192.168.1.5 # Router, Message Processor IP6=192.168.1.6 # Qpid IP7=192.168.1.7 # Qpid IP8=192.168.1.8 # Postgres IP9=192.168.1.9 # Postgres # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Specify "y" to check that the system meets the CPU and memory requirements # for the component being installed. See Installation Requirements for requirements # for each component. The default value is "n" to disable check. ENABLE_SYSTEM_CHECK=n # When "hostname -i" returns multiple IP addresses, # set to "y", to have the installer prompt you to select the IP address to use. ENABLE_DYNAMIC_HOSTIP=n # Set Edge sys admin credentials. ADMIN_EMAIL=your@email.com APIGEE_ADMINPW=yourPassword # If omitted, you are prompted for it. # Location of Edge license file. LICENSE_FILE=/tmp/license.txt # Management Server information. MSIP=$IP1 # IP or DNS name of Management Server node. # Specify the port the Management Server listens on for API calls. # APIGEE_PORT_HTTP_MS=8080 # Default is 8080. # # OpenLDAP information. # # Set to y if you are connecting to a remote LDAP server. # If n, Edge installs OpenLDAP when it installs the Management Server. USE_LDAP_REMOTE_HOST=n # If connecting to remote OpenLDAP server, specify the IP/DNS name and port. # LDAP_HOST=$IP1 # IP or DNS name of OpenLDAP node. # LDAP_PORT=10389 # Default is 10389. APIGEE_LDAPPW=yourLdapPassword # Specify OpenLDAP without replication, 1, or with replication, 2. LDAP_TYPE=1 # Set only if using replication. # LDAP_SID=1 # Unique ID for this LDAP server. # LDAP_PEER= # IP or DNS name of LDAP peer. # The Message Processor and Router pod. MP_POD=gateway # The name of the region, corresponding to the data center name. REGION=dc-1 # Use dc-1 unless installing in a # multi-data center environment. # If you are using region names other than dc-1, dc-2 etc, set this property to map your region # name to the appropriate dc-x format region name. This property is required by Management server # to appropriately register Cassandra data stores based on Cassandra's data centers and regions. REGION_MAPPING="<custom-region-1>:dc-1 <custom-region-2>:dc-2 ... <custom-region-x>:dc-x" # ZooKeeper information. # See table below if installing in a multi-data center environment. ZK_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. # Cassandra information. CASS_CLUSTERNAME=Apigee # Default name is Apigee. # Space-separated IP addresses of the Cassandra hosts (previously defined; do not use DNS names) # Syntax is: IP_address:host_number,rack_number CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" # Set to enable Cassandra authentication. # CASS_AUTH=y # The default value is n. # Cassandra uname/pword required if you enabled Cassandra authentication. # CASS_USERNAME= # CASS_PASSWORD='' # Postgres username and password as set when you installed Edge. # Default is apigee:postgres. PG_USER=apigee PG_PWD=postgres # Use to enable Postgres master-standby replication # when you have multiple Postgres nodes. # PG_MASTER=IPorDNSofNewMaster # PG_STANDBY=IPorDNSofOldMaster # SMTP information. SKIP_SMTP=n # Skip now and configure later by specifying "y". SMTPHOST=smtp.gmail.com SMTPUSER=your@email.com SMTPPASSWORD=yourEmailPassword SMTPSSL=y SMTPPORT=465 # If no SSL, use a different port, such as 25. SMTPMAILFROM="My Company <myco@company.com>" # The following four properties are only effective for Management server: # Cassandra JMX uname/pword required if you enabled Cassandra JMX authentication. # CASS_JMX_USERNAME = # CASS_JMX_PASSWORD = # Cassandra JMX SSL truststore details if you have enabled SSL based JMX in Cassandra. # JMX Truststore file should be readable by Apigee user # CASS_JMX_TRUSTSTORE = # CASS_JMX_TRUSTSTORE_PASS = # Set up username and password to access Qpid broker's management console QPID_MGMT_USERNAME=qpid QPID_MGMT_PASSWORD=Apigee1234
下表包含有关这些属性的其他信息:
属性 | 备注 |
---|---|
IP/DNS 名称 | 在指定节点的 IP 地址时,请勿使用映射到 127.0.0.1 的主机名或 IP 地址 127.0.0.1。 请注意,对于 Cassandra 主机定义,请仅使用 IP 地址;请勿使用 DNS 名称。 |
ENABLE_SYSTEM_CHECK |
如果值为“y”,请检查系统是否满足所安装组件的 CPU 和内存要求。如需了解每个组件的要求,请参阅安装要求。 默认值为“n”,以停用检查。 |
ENABLE_DYNAMIC_HOSTIP |
如果服务器具有多个接口卡,则“hostname -i”命令会返回以空格分隔的 IP 地址列表。默认情况下,Edge 安装程序使用返回的第一个 IP 地址,这可能并非在所有情况下都正确。作为替代方案,您可以在安装配置文件中设置以下属性。 如果设置为“y”,安装程序会提示您选择要在安装中使用的 IP 地址。默认值为“n”。 |
ADMIN_EMAIL APIGEE_ADMINPW
|
系统管理员的密码必须至少包含 8 个字符,并且包含一个大写字母、一个小写字母、一个数字或一个特殊字符。如果您省略密码,系统会提示您输入密码。 安装完成后,Apigee 建议您从配置文件中移除该密码。 |
LICENSE_FILE |
许可文件的位置,必须可供“apigee”用户访问。 例如,将其存储在 /tmp 目录和该文件的 chmod 777 中。该文件将复制到 Edge 安装目录。 |
APIGEE_LDAPPW |
指定 OpenLDAP 密码。 安装完成后,Apigee 建议您从配置文件中移除该密码。 |
USE_LDAP_REMOTE_HOST |
如果 如果您要连接到远程 LDAP 服务器,请将 如果您要连接到远程 OpenLDAP 服务器,请使用 |
LDAP_TYPE LDAP_SID LDAP_PEER
|
对于 OpenLDAP,设置 如果您的边缘拓扑使用单个 OpenLDAP 服务器,请指定 1。如果您的 Edge 安装使用多个 OpenLDAP 节点(例如在包含 13 个节点的正式版安装中),请指定 2。 如果启用复制,请设置以下属性:
|
MP_POD |
指定消息处理器和路由器 pod 的名称。默认情况下,名称为 Gateway。 |
REGION |
地区名称。按照惯例,名称通常采用 dc-# 格式,其中 # 对应于一个整数值。例如,dc-1、dc-2 等。您可以使用 dc-1,除非安装在多数据中心环境中。 在安装多个数据中心时,其值为 dc-1 或 dc-2 等,具体取决于您安装的数据中心。但是,您并非只能使用 dc-# 格式的名称,您可以使用任何区域名称。 |
REGION_MAPPING |
如果您使用的区域名称不是 dc-1、dc-2 等,请设置此属性,以将区域名称映射到相应的 dc-x 格式区域名称。 管理服务器需要使用此属性,才能根据 Cassandra 的数据中心和区域正确注册 Cassandra 数据存储区。 |
ZK_HOSTS |
ZooKeeper 节点的 IP 地址或 DNS 名称。IP 地址或 DNS 名称必须在所有 ZooKeeper 节点上以相同的顺序列出。 对 在多数据中心环境中,列出两个数据中心中的所有 ZooKeeper 节点。 只有在创建多个数据中心(如 12 台主机安装中所述)时,才能在 ZooKeeper 节点上指定 ":observer" 修饰符。在单个数据中心安装中,省略该修饰符。如需了解详情,请参阅包含 12 台主机的集群安装。 |
ZK_CLIENT_HOSTS |
此数据中心使用的 ZooKeeper 节点的 IP 地址或 DNS 名称。IP 地址或 DNS 名称必须在所有 ZooKeeper 节点上以相同的顺序列出。 对 在单个数据中心安装中,这些节点与 在多数据中心环境中,仅列出此数据中心中的 ZooKeeper 节点。如需了解详情,请参阅包含 12 台主机的集群安装。 |
CASS_CLUSTERNAME |
(可选)指定 Cassandra 集群的名称。默认名称为“Apigee”。 |
CASS_HOSTS |
以逗号分隔列表的形式指定 Cassandra 节点的主机 IP 地址(而非 DNS 名称),以及(可选)其数据中心编号及其所属的 rack。 对于生产拓扑,此列表中必须至少有三个节点。前两个节点用作“种子服务器”。因此,IP 地址必须在所有 Cassandra 节点上以相同的顺序列出。 列表中每个条目的语法如下所示: IP_address[:data_center_number,rack_number] Cassandra 节点可以视需要指定 Cassandra 节点的数据中心和机架。 只有在创建多个数据中心(如 12 台主机安装中所述)时,才需要指定 data_center_number 修饰符。在单个数据中心安装中,省略该修饰符。 例如,“192.168.124.201:1,1 = 数据中心 1 和机架/可用区 1”,“192.168.124.204:2,1 = 数据中心 2 和机架/可用区 1。 在多数据中心环境中,要克服防火墙问题,必须以如下方式对 如需了解如何为 Cassandra 主机指定 rack_number,请参阅添加 Cassandra 机架支持。 |
CASS_AUTH CASS_USERNAME CASS_PASSWORD
|
如果您启用了 Cassandra 身份验证 CASS_AUTH=y,则可以使用这些属性传递 Cassandra 用户名和密码。 安装完成后,Apigee 建议您从配置文件中移除该密码。 |
CONFIG_DELTA_LOG
|
|
PG_USER PG_PWD |
默认情况下,PostgreSQL 数据库定义了两个用户:“postgres”和“apigee”。
默认情况下,PostgreSQL 数据库定义了两个用户:“postgres”和“apigee”。两个用户的默认密码均为“postgres”。在安装时,使用 安装完成后,Apigee 建议您从配置文件中移除该密码。 |
PG_MASTER PG_STANDBY
|
设置为启用 Postgres 主备用复制,格式如下: PG_MASTER=IPorDNSofNewMaster PG_STANDBY=IPorDNSofOldMaster |
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT SMTPMAILFROM
|
配置 SMTP,以便 Edge 可在密码丢失和其他通知时发送电子邮件。 如果不需要 SMTP 用户凭据,请省略 “ |
CASS_JMX_USERNAME |
Cassandra JMX 用户名。如果已启用 Cassandra JMX 身份验证,则为必需项。 |
CASS_JMX_PASSWORD |
Cassandra JMX 密码。如果已启用 Cassandra JMX 身份验证,则为必需项。 |
CASS_JMX_TRUSTSTORE |
Cassandra JMX SSL 信任库用户名(如果您已在 Cassandra 中启用了基于 SSL 的 JMX)。 Apigee 用户应可以读取 JMX 信任库文件。 |
CASS_JMX_TRUSTSTORE_PASS |
Cassandra JMX SSL 信任库密码(如果您已在 Cassandra 中启用了基于 SSL 的 JMX)。 |
QPID_MGMT_USERNAME QPID_MGMT_PASSWORD
|
这些凭据提供对 Qpid 代理的 Qpid Web 管理控制台的访问权限。Web 管理控制台为 Qpid 代理的管理和控制提供了简单直观的界面。 |
除了此处列出的属性之外,还有用于配置 Apigee mTLS 的属性。 如需了解详情,请参阅配置 Apigee mTLS。