नया एज अनुभव इंस्टॉल करना

Edge for Private Cloud v4.19.01

इस दस्तावेज़ में, Edge for Private Cloud के लिए Edge का नया वर्शन इंस्टॉल करने का तरीका बताया गया है. New Edge, Edge के लिए अगली जनरेशन का यूज़र इंटरफ़ेस (यूआई) है.

Edge for Private Cloud इंस्टॉलेशन में Edge का नया वर्शन आज़माने के लिए, आपको ये काम करने होंगे:

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

Edge के नए वर्शन के बारे में ज़्यादा जानने के लिए, प्राइवेट क्लाउड के लिए Edge का नया वर्शन देखें.

इंस्टॉल करने के बारे में खास जानकारी

Edge for Private Cloud के लिए, Edge का नया वर्शन इंस्टॉल करने के लिए, आपको दो अलग-अलग इंस्टॉलेशन प्रोसेस पूरी करनी होंगी:

  • Edge का बुनियादी यूज़र इंटरफ़ेस इंस्टॉल करें, जिसे shoehorn कहा जाता है. इसके बाद, Edge का बुनियादी यूज़र इंटरफ़ेस कॉन्फ़िगर करें, ताकि Edge के साथ पुष्टि करने के लिए एसएएमएल का इस्तेमाल किया जा सके.
  • Edge का नया वर्शन इंस्टॉल करें. इसके बाद, Edge के नए वर्शन को कॉन्फ़िगर करें, ताकि Edge के साथ पुष्टि करने के लिए एसएएमएल का इस्तेमाल किया जा सके. New Edge को इंस्टॉल करने के बाद, उसमें लॉग इन किया जा सकता है. इसके बाद, Edge के साथ काम करने के लिए इसका इस्तेमाल किया जा सकता है.

इंस्टॉल करने से जुड़ी ज़रूरी शर्तें

  • Edge के नए वर्शन को इंस्टॉल करने से पहले, आपको Edge पर एसएएमएल को चालू करना होगा. Edge के नए वर्शन में, पुष्टि करने के लिए सिर्फ़ एसएएमएल का इस्तेमाल किया जा सकता है.

    Edge पर एसएएमएल को चालू करने के बारे में जानकारी पाने के लिए, निजी क्लाउड के लिए Edge पर एसएएमएल की सुविधा लेख पढ़ें.

  • Edge का नया वर्शन, सिर्फ़ TLS v1.2 के साथ काम करता है. आपको टीएलएस के ज़रिए एसएएमएल आईडीपी से कनेक्ट करना होता है. इसलिए, आपके एसएएमएल आईडीपी को टीएलएस v1.2 के साथ काम करना चाहिए.

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

    नोड को ये ज़रूरी शर्तें पूरी करनी होंगी:

    • JAVA 1.8
    • 4 जीबी रैम
    • 2-कोर
    • डिस्क में 60 जीबी स्टोरेज
    • आपको सबसे पहले नोड पर apigee-setup यूटिलिटी का 4.19.01 वर्शन इंस्टॉल करना होगा. इसके बारे में Edge apigee-setup यूटिलिटी इंस्टॉल करें में बताया गया है.
    • पोर्ट 3001 खुला होना चाहिए. यह डिफ़ॉल्ट पोर्ट है. इसका इस्तेमाल, Edge के नए वर्शन को किए जाने वाले अनुरोधों के लिए किया जाता है. अगर नीचे बताई गई प्रॉपर्टी का इस्तेमाल करके पोर्ट बदला जाता है, तो पक्का करें कि वह पोर्ट खुला हो.

Edge के नए वर्शन को इंस्टॉल करने से पहले ध्यान देने वाली बातें

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

