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

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

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

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

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

     ज़्यादा जानकारी के लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करें देखें.

6. अपनी चुनी गई टोपोलॉजी के हिसाब से हर नोड पर एक या उससे ज़्यादा Edge कॉम्पोनेंट इंस्टॉल करने के लिए, apigee-setup सुविधा का इस्तेमाल करें.

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

7. मैनेजमेंट सर्वर नोड पर, apigee-setup यूटिलिटी का इस्तेमाल apigee-provision को इंस्टॉल करने के लिए करें. यह उन यूटिलिटी को इंस्टॉल करता है जिनका इस्तेमाल, Edge के संगठन बनाने और उन्हें मैनेज करने के लिए किया जाता है.

   ज़्यादा जानकारी के लिए, संगठन में शामिल होना लेख पढ़ें.

8. इंस्टॉलेशन पूरा होने के बाद हर नोड पर क्लासिक यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:

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

9. (सुझाया गया) शुरुआती इंस्टॉलेशन पूरा करने के बाद, Apigee का सुझाव है कि आप नया Edge यूज़र इंटरफ़ेस (यूआई) (जिसका कॉम्पोनेंट नाम edge-management-ui है) इंस्टॉल करें. यह निजी क्लाउड के लिए, Apigee Edge के डेवलपर और एडमिन के लिए एक बेहतर यूज़र इंटरफ़ेस है.

   ज़्यादा जानकारी के लिए, नया Edge यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करें देखें.

इंस्टॉल पूरा होने के बाद, इंस्टॉल करने के बाद होने वाली सामान्य कार्रवाइयों की यह सूची देखें.

कौन इंस्टॉल कर सकता है

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

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

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

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

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

• apigee-service यूटिलिटी कमांड शामिल हैं. इनमें ये शामिल हैं:
  • apigee-service निर्देश दिए जाते हैं, जैसे कि start, stop, restart, configure.
  • apigee-all कमांड दिए जाते हैं, जैसे कि start, stop, restart, configure.

"apigee" उपयोगकर्ता के लिए पूर्ण sudo ऐक्सेस वाला उपयोगकर्ता बनाना

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

कॉन्फ़िगरेशन फ़ाइलों पर अनुमतियां सेट करना

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

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

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

रूट और नॉन-रूट उपयोगकर्ता के बीच Edge इंस्टॉल करने के टास्क को अलग करना

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

1. रूट के हिसाब से किए गए टास्क:
   1. bootstrap_4.52.01.sh फ़ाइल को डाउनलोड करके चलाएं:

      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

      यह चरण, apigee-service यूटिलिटी इंस्टॉल करता है और "apigee" उपयोगकर्ता बनाता है.

   2. "apigee" उपयोगकर्ता के लिए पूरे सुडो ऐक्सेस वाला उपयोगकर्ता बनाना में बताए गए तरीके के मुताबिक, "apigee" उपयोगकर्ता को पूरा sudo ऐक्सेस पाने के लिए उपयोगकर्ता को कॉन्फ़िगर करें.
   3. apigee-setup यूटिलिटी इंस्टॉल करें:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. नोड पर Edge आरपीएम इंस्टॉल करने के लिए apigee-setup सुविधा का इस्तेमाल करें:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      नोड पर इंस्टॉल किए गए Edge आरपीएम आपकी टोपोलॉजी पर निर्भर करते हैं. उपलब्ध कॉम्पोनेंट की सूची में ये कॉम्पोनेंट शामिल हैं: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. जब रूट उपयोगकर्ता नोड पर Edge आरपीएम इंस्टॉल कर लेता है, तो "apigee" उपयोगकर्ता के लिए पूरी सूडो ऐक्सेस वाला उपयोगकर्ता कॉन्फ़िगरेशन प्रोसेस को पूरा करता है:
   1. नोड पर Edge के कॉम्पोनेंट का कॉन्फ़िगरेशन पूरा करने के लिए, setup.sh सुविधा का इस्तेमाल करें. निर्देश का टाइप, उन कॉम्पोनेंट पर निर्भर करता है जिन्हें आपने नोड पर इंस्टॉल किया है. पूरी सूची के लिए, नोड पर एज कॉम्पोनेंट इंस्टॉल करें देखें.

      उदाहरण के लिए, ZooKeeper और Cassandra को इंस्टॉल करने के लिए, इस कमांड का इस्तेमाल करें:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      जहां configFile, Edge की कॉन्फ़िगरेशन फ़ाइल है.

      इसके अलावा, एक ही जगह पर ऐप्लिकेशन इंस्टॉल करने के लिए, इस कमांड का इस्तेमाल करें:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

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

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

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

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

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

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

