یادداشت‌های انتشار Edge برای «ابر خصوصی» نسخه ۴.۱۹.۰۶

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

این بخش نسخه ۴.۱۹.۰۶ از «انتشار ویژگی Edge برای ابر خصوصی» را شرح می‌دهد.

خلاصه انتشار

جدول زیر تغییرات این نسخه پخش را خلاصه می‌کند:

ویژگی‌های جدید

این نسخه شامل ویژگی‌های جدید زیر است:

○ پشتیبانی LDAP برای SSO
○ پشتیبانی استقرار HTTP
○ تجزیه‌وتحلیل‌های قابل‌اتصال
○ پشتیبانی از قفسه Cassandra
○ پشتیبانی از IPv6
○ نصب ساده‌شده تجربه New Edge
○ کنار گذاشتن INVALID_TSC تراکنش (درآمدزایی)

برای کسب اطلاعات بیشتر درباره هریک از این ویژگی‌های جدید، به ویژگی‌های جدید مراجعه کنید.
سازگاری با نسخه قدیمی

مشکلات زیر که بر سازگاری با نسخه‌های قبلی تأثیر می‌گذارند در این نسخه از Apigee Edge برای «ابر خصوصی» معرفی شده‌اند:

     

  • به‌دلیل رفع مشکل ۱۳۲۴۴۳۱۳۷ (همان‌طور که در یادداشت‌های انتشار Cloud عمومی در تاریخ ۱۹.۰۳.۰۱ توضیح داده شده است)، «پردازشگرهای پیام» اکنون سرایندهایی را که با X-Apigee-* شروع می‌شوند نادیده می‌گیرند. درنتیجه، باید هر کدی را که از سرایندهای X-Apigee-* استفاده می‌کند بازسازی کنید و آن سرایندها را با سرایندهای پشتیبانی‌شده جایگزین کنید.

  • نام فایل‌های گزارش Cassandra تغییر کرده است. اکنون این است:

    /opt/apigee/var/log/apigee-cassandra/system.log
نسخه‌های پخش گنجانده‌شده

از زمان انتشار ویژگی قبلی Edge for Private Cloud، نسخه‌های پخش زیر منتشر شده است و در این نسخه پخش گنجانده شده است:

○ Edge:
   ۲۳/۰۷/۱۹ (واسط کاربر)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31 		○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
بازنشستگی‌ها خالی
منسوخ‌سازی‌ها

با انتشار نسخه ۴.۱۹.۰۶، موارد زیر منسوخ شده‌اند:

  • 4.18.01: نسخه 4.18.01 از Apigee Edge for Private Cloud اکنون منسوخ شده است.

برای اطلاعات بیشتر، منسوخ شدن، بازنشستگی، و تغییرات CPS در Apigee را ببینید.
رفع اشکال‌ها

این نسخهٔ پخش شامل رفع اشکالات زیر است:

○ UseStringDeduplication تنظیم نشده است (140270474)
○ خطاهای MP (111445518)
○ خطاهای Cassandra با JMX (113342838)
○ ارتقاهای ۱۳ گره (138931337)
○ پراکسی‌هایی با نام یکسان (119802562)
○ بار نشدن مخزن کلید (118851790)
○ خطای Analytics (110988191)
○ خطاهای پشتیبان‌گیری (110785400)
○ HEAD درخواست به Node.js (79993247)
○ پشتیبان‌گیری/بازیابی apigee-postgres (70291825)
○ بازنشانی گذرواژه سرپرست سیستم (65737520)

برای اطلاعات بیشتر درباره هریک از این اصلاحات، به اصلاحات اشکال مراجعه کنید.
مشکلات شناخته‌شده

این نسخه شامل مشکلات شناخته‌شده زیر است:

