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

Edge for Private Cloud v4.19.01

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

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

किसी नोड पर एज इंस्टॉल करना एक कई चरणों वाली प्रक्रिया है:

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

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

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

   नोड पर Edge कॉम्पोनेंट इंस्टॉल करें देखें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   2. "apigee" उपयोगकर्ता के लिए पूरे sudo ऐक्सेस वाला उपयोगकर्ता बनाना में बताए गए तरीके से, "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 सुविधा का इस्तेमाल करें. निर्देश का टाइप उन कॉम्पोनेंट पर निर्भर करता है जिन्हें आपने नोड पर इंस्टॉल किया है. पूरी सूची देखने के लिए, नोड पर Edge कॉम्पोनेंट इंस्टॉल करें देखें.

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

      /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 यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करना न भूलें जिस पर वह चल रहा है.

इंटरनेट या गैर-इंटरनेट इंस्टॉलेशन

किसी नोड पर 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

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

लॉग फ़ाइलें

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 राऊटर, Ngnx का इस्तेमाल करके लागू किया गया है. अन्य लॉग के लिए, देखें: /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 यूज़र इंटरफ़ेस (यूआई)	/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
क्विड	/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" होती है.