下面显示了一个适用于 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=":dc-1 :dc-2 ... :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=IPofNewMaster # PG_STANDBY=IPofOldMaster # 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 =
下表列出了有关这些属性的更多信息:
属性 | 注意 |
---|---|
IP/DNS 名称 | 指定节点的 IP 地址时,请勿使用映射到 127.0.0.1 的主机名或 127.0.0.1 的 IP 地址。 请注意,对于 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 个字符,且需要包含 1 个大写字母、1 个小写字母、1 个数字或 1 个特殊字符。如果您省略了密码,系统会提示您输入密码。 安装完成后,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 的名称。默认情况下,名称为网关。 |
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 名称。所有 ZooKeeper 节点上的 IP 地址或 DNS 名称都必须以相同的顺序列出。 使用 在多数据中心环境中,列出两个数据中心的所有 ZooKeeper 节点。 如多个 12 台主机安装中所述,仅在创建多个数据中心时,才能在 ZooKeeper 节点上指定“:observer”修饰符。安装单个数据中心时,请忽略该修饰符。如需了解详情,请参阅 12 主机集群安装。 |
ZK_CLIENT_HOSTS |
此数据中心使用的 ZooKeeper 节点的 IP 地址或 DNS 名称。所有 ZooKeeper 节点上的 IP 地址或 DNS 名称都必须以相同的顺序列出。 使用 安装单个数据中心时,这些节点与 在多数据中心环境中,仅列出此数据中心内的 ZooKeeper 节点。如需了解详情,请参阅 12 主机集群安装。 |
CASS_CLUSTERNAME |
(可选)指定 Cassandra 集群的名称。默认名称为“Apigee”。 |
CASS_HOSTS |
以逗号分隔列表的形式指定 Cassandra 节点的主机 IP 地址(而非 DNS 名称),以及可选的数据中心编号和所属机架。 对于生产拓扑,此列表中必须有至少 3 个节点。前两个节点用作“种子服务器”。因此,IP 地址必须在所有 Cassandra 节点上以相同的顺序列出。 列表中每个条目的语法如下: IP_address[:data_center_number,rack_number] Cassandra 节点可以选择指定 Cassandra 节点的数据中心和机架。仅在创建多个数据中心时指定 data_center_number 修饰符(如 12 台主机安装中所述)。安装单个数据中心时,请忽略该修饰符。 例如,“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=IPofNewMaster PG_STANDBY=IPofOldMaster |
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 中启用了基于 SSL 的 JMX,则 Cassandra JMX SSL 信任存储区用户名可供您访问。JMX Truststore 文件应可供 Apigee 用户读取。 |
CASS_JMX_TRUSTSTORE_PASS |
如果您已在 Cassandra 中启用了基于 SSL 的 JMX,Cassandra JMX SSL 信任库密码便会生效。 |
除了此处列出的属性外,还有用于配置 Apigee mTLS 的属性。如需了解详情,请参阅配置 Apigee mTLS。