एज इंस्टॉलेशन की खास जानकारी

Edge for Private Cloud v. 4.17.01

आम तौर पर, Edge इंस्टॉलेशन में Edge के ऐसे कॉम्पोनेंट होते हैं जिन्हें कई नोड पर डिस्ट्रिब्यूट किया जाता है. किसी नोड पर Edge इंस्टॉल करने के बाद, उस नोड पर एक या उससे ज़्यादा Edge कॉम्पोनेंट इंस्टॉल और कॉन्फ़िगर करें.

इंस्टॉल करने की प्रोसेस

किसी नोड पर Edge इंस्टॉल करने की प्रोसेस में कई चरण होते हैं:

  • नोड पर SELinux को बंद करें या उसे अनुमति देने वाले मोड पर सेट करें. ज़्यादा जानकारी के लिए, Edge apigee-setup टूल इंस्टॉल करना देखें.
  • तय करें कि आपको Cassandra की पुष्टि करने की सुविधा चालू करनी है या नहीं.
  • तय करें कि आपको Postgres के लिए, मास्टर-स्टैंडबाय रिप्लिकेशन सेट अप करना है या नहीं.
  • सुझाई गई टोपोलॉजी की सूची में से अपना Edge कॉन्फ़िगरेशन चुनें. उदाहरण के लिए, आपके पास टेस्टिंग के लिए एक नोड पर या प्रोडक्शन के लिए 13 नोड पर Edge इंस्टॉल करने का विकल्प है. ज़्यादा जानकारी के लिए, पोस्टग्रे के लिए मास्टर-स्टैंडबाय रेप्लिकेशन सेट अप करना देखें.
  • अपनी चुनी गई टोपोलॉजी के हर नोड पर, Edge apigee-setup यूटिलिटी इंस्टॉल करें:
    • Edge bootstrap_4.17.01.sh फ़ाइल को /tmp/bootstrap_4.17.01.sh पर डाउनलोड करें.
    • Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें.
    • Edge apigee-setup यूटिलिटी और डिपेंडेंसी इंस्टॉल करें.

      ज़्यादा जानकारी के लिए, Edge apigee-setup सुविधा को इंस्टॉल करें पर जाएं.
  • अपनी चुनी गई टॉपोलॉजी के आधार पर, हर नोड पर एक या एक से ज़्यादा Edge कॉम्पोनेंट इंस्टॉल करने के लिए, apigee-setup यूटिलिटी का इस्तेमाल करें.
    किसी नोड पर Edge कॉम्पोनेंट इंस्टॉल करना देखें.
  • मैनेजमेंट सर्वर नोड पर, apigee-प्रावधान इंस्टॉल करने के लिए apigee-setup सुविधा का इस्तेमाल करें, वे सुविधाएं जिनका इस्तेमाल आप Edge संगठनों को बनाने और प्रबंधित करने के लिए करते हैं.
    इस बारे में ज़्यादा जानने के लिए, किसी संगठन को शामिल करना लेख पढ़ें.

इंस्टॉल करने की अनुमति किसे है

Apigee Edge की डिस्ट्रिब्यूशन फ़ाइलें, RPM और डिपेंडेंसी के सेट के तौर पर इंस्टॉल की जाती हैं. Edge को इंस्टॉल, अनइंस्टॉल, और अपडेट करने के लिए, Edge के निर्देशों को रूट उपयोगकर्ता या ऐसे उपयोगकर्ता से चलाना चाहिए जिसके पास sudo का पूरा ऐक्सेस हो. पूरी तरह से sudo ऐक्सेस का मतलब है कि उपयोगकर्ता के पास sudo ऐक्सेस है, ताकि वह वही काम कर सके जो रूट कर सकता है.

नीचे दिए गए निर्देशों या स्क्रिप्ट को चलाने के लिए, उपयोगकर्ता के पास रूट ऐक्सेस या फिर sudo का पूरा ऐक्सेस होना चाहिए:

  • apigee-service सुविधा:
    • apigee-service के निर्देश: इंस्टॉल करें, अनइंस्टॉल करें, अपडेट करें.
    • apigee-all कमांड: install, uninstall, update.
  • setup.sh स्क्रिप्ट, Edge के कॉम्पोनेंट इंस्टॉल करने के लिए है. ज़रूरी आरपीएम इंस्टॉल करने के लिए, "apigee-service install" का इस्तेमाल करें. इसके बाद, अगर ज़रूरी न हो, तो रूट या sudo का पूरा ऐक्सेस दें.)
  • Edge के कॉम्पोनेंट अपडेट करने के लिए, update.sh स्क्रिप्ट

