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

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

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

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

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

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

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

Edge को इंस्टॉल या अपडेट करने या लोकल रिपो बनाने के लिए, आपको Extra Packages for Enterprise Linux (या EPEL) को चालू करना होगा. Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x या Oracle Linux 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 9/Rocky 9/Oracle 9 के लिए ज़रूरी शर्तें

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

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 और एलडीएपी के लिए, इंस्टॉल करने से पहले किए जाने वाले बदलावों के बारे में जानने के लिए, PostgreSQL डेटाबेस को इंस्टॉल करने से पहले की ज़रूरी शर्तें और SymasLDAP 2.6.10 को इंस्टॉल करने से पहले किए जाने वाले बदलाव देखें.

बाहरी इंटरनेट कनेक्शन वाले नोड पर, 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.54.00.sh फ़ाइल को /tmp/bootstrap_4.54.00.sh में डाउनलोड करें:

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

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

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

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

   Apigee Edge for Private Cloud 4.54.00 के लिए, नोड पर Java 17 और Java 21, दोनों इंस्टॉल होने चाहिए. बूटस्ट्रैप स्क्रिप्ट चलाने से पहले, आपको Java 17 और Java 21, दोनों इंस्टॉल करने होंगे. इंस्टॉलर सिर्फ़ यह पुष्टि करता है कि JDK के दोनों वर्शन इंस्टॉल हैं. यह 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

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

nc -v software.apigee.com 443

Connection to software.apigee.com 443 port [tcp/https] succeeded!

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

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

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

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

• Apigee Edge रिपॉज़िटरी: जैसा कि लोकल Apigee रिपॉज़िटरी बनाना में बताया गया है.
• 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.54.00.sh फ़ाइल को /tmp/bootstrap_4.54.00.sh में डाउनलोड करें:

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

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

   sudo bash /tmp/bootstrap_4.54.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 रिपॉज़िटरी को /opt/apigee/data/apigee-mirror/repos/ डायरेक्ट्री के साथ सिंक करने के लिए, apigee-mirror यूटिलिटी का इस्तेमाल करें.

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

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

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.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.54.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 वेबसर्वर का इस्तेमाल करके, repo से इंस्टॉल करना

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.54.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 रिपॉज़िटरी को अपडेट करना

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

डेटा स्टोर करने की जगह को अपडेट करने के लिए:

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

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

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

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