درحال نصب «تجربه جدید Edge» (نسخه بتا)

Edge for Private Cloud v4.18.05

این سند نحوه نصب نسخه بتای تجربه «Edge جدید» برای Edge در «ابر خصوصی» را شرح می‌دهد. تجربه «Edge جدید» نسل بعدی واسط کاربر Edge است.

برای امتحان کردن تجربه «Edge جدید» در نصب Edge for Private Cloud، باید:

  • ‫SAML را در Edge فعال کنید. تجربه «Edge جدید» فقط از SAML به‌عنوان سازوکار اصالت‌سنجی پشتیبانی می‌کند.
  • تجربه «لبه جدید» را در گره خودش نصب کنید. نمی‌توانید آن را روی گرهی که حاوی دیگر عناصر Edge است نصب کنید.

برای اطلاعات بیشتر درباره تجربه «لبه جدید»، تجربه «لبه جدید» برای ابر خصوصی را ببینید.

نمای کلی نصب

برای نصب نسخه «بتا» از تجربه «Edge جدید» برای «Edge ویژه ابر خصوصی»، دو فرایند نصب متفاوت را انجام می‌دهید:

  • «میانای کاربر Edge» پایه، به‌نام shoehorn، را نصب کنید و «میانای کاربر Edge» پایه را پیکربندی کنید تا از SAML برای اصالت‌سنجی با Edge استفاده کند.
  • تجربه «Edge جدید» را نصب کنید، و تجربه «Edge جدید» را پیکربندی کنید تا از SAML برای اصالت‌سنجی با Edge استفاده کند. پس‌از نصب تجربه «Edge جدید»، می‌توانید به سیستم وارد شوید و از آن برای کار با Edge استفاده کنید.

پیش‌نیازهای نصب

  • قبل‌از نصب تجربه «Edge جدید»، باید SAML را در Edge فعال کنید. تجربه «New Edge» فقط از SAML به‌عنوان سازوکار اصالت‌سنجی پشتیبانی می‌کند.

    برای کسب اطلاعات درباره فعال کردن SAML در Edge، به پشتیبانی از SAML در Edge برای «ابر خصوصی» مراجعه کنید.

  • باید تجربه «لبه جدید» را در گره خود نصب کنید. نمی‌توانید آن را در گرهی نصب کنید که شامل دیگر عناصر Edge باشد. گره باید الزامات زیر را برآورده کند:
    • JAVA 1.8
    • ‫۴ گیگابایت حافظه دسترسی تصادفی
    • ‫۲ هسته‌ای
    • ‫۶۰ گیگابایت فضای دیسک
    • ابتدا باید نسخه 4.18.05 ابزار apigee-setup را در گره نصب کنید، همان‌طور که در نصب ابزار apigee-setup در Edge توضیح داده شده است.

ملاحظات قبل‌از نصب تجربه New Edge

همان‌طور که در پیش‌نیازهای بالا توضیح داده شد، تجربه «Edge جدید» مستلزم این است که SAML را در Edge فعال کنید. یعنی اصالت‌سنجی کاربر توسط SAML IDP کنترل می‌شود، جایی که SAML IDP را پیکربندی می‌کنید تا از نشانی‌های ایمیل به‌عنوان شناسه کاربر استفاده کند. بنابراین همه کاربران تجربه «Edge جدید» باید در SAML IDP ثبت شده باشند.