साथ ही, Edge इंस्टॉलर आपके सिस्टम पर "apigee" नाम का एक नया उपयोगकर्ता बनाता है. Edge के कई निर्देश, "apigee" उपयोगकर्ता के तौर पर चलाए जाने के लिए, sudo का इस्तेमाल करते हैं.

ऊपर दिए गए निर्देशों के अलावा, अन्य सभी निर्देश चलाने के लिए, उपयोगकर्ता के पास "apigee" उपयोगकर्ता के लिए, सुडो ऐक्सेस की पूरी अनुमति होनी चाहिए. इन निर्देशों में ये शामिल हैं:

  • apigee-service की सुविधा वाले कमांड. इनमें ये शामिल हैं:
    • apigee-service कमांड, जैसे कि start, stop, restart, configure.
    • apigee-all कमांड, जैसे कि start, stop, restart, configure.

किसी उपयोगकर्ता को "apigee" उपयोगकर्ता का पूरा sudo ऐक्सेस देने के लिए, sudoers फ़ाइल में बदलाव करें और ये जोड़ें:

installUser        ALL=(apigee)      NOPASSWD: ALL

यहां installUser, Edge का इस्तेमाल करने वाले व्यक्ति का उपयोगकर्ता नाम है.

Edge कमांड का इस्तेमाल करके इस्तेमाल की जाने वाली सभी फ़ाइलों या संसाधनों को "apigee" उपयोगकर्ता ऐक्सेस कर सकता है. इसमें Edge लाइसेंस फ़ाइल और कोई भी कॉन्फ़िगरेशन फ़ाइल शामिल होती है.

कॉन्फ़िगरेशन फ़ाइल बनाते समय, उसके मालिक को "apigee:apigee" में बदलें, ताकि यह पक्का किया जा सके कि उसे Edge के निर्देश से ऐक्सेस किया जा सकता है:

  1. किसी भी उपयोगकर्ता के तौर पर, एडिटर में फ़ाइल बनाएं.
  2. फ़ाइल के मालिक को "apigee:apigee" पर सेट करें. अगर आपने Edge सेवा को चलाने वाले उपयोगकर्ता को "apigee" से बदल दिया है, तो फ़ाइल के मालिक को Edge सेवा को चलाने वाले उपयोगकर्ता पर सेट करें.

इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइलों की जगह

आपको apigee-setup सुविधा को एक कॉन्फ़िगरेशन फ़ाइल देनी होगी, जिसमें Edge इंस्टॉलेशन के बारे में जानकारी हो. साइलेंट इंस्टॉलेशन के लिए सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल "apigee" उपयोगकर्ता के पास ऐक्सेस करने लायक या पढ़ने लायक हो. उदाहरण के लिए, फ़ाइल को नोड पर /usr/local/var या /usr/local/share डायरेक्ट्री में डालें और "apigee:apigee" में रखें.

कॉन्फ़िगरेशन फ़ाइल में मौजूद सभी जानकारी ज़रूरी है. हालांकि, Edge सिस्टम के एडमिन के पासवर्ड की जानकारी देना ज़रूरी नहीं है. पासवर्ड को छोड़ देने पर, apigee-setup यूटिलिटी आपसे कमांड लाइन पर पासवर्ड डालने का अनुरोध करती है.

ज़्यादा जानकारी के लिए, नोड पर Edge कॉम्पोनेंट इंस्टॉल करना देखें.

इंस्टॉलेशन में होने वाली गड़बड़ी को ठीक करना

अगर Edge कॉम्पोनेंट के इंस्टॉलेशन के दौरान कोई समस्या आती है, तो समस्या को ठीक करने के बाद, इंस्टॉलर को फिर से चलाएं. इंस्टॉलर को ऐसे मामलों में बार-बार चलाने के लिए डिज़ाइन किया गया है जहां उसे गड़बड़ी का पता चलता है या अगर बाद में आपको इंस्टॉलेशन के बाद किसी कॉम्पोनेंट में बदलाव करना हो या उसे अपडेट करना हो.

इंटरनेट या बिना इंटरनेट वाला इंस्टॉलेशन