○ Mint در ابتدا تراکنش‌ها را رده‌بندی نمی‌کند (۱۴۱۶۲۸۴۹۷)
○ نشت حافظه سرورهای رده‌بندی Mint (۱۳۷۸۶۵۱۸۴)
○ قالب فایل فراداده برای نصب apigee-sso (۱۳۵۶۱۶۴۹۸)
○ apigee-monit در Amazon Linux 1 پشتیبانی نمی‌شود (۱۲۲۳۷۰۹۸۰)
○ پشتیبان‌گیری «پردازشگر پیام» از مجموعه فایل‌های صحیح پشتیبان‌گیری نمی‌کند (۱۲۰۹۵۱۴۸)
○ DataAccessExceptions در پیکربندی‌های چند مرکز داده (۷۶۰۸۷۱۶۶)
○ خط‌مشی MessageLogging اطلاعات اضافی را در پیام گزارش وارد می‌کند (۶۸۷۲۲۱۰۲)

برای اطلاعات بیشتر درباره هریک از این مشکلات شناخته‌شده، ازجمله راهکارهای موقت، به مشکلات شناخته‌شده مراجعه کنید.

مسیرهای ارتقا

جدول زیر مسیرهای ارتقا را برای این نسخه نشان می‌دهد:

از ۴.۱۹.۰۱ مستقیماً از ۴.۱۹.۰۱ به ۴.۱۹.۰۶ ارتقا دهید
از ۴.۱۸.۰۵ مستقیماً از ۴.۱۸.۰۵ به ۴.۱۹.۰۶ ارتقا دهید
از ۴.۱۸.۰۱ مستقیماً از ۴.۱۸.۰۱ به ۴.۱۹.۰۶ ارتقا دهید

ویژگی‌های جدید

این بخش ویژگی‌های جدید این نسخه پخش را فهرست می‌کند. علاوه‌براین، این نسخهٔ پخش شامل همه ویژگی‌های موجود در نسخه‌های پخش «میانای کاربر Edge»، «مدیریت Edge»، و «درگاه» فهرست‌شده در نسخه‌های پخش گنجانده‌شده می‌شود.

علاوه‌بر بهبودهای زیر، این نسخهٔ پخش شامل بهبودهای متعددی در زمینه کارایی، عملکرد، امنیت، و پایداری نیز می‌شود.

پشتیبانی از استقرار HTTP

به‌طور پیش‌فرض، Edge از RPC برای استقرار پراکسی‌های API استفاده می‌کند. اگرچه این حالت برای اکثر نصب‌ها بسیار خوب کار می‌کند، اما توپولوژی‌های بزرگ‌تر با تعداد زیادی MP ممکن است هنگام برقراری تعداد زیادی تماس هم‌زمان ازطریق RPC، با زمان‌های انتظار مواجه شوند.

درنتیجه، Apigee توصیه می‌کند که استقرار بزرگ‌تر از HTTP به‌جای RPC برای استقرار استفاده کنند. فعال کردن استقرار HTTP اکنون پشتیبانی می‌شود.

برای اطلاعات بیشتر، فعال کردن استقرار HTTP را ببینید.

پشتیبانی از قفسه Cassandra

‫Apigee اکنون با ایجاد Cassandra در Apigee Edge برای «ابر خصوصی» که از قفسه آگاه است، راهنمایی کلی برای مقیاس‌بندی عملیات Cassandra ارائه می‌دهد.

برای اطلاعات بیشتر، پشتیبانی از قفسه Cassandra را ببینید.

تجزیه‌وتحلیل‌های قابل‌اتصال

به‌طور پیش‌فرض، داده‌های تجزیه‌وتحلیل جمع‌آوری‌شده توسط «پردازشگر پیام» برای پردازش در Qpid و Postgres بارگذاری می‌شود. سپس می‌توانید داده‌های Analytics را در «میانای کاربری Edge» مشاهده کنید.

با این «نسخه پخش ویژگی»، می‌توانید «پردازشگر پیام» را پیکربندی کنید تا داده‌های تحلیل را در دیسک بنویسد یا می‌توانید انتخاب کنید از هر دو گزینه استفاده کنید.

برای اطلاعات بیشتر، به نوشتن داده‌های Analytics در فایل مراجعه کنید.

نصب تجربه جدید ساده‌شده Edge

نصب تجربه «Edge جدید» با یک دستورگان جدید ساده‌تر شده است.

برای اطلاعات بیشتر، نصب تجربه جدید Edge را ببینید.

پشتیبانی از LDAP IDP