میانای کاربری کلاسیک Edge، میانای کاربری پیش‌فرضی که با Edge برای «ابر خصوصی» نصب کرده‌اید، به SAML نیاز ندارد. می‌تواند از SAML یا اصالت‌سنجی پایه استفاده کند. یعنی می‌توانید:

  • پشتیبانی از SAML را در Edge و در هر دو واسط کاربر کلاسیک و تجربه «Edge جدید» فعال کنید.

    در این سناریو، همه کاربران میانای کاربر کلاسیک و تجربه «لبه جدید» در SAML IDP ثبت شده‌اند. برای کسب اطلاعات درباره افزودن کاربران جدید به SAML IDP، به ثبت کاربران جدید Edge مراجعه کنید.

  • پشتیبانی از SAML را در Edge فعال کنید، اما احراز هویت پایه را فعال بگذارید. تجربه «Edge جدید» از SAML استفاده می‌کند و واسط کاربر کلاسیک همچنان از اصالت‌سنجی پایه استفاده می‌کند.

    در این سناریو، همه کاربران رابط کاربری کلاسیک با اطلاعات اعتباری اصالت‌سنجی پایه به سیستم وارد می‌شوند، درحالی‌که اطلاعات اعتباری آن‌ها در پایگاه داده Edge OpenLDAP ذخیره می‌شود. کاربران تجربه جدید Edge در SAML IDP ثبت شده‌اند و بااستفاده از SAML به سیستم وارد می‌شوند.

    بااین‌حال، کاربر میانای کاربر کلاسیک نمی‌تواند تا زمانی که آن کاربر را به SAML IDP اضافه نکرده‌اید، همان‌طور که در ثبت کاربران جدید Edge توضیح داده شده است، به تجربه «Edge جدید» وارد شود.

تغییرات پیکربندی نصب از Edge 4.18.01

نسخه ۴.۱۸.۰۵ از تجربه «Edge جدید» شامل تغییرات زیر در فایل پیکربندی از نسخه ۴.۱۸.۰۱ «Edge» است. این دارایی‌ها به‌طور مفصل در بخش زیر شرح داده شده‌اند:

نوع تغییر دارایی‌های تحت‌تأثیر
افزوده‌شده 
# 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.
# 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 جدید» را نصب کنید، باید واسط کاربر پایه Edge، به‌نام shoehorn، را نصب کنید.

برای نصب کردن میانای کاربر پایه:

  1. نسخه 4.18.05 ابزار apigee-setup را در گره نصب کنید، همان‌طور که در نصب ابزار Edge apigee-setup توضیح داده شده است.
  2. ‫Clean Yum: 
    sudo yum clean all
  3. فایل پیکربندی را همان‌طور که در بالا توضیح داده شده است ایجاد کنید و مطمئن شوید که متعلق به کاربر «apigee» است: 
    chown apigee:apigee configFile

    که در آن configFile فایل پیکربندی است که در بالا در فایل پیکربندی نصب توضیح داده شده است.

  4. نسخه Shoehorn از «واسط کاربر 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. فعال کردن SAML در «میانای کاربر Edge»: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

نصب تجربه «Edge جدید»

پس‌از نصب کردن «واسط کاربر» پایه Edge، می‌توانید تجربه «Edge جدید» را نصب و پیکربندی کنید.

برای نصب تجربه «Edge جدید»:

  1. تجربه «لبه جدید» را نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
  2. به فهرست راهنمای edge-management-ui تغییر دهید: 
    cd /opt/apigee/edge-management-ui
  3. تجربه «Edge جدید» را پیکربندی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile

    که در آن configFile فایل پیکربندی است که در بالا در فایل پیکربندی نصب توضیح داده شده است.

  4. فعال کردن SAML در تجربه «Edge جدید»: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  5. با باز کردن نشانی وب زیر در مرورگر، به تجربه «Edge جدید» وارد شوید: 
    http://newEdgeExperienceIP:3001

    که در آن newEdgeExperienceIP نشانی IP گره میزبان تجربه «Edge جدید» است. از شما خواسته می‌شود اعتبارنامه‌های SAML خود را وارد کنید. پس‌از وارد کردن اعتبارنامه‌هایتان، تجربه New Edge ظاهر می‌شود.

  6. برای اطلاعات بیشتر، ازجمله پیوندهای مربوط به اطلاعات استفاده از تجربه «جدید Edge»، به تجربه جدید Edge برای «ابر خصوصی» (نسخه بتا) مراجعه کنید.

حذف نصب تجربه «Edge جدید»

برای حذف نصب تجربه «Edge جدید»:

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

برای حذف نصب واسط کاربر پایه Edge (کفش‌قاپ):

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

برای حذف کامل Edge از گره:

  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