Edge apigee-सेटअप यूटिलिटी इंस्टॉल करें

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

डिफ़ॉल्ट इंस्टॉलेशन डायरेक्ट्री: /opt/apigee

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

ज़रूरी शर्तें: SELinux को बंद करें

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

SELinux को हमेशा के लिए बंद करने या इसे अनुमति वाले मोड पर सेट करने के लिए:

1. /etc/sysconfig/selinux को किसी एडिटर में खोलें.
2. SELINUX=disabled या SELINUX=permissive सेट करें
3. बदलावों को सेव करें.
4. नोड को रीस्टार्ट करें.
5. अगर ज़रूरी हो, तो Edge को इंस्टॉल करने के बाद SELinux को फिर से चालू करें. इसके लिए, SELINUX=enabled को सेट करने की यह प्रक्रिया दोहराएं.

ज़रूरी शर्तें: EPEL repo चालू करें

Edge को इंस्टॉल या अपडेट करने या लोकल रेपो बनाने के लिए, आपको Extra Packages for Enterprise Linux (या EPEL) को चालू करना होगा. इस्तेमाल की जाने वाली कमांड, RedHat/CentOS के वर्शन पर निर्भर करती है:

• Red Hat/CentOS/Oracle 8.x के लिए:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  sudo rpm -ivh epel-release-latest-8.noarch.rpm

• Red Hat/CentOS/Oracle 9.x के लिए:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
  sudo rpm -ivh epel-release-latest-9.noarch.rpm

RHEL 8/Rocky 8/Oracle 8 के लिए ज़रूरी शर्तें

अगर आपको Red Hat Enterprise Linux (RHEL) 8 पर चलने वाले सर्वर पर Edge इंस्टॉल करना है, तो इंस्टॉलेशन से पहले यह तरीका अपनाएं:

1. Extra Packages for Enterprise Linux (EPEL) को चालू करें:

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

2. Postgres और Nginx को बंद करें:

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

RHEL 9/Rocky 9/Oracle 9 के लिए ज़रूरी शर्तें

अगर आपको Red Hat Enterprise Linux (RHEL) 9, Rocky 9 या Oracle 9 चलाने वाले सर्वर पर Edge इंस्टॉल करना है, तो इंस्टॉलेशन से पहले यह तरीका अपनाएं:

1. Extra Packages for Enterprise Linux (EPEL) को चालू करें:

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

2. Postgres और Nginx को बंद करें:

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

PostgreSQL और LDAP को इंस्टॉल करने से पहले किए जाने वाले बदलावों के बारे में जानने के लिए, PostgreSQL डेटाबेस को इंस्टॉल करने से पहले की ज़रूरी शर्तें और SymasLDAP 2.6.7 को इंस्टॉल करने से पहले किए जाने वाले बदलाव लेख पढ़ें.

बाहरी इंटरनेट कनेक्शन वाले नोड पर, Edge apigee-setup यूटिलिटी इंस्टॉल करें

बाहरी इंटरनेट कनेक्शन वाले नोड पर Edge इंस्टॉल करने के लिए:

1. Apigee से वह उपयोगकर्ता नाम और पासवर्ड पाएं जिसका इस्तेमाल करके, Apigee रिपॉज़िटरी को ऐक्सेस किया जाता है. अगर आपके पास Apigee की एफ़टीपी साइट के लिए पहले से username:password है, तो उन क्रेडेंशियल का इस्तेमाल किया जा सकता है.
2. Edge RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें
   
3. SELinux को बंद करें.
4. EPEL repo चालू करें.
5. अगर आपको RHEL 9/Rocky 9/Oracle 9 पर इंस्टॉल करना है, तो RHEL 9/Rocky 9/Oracle 9 के लिए ज़रूरी शर्तें में दिया गया तरीका अपनाएं.
6. Edge bootstrap_4.53.01.sh फ़ाइल को /tmp/bootstrap_4.53.01.sh में डाउनलोड करें:

   curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

7. Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:

   sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

   यहां uName:pWord, Apigee से मिला उपयोगकर्ता नाम और पासवर्ड है. अगर आपने pWord नहीं डाला है, तो आपको इसे डालने के लिए कहा जाएगा.

   डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 1.8 इंस्टॉल है या नहीं. अगर आपने ऐसा नहीं किया, तो यह आपके लिए इसे इंस्टॉल कर देगा. JAVA_FIX विकल्प का इस्तेमाल करके, यह तय करें कि Java को कैसे इंस्टॉल करना है. JAVA_FIX की ये वैल्यू होती हैं:

   • I: Install OpenJDK 1.8 (default)
   • C: Continue without installing Java
   • सवाल: छोड़ दो. इस विकल्प के लिए, आपको Java खुद इंस्टॉल करना होगा.

   apigee-service यूटिलिटी इंस्टॉल करने पर, /etc/yum.repos.d/apigee.repo फ़ाइल बनती है. यह Apigee रिपॉज़िटरी के बारे में बताती है. डेफ़िनिशन फ़ाइल देखने के लिए, यह निर्देश इस्तेमाल करें:

   cat /etc/yum.repos.d/apigee.repo

   रिपो के कॉन्टेंट देखने के लिए, इस कमांड का इस्तेमाल करें:

   sudo yum -v repolist 'apigee*'

8. apigee-setup यूटिलिटी इंस्टॉल करने के लिए, apigee-service का इस्तेमाल करें:
   

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

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

समस्या का हल

बाहरी इंटरनेट कनेक्शन वाले नोड पर इंस्टॉल करने की कोशिश करते समय, आपको इनमें से एक या इससे ज़्यादा गड़बड़ियां दिख सकती हैं:

Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

इस टेबल में, इन गड़बड़ियों को ठीक करने के कुछ संभावित तरीके दिए गए हैं:

गड़बड़ी प्रकार	समस्या हल करने का तरीका
पासवर्ड में अमान्य वर्ण शामिल हैं	Apigee के पासवर्ड में खास वर्णों का इस्तेमाल न करें.
कनेक्टिविटी से जुड़ी समस्याएं	नीचे दी गई ncat कमांड को चलाकर, अपने नेटवर्क कनेक्शन की जांच करें: nc -v software.apigee.com 443 आपको कुछ ऐसा मैसेज मिलेगा: Connection to software.apigee.com 443 port [tcp/https] succeeded! अगर आपने nc इंस्टॉल नहीं किया है, तो यहां दी गई telnet कमांड का इस्तेमाल करें: telnet software.apigee.com 443 अगर कमांड काम करती हैं, तो खुले हुए कनेक्शन को बंद करने के लिए, CTRL+C का इस्तेमाल करें. अगर इनमें से कोई भी कमांड काम नहीं करती है, तो इसका मतलब है कि आपके पास सीमित या कोई नेटवर्क कनेक्टिविटी नहीं है. अपने नेटवर्क एडमिन से संपर्क करें.
क्रेडेंशियल सही नहीं हैं	पक्का करें कि आपका उपयोगकर्ता नाम और पासवर्ड सही हो. उदाहरण के लिए, देखें कि Apigee के उपयोगकर्ता नाम और पासवर्ड के साथ यहां दी गई कमांड का इस्तेमाल करने पर, आपको कोई गड़बड़ी का मैसेज मिलता है या नहीं: curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
प्रॉक्सी से जुड़ी समस्याएं	आपके लोकल कॉन्फ़िगरेशन में, इग्रेस एचटीटीपी प्रॉक्सी का इस्तेमाल किया जाता है. हालांकि, आपने yum पैकेज मैनेजर के लिए उसी कॉन्फ़िगरेशन का इस्तेमाल नहीं किया है. अपने एनवायरमेंट वैरिएबल देखें: echo $http_proxy echo $https_proxy ईग्रैस एचटीटीपी प्रॉक्सी के लिए, इनमें से किसी एक विकल्प का इस्तेमाल करें: /etc/yum.conf में एचटीटीपी प्रॉक्सी कॉन्फ़िगरेशन जोड़ना /etc/environment में ग्लोबल एचटीटीपी प्रॉक्सी कॉन्फ़िगरेशन जोड़ना

