4.53.00.02 - Edge for Private Cloud के रिलीज़ नोट

Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X के दस्तावेज़ पर जाएं. info

हमने 19 दिसंबर, 2024 को Apigee Edge for Private Cloud का नया वर्शन रिलीज़ किया है.

अपडेट करने की प्रोसेस

अगर आपको Edge for Private Cloud की पिछली रिलीज़ से अपडेट करना है, तो इस सेक्शन में इस रिलीज़ को इंस्टॉल करने का तरीका बताया गया है. अगर आपको पिछले वर्शन से अपडेट करना है, तो एक से ज़्यादा पैच वर्शन लागू करना लेख पढ़ें.

इस रिलीज़ को अपडेट करने पर, यहां दिए गए कॉम्पोनेंट अपडेट हो जाएंगे:

• apigee-nginx-1.26.1-el8.x86_64.rpm
• apigee-nginx-1.26.1-el9.x86_64.rpm
• apigee-qpidd-8.0.6-0.0.2534.noarch.rpm
• apigee-sso-4.53.00-0.0.21506.noarch.rpm
• apigee-tomcat-9.0.86-0.0.948.noarch.rpm

फ़िलहाल इंस्टॉल किए गए RPM वर्शन देखने के लिए, यह कमांड डालें:

apigee-all version

इंस्टॉलेशन को अपडेट करने के लिए, Edge नोड पर यह तरीका अपनाएं:

1. सभी Edge नोड पर:

   1. Yum रिपॉज़िटरी साफ़ करें:

      sudo yum clean all

   2. Edge 4.53.00 की नई 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

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

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

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

   4. apigee-service.sh स्क्रिप्ट को चलाने के लिए, source कमांड का इस्तेमाल करें:

      source /etc/profile.d/apigee-service.sh

2. सभी Qpid नोड पर, update.sh स्क्रिप्ट को एक्ज़ीक्यूट करें:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. एसएसओ नोड पर, Apigee SSO को पुराने वर्शन से अपडेट करने का तरीका सेक्शन में दी गई प्रोसेस का पालन करें:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Apigee SSO को पुराने वर्शन से अपडेट करने का तरीका

Edge for Private Cloud 4.53.00 में, apigee-sso कॉम्पोनेंट में इस्तेमाल की गई आईडीपी कुंजियों और सर्टिफ़िकेट को अब कीस्टोर के ज़रिए कॉन्फ़िगर किया जाता है. आपको पहले इस्तेमाल किए गए पासकोड और सर्टिफ़िकेट को कीस्टोर में एक्सपोर्ट करना होगा. इसके बाद, इसे कॉन्फ़िगर करना होगा. इसके बाद, एसएसओ को सामान्य तरीके से अपडेट करें.

1. आईडीपी को कॉन्फ़िगर करने के लिए इस्तेमाल की गई मौजूदा कुंजी और सर्टिफ़िकेट की पहचान करें:

   1. एसएसओ इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में SSO_SAML_SERVICE_PROVIDER_CERTIFICATE की वैल्यू देखकर सर्टिफ़िकेट पाएं. इसके अलावा, conf_login_service_provider_certificate के लिए apigee-sso कॉम्पोनेंट से क्वेरी करके भी सर्टिफ़िकेट पाया जा सकता है.

      आईडीपी सर्टिफ़िकेट के पाथ के लिए apigee-sso से क्वेरी करने के लिए, एसएसओ नोड पर यह निर्देश इस्तेमाल करें. आउटपुट में, आखिरी लाइन में मौजूद वैल्यू देखें.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. एसएसओ इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में SSO_SAML_SERVICE_PROVIDER_KEY की वैल्यू देखकर या conf_login_service_provider_key के लिए apigee-sso कॉम्पोनेंट से क्वेरी करके, कुंजी वापस पाएं.

      एसएसओ नोड पर, यहां दिए गए निर्देश का इस्तेमाल करके apigee-sso से आईडीपी कुंजी के पाथ के बारे में क्वेरी करें. आउटपुट में, आखिरी लाइन में दी गई वैल्यू देखें.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. पासकोड और सर्टिफ़िकेट को कीस्टोर में एक्सपोर्ट करें:
   1. पासकोड और सर्टिफ़िकेट को PKCS12 कीस्टोर में एक्सपोर्ट करें:

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      पैरामीटर:

      • certificate_path: पहले चरण में वापस लाई गई सर्टिफ़िकेट फ़ाइल का पाथ.
      • key_path: पहले चरण के 1.b में वापस लाई गई निजी पासकोड फ़ाइल का पाथ.
      • keystore_path: सर्टिफ़िकेट और निजी कुंजी वाले नए कीस्टोर का पाथ.
      • alias: कीस्टोर में मौजूद कुंजी और सर्टिफ़िकेट के जोड़े के लिए इस्तेमाल किया गया उपनाम.

      ज़्यादा जानकारी के लिए, OpenSSL का दस्तावेज़ देखें.

   2. (ज़रूरी नहीं) पीकेसीएस12 से कुंजी और सर्टिफ़िकेट को जेकेएस कीस्टोर में एक्सपोर्ट करें:

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      पैरामीटर:

      • PKCS12_keystore_path: यह चरण 2.a में बनाए गए PKCS12 कीस्टोर का पाथ है. इसमें सर्टिफ़िकेट और पासकोड होता है.
      • destination_keystore_path: नए JKS कीस्टोर का पाथ, जहां सर्टिफ़िकेट और कुंजी एक्सपोर्ट की जाएगी.
      • alias: JKS कीस्टोर में, कुंजी और सर्टिफ़िकेट के जोड़े के लिए इस्तेमाल किया गया दूसरा नाम.

   ज़्यादा जानकारी के लिए, keytool का दस्तावेज़ देखें.