किसी नोड पर Edge इंस्टॉल करने के लिए, यह ज़रूरी है कि नोड, Apigee रिपॉज़िटरी को ऐक्सेस कर सके:

  • बाहरी इंटरनेट कनेक्शन वाले नोड

    एज आरपीएम और डिपेंडेंसी इंस्टॉल करने के लिए, बाहरी इंटरनेट कनेक्शन वाले नोड, Apigee डेटा स्टोर करने की जगह को ऐक्सेस करते हैं.
  • बिना बाहरी इंटरनेट कनेक्शन वाले नोड

    बिना बाहरी इंटरनेट कनेक्शन वाले नोड, Apigee डेटा स्टोर करने की उस जगह के डुप्लीकेट वर्शन को ऐक्सेस कर सकते हैं जिसे आपने अंदरूनी तौर पर सेट अप किया है. डेटा स्टोर करने की इस जगह में सभी एज आरपीएम शामिल होते हैं. हालांकि, आपको यह पक्का करना होगा कि आपके पास इंटरनल नेटवर्क पर रिपॉज़िटरी (डेटा स्टोर करने की जगह) से उपलब्ध दूसरी सभी डिपेंडेंसी भी शामिल हैं.

    ध्यान दें: Apigee, अपने सार्वजनिक रिपॉज़िटरी में तीसरे पक्ष की सभी डिपेंडेंसी को होस्ट नहीं करता. आपको सार्वजनिक तौर पर ऐक्सेस किए जा सकने वाले रिपॉज़िटरी से, इन डिपेंडेंसी को डाउनलोड और इंस्टॉल करना होगा.

    इंटरनल Apigee रिपॉज़िटरी बनाने के लिए, आपको Edge RPM और डिपेंडेंसी डाउनलोड करने के लिए, किसी ऐसे नोड की ज़रूरत होती है जिसके पास बाहरी इंटरनेट ऐक्सेस हो. इंटरनल रिपॉज़िटरी बनाने के बाद, उसे किसी दूसरे नोड पर ले जाया जा सकता है या इंस्टॉलेशन के लिए, उस नोड को Edge नोड के लिए ऐक्सेस किया जा सकता है.

Edge के वर्शन को मैनेज करने के लिए, किसी लोकल Edge रिपॉज़िटरी का इस्तेमाल करना

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

हालांकि, लोकल रिपॉज़िटरी का इस्तेमाल करने का एक और फ़ायदा है. यह फ़ायदा, बाहरी इंटरनेट कनेक्शन वाले नोड के लिए भी है. Apigee की सार्वजनिक रिपॉज़िटरी से Edge इंस्टॉल करने पर, हमेशा Edge के सबसे नए आरपीएम इंस्टॉल होते हैं. इसलिए, अगर आपको Edge के किसी खास वर्शन के लिए Edge RPM डाउनलोड और सेव करने हैं, तो आपको उस Edge वर्शन के लिए एक लोकल रिपॉज़िटरी बनानी होगी. इसके बाद, Edge के किसी भी वर्शन को इंस्टॉल करने के लिए, स्थानीय स्टोर का इस्तेमाल किया जा सकता है.

उदाहरण के लिए, Edge डेवलपमेंट एनवायरमेंट इंस्टॉल करने के लिए, पहले लोकल रिपॉज़िटरी का इस्तेमाल किया जाता है. इसके बाद, जब आप प्रोडक्शन एनवायरमेंट पर जाने के लिए तैयार हों, तो लोकल रिपॉज़िटरी से Edge को फिर से इंस्टॉल करें. लोकल रिपॉज़िटरी से इंस्टॉल करने पर, यह पक्का किया जा सकता है कि आपके डेवलपमेंट और प्रोडक्शन एनवायरमेंट मैच करते हैं.

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

RPM इंस्टॉलेशन की डिपेंडेंसी को हल करना

Apigee Edge की डिस्ट्रिब्यूशन फ़ाइलें, RPM फ़ाइलों के सेट के तौर पर इंस्टॉल की जाती हैं. इनमें से हर फ़ाइल में, इंस्टॉलेशन के लिए ज़रूरी डिपेंडेंसी की अपनी चेन हो सकती है. इनमें से कई डिपेंडेंसी, तीसरे पक्ष के ऐसे कॉम्पोनेंट से तय होती हैं जो Apigee के कंट्रोल में नहीं होते और कभी भी बदल सकते हैं. इसलिए, दस्तावेज़ में हर डिपेंडेंसी के वर्शन नंबर की साफ़ तौर पर जानकारी नहीं दी गई है.

