‫4.19.01 Edge for Private Cloud release notes

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

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

راهکار موقت:

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

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

  یا

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

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

راهکار موقت:

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

راهکار موقت:

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

نشان‌های جلسه نامعتبر نشد

وقتی کاربر روی دکمه «خروج از سیستم Apigee Edge» کلیک می‌کند، نشان‌های جلسه در سرور نامعتبر نمی‌شوند.

راهکار موقت:

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

راهکار موقت:

HEAD درخواست به هدف‌های Node.js معلقه است

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

راهکار موقت:

برای دور زدن این مشکل، یک مدیریت‌کننده برای درخواست‌های HEAD تعریف کنید تا صریحاً پاسخ خالی برگرداند.

نام‌های میزبان حل‌وفصل نمی‌شوند

پس‌از نصب یا ارتقا دادن Edge for Private Cloud، نام‌های میزبان ممکن است به نشانی‌هایشان تبدیل نشوند.

راهکار موقت:

برای حل کردن این مشکل، مؤلفه Edge UI را بازراه‌اندازی کنید:

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

‫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 ندارد. برای کسب اطلاعات بیشتر درباره این فرمان‌ها، به‌روزرسانی ثبت‌های انبار داده را ببینید.

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

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

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

راهکار موقت:

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

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

راهکار موقت:

گذرواژه را در فایل داده‌ای تعریف کنید که سپس آن را به نقطه پایانی /users در «میانای برنامه‌سازی کاربردی مدیریت» منتقل می‌کنید. برای کسب اطلاعات بیشتر، به بازنشانی گذرواژه سرپرست سیستم مراجعه کنید.