Edge क्लासिक यूज़र इंटरफ़ेस (यूआई) के लिए एसएएमएल की ज़रूरत नहीं होती. यह डिफ़ॉल्ट यूज़र इंटरफ़ेस (यूआई) होता है, जिसे आपने Edge for Private Cloud के साथ इंस्टॉल किया है. यह एसएएमएल या बुनियादी पुष्टि करने की सुविधा का इस्तेमाल कर सकता है. इसका मतलब है कि आपके पास ये विकल्प हैं:

  • Edge पर एसएएमएल की सुविधा चालू करें. साथ ही, क्लासिक यूज़र इंटरफ़ेस (यूआई) और Edge के नए वर्शन, दोनों पर यह सुविधा चालू करें.

    इस मामले में, क्लासिक यूज़र इंटरफ़ेस (यूआई) और New Edge का इस्तेमाल करने वाले सभी उपयोगकर्ता, एसएएमएल आईडीपी में रजिस्टर होते हैं. एसएएमएल आईडीपी में नए उपयोगकर्ताओं को जोड़ने के बारे में जानकारी पाने के लिए, Edge के नए उपयोगकर्ताओं को रजिस्टर करना लेख पढ़ें.

  • Edge पर एसएएमएल की सुविधा चालू करें, लेकिन पुष्टि करने की बुनियादी सुविधा को चालू रहने दें. Edge के नए वर्शन में एसएएमएल का इस्तेमाल किया जाता है. वहीं, क्लासिक यूज़र इंटरफ़ेस (यूआई) में अब भी बुनियादी पुष्टि का इस्तेमाल किया जाता है.

    इस मामले में, क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने वाले सभी उपयोगकर्ता, पुष्टि करने वाले बुनियादी क्रेडेंशियल से लॉग इन करते हैं. ये क्रेडेंशियल, Edge OpenLDAP डेटाबेस में सेव होते हैं. Edge के नए वर्शन का इस्तेमाल करने वाले उपयोगकर्ता, एसएएमएल आईडीपी में रजिस्टर होते हैं और एसएएमएल का इस्तेमाल करके लॉग इन करते हैं.

    हालांकि, क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने वाला कोई उपयोगकर्ता, Edge के नए वर्शन में तब तक लॉग इन नहीं कर सकता, जब तक आपने उसे एसएएमएल आईडीपी में नहीं जोड़ा हो. इसके बारे में, Edge के नए उपयोगकर्ताओं को रजिस्टर करना में बताया गया है.

पिछली रिलीज़ के बाद, इंस्टॉलेशन कॉन्फ़िगरेशन में हुए बदलाव

New Edge के बीटा वर्शन को इंस्टॉल करने की प्रोसेस में हुए इन बदलावों के बारे में जानें.

Edge 4.18.05 से इंस्टॉलेशन कॉन्फ़िगरेशन में बदलाव

Edge 4.19.01 की रिलीज़ में, Edge 4.18.05 की रिलीज़ की कॉन्फ़िगरेशन फ़ाइल में ये बदलाव किए गए हैं:

बदलाव का टाइप जिन प्रॉपर्टी पर असर पड़ा है
हटाया गया 
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS

इस प्रॉपर्टी की वैल्यू पहले से 0.5 (30 मिनट) तय होती है और इसे बदला नहीं जा सकता.
जोड़ा गया अब प्रॉपर्टी का इस्तेमाल करके, New Edge पर टीएलएस को चालू किया जा सकता है. ज़्यादा जानकारी के लिए, Edge के नए वर्शन के लिए टीएलएस कॉन्फ़िगर करना लेख पढ़ें.

Edge 4.18.01 से, इंस्टॉलेशन कॉन्फ़िगरेशन में किए गए बदलाव

Edge 4.19.01 के नए Edge वर्शन में, Edge 4.18.01 वर्शन की कॉन्फ़िगरेशन फ़ाइल में ये बदलाव किए गए हैं:

बदलाव का टाइप जिन प्रॉपर्टी पर असर पड़ा है
जोड़ा गया 
# Shoehorn UI configurations.
SHOEHORN_SCHEME
SHOEHORN_IP
SHOEHORN_PORT

# Classic UI configurations.
CLASSIC_UI_SCHEME
CLASSIC_UI_IP
CLASSIC_UI_PORT

# Information about Edge SSO module.
MANAGEMENT_UI_SKIP_VERIFY
हटाया गया 
ROUTES_SHOEHORN
ROUTES_CLASSICUI
बैटरी को बदला गया 
MANAGEMENT_UI_USE_HTTPS
 इसकी जगह यह इस्तेमाल करें: 
MANAGEMENT_UI_SCHEME

इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल

कॉन्फ़िगरेशन फ़ाइल में, New Edge अनुभव को इंस्टॉल और कॉन्फ़िगर करने के लिए ज़रूरी सभी जानकारी होती है. एक ही कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करके, बुनियादी यूज़र इंटरफ़ेस (यूआई) और Edge के नए वर्शन, दोनों को इंस्टॉल और कॉन्फ़िगर किया जा सकता है.

कॉन्फ़िगरेशन फ़ाइल का एक उदाहरण यहां दिया गया है:

# IP of the Edge Management Server.
# This node also hosts the Edge SSO module and the current, or classic, Edge UI.
IP1=11.111.111.111

# IP of the New Edge experience node.
IP2=22.222.222.222

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge experience configuration.
#

# Enable the New Edge experience.
EDGEUI_ENABLE_UNIFIED_UI=y
# Specify IP and port for the New Edge experience.
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
# Specify a Private Cloud deployment.
MANAGEMENT_UI_APP_ENV=OPDK
# Disable TLS on the New Edge experience.
MANAGEMENT_UI_SCHEME=http

