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

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

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

راه حل:

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

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

  یا

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

apigee-monit در آمازون لینوکس ۱ پشتیبانی نمی‌شود

راه حل:

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

راه حل:

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

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

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

راه حل:

عملیات کاساندرا هنگام فعال بودن JMX auth کار نمی‌کند

راه حل:

درخواست‌های HEAD به سمت اهداف Node.js هنگ می‌کنند

درخواست‌های HEAD به یک مقصد Node.js می‌توانند قطع شوند و اتصالات را در حالت انتظار باقی بگذارند.

راه حل:

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

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

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

راه حل:

برای حل این مشکل، کامپوننت رابط کاربری Edge را مجدداً راه‌اندازی کنید:

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

خطای DataAccessException در پیکربندی‌های مختلف مرکز داده

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

DataAccessException: Error while accessing datastore;
Please retry later

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

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

راه حل

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

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

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

1. با استفاده از دستور curl زیر، UUID های گره‌های کاساندرا را دریافت کنید:

   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 نام مرکز داده‌ای است که سرور مدیریت (Management Server) در آن قرار دارد.
   • GATEWAY_POD نام پاد است که به طور پیش‌فرض "gateway" است. با این حال، ممکن است آن را به چیز دیگری تغییر نام داده باشید، بنابراین پیاده‌سازی خود را بررسی کنید.
   • 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. مرحله ۳ را برای هر 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 ندارند. برای اطلاعات بیشتر در مورد این دستورات، به بخش «به‌روزرسانی ثبت‌های فروشگاه داده» مراجعه کنید.

سیاست ثبت پیام شامل اطلاعات اضافی در پیام ثبت

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

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

راه حل:

بازنشانی رمز عبور مدیر سیستم ناموفق بود

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

راه حل:

رمز عبور را در یک فایل داده تعریف کنید که سپس آن را به نقطه پایانی /users در API مدیریت ارسال کنید. برای اطلاعات بیشتر، به تنظیم مجدد رمز عبور مدیر سیستم مراجعه کنید.