अगर इंटरनेट ऐक्सेस वाली मशीन पर इंस्टॉलेशन किया जा रहा है, तो नोड ज़रूरी RPM और डिपेंडेंसी डाउनलोड कर सकता है. हालांकि, अगर इंटरनेट ऐक्सेस के बिना किसी नोड से इंस्टॉल किया जा रहा है, तो आम तौर पर एक इंटरनल रिपॉज़िटरी सेट अप किया जाता है. इसमें सभी ज़रूरी डिपेंडेंसी शामिल होती हैं. यह पक्का करने का एक ही तरीका है कि आपके लोकल रेपो में सभी डिपेंडेंसी शामिल हैं. इसके लिए, इंस्टॉलेशन की कोशिश करें, उन डिपेंडेंसी की पहचान करें जो मौजूद नहीं हैं, और उन्हें लोकल रेपो में कॉपी करें. ऐसा तब तक करें, जब तक इंस्टॉलेशन पूरा नहीं हो जाता.

Yum के सामान्य निर्देश

Linux के लिए Edge इंस्टॉल करने वाले टूल, कॉम्पोनेंट को इंस्टॉल और अपडेट करने के लिए Yum पर निर्भर करते हैं. किसी नोड पर इंस्टॉलेशन मैनेज करने के लिए, आपको कई Yum निर्देशों का इस्तेमाल करना पड़ सकता है.

  • Yum की सभी कैश मेमोरी मिटाएं:
    sudo yum clean all
  • Edge कॉम्पोनेंट को अपडेट करने के लिए:
    sudo yum update componentName
    उदाहरण के लिए:
    sudo yum update apigee-setup
    sudo yum update edge-management-server

फ़ाइल सिस्टम का स्ट्रक्चर

Edge, /opt/apigee डायरेक्ट्री में सभी फ़ाइलें इंस्टॉल करता है.

इस गाइड और Edge के इस्तेमाल से जुड़ी गाइड में, रूट इंस्टॉलेशन डायरेक्ट्री को इस तरह से दिखाया गया है:

<inst_root>/apigee

Private Cloud के लिए Apigee Edge को डिप्लॉय करने के लिए, इंस्टॉलेशन इस फ़ाइल सिस्टम स्ट्रक्चर का इस्तेमाल करता है.

लॉग फ़ाइलें

apigee-setup और setup.sh स्क्रिप्ट की लॉग फ़ाइल, /tmp/setup-root.log में लिखी जाती है.

हर कॉम्पोनेंट की लॉग फ़ाइलें, /opt/apigee/var/log डायरेक्ट्री में होती हैं. हर कॉम्पोनेंट की अपनी सबडायरेक्ट्री होती है. उदाहरण के लिए, मैनेजमेंट सर्वर के लॉग, डायरेक्ट्री में मौजूद होते हैं:

/opt/apigee/var/log/edge-management-server

नीचे दी गई टेबल में लॉग फ़ाइलों की जगह बताई गई है:

कॉम्पोनेंट

जगह की जानकारी

मैनेजमेंट सर्वर

&lt;inst_root&gt;/apigee/var/log/edge-management-server

राऊटर

&lt;inst_root&gt;/apigee/var/log/edge-router

मैसेज प्रोसेसर

<inst_root>/apigee/var/log/edge-message-processor

Apigee Qpid सर्वर

<inst_root>/apigee/var/log/edge-qpid-server

Apigee Postgres सर्वर

&lt;inst_root&gt;/apigee/var/log/edge-postgres-server

Edge का यूज़र इंटरफ़ेस (यूआई)

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

&lt;inst_root&gt;/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

कassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

&lt;inst_root&gt;/apigee/var/log/apigee-qpidd

PostgreSQL डेटाबेस

<inst_root>/apigee/var/log/apigee-postgresql

Data

कॉम्पोनेंट

जगह की जानकारी

मैनेजमेंट सर्वर

<data_root>/apigee/data/edge-management-server

राऊटर

<data_root>/apigee/data/edge-router

मैसेज प्रोसेसर

&lt;data_root&gt;/apigee/data/edge-message-processor

Apigee Qpid एजेंट

<data_root>/apigee/data/edge-qpid-server

Apigee Postgres एजेंट

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

&lt;data_root&gt;/apigee/data/apigee-zookeeper

OpenLDAP

&lt;data_root&gt;/apigee/data/apigee-openldap

कास्सांद्रा

&lt;data_root&gt;/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

PostgreSQL डेटाबेस

&lt;data_root&gt;/apigee/data/apigee-postgres/pgdata

इंस्टॉलेशन के बाद होने वाले टास्क