اکنون اصالت‌سنجی کاربران با Edge UI و فراخوانی‌های Edge management API علاوه‌بر SAML از LDAP نیز پشتیبانی می‌کند. پشتیبانی از LDAP شامل هر دو روش اتصال مستقیم و اتصال غیرمستقیم است.

برای اطلاعات بیشتر، مروری بر اصالت‌سنجی IDP خارجی را ببینید.

پشتیبانی از IPv6

به‌طور پیش‌فرض، همه فراخوانی‌های API زمان اجرا به Apigee Edge for Private Cloud از IPv4 استفاده می‌کنند. با دارایی جدیدی می‌توانید پشتیبانی از IPv6 را به «مسیریاب» اضافه کنید.

برای اطلاعات بیشتر، استفاده از IPv6 در «مسیریاب» را ببینید.

مستثنی کردن INVALID_TSC تراکنش (درآمدزایی)

اکنون می‌توانید INVALID_TSC تراکنش را از اضافه شدن به پایگاه داده Postgres هنگام استفاده از «درآمدزایی» مستثنا کنید.

برای اطلاعات بیشتر، دارایی‌های سرور درآمدزایی را ببینید.

نرم‌افزار پشتیبانی‌شده

این نسخه شامل تغییرات زیر در نرم‌افزار پشتیبانی‌شده است:

پشتیبانی اضافه شد دیگر پشتیبانی نمی‌شود

این نسخه پخش از پلاتفرم‌های زیر پشتیبانی می‌کند:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

نسخه پخش جدید دیگر از پلاتفرم‌های زیر پشتیبانی نمی‌کند:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • ‫Oracle 6.8

برای فهرست کامل پلاتفرم‌های پشتیبانی‌شده، به نرم‌افزار پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده مراجعه کنید.

رفع اشکال‌ها

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

شناسه مشکل شرح
140270474

UseStringDeduplication تنظیم نشده است

‫UseStringDeduplication برای مؤلفه‌های edge-message-processor در محیط‌های تولید تنظیم نشده بود.
111445518

خطاهای MP

«پردازشگرهای پیام» به‌طور مداوم پیام خطای زیر را هر ۵ دقیقه ثبت می‌کردند: 
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

خطاهای Cassandra با JMX

وقتی اصالت‌سنجی JMX فعال بود، عملیات Cassandra کار نمی‌کرد
138931337

ارتقاهای ۱۳ گره‌ای

ارتقاهای نصب‌های ۱۳ گره‌ای از نسخه‌های ۱۷.۰۹، ۱۸.۰۱، و ۱۸.۰۵ ناموفق بود.
119802562

کارگزاران با نام یکسان

اگر دو کاربر در یک سازمان کارگزاره‌هایی با نام‌های یکسان ایجاد کنند، کارگزاره دوم کارگزاره اول را ملغی می‌کند. این فقط زمانی رخ می‌داد که کاربران مختلف نمی‌توانستند پراکسی دیگر را ببینند.
118851790

فروشگاه کلید بار نمی‌شود

وقتی بیش‌از ۱۰۰ انبار کلید برای سازمان/محیط وجود داشت، بخش انبار کلید و مرجع در واسط کاربر Edge بار نمی‌شد. درعوض، واسط کاربر خطای Internal Error (Error Fetching Keystores) را نمایش داد.
110988191

‫Analytics انجام نشد

وقتی داده‌های Microgateway که روی تاریخ آینده تنظیم شده بود به محیطی ارائه شد، Analytics برای آن محیط کار نکرد.
110785400

پشتیبان‌گیری ناموفق بود

‫ZooKeeper،‏ Cassandra، و OpenLDAP به‌طور متناوب نتوانستند داده‌هایشان را به‌درستی با خطای زیر پشتیبان‌گیری کنند: File changed as we read it.
79993247

‫HEAD درخواست به Node.js

‫HEAD درخواست به هدف Node.js ممکن است معلقه شود و اتصال‌ها را در حالت تعلیق قرار دهد.
70291825

پشتیبان‌گیری/بازیابی apigee-postgres

اجرای پشتیبان‌گیری/بازیابی apigee-postgres اکنون از داده‌های همه عناصر پشتیبان‌گیری می‌کند.
65737520

بازنشانی گذرواژه سرپرست سیستم

