4.19.06 Edge for Private Cloud یادداشت های انتشار

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

این بخش نسخه 4.19.06 Edge for Private Cloud Feature Release را شرح می دهد.

خلاصه انتشار

جدول زیر به طور خلاصه تغییرات این نسخه را نشان می دهد:

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

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

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

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

سازگاری به عقب

در این نسخه از Apigee Edge برای Private Cloud، مسائل زیر بر سازگاری به عقب تأثیر می گذارد:

  • با توجه به رفع مشکل 132443137 (همانطور که در یادداشت‌های انتشار عمومی Cloud 19.03.01 توضیح داده شده است)، پردازنده‌های پیام اکنون هدرهایی را که با X-Apigee-* شروع می‌شوند نادیده می‌گیرند. در نتیجه، شما باید هر کدی را که از هدرهای X-Apigee-* استفاده می‌کند، تغییر شکل دهید و آن هدرها را با هدرهای پشتیبانی شده جایگزین کنید.

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

    /opt/apigee/var/log/apigee-cassandra/system.log
شامل انتشارات

از زمان انتشار قبلی Edge برای Private Cloud Feature Release، نسخه های زیر رخ داده اند و در این نسخه گنجانده شده اند:

○ لبه:
19.07.23 (UI)
19.03.01
19.02.19
19.02.04
19.01.23
19.01.14
18.12.04
18.08.31
18.07.31		 ○ پورتال:
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.19.06 موارد زیر منسوخ شده است:

  • 4.18.01: نسخه 4.18.01 Apigee Edge برای Private Cloud اکنون منسوخ شده است.

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

رفع اشکال

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

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

برای اطلاعات بیشتر در مورد هر یک از این اصلاحات، رفع اشکال را ببینید.

مسائل شناخته شده

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

○ ضرابخانه در ابتدا به معاملات رتبه بندی نمی کند (141628497)
○ نشت حافظه سرورهای رتبه بندی Mint (137865184)
○ فرمت فایل متادیتا برای نصب apigee-sso (135616498)
○ apigee-monit در Amazon Linux 1 (122370980) پشتیبانی نمی شود
○ پشتیبان‌گیری پردازشگر پیام از مجموعه صحیح فایل‌ها پشتیبان‌گیری نمی‌کند (121095148)
○ DataAccess Exceptions در تنظیمات چند مرکز داده (76087166)
○ خط مشی MessageLogging شامل اطلاعات اضافی در پیام گزارش (68722102)

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

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

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

از 4.19.01 به طور مستقیم از 4.19.01 → 4.19.06 ارتقا دهید
از 4.18.05 به طور مستقیم از 4.18.05 → 4.19.06 ارتقا دهید
از تاریخ 4.18.01 به طور مستقیم از 4.18.01 → 4.19.06 ارتقا دهید

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

این بخش ویژگی های جدید این نسخه را فهرست می کند. به‌علاوه، این نسخه شامل تمام ویژگی‌های نسخه‌های Edge UI، Edge Management و Portal است که در نسخه‌های گنجانده شده فهرست شده‌اند.

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

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

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

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

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

پشتیبانی از قفسه کاساندرا

اکنون Apigee با آگاه کردن Cassandra در Apigee Edge برای Private Cloud، راهنمایی کلی برای عملیات مقیاس‌پذیری Cassandra ارائه می‌کند.

برای اطلاعات بیشتر، به پشتیبانی رک Cassandra مراجعه کنید.

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

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

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

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

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

نصب تجربه New Edge با یک اسکریپت جدید ساده شده است.

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

پشتیبانی LDAP IDP

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

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

پشتیبانی از IPv6

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

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

مستثنی کردن تراکنش‌های INVALID_TSC (کسب درآمد)

اکنون می توانید هنگام استفاده از کسب درآمد، تراکنش های INVALID_TSC را از اضافه شدن به پایگاه داده Postgres حذف کنید.

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

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

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

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

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

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • اوراکل لینوکس 6.9

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

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • اوراکل 6.8

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

رفع اشکال

این بخش اشکالات Private Cloud را که در این نسخه رفع شده اند فهرست می کند. علاوه بر این، این نسخه شامل تمام رفع اشکال‌ها در نسخه‌های Edge UI، Edge Management و Portal است که در نسخه‌های گنجانده شده نشان داده شده‌اند.

شناسه شماره توضیحات
140270474

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

UseStringDeduplication برای اجزای edge-message-processor در محیط های تولید تنظیم نشده بود.
111445518

خطاهای MP

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

شکست کاساندرا با JMX

وقتی JMX auth فعال شد، عملیات Cassandra کار نمی کرد
138931337

ارتقاء 13 گره

ارتقاء نصب های 13 گره از 17.09، 18.01 و 18.05 با شکست مواجه شد.
119802562

پروکسی هایی با همین نام

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

ذخیره‌سازی کلید بارگیری نمی‌شود

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

تجزیه و تحلیل شکست خورد

تجزیه و تحلیل برای یک محیط زمانی که با داده های Microgateway ارائه شد که برای تاریخ آینده تنظیم شده بود، شکست خورد.
110785400

خرابی های پشتیبان گیری

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

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

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

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

اجرای یک نسخه پشتیبان/بازیابی apigee-postgres اکنون از داده‌ها برای همه مؤلفه‌ها نسخه پشتیبان تهیه می‌کند.
65737520

بازنشانی رمز عبور sysadmin

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

مسائل شناخته شده

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

شناسه شماره توضیحات
141628497

ضرابخانه در ابتدا به معاملات رتبه بندی نمی کند

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

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

راه حل:

هر پردازشگر پیام (MPs) را مجددا راه اندازی کنید، که می تواند با موارد زیر انجام شود: 
apigee-service edge-message-processor restart

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

137865184

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

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

راه حل:

هیچ کدام
135616498

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

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

راه حل:

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

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

    یا

  • از یک مکان مبتنی بر URL برای ابرداده استفاده کنید
122370980

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

راه حل:

هیچ کدام
121095148

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

راه حل:

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

76087166

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

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

DataAccessException: Error while accessing datastore;
Please retry later

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

توجه داشته باشید که حالت مورد انتظار این است که سرور مدیریت به اجزای ذخیره داده در مناطق مختلف متصل نشود.

راه حل

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

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

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

  1. UUID گره های Cassandra را با استفاده از دستور curl زیر دریافت کنید: 
    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. مرحله یک را برای هر نوع گره کاساندرا تکرار کنید: 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. مرحله 3 را برای هر UUID که در مراحل 1 و 2 جمع آوری کرده اید تکرار کنید.
  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، از پیوندهای زیر استفاده کنید:

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