# Location of New Edge experience.
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=CHANGE_TO_YOUR_SECRET
# Duration of CSRF token.
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
# Defaults to 8760 hours, or 365 days.
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=8760

# SSO configuration for the New Edge experience.
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y
MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=secret111

#
# Shoehorn UI configuration
#
# Set to http even if you enable TLS on the New Edge experience.
SHOEHORN_SCHEME=http
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000

#
# Edge Classic UI configuration.
# Some settings are for the classic UI,
# but are still required to configure the New Edge experience.
#

# These settings assume that classic UI is installed on the Management Server.
CLASSIC_UI_IP=$MSIP
CLASSIC_UI_PORT=9000
CLASSIC_UI_SCHEME=http
EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT

# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Enable SSO.
EDGEUI_SSO_ENABLED=y

# The name of the OAuth client used to connect to apigee-sso. 
# The default client name is edgeui.
# Apigee recommends that you use the same settings as you used
# when enabling SAML on the classic Edge UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars. 
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Information about Edge SSO module.
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Edge SSO module.
# If Edge SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
SSO_PUBLIC_URL_SCHEME=http
# MANAGEMENT_UI_SKIP_VERIFY=y
# SSO admin credentials as set when you installed Edge SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

#
# Required SMTP information.
#

SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company myco@company.com"

Edge का बुनियादी यूज़र इंटरफ़ेस (शू हॉर्न) इंस्टॉल करना

Edge के नए वर्शन को इंस्टॉल करने से पहले, आपको Edge का बुनियादी यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करना होगा. इसे shoehorn कहा जाता है.

बुनियादी यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करने के लिए:

  1. Edge apigee-setup यूटिलिटी इंस्टॉल करें में बताए गए तरीके से, नोड पर apigee-setup यूटिलिटी का 4.19.01 वर्शन इंस्टॉल करें.
  2. Yum को क्लीन करना: 
    sudo yum clean all
  3. ऊपर बताए गए तरीके से कॉन्फ़िगरेशन फ़ाइल बनाएं और पक्का करें कि इसका मालिकाना हक "apigee" उपयोगकर्ता के पास हो: 
    chown apigee:apigee configFile

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

  4. कॉन्फ़िगरेशन फ़ाइल में, MANAGEMENT_UI_SSO_CSRF_SECRET प्रॉपर्टी की वैल्यू को अपने सीएसआरएफ़ सीक्रेट में बदलें.
  5. Edge यूज़र इंटरफ़ेस (यूआई) का Shoehorn वर्शन इंस्टॉल करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui install
  6. Edge यूज़र इंटरफ़ेस (यूआई) को कॉन्फ़िगर करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
  7. Edge यूज़र इंटरफ़ेस (यूआई) पर एसएएमएल चालू करने के लिए: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

Edge का नया वर्शन इंस्टॉल करना

Edge यूज़र इंटरफ़ेस (यूआई) का बुनियादी वर्शन इंस्टॉल करने के बाद, Edge के नए वर्शन को इंस्टॉल और कॉन्फ़िगर किया जा सकता है.

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

  1. Edge का नया वर्शन इंस्टॉल करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
  2. edge-management-ui डायरेक्ट्री में जाएं: 
    cd /opt/apigee/edge-management-ui
  3. New Edge अनुभव को कॉन्फ़िगर करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile

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

  4. Edge के नए वर्शन पर एसएएमएल चालू करने के लिए: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  5. Edge के नए वर्शन में लॉग इन करने के लिए, ब्राउज़र में यह यूआरएल खोलें: 
    http://newEdgeExperienceIP:3001

    जहां newEdgeExperienceIP, Edge के नए वर्शन को होस्ट करने वाले नोड का आईपी पता है. आपसे एसएएमएल क्रेडेंशियल मांगे जाएंगे. क्रेडेंशियल डालने के बाद, Edge का नया वर्शन दिखता है.

  6. ज़्यादा जानकारी के लिए, प्राइवेट क्लाउड के लिए Edge का नया वर्शन देखें. इसमें Edge के नए वर्शन को इस्तेमाल करने के बारे में जानकारी देने वाले लिंक भी शामिल हैं.

Edge का नया वर्शन अनइंस्टॉल करना

New Edge को अनइंस्टॉल करने के लिए:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall

Edge के बुनियादी यूज़र इंटरफ़ेस (यूआई) (shoehorn) को अनइंस्टॉल करने के लिए:

/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

नोड से एज को पूरी तरह से हटाने के लिए:

  1. मशीन पर चल रही Edge की सभी सेवाएं बंद करें: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. yum कैश मेमोरी मिटाएं: 
    sudo yum clean all
  3. सभी Apigee RPM हटाएं: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. इंस्टॉलेशन की रूट डायरेक्ट्री हटाएं: 
    sudo rm -rf /opt/apigee