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

Edge for Private Cloud v4.18.01

यहां 9 नोड एज इंस्टॉलेशन के लिए, पूरी तरह से साइलेंट कॉन्फ़िगरेशन फ़ाइल का उदाहरण दिया गया है. अपने कॉन्फ़िगरेशन के लिए, इस फ़ाइल में ज़रूरत के हिसाब से बदलाव करें. इस फ़ाइल को शामिल करने के लिए, setup.sh के -f विकल्प का इस्तेमाल करें. यहां यह भी दिखाया गया है कि हर एज टोपोलॉजी के लिए कॉन्फ़िगरेशन फ़ाइलें कैसी हैं.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
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.

# 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.

# IP (not DNS names) of the Cassandra hosts separated by spaces.
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>"

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

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

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

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

ENABLE_DYNAMIC_HOSTIP

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

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

ADMIN_EMAIL
APIGEE_ADMINPW

सिस्टम एडमिन का पासवर्ड कम से कम 8 वर्णों का होना चाहिए. साथ ही, इसमें अंग्रेज़ी का एक बड़ा अक्षर, एक छोटा अक्षर, एक अंक या एक विशेष वर्ण होना चाहिए. पासवर्ड न डालने पर, आपको वह पासवर्ड डालने के लिए कहा जाएगा.

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

LICENSE_FILE

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

APIGEE_LDAPPW

OpenLDAP पासवर्ड तय करता है.

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

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

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

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

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

LDAP_TYPE
LDAP_SID
LDAP_PEER

OpenLDAP के लिए बिना किसी नकल को LDAP_TYPE=1 सेट करें. LDAP_TYPE=2, OpenLDAP से जुड़ा है, जिसे रेप्लिकेशन के तौर पर कॉपी किया गया है.

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

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

  • LDAP_SID=1 - इस LDAP सर्वर के लिए यूनीक आईडी. हर LDAP नोड एक अलग आईडी का इस्तेमाल करता है. उदाहरण के लिए, LDAP मिलते-जुलते ऐप्लिकेशन के लिए 2 पर सेट करें.
  • LDAP_PEER=10.0.0.1 - LDAP मिलते-जुलते ऐप्लिकेशन के आईपी या डीएनएस का नाम.
MP_POD मैसेज प्रोसेसर और राऊटर पॉड का नाम बताएं. डिफ़ॉल्ट रूप से, नाम गेटवे होता है.
REGION

इलाके का नाम. कन्वेंशन के मुताबिक, नाम आम तौर पर dc-# के रूप में होते हैं, जहां # पूर्णांक वैल्यू से मेल खाता है. उदाहरण के लिए, dc-1, dc-2 वगैरह. अगर आपको कई डेटा सेंटर वाले माहौल में इंस्टॉल करने के लिए dc-1 का इस्तेमाल नहीं करना है, तो ऐसा किया जा सकता है.

कई डेटा सेंटर इंस्टॉलेशन में, वैल्यू dc-1 या dc-2 वगैरह होती है. यह इस बात पर निर्भर करता है कि आप किस डेटा सेंटर को इंस्टॉल कर रहे हैं. हालांकि, आपको dc-# फ़ॉर्म में सिर्फ़ नामों का इस्तेमाल करने तक ही सीमित नहीं हैं, आप क्षेत्र के लिए किसी भी नाम का इस्तेमाल कर सकते हैं.

ZK_HOSTS

महारथी नोड के आईपी पते या डीएनएस नाम. आईपी पतों या डीएनएस के नामों को सभी ज़ूलॉजिकर नोड पर एक ही क्रम में डाला जाना चाहिए.

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

कई डेटा सेंटर वाले माहौल में, दोनों डेटा सेंटर के सभी ZoomKeeper नोड की सूची बनाएं.

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

ZK_CLIENT_HOSTS

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

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

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

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

CASS_CLUSTERNAME वैकल्पिक रूप से, कैसंड्रा क्लस्टर का नाम बताएं. डिफ़ॉल्ट नाम "Apigee" है.
CASS_HOSTS

Cassandra नोड के आईपी पते (न कि डीएनएस के नाम). पहले दो नोड, सीड सर्वर के तौर पर इस्तेमाल किए जाएंगे. सभी आईपी पतों को कैसंड्रा नोड में एक ही क्रम में रखा जाना चाहिए.

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

उदाहरण के लिए, '192.168.124.201:1, 1 = डेटा सेंटर 1 और रैक/उपलब्धता ज़ोन 1 और '192.168.124.204:2,1 = डेटासेंटर 2 और रैक/उपलब्धता ज़ोन 1.

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

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

अगर आपने Cassandra की पुष्टि करने की सुविधा चालू की है, तो CASS_AUTH=y को इन प्रॉपर्टी के ज़रिए इस्तेमाल किया जा सकता है.

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

PG_USER
PG_PWD

डिफ़ॉल्ट रूप से, PostgreSQL डेटाबेस में दो उपयोगकर्ता तय किए जाते हैं: 'postgres' और 'apigee'.

PG_USER आपको 'apigee' उपयोगकर्ता का उपयोगकर्ता नाम बदलने की अनुमति देता है. आप 'पोस्टग्रे' उपयोगकर्ता का नाम नहीं बदल सकते.

डिफ़ॉल्ट रूप से, PostgreSQL डेटाबेस में दो उपयोगकर्ता तय किए जाते हैं: 'postgres' और 'apigee'. दोनों उपयोगकर्ताओं के पास 'postgres' का डिफ़ॉल्ट पासवर्ड होता है. इंस्टॉल के समय, दोनों उपयोगकर्ताओं के लिए पासवर्ड अलग-अलग वैल्यू पर सेट करने के लिए, PG_PWD का इस्तेमाल करें.

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

PG_MASTER
PG_STANDBY

Postgres के मास्टर-स्टैंडअलोन रेप्लिकेशन को इस तरह से चालू करें:

PG_MMaster=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

SMTPMAILFROM ज़रूरी है.