एज कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस

नीचे एक 9 नोड एज के लिए पूरी तरह से साइलेंट कॉन्फ़िगरेशन फ़ाइल का उदाहरण दिया गया है इंस्टॉल करना. अपने कॉन्फ़िगरेशन के लिए, इस फ़ाइल में ज़रूरत के मुताबिक बदलाव करें. -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
    
    # FIPS_OS should be set to true when OPDK 4.53 or later is installed on 
    # FIPS enabled operating system
    FIPS_OS=false
    

यहां दी गई टेबल में, इन प्रॉपर्टी के बारे में ज़्यादा जानकारी दी गई है:

प्रॉपर्टी ध्यान दें
आईपी/डीएनएस नाम 127.0.0.1 या 127.0.0.1 के आईपी पते के साथ होस्ट नाम मैपिंग का इस्तेमाल तब न करें, जब किसी नोड का आईपी पता तय करता है.

ध्यान दें कि कैसंड्रा होस्ट की परिभाषाओं के लिए, सिर्फ़ आईपी पतों का इस्तेमाल करें; DNS का उपयोग न करें नाम.

ENABLE_SYSTEM_CHECK

अगर "y" है, तो देखें कि सिस्टम, कॉम्पोनेंट के लिए सीपीयू और मेमोरी से जुड़ी ज़रूरी शर्तों को पूरा करता है या नहीं इंस्टॉल किया जा रहा है. हर कॉम्पोनेंट की ज़रूरी शर्तों के बारे में जानने के लिए, इंस्टॉलेशन की ज़रूरी शर्तें देखें.

जांच बंद करने के लिए, डिफ़ॉल्ट वैल्यू "n" होती है.

ENABLE_DYNAMIC_HOSTIP

अगर किसी सर्वर में कई इंटरफ़ेस कार्ड हैं, तो "hostname -i" कमांड, आईपी पतों की सूची दिखाता है. इसमें, आईपी पतों को स्पेस से अलग किया जाता है. डिफ़ॉल्ट रूप से, Edge इंस्टॉलर पहले आईपी का इस्तेमाल करता है पता दिया गया है, जो शायद सभी स्थितियों में सही न हो. वैकल्पिक रूप से, आप इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में, नीचे दी गई प्रॉपर्टी सेट कर सकता है.

"y" पर सेट होने पर, इंस्टॉलर आपको वह आईपी पता चुनने के लिए कहता है जिसका इस्तेमाल इंस्टॉल करने के लिए करना है. इसकी डिफ़ॉल्ट वैल्यू "n" है.

ADMIN_EMAIL
APIGEE_ADMINPW

सिस्टम एडमिन के पासवर्ड में कम से कम आठ वर्ण होने चाहिए. इसमें एक अपरकेस अक्षर, एक लोअरकेस अक्षर, एक अंक या एक खास वर्ण होना चाहिए. अगर आप छोड़ देते हैं तो आपसे पासवर्ड डालने के लिए कहा जाएगा.

इंस्टॉलेशन पूरा होने के बाद, Apigee का सुझाव है कि आप Google खाते से पासवर्ड हटा दें .

LICENSE_FILE

लाइसेंस फ़ाइल की लोकेशन, जिसे "apigee" से ऐक्सेस किया जा सकता हो उपयोगकर्ता. उदाहरण के लिए, इसे /tmp डायरेक्ट्री में सेव करें और फ़ाइल पर chmod 777 का इस्तेमाल करें. फ़ाइल को Edge के इंस्टॉलेशन डायरेक्ट्री में कॉपी किया जाता है.

APIGEE_LDAPPW

OpenLDAP पासवर्ड के बारे में बताता है.

इंस्टॉलेशन पूरा होने के बाद, Apigee का सुझाव है कि आप Google खाते से पासवर्ड हटा दें .

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

अगर USE_LDAP_REMOTE_HOST n है, तो मैनेजमेंट सर्वर इंस्टॉल करने पर Edge, OpenLDAP को अपने-आप इंस्टॉल कर देता है.

अगर आप हैं, तो USE_LDAP_REMOTE_HOST को y पर सेट करें रिमोट LDAP सर्वर से कनेक्ट किया जा रहा है. OpenLDAP को मैनेजमेंट के साथ इंस्टॉल नहीं किया गया है सर्वर.

अगर आप किसी रिमोट OpenLDAP सर्वर से कनेक्ट कर रहे हैं, तो LDAP_HOST और आईपी पता बताने के लिए LDAP_PORT या डीएनएस नाम और होस्ट के पोर्ट नंबर का इस्तेमाल करें.

LDAP_TYPE
LDAP_SID
LDAP_PEER

बिना डुप्लीकेट कॉपी वाले OpenLDAP के लिए, LDAP_TYPE=1 सेट करें. LDAP_TYPE=2, OpenLDAP के मुताबिक है एक जैसे बनाए जा सकते हैं.

अगर आपकी Edge टोपोलॉजी में एक OpenLDAP सर्वर का इस्तेमाल किया जाता है, तो 1 डालें. अगर आपका Edge इंस्टॉलेशन के लिए, कई OpenLDAP नोड का इस्तेमाल होता है, जैसे कि 13-नोड प्रोडक्शन इंस्टॉलेशन में, तय करें 2.

अगर आपने एक जैसे डेटा को कई जगहों पर स्टोर करने की सुविधा चालू की है, तो इन प्रॉपर्टी को सेट करें:

  • LDAP_SID=1 - यूनीक इस LDAP सर्वर के लिए आईडी. हर LDAP नोड अलग आईडी का इस्तेमाल करता है. उदाहरण के लिए, LDAP पीयर.
  • LDAP_PEER=10.0.0.1 - LDAP मिलते-जुलते ऐप्लिकेशन का आईपी या डीएनएस नाम.
MP_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 नोड के आईपी पते या डीएनएस नाम. सभी ZooKeeper नोड पर, आईपी पते या डीएनएस नेम एक ही क्रम में होने चाहिए.

HOSTIP के लिए वही फ़ॉर्मैट इस्तेमाल करें जो ZK_HOSTS के लिए इस्तेमाल किया जाता है. इसका मतलब है कि अगर आपने ZK_HOSTS के लिए आईपी पता डाला है, तो HOSTIP के लिए भी आईपी पता डालें. अगर डीएनएस का इस्तेमाल किया जाता है, तो फिर दोनों के लिए डीएनएस नाम का इस्तेमाल करें.

एक से ज़्यादा डेटा सेंटर वाले एनवायरमेंट में, दोनों डेटा सेंटर के सभी ZooKeeper नोड की सूची बनाएं.

":ऑब्ज़र्वर" तय करें ZooKeeper नोड पर कार्रवाई बदलने वाला सिर्फ़ तब काम करें, जब कई डेटा सेंटर बनाकर, जैसा कि 12-होस्ट इंस्टॉलेशन में बताया गया है. किसी एक डेटा सेंटर के इंस्टॉलेशन में, उस मॉडिफ़ायर को छोड़ दें. ज़्यादा जानकारी के लिए, यह देखें 12-होस्ट वाले क्लस्टर में इंस्टॉलेशन.

ZK_CLIENT_HOSTS

इस डेटा सेंटर में इस्तेमाल किए जाने वाले ZooKeeper नोड के आईपी पते या डीएनएस नाम. सभी ZooKeeper नोड पर, आईपी पते या डीएनएस नेम एक ही क्रम में होने चाहिए.

HOSTIP के लिए उसी फ़ॉर्मैट का इस्तेमाल करें जिसका इस्तेमाल आपने ZK_CLIENT_HOSTS. इसका मतलब है कि अगर आप ZK_CLIENT_HOSTS के लिए आईपी पता बताते हैं, तो आईपी का इस्तेमाल करें HOSTIP के लिए पता. अगर आपने आप एक डीएनएस का इस्तेमाल करते हैं, फिर दोनों के लिए डीएनएस के नाम का इस्तेमाल करते हैं.

किसी सिंगल डेटा सेंटर इंस्टॉलेशन में, ये वही नोड होते हैं जो ZK_HOSTS.

मल्टी-डेटा सेंटर एनवायरमेंट में, इस डेटा सेंटर में सिर्फ़ ZooKeeper नोड की सूची बनाएं. ज़्यादा जानकारी के लिए, यह देखें 12-होस्ट वाले क्लस्टर में इंस्टॉलेशन.

CASS_CLUSTERNAME Cassandra क्लस्टर का नाम बताएं. हालांकि, ऐसा करना ज़रूरी नहीं है. डिफ़ॉल्ट नाम "Apigee" है.
CASS_HOSTS

कैसंड्रा नोड की कॉमा-सेपरेटेड लिस्ट दिखाता है होस्ट के आईपी पते (डीएनएस नाम नहीं), और विकल्प के तौर पर, उनका डेटा सेंटर नंबर और रैक से जुड़ा होगा, जिससे वे संबंधित हैं.

प्रोडक्शन टॉपोलॉजी के लिए, इस सूची में कम से कम तीन नोड होने चाहिए. पहला दो नोड का इस्तेमाल "सीड सर्वर" के तौर पर किया जाता है. इस वजह से, आईपी पते सभी कैसंड्रा नोड पर एक ही क्रम है.

सूची में हर एंट्री के लिए सिंटैक्स इस तरह है:

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.

एक से ज़्यादा डेटासेंटर वाले एनवायरमेंट में, फ़ायरवॉल से जुड़ी समस्याओं को हल करने के लिए, CASS_HOSTS को इस तरह से क्रम में लगाया जाना चाहिए (जैसा कि ऊपर दिए गए उदाहरण में दिखाया गया है) कि मौजूदा डेटासेंटर के नोड सबसे पहले रखे जाएं. ज़्यादा जानकारी के लिए, 12-होस्ट क्लस्टर वाला इंस्टॉलेशन देखें.

Cassandra होस्ट के लिए rack_number तय करने के बारे में जानकारी पाने के लिए, 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

एसएमटीपी को कॉन्फ़िगर करें, ताकि Edge पर खोए हुए पासवर्ड और अन्य सूचनाओं के लिए ईमेल भेजे जा सकें.

अगर एसएमटीपी उपयोगकर्ता क्रेडेंशियल की ज़रूरत नहीं है, तो SMTPUSER और SMTPPASSWORD को छोड़ दें.

SMTPMAILFROM ज़रूरी है.

CASS_JMX_USERNAME Cassandra JMX का उपयोगकर्ता नाम. अगर आपने कैसंड्रा जेएमएक्स की पुष्टि करने की सुविधा चालू की है, तो ज़रूरी है.
CASS_JMX_PASSWORD Cassandra JMX का पासवर्ड. अगर आपने Cassandra JMX पुष्टि करने की सुविधा चालू की है, तो यह ज़रूरी है.
CASS_JMX_TRUSTSTORE अगर आपने Cassandra में एसएसएल पर आधारित JMX को चालू किया है, तो Cassandra JMX एसएसएल ट्रस्टस्टोर का उपयोगकर्ता नाम. JMX ट्रस्टस्टोर फ़ाइल को Apigee उपयोगकर्ता पढ़ सकता है.
CASS_JMX_TRUSTSTORE_PASS अगर आपने कैसंड्रा में एसएसएल आधारित जेएमएक्स चालू किया है, तो कैसंद्रा जेएमएक्स एसएसएल ट्रस्टस्टोर पासवर्ड.
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
इन क्रेडेंशियल से, Qpid ब्रोकर के Qpid वेब मैनेजमेंट कंसोल को ऐक्सेस किया जा सकता है. वेब प्रबंधन कंसोल, प्रबंधन के लिए सरल और सहज इंटरफ़ेस प्रदान करता है Qpid ब्रोकर के कंट्रोल का इस्तेमाल करती हैं.
FIPS_OS FIPS_OS का मान सही या गलत हो सकता है. हालांकि, इसका डिफ़ॉल्ट मान 'गलत' हो सकता है. एफ़आईपीएस की सुविधा वाले ऑपरेटिंग सिस्टम पर, इसे 'निजी क्लाउड' के लिए Edge के 4.53.00 या इसके बाद के वर्शन के लिए 'सही' पर सेट करें.

यहां दी गई प्रॉपर्टी के अलावा, Apigee mTLS को कॉन्फ़िगर करने की प्रॉपर्टी भी मौजूद हैं. ज़्यादा जानकारी के लिए, Apigee mTLS को कॉन्फ़िगर करना लेख पढ़ें.