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

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

इंस्टॉलेशन की डिफ़ॉल्ट डायरेक्ट्री: /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=enabled को सेट करने के लिए, यह तरीका दोहराकर SELinux को फिर से चालू करें.

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

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. 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, रॉकी 9 या ओराकल 9 चलाने वाले सर्वर पर Edge इंस्टॉल करना है, तो इंस्टॉल करने से पहले यहां दिए गए चरणों को पूरा करें:

1. 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 डेटाबेस को इंस्टॉल करने से पहले की जाने वाली ज़रूरी शर्तें और OpenLDAP 2.4 को इंस्टॉल करने से पहले किए गए बदलाव लेख पढ़ें.

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

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

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

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

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

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

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

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

   • I: OpenJDK 1.8 (डिफ़ॉल्ट) इंस्टॉल करना
   • C: 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 नोड किसी फ़ायरवॉल के पीछे हैं या किसी और तरीके से इंटरनेट को ऐक्सेस करने पर पाबंदी है, तो आपको कई रिपॉज़िटरी या मिरर बनाने होंगे. इनमें वे फ़ाइलें होनी चाहिए जिनकी आपको इंस्टॉल के दौरान ज़रूरत पड़ेगी. इसके बाद, उन मिरर को सभी नोड ऐक्सेस कर पाएंगे. बनाने के बाद, नोड, Edge इंस्टॉल करने के लिए इन लोकल मिरर को ऐक्सेस कर सकते हैं.

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

• Apigee Edge का रिपॉज़िटरी: जैसा कि स्थानीय Apigee रिपॉज़िटरी बनाना में बताया गया है.
• Enterprise Linux (या EPEL) के लिए अतिरिक्त पैकेज: आपकी ऑपरेशंस टीम इसे आपके लिए सेट अप कर सकती है.

स्थानीय Apigee डेटा स्टोर करने की जगह बनाना

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

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

स्थानीय Apigee repo बनाने के लिए:

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

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

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

   sudo bash /tmp/bootstrap_4.53.00.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.00.sh चलाएं:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.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.00.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. repo नोड पर Nginx वेब सर्वर इंस्टॉल करें:
   

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

2. डिफ़ॉल्ट रूप से, Nginx को सर्वर के नाम के तौर पर localhost और पोर्ट 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.00.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 रिपॉज़िटरी को अपडेट करना

रेपो को अपडेट करने के लिए, आपको सबसे नई बूटस्ट्रैप_4.53.00.sh फ़ाइल डाउनलोड करनी होगी और फिर नया सिंक करना होगा.

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

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

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

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

   sudo bash/tmp/bootstrap_4.53.00.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