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

Edge for Private Cloud v. 4.16.05

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

/opt/apigee से सिमलिंक बनाना

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

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

सिमलिंक बनाने के लिए, bootstrap_4.16.05.sh फ़ाइल डाउनलोड करने से पहले, यह तरीका अपनाएं. आपको ये सभी चरण रूट के तौर पर पूरे करने होंगे:

1. "apigee" उपयोगकर्ता और ग्रुप बनाएं:
   > groupadd -r apigee
   > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
2. /opt/apigee से अपने पसंदीदा इंस्टॉल रूट के लिए एक सिमलिंक बनाएं:
   > ln -Ts /srv/myInstallDir /opt/apigee
   जहां /srv/myInstallDir, Edge फ़ाइलों की पसंदीदा जगह है.
3. इंस्टॉल रूट और सिमलिंक का मालिकाना हक "apigee" उपयोगकर्ता को दें:
   > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

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

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

• SELinux को कुछ समय के लिए नीति लागू न करने वाले मोड पर सेट करने के लिए, यह निर्देश चलाएं:
  1. Linux 6.x ऑपरेटिंग सिस्टम पर:
     echo 0 > /selinux/enforce
     
     Edge इंस्टॉल करने के बाद, SELinux को फिर से चालू करने के लिए:
     echo 1 > /selinux/enforce
  2. Linux 7.x ऑपरेटिंग सिस्टम पर:
     setenforce 0
     
     Edge इंस्टॉल करने के बाद, SELinux को फिर से चालू करने के लिए:
     setenforce 1
• SELinux को हमेशा के लिए बंद करने या इसे नीति लागू न करने वाले मोड पर सेट करने के लिए:
  1. किसी एडिटर में /etc/sysconfig/selinux खोलें.
  2. SELINUX=disabled या SELINUX=permissive सेट करें
  3. किए गए बदलाव सेव करें.
  4. नोड को रीस्टार्ट करें.
  5. अगर ज़रूरी हो, तो Edge इंस्टॉल करने के बाद SELinux को फिर से चालू करें. इसके लिए, इस प्रोसेस को दोहराकर SELINUX=enabled पर सेट करें.

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

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

1. Apigee से वह उपयोगकर्ता नाम और पासवर्ड लें जिसका इस्तेमाल करके Apigee रिपॉज़िटरी को ऐक्सेस किया जाता है. अगर आपके पास Apigee एफ़टीपी साइट के लिए पहले से कोई उपयोगकर्ता नाम और पासवर्ड है, तो उन क्रेडेंशियल का इस्तेमाल किया जा सकता है.
2. Edge RPM इंस्टॉल करने के लिए, रूट के तौर पर अपने नोड में लॉग इन करें
   ध्यान दें: RPM इंस्टॉल करने के लिए रूट ऐक्सेस की ज़रूरत होती है. हालांकि, Edge को कॉन्फ़िगर करने के लिए रूट ऐक्सेस की ज़रूरत नहीं होती.
3. ऊपर बताए गए तरीके से SELinux को बंद करें.
4. Edge bootstrap_4.16.05.sh फ़ाइल को /tmp/bootstrap_4.16.05.sh में डाउनलोड करें:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
5. Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   
   जहां uName:pWord वह उपयोगकर्ता नाम और पासवर्ड है जो आपको Apigee से मिला है. अगर आपने pWord नहीं डाला है, तो आपसे इसे डालने के लिए कहा जाएगा.
   
   डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 1.8 इंस्टॉल है या नहीं. अगर ऐसा नहीं किया जाता है, तो यह आपके लिए इसे इंस्टॉल कर देता है. JAVA_FIX विकल्प का इस्तेमाल करके बताएं कि Java इंस्टॉलेशन को कैसे मैनेज करना है. JAVA_FIX इनमें से कोई वैल्यू लेता है:
   
   I = OpenJDK 1.8 इंस्टॉल करें (डिफ़ॉल्ट)
   C = Java इंस्टॉल किए बिना जारी रखें
   Q = बंद करें. इस विकल्प के लिए, आपको Java खुद इंस्टॉल करना होगा.
   
   apigee-service यूटिलिटी को इंस्टॉल करने पर, /etc/yum.repos.d/apigee.repo फ़ाइल बनती है. यह फ़ाइल, Apigee डेटा स्टोर करने की जगह के बारे में बताती है. डेफ़िनिशन फ़ाइल देखने के लिए, इस निर्देश का इस्तेमाल करें:
   > cat /etc/yum.repos.d/apigee.repo
   
   रेपो का कॉन्टेंट देखने के लिए, इस निर्देश का इस्तेमाल करें:
   > sudo yum -v repolist 'apigee*'
6. apigee-setup यूटिलिटी इंस्टॉल करने के लिए, apigee-service का इस्तेमाल करें:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. नोड पर Edge कॉम्पोनेंट इंस्टॉल और कॉन्फ़िगर करने के लिए, apigee-setup का इस्तेमाल करें. ज़्यादा जानकारी के लिए, नोड पर Edge कॉम्पोनेंट इंस्टॉल करना लेख पढ़ें.

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

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

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

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

लोकल Apigee डेटाबेस बनाना

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

1. Apigee से वह उपयोगकर्ता नाम और पासवर्ड लें जिसका इस्तेमाल करके Apigee रिपॉज़िटरी को ऐक्सेस किया जाता है. अगर आपके पास Apigee एफ़टीपी साइट के लिए पहले से कोई उपयोगकर्ता नाम और पासवर्ड है, तो उन क्रेडेंशियल का इस्तेमाल किया जा सकता है.
2. Edge RPMs इंस्टॉल करने के लिए, अपने RedHat या CentOS नोड में रूट के तौर पर लॉग इन करें.
   ध्यान दें: आरपीएम इंस्टॉल करने के लिए रूट ऐक्सेस की ज़रूरत होती है. हालांकि, रूट ऐक्सेस के बिना भी Edge को कॉन्फ़िगर किया जा सकता है.
3. पक्का करें कि आपके पास yum-utils का नया वर्शन हो:
   > sudo yum update yum-utils
4. ऊपर बताए गए तरीके से SELinux को बंद करें.
5. Edge bootstrap_4.16.05.sh फ़ाइल को /tmp/bootstrap_4.16.05.sh में डाउनलोड करें:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
6. Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   
   जहां uName:pWord, Apigee से मिला उपयोगकर्ता नाम और पासवर्ड है. अगर आपने pWord नहीं डाला है, तो आपसे इसे डालने के लिए कहा जाएगा.
7. नोड पर apigee-mirror यूटिलिटी इंस्टॉल करें:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
8. Apigee रिपॉज़िटरी को /opt/apigee/data/apigee-mirror/repos/ डायरेक्ट्री के साथ सिंक करने के लिए, apigee-mirror यूटिलिटी का इस्तेमाल करें.
   
   रेपो का साइज़ कम करने के लिए, --only-new-rpms शामिल करें, ताकि सिर्फ़ नए आरपीएम डाउनलोड किए जा सकें. डाउनलोड के लिए आपको लगभग 1.6GB डिस्क स्थान की आवश्यकता है:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
   
   यदि आप पुराने RPM सहित संपूर्ण रेपो डाउनलोड करना चाहते हैं, तो --only-new-rpms को छोड़ दें. पूरा डाउनलोड करने के लिए, आपको डिस्क में करीब छह जीबी स्टोरेज की ज़रूरत होगी:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
   
   अब आपके पास Apigee रेपो की एक लोकल कॉपी है. अगले सेक्शन में, लोकल रिपॉज़िटरी से Edge apigee-setup यूटिलिटी को इंस्टॉल करने का तरीका बताया गया है.
9. (ज़रूरी नहीं) अगर आपको Edge को लोकल रिपॉज़िटरी से उसी नोड पर इंस्टॉल करना है जो लोकल रिपॉज़िटरी को होस्ट करता है, तो आपको पहले ये कमांड चलाने होंगे:
   1. apigee-service यूटिलिटी इंस्टॉल करने के लिए, लोकल रिपॉज़िटरी से bootstrap_4.16.05.sh चलाएं:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.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 फ़ाइल से इंस्टॉल करें:

1. लोकल रिपॉज़िटरी वाले नोड पर, लोकल रिपॉज़िटरी को /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz नाम की एक.tar फ़ाइल में पैकेज करने के लिए, इस निर्देश का इस्तेमाल करें:
   
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge इंस्टॉल करना है. उदाहरण के लिए, इसे नए नोड पर /tmp डायरेक्ट्री में कॉपी करें.
3. नए नोड पर, ऊपर बताए गए तरीके से SELinux को बंद करें.
4. नए नोड पर, फ़ाइल को /tmp डायरेक्ट्री में अनटार करें:
   > tar -xzf apigee-4.16.05.tar.gz
   
   यह निर्देश, .tar फ़ाइल वाली डायरेक्ट्री में repos नाम की एक नई डायरेक्ट्री बनाता है. उदाहरण के लिए /tmp/repos.
5. /tmp/repos से Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
   > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   ध्यान दें कि इस निर्देश में, रिपॉज़िटरी डायरेक्ट्री का पाथ शामिल है.
6. apigee-setup यूटिलिटी इंस्टॉल करने के लिए, apigee-service का इस्तेमाल करें:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. नोड पर Edge कॉम्पोनेंट इंस्टॉल और कॉन्फ़िगर करने के लिए, apigee-setup का इस्तेमाल करें. ज़्यादा जानकारी के लिए, नोड पर Edge कॉम्पोनेंट इंस्टॉल करना लेख पढ़ें.

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