इंस्टॉल पूरा होने के बाद, Edge कॉम्पोनेंट पर अन्य कार्रवाइयां की जा सकती हैं.

इंस्टॉल किए जाने के बाद, Edge कॉम्पोनेंट कॉन्फ़िगर करना

इंस्टॉल करने के बाद Edge को कॉन्फ़िगर करने के लिए, .properties फ़ाइलों और Edge की सुविधाओं का इस्तेमाल किया जाता है. उदाहरण के लिए, Edge यूज़र इंटरफ़ेस (यूआई) पर TLS/एसएसएल कॉन्फ़िगर करने के लिए, ज़रूरी प्रॉपर्टी सेट करने के लिए, .properties फ़ाइलों में बदलाव किया जाता है. .properties फ़ाइलों में बदलाव करने के लिए, आपको उस Edge कॉम्पोनेंट को रीस्टार्ट करना होगा जिस पर असर पड़ा है.

.property फ़ाइलें, /opt/apigee/customer/application डायरेक्ट्री में मौजूद होती हैं. उस डायरेक्ट्री में हर कॉम्पोनेंट की अपनी .properties फ़ाइल होती है. उदाहरण के लिए, router.property और management-server.property.

किसी कॉम्पोनेंट के लिए प्रॉपर्टी सेट करने के लिए, उससे जुड़ी .property फ़ाइल में बदलाव करें, और फिर कॉम्पोनेंट को रीस्टार्ट करें:

> /opt/apigee/apigee-service/bin/apigee-service component restart

उदाहरण के लिए:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Edge को अपडेट करने पर, /opt/apigee/customer/application डायरेक्ट्री में मौजूद .properties फ़ाइलें पढ़ी जाती हैं. इसका मतलब है कि कॉम्पोनेंट पर सेट की गई सभी प्रॉपर्टी, अपडेट में बनी रहेंगी.

Edge के कॉन्फ़िगरेशन के बारे में ज़्यादा जानकारी के लिए, Edge को कॉन्फ़िगर करने का तरीका देखें.

Edge के कॉम्पोनेंट पर निर्देश शुरू करना

Edge, /opt/apigee/apigee-service/bin में मैनेजमेंट यूटिलिटी इंस्टॉल करता है. इनका इस्तेमाल, Edge इंस्टॉलेशन को मैनेज करने के लिए किया जा सकता है. उदाहरण के लिए, apigee-all सुविधा का इस्तेमाल करके, नोड पर सभी Edge कॉम्पोनेंट को शुरू, बंद, रीस्टार्ट किया जा सकता है या उनकी स्थिति का पता लगाया जा सकता है:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

अलग-अलग कॉम्पोनेंट को कंट्रोल और कॉन्फ़िगर करने के लिए, apigee-service टूल का इस्तेमाल करें. apigee-service की सुविधा का फ़ॉर्मैट इस तरह का है:

/opt/apigee/apigee-service/bin/apigee-service component action

उदाहरण के लिए, Edge Router को रीस्टार्ट करने के लिए:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

/opt/apigee डायरेक्ट्री की जांच करके, नोड पर इंस्टॉल किए गए कॉम्पोनेंट की सूची देखी जा सकती है. उस डायरेक्ट्री में, नोड पर इंस्टॉल किए गए हर Edge कॉम्पोनेंट के लिए एक सबडायरेक्ट्री होती है. हर सबडायरेक्ट्री के नाम के आगे ये प्रीफ़िक्स होते हैं:

  • apigee - Edge का इस्तेमाल करने वाला तीसरे पक्ष का कॉम्पोनेंट. उदाहरण के लिए, apigee-cassandra.
  • edge - Apigee का Edge कॉम्पोनेंट. उदाहरण के लिए, edge-management-server.
  • edge-mint - कमाई करने की सुविधा से जुड़ा एक कॉम्पोनेंट. उदाहरण के लिए, edge-mint-management-server.
  • baas - एक API BaaS कॉम्पोनेंट. उदाहरण के लिए, baas-usergrid.

किसी कॉम्पोनेंट के लिए कार्रवाइयों की पूरी सूची, कॉम्पोनेंट पर निर्भर करती है. हालांकि, सभी कॉम्पोनेंट में ये कार्रवाइयां की जा सकती हैं:

  • शुरू करना, बंद करना, रीस्टार्ट करना
  • स्टेटस, वर्शन
  • बैकअप, पहले जैसा करें
  • इंस्टॉल करना, अनइंस्टॉल करना