3. आउटपुट कीस्टोर फ़ाइल के मालिक को "apigee" उपयोगकर्ता में बदलें:

   sudo chown apigee:apigee <keystore_file>

4. Apigee SSO कॉन्फ़िगरेशन फ़ाइल में ये प्रॉपर्टी जोड़ें. साथ ही, इन्हें कीस्टोर फ़ाइल पाथ, पासवर्ड, कीस्टोर टाइप, और एलियास से अपडेट करें:

   # Path to the keystore file
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks
   
   # Keystore password
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore
   
   # Keystore type
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12
   
   # Alias within keystore that stores the key and certificate
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

5. एसएसओ नोड पर Apigee SSO सॉफ़्टवेयर को हमेशा की तरह अपडेट करें. इसके लिए, यह निर्देश इस्तेमाल करें:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

गड़बड़ियां ठीक की गईं

इस सेक्शन में, Private Cloud में मौजूद उन गड़बड़ियों की सूची दी गई है जिन्हें इस रिलीज़ में ठीक किया गया है.

सुरक्षा से जुड़ी समस्याएं ठीक की गईं

यहां सुरक्षा से जुड़ी उन समस्याओं की सूची दी गई है जिन्हें इस रिलीज़ में ठीक कर दिया गया है. इन समस्याओं से बचने के लिए, Edge Private Cloud का नया वर्शन इंस्टॉल करें.

साथ काम करने वाले सॉफ़्टवेयर में बदलाव

इस रिलीज़ में, नए सॉफ़्टवेयर के लिए सहायता शामिल नहीं की गई है.

बंद की गई सेवाएं/सुविधाएं

इस रिलीज़ में, किसी भी सुविधा को बंद नहीं किया गया है.

नई सुविधाएं

इस सेक्शन में, इस रिलीज़ में जोड़ी गई नई सुविधाओं के बारे में बताया गया है.

ज्ञात समस्याएं

Edge for Private Cloud से जुड़ी ज्ञात समस्याएं लेख में, ज्ञात समस्याओं की पूरी सूची देखें.

पैच के एक से ज़्यादा वर्शन लागू करना

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

हर पैच रिलीज़ में, Edge for Private Cloud के कुछ कॉम्पोनेंट के अपडेट शामिल होते हैं. जैसे, edge-management-server. एक से ज़्यादा पैच वर्शन लागू करने के लिए, आपको हर उस Edge कॉम्पोनेंट को अपडेट करना होगा जो आपके मौजूदा इंस्टॉल किए गए वर्शन के बाद, पैच रिलीज़ में शामिल किया गया था. इन कॉम्पोनेंट के बारे में जानने के लिए, Edge for Private Cloud के रिलीज़ नोट देखें. ये नोट, आपके मौजूदा वर्शन के बाद के सभी वर्शन के लिए उपलब्ध हैं. साथ ही, उन रिलीज़ के लिए आरपीएम की सूची देखें. Edge for Private Cloud के सभी रिलीज़ नोट के लिंक पाने के लिए, Apigee के रिलीज़ नोट देखें.

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

ध्यान दें: किसी कॉम्पोनेंट को अपग्रेड करने पर, उसका नया पैच वर्शन अपने-आप इंस्टॉल हो जाता है. अगर आपको किसी ऐसे पैच वर्शन पर अपग्रेड करना है जो सबसे नया नहीं है, तो आपको Apigee mirror का इस्तेमाल करके, Apigee के रेपो की अपनी tarball कॉपी बनाए रखनी होगी. साथ ही, Apigee को इंस्टॉल करने के लिए इस मिरर का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, Edge के वर्शन को बनाए रखने के लिए, लोकल Edge रिपॉज़िटरी का इस्तेमाल करना लेख पढ़ें.