Edge apigee-setup यूटिलिटी को ऐसे नोड पर इंस्टॉल करें जिसमें बाहरी इंटरनेट कनेक्शन न हो

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

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

• Apigee Edge repo: Apigee की लोकल रिपॉज़िटरी बनाना लेख में बताए गए तरीके से बनाएं.
• Extra Packages for Enterprise Linux (या EPEL): आपकी ऑपरेशंस टीम को इसे आपके लिए सेट अप करना चाहिए.

Apigee की लोकल रिपॉज़िटरी बनाना

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

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

Apigee का लोकल रेपो बनाने के लिए:

1. Apigee से वह उपयोगकर्ता नाम और पासवर्ड पाएं जिसका इस्तेमाल करके, Apigee रिपॉज़िटरी को ऐक्सेस किया जाता है. अगर आपके पास Apigee की एफ़टीपी साइट के लिए पहले से मौजूद उपयोगकर्ता नाम और पासवर्ड है, तो उन क्रेडेंशियल का इस्तेमाल किया जा सकता है.
2. Edge RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
   
3. ऊपर बताए गए तरीके से SELinux को बंद करें.
4. Edge bootstrap_4.53.01.sh फ़ाइल को /tmp/bootstrap_4.53.01.sh में डाउनलोड करें:

   curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

5. Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
   

   sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

   यहां uName:pWord, Apigee से मिला उपयोगकर्ता नाम और पासवर्ड है. अगर आपने pWord नहीं डाला है, तो आपको इसे डालने के लिए कहा जाएगा.

6. नोड पर apigee-mirror यूटिलिटी इंस्टॉल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. Apigee repo को /opt/apigee/data/apigee-mirror/repos/ डायरेक्ट्री के साथ सिंक करने के लिए, apigee-mirror यूटिलिटी का इस्तेमाल करें.

   रेपो का साइज़ कम करने के लिए, --only-new-rpms को शामिल करें, ताकि सिर्फ़ नए आरपीएम डाउनलोड किए जा सकें.

8. (ज़रूरी नहीं) अगर आपको Edge को लोकल रेपो से उसी नोड पर इंस्टॉल करना है जिस पर लोकल रेपो होस्ट की गई है, तो आपको सबसे पहले ये कमांड चलाने होंगे:
   1. apigee-service यूटिलिटी इंस्टॉल करने के लिए, लोकल रेपो से bootstrap_4.53.01.sh चलाएं:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   2. apigee-setup यूटिलिटी इंस्टॉल करने के लिए, apigee-service का इस्तेमाल करें:

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

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

लोकल रेपो से किसी रिमोट नोड पर apigee-setup इंस्टॉल करना

लोकल रेपो से Edge को इंस्टॉल करने के लिए, आपके पास दो विकल्प हैं. इनमें से कोई एक विकल्प चुना जा सकता है:

• रिपो की .tar फ़ाइल बनाएं. इसके बाद, .tar फ़ाइल को किसी नोड पर कॉपी करें. इसके बाद, .tar फ़ाइल से Edge इंस्टॉल करें.
• लोकल रेपो वाले नोड पर वेबसर्वर इंस्टॉल करें, ताकि अन्य नोड इसे ऐक्सेस कर सकें. Apigee, Nginx वेबसर्वर उपलब्ध कराता है. इसका इस्तेमाल किया जा सकता है. इसके अलावा, अपने वेबसर्वर का भी इस्तेमाल किया जा सकता है.

.tar फ़ाइल से इंस्टॉल करना

.tar फ़ाइल से इंस्टॉल करने के लिए:

1. लोकल रेपो वाले नोड पर, लोकल रेपो को /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz नाम की एक .tar फ़ाइल में पैकेज करने के लिए, इस कमांड का इस्तेमाल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge इंस्टॉल करना है. उदाहरण के लिए, इसे नए नोड पर मौजूद /tmp डायरेक्ट्री में कॉपी करें.
3. नए नोड पर, ऊपर बताए गए तरीके से SELinux बंद करें.
4. नए नोड पर, पक्का करें कि आपके पास लोकल Yum यूटिलिटी रेपो और EPEL रेपो का ऐक्सेस हो.
5. दोबारा जांच करें कि सभी बाहरी इंटरनेट रिपॉज़िटरी बंद हों. ऐसा इसलिए होना चाहिए, क्योंकि आपको इंटरनेट ऐक्सेस के बिना किसी मशीन पर इंस्टॉल करना है:

   sudo yum repolist

   सभी बाहरी रिपॉज़िटरी बंद होनी चाहिए. हालांकि, Apigee की लोकल रिपॉज़िटरी और आपकी इंटरनल रिपॉज़िटरी चालू होनी चाहिए.

6. apigee-setup यूटिलिटी इंस्टॉल करने के लिए, apigee-service का इस्तेमाल करें:

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

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

Nginx वेबसर्वर का इस्तेमाल करके, रेपो से इंस्टॉल करना

Nginx वेबसर्वर का इस्तेमाल करके, रिपो से इंस्टॉल करने के लिए:

1. रेपो नोड पर Nginx वेबसर्वर इंस्टॉल करें:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

2. डिफ़ॉल्ट रूप से, Nginx को सर्वर के नाम के तौर पर लोकलहोस्ट और पोर्ट 3939 का इस्तेमाल करने के लिए कॉन्फ़िगर किया जाता है. इन वैल्यू को बदलने के लिए:
   1. /opt/apigee/customer/application/mirror.properties को किसी एडिटर में खोलें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
   2. ज़रूरत के मुताबिक, ये वैल्यू सेट करें:

      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost

   3. Nginx को रीस्टार्ट करने के लिए:

      /opt/nginx/scripts/apigee-nginx restart

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

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. नए नोड पर, पक्का करें कि EPEL रिपॉज़िटरी स्थानीय तौर पर चालू हो.
5. नए नोड पर, ऊपर बताए गए तरीके से libdb4 का वर्शन देखें.
6. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:

   sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   यहां uName:pWord, रिपो का उपयोगकर्ता नाम और पासवर्ड है.

7. रिमोट नोड पर, apigee-setup यूटिलिटी इंस्टॉल करने के लिए apigee-service का इस्तेमाल करें:

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

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

Apigee की लोकल रिपॉज़िटरी अपडेट करना

रिपो को अपडेट करने के लिए, आपको bootstrap_4.53.01.sh फ़ाइल का नया वर्शन डाउनलोड करना होगा. इसके बाद, नया सिंक करना होगा.

रिपो को अपडेट करने के लिए:

1. Edge bootstrap_4.53.01.sh फ़ाइल को /tmp/bootstrap_4.53.01.sh में डाउनलोड करें:

   curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

2. Edge bootstrap_4.53.01.sh फ़ाइल चलाएं:

   sudo bash/tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

   यहां uName:pWord, Apigee से मिला उपयोगकर्ता नाम और पासवर्ड है. अगर आपने pWord नहीं डाला है, तो आपको इसे डालने के लिए कहा जाएगा.

3. apigee-mirror को अपडेट करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. सिंक करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

5. अगर आपको पूरी रिपो का बैकअप लेना है, तो:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Apigee के लोकल रेपो को क्लीन करना

लोकल रेपो को क्लीन करने से, /opt/apigee/data/apigee-mirror और /var/tmp/yum-apigee-* मिट जाते हैं.

लोकल रेपो को साफ़ करने के लिए, इस कमांड का इस्तेमाल करें:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean