New Edge Experience (बीटा वर्शन) इंस्टॉल करना

Edge for Private Cloud v4.18.05

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

प्राइवेट क्लाउड इंस्टॉलेशन के लिए, Edge में New Edge इस्तेमाल करने के लिए, आपको ये काम करने होंगे:

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

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

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

प्राइवेट क्लाउड के लिए Edge के लिए New Edge का बीटा वर्शन इंस्टॉल करने के लिए, आपको इंस्टॉल करने की दो अलग-अलग प्रोसेस करता है:

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

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

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

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

  • आपको इसके खुद के नोड पर New Edge इंस्टॉल करना होगा. इसे किसी नोड पर इंस्टॉल नहीं किया जा सकता इसमें Edge के अन्य कॉम्पोनेंट शामिल होते हैं. नोड को नीचे दी गई ज़रूरी शर्तें पूरी करनी होंगी:

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

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

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

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

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

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

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

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

Edge 4.18.01 से इंस्टॉल करने का कॉन्फ़िगरेशन बदल गया है

New Edge के Edge 4.18.05 वर्शन की रिलीज़ में, नीचे दिए गए बदलाव होते हैं कॉन्फ़िगरेशन फ़ाइल बनाई है. इन प्रॉपर्टी के बारे में पूरी जानकारी दी गई है इन सेक्शन में शामिल करें:

बदलाव का टाइप ऐसी प्रॉपर्टी जिन पर असर पड़ा है
जोड़ा गया 
# 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

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

कॉन्फ़िगरेशन फ़ाइल में नई फ़ाइल को इंस्टॉल और कॉन्फ़िगर करने के लिए सभी ज़रूरी जानकारी मौजूद है Edge का अनुभव. दोनों बेस को इंस्टॉल और कॉन्फ़िगर करने के लिए, एक ही कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल किया जा सकता है यूज़र इंटरफ़ेस (यूआई) और New 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.
# This release does not support TLS.
MANAGEMENT_UI_SCHEME=http

# Location of New Edge experience.
MANAGEMENT_UI_PUBLIC_URIS=http://$IP2:3001
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=secret222
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

# 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.
#

# The first two properties use the same values as the New Edge experience.
SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME
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 का अनुभव.

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

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

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

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

New Edge इंस्टॉल करें

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

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

  1. New 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. यहां दिए गए यूआरएल को ब्राउज़र में खोलकर, New Edge पर लॉग इन करें: 
    http://newEdgeExperienceIP:3001

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

  6. द न्यू प्राइवेट क्लाउड के लिए Edge Experience (बीटा वर्शन) पर जाएं. इसमें आपको ज़्यादा जानकारी मिलेगी, जिसमें New Edge इस्तेमाल करने के बारे में जानकारी.

New Edge के अनुभव को अनइंस्टॉल करें

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

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

बेस एज यूज़र इंटरफ़ेस (यूआई) को अनइंस्टॉल करने के लिए (शूहॉर्न):

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

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

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