بازنشانی گذرواژه سرپرست سیستم برای «سرور مدیریت» که حاوی نویسه‌های خاص بود ناموفق بود.

مشکلات شناخته‌شده

جدول زیر مشکلات شناخته‌شده در این نسخه پخش را فهرست می‌کند:

شناسه مشکل شرح
141628497

‫Mint در ابتدا تراکنش‌ها را رده‌بندی نمی‌کند

‫Edge for the Private Cloud در ابتدا که درآمدزایی را برای سازمانی فعال می‌کنید، تراکنش‌ها را رده‌بندی نمی‌کند. این امر برای سازمان‌های جدید و موجود اعمال می‌شود.

«میانای برنامه‌سازی کاربردی فعال‌سازی درآمدزایی» با شناسه کار پاسخ می‌دهد و پس‌از تکمیل، وضعیت کار موفقیت‌آمیز بودن آن را نشان می‌دهد. بااین‌حال، هرگونه تماس API درآمدزایی که در ابتدا انجام شده باشد، توسط درآمدزایی پردازش نخواهد شد و رتبه‌بندی نخواهد شد. این تراکنش‌ها فقط در تجزیه‌وتحلیل‌های معمولی نشان داده می‌شوند.

راهکار موقت:

«پردازنده‌های پیام» (MPs) را بازراه‌اندازی کنید. این کار را می‌توانید با موارد زیر انجام دهید: 
apigee-service edge-message-processor restart

پس‌از فعال شدن درآمدزایی، بازراه‌اندازی کردن MPs باعث می‌شود Edge پیکربندی را از ZooKeeper در زمان راه‌اندازی بار کند. این اتفاق در هر بار راه‌اندازی مجدد رخ می‌دهد، به این معنی که مشکل فقط در ابتدا اعمال می‌شود.

137865184

نشت حافظه سرورهای رده‌بندی Mint

وقتی نمونه Qpid جدیدی در mxgroup ثبت می‌شود، صف‌ها بدون مصرف‌کننده ساخته می‌شوند که باعث می‌شود عمق صف تا زمانی که از همه منابع دردسترس استفاده کند افزایش یابد.

راهکار موقت:

هیچ‌کدام.
135616498

قالب فایل فراداده برای نصب apigee-sso

هنگام نصب apigee-sso و استفاده از فایل metadata.xml به‌جای نشانی وب، اگر فایل metadata.xml در انتهای فایل خط جدید (CRLF) نداشته باشد، فایل metadata.xml به‌طور کامل خوانده نمی‌شود.

راهکار موقت:

برای دور زدن این مشکل، می‌توانید یکی از کارهای زیر را انجام دهید:

  • یک CRLF به انتهای فایل metadata.xml اضافه کنید

    یا

  • استفاده از مکان نشانی وب‌محور برای فراداده
122370980

‫apigee-monit در Amazon Linux 1 پشتیبانی نمی‌شود

راهکار موقت:

هیچ‌کدام.
121095148

پشتیبان‌گیری «پردازشگر پیام» از مجموعه فایل‌های صحیح پشتیبان‌گیری نمی‌کند

راهکار موقت:

پشتیبان‌گیری را برای بار دوم اجرا کنید تا مجموعه فایل‌های صحیح پشتیبان‌گیری شود.
76087166

‫DataAccessException در پیکربندی‌های چند مرکز داده

در پیکربندی‌های چند مرکز داده، اگر یکی از مخازن داده دردسترس نباشد، ممکن است خطای زیر را ببینید:

DataAccessException: Error while accessing datastore;
Please retry later

نتیجه این است که «سرور مدیریت» ممکن است شروع نشود زیرا درحال تلاش برای اتصال به گره‌های Cassandra در هر دو dc-1 و dc-2 است. اگر گره Cassandra غیرفعال باشد، DataAccessExceptions رخ می‌دهد. این امر همچنین ممکن است منجر به اختلال در ترافیک «میانای برنامه‌سازی کاربردی» شود، به‌طوری‌که «پردازشگرهای پیام» هنگام تلاش برای بازیابی KVM، DataAccessExceptions را گزارش می‌کنند.

توجه داشته باشید که وضعیت موردانتظار این است که «سرور مدیریت» به عناصر مخزن داده در مناطق متصل نشود.