इंस्टॉल या अपग्रेड करने के बाद, हर उस नोड पर Edge यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करना न भूलें जिस पर यह चल रहा है.

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

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

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

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

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

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

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

Edge का वर्शन मैनेज करने के लिए, लोकल Edge का डेटा स्टोर करने की जगह का इस्तेमाल करना

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

आरपीएम इंस्टॉलेशन की डिपेंडेंसी से जुड़ी समस्या हल करना

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

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

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 कार्रवाइयों की गाइड में, रूट इंस्टॉलेशन डायरेक्ट्री को इस तरह से नोट किया जाता है:

/opt/apigee

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

लॉग फ़ाइलें

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

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

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

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

कॉम्पोनेंट	जगह
मैनेजमेंट सर्वर	/opt/apigee/var/log/edge-management-server
राऊटर	/opt/apigee/var/log/edge-router Edge राऊटर को Nजिनx का इस्तेमाल करके लागू किया जाता है. अतिरिक्त लॉग के लिए, देखें: /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs
मैसेज प्रोसेसर	/opt/apigee/var/log/edge-message-processor
Apigee Qpid सर्वर	/opt/apigee/var/log/edge-qpid-server
Apigee Postgres सर्वर	/opt/apigee/var/log/edge-postgres-server
क्लासिक यूज़र इंटरफ़ेस (यूआई) (नया Edge यूज़र इंटरफ़ेस (यूआई), जिसका कॉम्पोनेंट नाम edge-management-ui है) नहीं	/opt/apigee/var/log/edge-ui
ZooKeeper	/opt/apigee/var/log/apigee-zookeeper
OpenLDAP	/opt/apigee/var/log/apigee-openldap
कासांद्रा	/opt/apigee/var/log/apigee-cassandra/system.log
क्विड	/opt/apigee/var/log/apigee-qpidd
PostgreSQL डेटाबेस	/opt/apigee/var/log/apigee-postgresql
apigee-monit	/opt/apigee/var/log/apigee-monit

डेटा

कॉम्पोनेंट	जगह
मैनेजमेंट सर्वर	/opt/apigee/data/edge-management-server
राऊटर	/opt/apigee/data/edge-router
मैसेज प्रोसेसर	/opt/apigee/data/edge-message-processor
Apigee Qpid एजेंट	/opt/apigee/data/edge-qpid-server
Apigee Postgres एजेंट	/opt/apigee/data/edge-postgres-server
ZooKeeper	/opt/apigee/data/apigee-zookeeper
OpenLDAP	/opt/apigee/data/apigee-openldap
कासांद्रा	/opt/apigee/data/apigee-cassandra/data
क्विड	/opt/apigee/data/apigee-qpid/data
PostgreSQL डेटाबेस	/opt/apigee/data/apigee-postgres/pgdata
apigee-monit	/opt/apigee/data/apigee-monit

इंस्टॉल करने पर सिस्टम की जांच करने की सुविधा चालू करें

Edge इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल, नीचे दी गई प्रॉपर्टी के साथ काम करती है:

ENABLE_SYSTEM_CHECK=y

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