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

Edge for Private Cloud v4.18.01

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

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

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

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

इंस्टॉल करने की प्रोसेस कौन पूरी कर सकता है

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

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

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

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

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

• 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. फ़ाइल के मालिक को "apigee:apigee" पर सेट करें. इसके अलावा, अगर आपने Edge सेवा को चलाने वाले उपयोगकर्ता को "apigee" उपयोगकर्ता से बदल दिया है, तो फ़ाइल को Edge सेवा चलाने वाले उपयोगकर्ता पर सेट करें.

रूट और नॉन-रूट उपयोगकर्ता के लिए, Edge इंस्टॉल करने के टास्क अलग-अलग करना

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

1. रूट से किए गए टास्क:
   1. bootstrap_4.18.01.sh फ़ाइल डाउनलोड करें और चलाएं:??
      > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
      
      इस चरण में, apigee-service यूटिलिटी इंस्टॉल होती है और "apigee" उपयोगकर्ता बनता है.
   2. किसी उपयोगकर्ता को "apigee" उपयोगकर्ता के लिए पूरा sudo ऐक्सेस देने के लिए, ऊपर बताया गया तरीका अपनाएं.
   3. apigee-setup यूटिलिटी इंस्टॉल करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. नोड पर Edge RPM इंस्टॉल करने के लिए, apigee-setup यूटिलिटी का इस्तेमाल करें:
      > /opt/apigee/apigee-service/bin/apigee-service compName install
      
      नोड पर इंस्टॉल किए जाने वाले Edge RPM, आपकी टोपोलॉजी पर निर्भर करते हैं. उपलब्ध कॉम्पोनेंट की सूची में ये शामिल हैं: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-ui, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.
2. रूट उपयोगकर्ता के नोड पर Edge RPM इंस्टॉल करने के बाद, "apigee" उपयोगकर्ता के पास sudo का पूरा ऐक्सेस होता है. इसके बाद, वह कॉन्फ़िगरेशन की प्रोसेस पूरी करता है:
   1. नोड पर Edge कॉम्पोनेंट का कॉन्फ़िगरेशन पूरा करने के लिए, setup.sh यूटिलिटी का इस्तेमाल करें. कमांड का फ़ॉर्म, नोड पर इंस्टॉल किए गए कॉम्पोनेंट पर निर्भर करता है. पूरी सूची देखने के लिए, नोड पर Edge कॉम्पोनेंट इंस्टॉल करना लेख पढ़ें.
      उदाहरण के लिए, 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 डायरेक्ट्री में डालें और उसे "apigee:apigee" पर chown करें.

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

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

इंस्टॉल न हो पाने की समस्या को हल करना

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

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

किसी नोड पर Edge इंस्टॉल करने के लिए, नोड के पास Apigee डेटाबेस का ऐक्सेस होना चाहिए:

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

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

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

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

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

/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

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

डेटा

इंस्टॉल करने के बाद किए जाने वाले टास्क

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

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

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

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

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

> /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 इंस्टॉलेशन को मैनेज किया जा सकता है. उदाहरण के लिए, नोड पर सभी Edge कॉम्पोनेंट को शुरू करने, रोकने, रीस्टार्ट करने या उनकी स्थिति का पता लगाने के लिए, apigee-all यूटिलिटी का इस्तेमाल किया जा सकता है:

/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 राऊटर को रीस्टार्ट करने के लिए:

/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 - एपीआई BaaS कॉम्पोनेंट. उदाहरण के लिए, baas-usergrid.

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

• start, stop, restart
• status, version
• बैकअप, रीस्टोर
• इंस्टॉल करना, अनइंस्टॉल करना