مرجع فایل پیکربندی Edge

در زیر نمونه‌ای از فایل پیکربندی کامل بی‌صدا برای نصب Edge با ۹ گره نشان داده شده است. این فایل را درصورت نیاز برای پیکربندی‌تان ویرایش کنید. برای setup.sh کردن این فایل، از گزینه -f استفاده کنید. برای نمونه‌های فایل‌های پیکربندی که مختص هر توپولوژی است، به نصب عناصر Edge مراجعه کنید.

    # IP address or DNS name of nodes.
    IP1=192.168.1.1  # Management Server, SymasLDAP, 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.
    
    # SymasLDAP information.
    # Set to y if you are connecting to a remote LDAP server.
    # If n, Edge installs SymasLDAP when it installs the Management Server.
    USE_LDAP_REMOTE_HOST=n
    
    # If connecting to remote SymasLDAP server, specify the IP/DNS name and port.
    # LDAP_HOST=$IP1    # IP or DNS name of SymasLDAP node.
    # LDAP_PORT=10389   # Default is 10389.
    APIGEE_LDAPPW=yourLdapPassword
    
    # Specify SymasLDAP 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
    
    # FIPS_OS should be set to true when OPDK 4.53 or later is installed on 
    # FIPS enabled operating system
    FIPS_OS=false
    

جدول زیر حاوی اطلاعات تکمیلی درباره این دارایی‌ها است:

دارایی یادداشت
نام‌های IP/ساناد هنگام مشخص کردن نشانی IP گره، از نگاشت نام میزبان به 127.0.0.1 یا نشانی IP 127.0.0.1 استفاده نکنید.

توجه داشته باشید که برای تعریف‌های میزبان Cassandra، فقط از نشانی‌های IP استفاده کنید؛ از نام‌های «ساناد» استفاده نکنید.

ENABLE_SYSTEM_CHECK

اگر «بله»، بررسی کنید که سیستم از الزامات CPU و حافظه برای مؤلفه دردست نصب برخوردار باشد. برای اطلاع از الزامات هر عنصر، به الزامات نصب مراجعه کنید.

مقدار پیش‌فرض «n» برای غیرفعال کردن بررسی است.

ENABLE_DYNAMIC_HOSTIP

اگر سروری چند کارت واسط داشته باشد، فرمان «hostname -i» فهرست نشانی‌های IP را که با فاصله از هم جدا شده‌اند برمی‌گرداند. به‌طور پیش‌فرض، نصب‌کننده Edge از اولین نشانی IP برگردانده‌شده استفاده می‌کند که ممکن است در همه شرایط درست نباشد. به‌عنوان جایگزین، می‌توانید دارایی زیر را در فایل پیکربندی نصب تنظیم کنید.

وقتی روی «بله» تنظیم شود، نصب‌کننده از شما می‌خواهد نشانی IP موردنظر برای استفاده در نصب را انتخاب کنید. مقدار پیش‌فرض «n» است.

ADMIN_EMAIL
APIGEE_ADMINPW

گذرواژه سرپرست سیستم باید حداقل ۸ نویسه داشته باشد و شامل یک حرف بزرگ، یک حرف کوچک، یک رقم، یا یک نویسه خاص باشد. اگر گذرواژه را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

پس‌از تکمیل نصب، Apigee توصیه می‌کند گذرواژه را از فایل پیکرببندی بردارید.

LICENSE_FILE

مکان فایل پروانه که باید برای کاربر «apigee» دردسترس باشد. برای مثال، آن را در دایرکتوری /tmp ذخیره کنید و chmod 777 را روی فایل اعمال کنید. فایل در دایرکتوری نصب Edge کپی می‌شود.

APIGEE_LDAPPW

گذرواژه SymasLDAP را مشخص می‌کند.

پس‌از تکمیل نصب، Apigee توصیه می‌کند گذرواژه را از فایل پیکرببندی بردارید.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

اگر USE_LDAP_REMOTE_HOST برابر با n باشد، Edge هنگام نصب «سرور مدیریت»، SymasLDAP را به‌طور خودکار نصب می‌کند.

اگر به سرور LDAP از دور متصل می‌شوید، USE_LDAP_REMOTE_HOST را روی y تنظیم کنید. ‫SymasLDAP با «سرور مدیریت» نصب نشده است.

اگر به سرور SymasLDAP از دور متصل می‌شوید، از LDAP_HOST و LDAP_PORT برای مشخص کردن نشانی IP یا نام ساناد و شماره درگاه میزبان استفاده کنید.

LDAP_TYPE
LDAP_SID
LDAP_PEER