راهکار موقت

راهکار موقت این است که انواع گره Cassandra زیر را در مرکز داده دردسترس‌نبود ثبت‌نام لغو کنید و سپس آن‌ها را پس‌از دردسترس قرار گرفتن مجدد گره‌های Cassandra ثبت‌نام کنید:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

برای لغو ثبت و ثبت مجدد این انواع گره Cassandra:

  1. بااستفاده از فرمان curl زیر، «شناسه‌های یکتای» گره‌های Cassandra را دریافت کنید: 
    curl -u ADMIN_EMAIL:ADMIN_PW \
  "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
  &type=CASSANDRA_NODE_TYPE"

    مکان:

    • ‫ADMIN_EMAIL و ADMIN_PW اطلاعات اعتباری حساب Apigee شما است.
    • ‫MS_IP و MS_PORT نشانی IP و شماره درگاه «سرور مدیریت» هستند.
    • ‫REGION نام مرکز داده‌ای است که «سرور مدیریت» در آن قرار دارد.
    • ‫GATEWAY_POD نام واحد است که به‌طور پیش‌فرض «دروازه» است. ممکن است آن را به نام دیگری تغییر داده باشید، بنابراین پیاده‌سازی‌تان را بررسی کنید.
    • ‫CASSANDRA_NODE_TYPE یکی از kms-datastore،‏ dc-datastore، و keyvaluemap-datastore است.

    برای مثال: 

    curl -u nickdanger@google.com:myP@$$w0rD
  "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    پاسخ از قالب زیر استفاده می‌کند: 

    {
  "internalIP" : "POD_IP_ADDRESS",
  "isUp" : [true|false],
  "pod" : "GATEWAY_POD",
  "reachable" : [true|false],
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
    "uUID" : "POD_UUID"
}

    برای مثال: 

    {
  "internalIP" : "192.168.1.11",
  "isUp" : false,
  "pod" : "gateway",
  "reachable" : false,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : "dc-datastore",
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
}

    مقادیر فیلد uUID را در پاسخ یادداشت کنید. از این موارد برای لغو ثبت گره‌ها استفاده خواهید کرد.

  2. مرحله یک را برای هر نوع گره Cassandra تکرار کنید: kms-datastore، dc-datastore، و keyvaluemap-datastore. حتماً شناسه‌های UUID برگشتی را یادداشت کنید.
  3. ثبت گره‌ها را بااستفاده از فرمان زیر لغو کنید: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    که در آن UUID شناسه UUID برگشتی در پاسخ فرمان قبلی است.

  4. مرحله ۳ را برای هر شناسه UUID که در مراحل ۱ و ۲ جمع‌آوری کرده‌اید تکرار کنید.
  5. بااستفاده از فرمان زیر، گره‌ها را دوباره ثبت کنید: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
  Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
  region=REGION&pod=GATEWAY_POD" -H \
  'content-type: application/x-www-form-urlencoded' -X POST

توجه داشته باشید که این عملیات گره‌ها را در Zookeeper ثبت و لغو ثبت می‌کند و هیچ تأثیری بر خوشه Cassandra ندارد. برای کسب اطلاعات بیشتر درباره این فرمان‌ها، به‌روزرسانی ثبت‌های انبار داده را ببینید.
68722102

خط‌مشی MessageLogging (ثبت پیام) شامل اطلاعات اضافی در پیام گزارش

عنصر FormatMessage خط‌مشی MessageLogging قالب پیام گزارش‌شده را کنترل می‌کند. وقتی FormatMessage=false، پیام ثبت‌شده نباید شامل هیچ‌گونه اطلاعات تولیدشده توسط Apigee باشد. بااین‌حال، حتی اگر FormatMessage=false را تنظیم کنید، پیام گزارش همچنان شامل اطلاعات زیر است:

  • امتیاز اولویت
  • مُهر زمان

راهکار موقت:

هیچ‌کدام.

مرحله بعدی

برای شروع کار با Edge for Private Cloud 4.19.06، از پیوندهای زیر استفاده کنید:

تاسیسات جدید:
نمای کلی نصب جدید
تاسیسات موجود:
مسیرها را ارتقا دهید