1. रेपो नोड पर 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. नए नोड पर, ऊपर बताए गए तरीके से SELinux को बंद करें.
5. रिमोट नोड पर, Edge bootstrap_4.16.05.sh फ़ाइल को /tmp/bootstrap_4.16.05.sh पर डाउनलोड करें:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
   
   जहां uName:pWord, उपयोगकर्ता नाम और पासवर्ड हैं, जिन्हें आपने ऊपर रेपो के लिए सेट किया है. साथ ही, remoteRepo, रेपो नोड का आईपी पता या डीएनएस नाम है.
6. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
   > sudo bash /tmp/bootstrap_4.16.05.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.16.05.sh फ़ाइल डाउनलोड करनी होगी. इसके बाद, नया सिंक करना होगा:

1. Edge bootstrap_4.16.05.sh फ़ाइल को /tmp/bootstrap_4.16.05.sh में डाउनलोड करें:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. सिंक करें:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
3. अगर आपको पूरी रिपॉज़िटरी डाउनलोड करनी है, तो:
   > /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

4.16.05 रेपो में Edge 4.16.01 को जोड़ना या अपडेट करना

अगर आपको Edge 4.16.05 और 4.16.01, दोनों के इंस्टॉलेशन को मैनेज करना है, तो ऐसी रिपॉज़िटरी को मैनेज किया जा सकता है जिसमें दोनों वर्शन शामिल हों. उस रिपॉज़िटरी से, Edge 4.16.05 और 4.16.01 में से कोई भी वर्शन इंस्टॉल किया जा सकता है.

4.15.05 रिपॉज़िटरी में 4.16.01 जोड़ने के लिए:

1. पक्का करें कि आपने apigee-mirror यूटिलिटी का 4.16.05 वर्शन इंस्टॉल किया हो:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
   
   आपको नीचे दिए गए फ़ॉर्म में नतीजा दिखेगा. इसमें xyz, बिल्ड नंबर है:
   apigee-mirror-4.16.05-0.0.xyz
2. apigee-mirror यूटिलिटी का इस्तेमाल करके, Edge 4.16.01 को अपने डेटा स्टोर करने की जगह में डाउनलोड करें. ध्यान दें कि कमांड के आगे apigeereleasever=4.16.01 कैसे जोड़ा जाता है:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
   
   बाद में, 4.16.01 रिपॉज़िटरी को अपडेट करने के लिए, इसी कमांड का इस्तेमाल करें.
3. फ़ाइल का स्ट्रक्चर देखने के लिए, /opt/apigee/data/apigee-mirror/repos डायरेक्ट्री की जांच करें:
   > ls /opt/apigee/data/apigee-mirror/repos
   
   आपको ये फ़ाइलें और डायरेक्ट्री दिखनी चाहिए:
   apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh thirdparty
   
   ध्यान दें कि आपके पास Edge के दोनों वर्शन के लिए बूटस्ट्रैप फ़ाइल है. apigee डायरेक्ट्री में, Edge के हर वर्शन के लिए अलग-अलग डायरेक्ट्री भी होती हैं.
4. रेपो को .tar फ़ाइल में पैकेज करने के लिए, इस निर्देश का इस्तेमाल करें:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   
   यह निर्देश, 4.16.05 और 4.16.01, दोनों रेपो को एक ही .tar फ़ाइल में पैकेज करता है. रिपॉज़िटरी के सिर्फ़ एक हिस्से को पैकेज नहीं किया जा सकता.

लोकल रिपॉज़िटरी या .tar फ़ाइल से Edge इंस्टॉल करने के लिए, पक्का करें कि आपने सही बूटस्ट्रैप फ़ाइल को चलाया हो. इसके लिए, इनमें से किसी एक कमांड का इस्तेमाल करें:

• अगर .tar फ़ाइल से इंस्टॉल किया जा रहा है, तो रेपो से सही बूटस्ट्रैप फ़ाइल चलाएं:
  > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  इंस्टॉलेशन पूरा करने के लिए, ऊपर दिए गए ".tar फ़ाइल से इंस्टॉल करें" सेक्शन में बताए गए बाकी चरणों को पूरा करें.
• अगर Nginx वेबसर्वर का इस्तेमाल करके इंस्टॉल किया जा रहा है, तो रिपॉज़िटरी से सही बूटस्ट्रैप फ़ाइल डाउनलोड करें और फिर उसे चलाएं:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
  > sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  इंस्टॉलेशन पूरा करने के लिए, ऊपर दिए गए "Nginx वेबसर्वर का इस्तेमाल करके रिपॉज़िटरी से इंस्टॉल करें" सेक्शन में दिए गए बाकी चरणों को पूरा करें.