برای SymasLDAP بدون تکثیر، LDAP_TYPE=1 را تنظیم کنید. ‫LDAP_TYPE=2 مربوط به SymasLDAP با تکثیر است.

اگر توپولوژی Edge شما از یک سرور SymasLDAP استفاده می‌کند، ۱ را مشخص کنید. اگر نصب Edge شما از چندین گره SymasLDAP استفاده می‌کند، مانند نصب تولیدی ۱۳ گره‌ای، مقدار ۲ را مشخص کنید.

اگر تکثیر را فعال کنید، ویژگی‌های زیر را تنظیم کنید:

  • LDAP_SID=1 - شناسه یکتا برای این سرور LDAP. هر گره LDAP از شناسه متفاوتی استفاده می‌کند. برای مثال، برای همتای LDAP روی ۲ تنظیم کنید.
  • LDAP_PEER=10.0.0.1 - نام IP یا ساناد همتای LDAP.
MP_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

نشانی‌های IP یا نام‌های ساناد گره‌های ZooKeeper. نشانی‌های IP یا نام‌های ساناد باید در همه گره‌های ZooKeeper به یک ترتیب فهرست شوند.

از همان قالبی برای HOSTIP استفاده کنید که برای ZK_HOSTS استفاده می‌کنید. یعنی اگر نشانی IP را برای ZK_HOSTS مشخص کنید یا از نشانی IP برای HOSTIP استفاده کنید. اگر از ساناد استفاده می‌کنید، برای هر دو از نام ساناد استفاده کنید.

در محیط چند مرکز داده، همه گره‌های ZooKeeper را از هر دو مرکز داده فهرست کنید.

فقط هنگام ایجاد چندین مرکز داده همان‌طور که در نصب ۱۲ میزبان توضیح داده شده است، اصلاح‌گر «:observer» را در گره‌های ZooKeeper مشخص کنید. در نصب تک‌مرکز داده، این اصلاح‌گر را حذف کنید. برای اطلاعات بیشتر، به نصب خوشه‌ای ۱۲ میزبان مراجعه کنید.

ZK_CLIENT_HOSTS

نشانی‌های IP یا نام‌های ساناد گره‌های ZooKeeper که این مرکز داده استفاده می‌کند. نشانی‌های IP یا نام‌های ساناد باید در همه گره‌های ZooKeeper به یک ترتیب فهرست شوند.

از همان قالبی برای HOSTIP استفاده کنید که برای ZK_CLIENT_HOSTS استفاده می‌کنید. یعنی اگر نشانی IP را برای ZK_CLIENT_HOSTS مشخص می‌کنید، برای HOSTIP هم از نشانی IP استفاده کنید. اگر از ساناد استفاده می‌کنید، برای هر دو از نام ساناد استفاده کنید.

در نصب مرکز داده تکی، این گره‌ها همان گره‌هایی هستند که توسط ZK_HOSTS مشخص شده‌اند.

در محیط چند مرکز داده، فقط گره‌های ZooKeeper را در این مرکز داده فهرست کنید. برای اطلاعات بیشتر، به نصب خوشه‌ای ۱۲ میزبان مراجعه کنید.

CASS_CLUSTERNAME درصورت تمایل، نام خوشه Cassandra را مشخص کنید. نام پیش‌فرض «Apigee» است.
CASS_HOSTS

فهرست جداشده با کاما از نشانی‌های IP میزبان گره‌های Cassandra (نه نام‌های ساناد)، و به‌صورت اختیاری شماره مرکز داده آن‌ها و قفسه‌ای که به آن تعلق دارند را مشخص می‌کند.

برای توپولوژی‌های تولید، باید حداقل سه گره در این فهرست وجود داشته باشد. از دو گره اول به‌عنوان «کارسازهای بذر» استفاده می‌شود. در نتیجه، نشانی‌های IP باید در همان ترتیب در همه گره‌های Cassandra فهرست شوند.

نحو هر ورودی در فهرست به این صورت است:

IP_address[:data_center_number,rack_number]

گره‌های Cassandra می‌توانند به‌صورت اختیاری مرکز داده و قفسه گره Cassandra را مشخص کنند. فقط هنگام ایجاد چندین مرکز داده همان‌گونه که در نصب ۱۲ میزبانی توضیح داده شده است، اصلاح‌کننده data_center_number را مشخص کنید. در نصب تک‌مرکز داده، این اصلاح‌گر را حذف کنید.

برای مثال، «192.168.124.201:1,1 = مرکز داده ۱ و قفسه/منطقه دردسترس ۱، و «192.168.124.204:2,1 = مرکز داده ۲ و قفسه/منطقه دردسترس ۱.

در محیط چند مرکز داده، برای غلبه بر مشکلات دیوار آتش، CASS_HOSTS باید به‌گونه‌ای مرتب شود (همان‌طور که در مثال بالا نشان داده شده است) که گره‌های مرکز داده فعلی در ابتدا قرار گیرند. برای اطلاعات بیشتر، به نصب خوشه‌ای ۱۲ میزبان مراجعه کنید.

برای اطلاعات درباره مشخص کردن rack_number برای میزبان Cassandra، به افزودن پشتیبانی از قفسه Cassandra مراجعه کنید.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

اگر اصالت‌سنجی Cassandra را فعال کنید، CASS_AUTH=y، می‌توانید نام کاربری و گذرواژه Cassandra را بااستفاده از این دارایی‌ها ارسال کنید.

پس‌از تکمیل نصب، Apigee توصیه می‌کند گذرواژه را از فایل پیکرببندی بردارید.

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG نحوه ثبت تغییرات در فایل‌های پیکربندی را کنترل می‌کند. اگر CONFIG_DELTA_LOG=y را تنظیم کنید، تغییرات پیکربندی برای یک عنصر ثبت نمی‌شود.

PG_USER
PG_PWD

به‌طور پیش‌فرض، پایگاه داده PostgreSQL دو کاربر تعریف‌شده دارد: «postgres» و «apigee».

‫PG_USER به شما امکان می‌دهد نام کاربری کاربر «apigee» را تغییر دهید. نمی‌توانید نام کاربر «postgres» را تغییر دهید.

به‌طور پیش‌فرض، پایگاه داده PostgreSQL دو کاربر تعریف‌شده دارد: «postgres» و «apigee». هر دو کاربر گذرواژه پیش‌فرض «postgres» را دارند. از PG_PWD برای تنظیم گذرواژه با مقدار متفاوت برای هر دو کاربر در زمان نصب استفاده کنید.

پس‌از تکمیل نصب، Apigee توصیه می‌کند گذرواژه را از فایل پیکرببندی بردارید.

PG_MASTER
PG_STANDBY

برای فعال کردن تکثیر آماده‌باش اصلی Postgres تنظیم کنید، به‌این شکل:

PG_MASTER=IPorDNSofNewMaster
PG_STANDBY=IPorDNSofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

‫SMTP را پیکربندی کنید تا Edge بتواند ایمیل‌های مربوط به گذرواژه‌های گم‌شده و اعلان‌های دیگر را ارسال کند.

اگر اطلاعات اعتباری کاربر SMTP لازم نیست، SMTPUSER و SMTPPASSWORD را حذف کنید.

‫SMTPMAILFROM الزامی است.

CASS_JMX_USERNAME نام کاربری Cassandra JMX. اگر اصالت‌سنجی Cassandra JMX را فعال کرده‌اید، لازم است.
CASS_JMX_PASSWORD گذرواژه Cassandra JMX. اگر اصالت‌سنجی Cassandra JMX را فعال کرده‌اید، لازم است.
CASS_JMX_TRUSTSTORE نام کاربری truststore امنیت لایه انتقال/ پوسته ایمن Cassandra JMX، درصورتی‌که امنیت لایه انتقال/ پوسته ایمن مبتنی بر JMX را در Cassandra فعال کرده باشید. کاربر Apigee باید بتواند فایل JMX Truststore را بخواند.
CASS_JMX_TRUSTSTORE_PASS گذرواژه انبار اعتماد SSL مربوط به Cassandra JMX، درصورتی‌که JMX مبتنی بر SSL را در Cassandra فعال کرده باشید.
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
این اطلاعات اعتباری دسترسی به کارگزار Qpid در Qpid Web Management Console را فراهم می‌کند. «کنسول مدیریت وب» میانایی ساده و شهودی برای مدیریت و کنترل کارگزار Qpid ارائه می‌دهد.
FIPS_OS ‫FIPS_OS می‌تواند درست یا نادرست باشد، و مقدار پیش‌فرض آن نادرست است. برای Edge برای نسخه 4.53.00 یا بالاتر «ابر خصوصی» در سیستم‌های عامل دارای FIPS، آن را روی true تنظیم کنید.

علاوه‌بر دارایی‌های فهرست‌شده در اینجا، دارایی‌هایی برای پیکربندی Apigee mTLS وجود دارد. برای اطلاعات بیشتر، پیکربندی Apigee mTLS را ببینید.