Apigee-তে পরিচিত সমস্যা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

নিচে দেওয়া বিভাগগুলিতে Apigee Edge এবং Edge for Private Cloud-এর পরিচিত সমস্যাগুলি বর্ণনা করা হয়েছে। বেশিরভাগ ক্ষেত্রে, তালিকাভুক্ত সমস্যাগুলি ভবিষ্যতের রিলিজে সমাধান করা হবে।

Edge-এর বিভিন্ন পরিচিত সমস্যা

Edge-এ হওয়া অন্যান্য পরিচিত সমস্যা সম্পর্কে নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

এলাকা/সারসংক্ষেপ পরিচিত সমস্যা
ক্যাশে মেয়াদ শেষ হয়ে গেলে ভুল cachehit ভ্যালু দেখানো হয়

cachehit ফ্লো ভেরিয়েবলটি LookupCache নীতির পরে ব্যবহার করা হলে, অ্যাসিঙ্ক্রোনাস আচরণের জন্য যেভাবে ডিবগ পয়েন্ট ডিসপ্যাচ করা হয়, তার ফলে কল ব্যাক এক্সিকিউট হওয়ার আগে LookupPolicy, DebugInfo অবজেক্ট পূরণ করে দেয়, যার ফলে একটি সমস্যা হয়।

সমস্যার সমাধান: প্রথম কল করার ঠিক পরেই আবার প্রসেসটি (দ্বিতীয় কল করুন) রিপিট করুন।

Setting InvalidateCache Policy PurgeChildEntries to true does not work correctly

InvalidateCache নীতিতে PurgeChildEntries সেট করলে শুধুমাত্র KeyFragment এলিমেন্টের ভ্যালু মুছে যাওয়ার কথা, কিন্তু পুরো ক্যাশে মুছে যায়।

সমস্যা সমাধানের বিকল্প: ক্যাশে ভার্সনিংয়ের পুনরাবৃত্তি করতে এবং ক্যাশে ইনভ্যালিড করার প্রয়োজনীয়তা এড়াতে KeyValueMapOperations নীতি ব্যবহার করুন।

SharedFlow বা API প্রক্সির জন্য একই সাথে ডিপ্লয়মেন্টের অনুরোধ করলে ম্যানেজমেন্ট সার্ভারে অসঙ্গতিপূর্ণ অবস্থা তৈরি হতে পারে যেখানে একাধিক রিভিশন ডিপ্লয় করা হয়েছে বলে দেখানো হয়।

এটি হতে পারে, যেমন, যখন CI/CD ডিপ্লয়মেন্ট পাইপলাইনের কনকারেন্ট রান বিভিন্ন রিভিশন ব্যবহার করে ঘটে। এই সমস্যা এড়াতে, বর্তমান ডিপ্লয়মেন্ট সম্পূর্ণ হওয়ার আগে API প্রক্সি বা SharedFlows ডিপ্লয় করা এড়িয়ে চলুন।

সমস্যা সমাধানের বিকল্প: একই সাথে API প্রক্সি বা SharedFlow ডেপ্লয়মেন্ট এড়িয়ে চলুন।

Edge API Analytics-এ দেখানো API কলের সংখ্যায় ডুপ্লিকেট ডেটা থাকতে পারে।

Edge API Analytics-এ কখনও কখনও API কলের জন্য ডুপ্লিকেট ডেটা থাকতে পারে। সেই ক্ষেত্রে, Edge API Analytics-এ API কলের জন্য দেখানো সংখ্যা থার্ড-পার্টি অ্যানালিটিক্স টুলে দেখানো তুলনামূলক ভ্যালুর থেকে বেশি হয়।

সমস্যা সমাধানের বিকল্প: অ্যানালিটিক্স ডেটা এক্সপোর্ট করুন এবং ডেটা ডুপ্লিকেট করা এড়াতে gateway_flow_id ফিল্ড ব্যবহার করুন।

Edge UI সংক্রান্ত পরিচিত সমস্যা

Edge UI-তে পরিচিত সমস্যাগুলি নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

এলাকা/সারসংক্ষেপ পরিচিত সমস্যা
কোনও অর্গানাইজেশনকে আইডেন্টিটি জোনের সাথে ম্যাপ করার পরে নেভিগেশন বার থেকে Edge SSO জোন অ্যাডমিনিস্ট্রেশন পৃষ্ঠা অ্যাক্সেস করা যায় না

আপনি কোনও সংস্থা থেকে পরিচয় জোন কানেক্ট করলে, আপনি আর Edge SSO জোন অ্যাডমিনিস্ট্রেশন পৃষ্ঠা অ্যাক্সেস করতে পারবেন না। এর জন্য বাঁদিকের নেভিগেশন বার থেকে অ্যাডমিন > SSO বেছে নিতে হবে।

সমস্যা সমাধানের বিকল্প: নিম্নলিখিত URL ব্যবহার করে সরাসরি পৃষ্ঠায় নেভিগেট করুন: https://apigee.com/sso

Edge UI TLS কনফিগারেশন

TLS_DISABLED_ALGO ও TLS_ENABLED_CIPHERS বিকল্পগুলি সঠিকভাবে কাজ করে না।

সমস্যার সমাধান: Edge UI-এর জন্য নির্দিষ্ট সাইফার চালু করতে, নিচে উল্লেখ করা ধাপগুলি অনুসরণ করুন:

  1. /opt/apigee/etc/edge-ui.d/SSL.sh কনফিগারেশন ফাইল খুলুন।
  2. UI_OPTIONS-এর মধ্যে IANA নোটেশনে কমা দিয়ে আলাদা করা সাইফার স্যুটের তালিকা সহ -Djdk.tls.server.cipherSuites প্রপার্টি যোগ করুন। যেমন: 
    UI_OPTIONS=" -Dhttp.port=disabled -Dhttps.port=9433 -Dhttps.keyStoreType=JKS -Dhttps.keyStore=/opt/apigee/customer/conf/keystore.jks -Dplay.http.sslengineprovider=services.CustomSSLEngineProvider -Dhttps.keyStorePasswordEncrypted=mypass -Djdk.tls.server.cipherSuites=TLS_RSA_WITH_AES_256_CBC_SHA256,TLS_RSA_WITH_AES_256_GCM_SHA384"
  3. কনফিগারেশন ফাইলে আপনার করা পরিবর্তন সেভ করুন।
  4. Edge UI রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ইন্টিগ্রেটেড পোর্টাল সম্পর্কিত পরিচিত সমস্যা

ইন্টিগ্রেটেড পোর্টাল সংক্রান্ত পরিচিত সমস্যাগুলি নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

এলাকা পরিচিত সমস্যা
SmartDocs
  • আপনি যখন স্পেক এডিটর ব্যবহার করে স্পেসিফিকেশন তৈরি করেন এবং আপনার পোর্টালের SmartDocs ব্যবহার করে API প্রকাশ করেন, তখন Apigee Edge OpenAPI স্পেসিফিকেশন 3.0-কে সাপোর্ট করে, যদিও কিছু ফিচার এখনও কাজ করে না।

    যেমন, OpenAPI স্পেসিফিকেশন ৩.০-এর নিম্নলিখিত ফিচার এখনও কাজ করে না:

    • স্কিমা একত্রিত ও এক্সটেন্ড করার জন্য allOfটি প্রপার্টি
    • রিমোট রেফারেন্স

    আপনার OpenAPI স্পেসিফিকেশনে কোনও কাজ করে না এমন ফিচারের রেফারেন্স দেওয়া থাকলে, কিছু ক্ষেত্রে টুলটি ফিচারটি উপেক্ষা করবে, কিন্তু তা সত্ত্বেও API রেফারেন্স ডকুমেন্টেশন রেন্ডার করবে। অন্যান্য ক্ষেত্রে, API রেফারেন্স ডকুমেন্ট সঠিকভাবে রেন্ডার করতে না পারার কারণ হল, কোনও ফিচার কাজ করে না। দুটি ক্ষেত্রেই, ভবিষ্যতে রিলিজ না হওয়া পর্যন্ত, কাজ করে না এমন ফিচার ব্যবহার করা এড়াতে আপনাকে OpenAPI স্পেসিফিকেশন পরিবর্তন করতে হবে।

    মনে রাখবেন: API রেফারেন্স ডকুমেন্ট রেন্ডার করার সময় স্পেক এডিটর SmartDocs-এর তুলনায় কম বিধিনিষেধ মেনে চলে, তাই আপনি টুল দুটির মধ্যে আলাদা আলাদা ফলাফল পেতে পারেন।

  • পোর্টাল থেকে Try this API ব্যবহার করার সময়, OpenAPI স্পেসিফিকেশনে consumes-এর জন্য যে ভ্যালু সেট করা হোক না কেন, Accept হেডার application/json হিসেবে সেট করা হয়।
  • 138438484: একাধিক সার্ভার কাজ করে না।
SAML পরিচয় প্রদানকারী কাস্টম ডোমেনের ক্ষেত্রে SAML আইডেন্টিটি প্রোভাইডারের সাথে সিঙ্গেল লগ-আউট (SLO) কাজ করে না। SAML আইডেন্টিটি প্রোভাইডারের সাথে কাস্টম ডোমেন চালু করতে, আপনি যখন SAML সেটিংস কনফিগার করেন, তখন সাইন-আউট URL ফিল্ডটি খালি রাখুন।
পোর্টাল অ্যাডমিন
  • এই মুহূর্তে একাধিক ব্যবহারকারী একই সাথে পোর্টাল আপডেট (যেমন, পৃষ্ঠা, থিম, CSS বা স্ক্রিপ্ট এডিট) করতে পারবেন না।
  • আপনি পোর্টাল থেকে কোনও API রেফারেন্স ডকুমেন্টেশন পৃষ্ঠা মুছে দিলে, এটি আবার তৈরি করার কোনও উপায় নেই; আপনাকে API প্রোডাক্টটি মুছে দিয়ে আবার যোগ করতে হবে এবং API রেফারেন্স ডকুমেন্টেশন আবার তৈরি করতে হবে।
  • কন্টেন্ট নিরাপত্তা নীতি কনফিগার করার সময়, পরিবর্তন সম্পূর্ণ প্রয়োগ করতে ১৫ মিনিট পর্যন্ত সময় লাগতে পারে।
  • আপনার পোর্টাল থিম কাস্টমাইজ করার সময়, পরিবর্তনগুলি সম্পূর্ণভাবে প্রয়োগ করতে ৫ মিনিট পর্যন্ত সময় লাগতে পারে।
পোর্টাল ফিচার
  • ভবিষ্যতের রিলিজের মাধ্যমে ইন্টিগ্রেটেড পোর্টালে সার্চ ইন্টিগ্রেট করা হবে।

প্রাইভেট ক্লাউডের জন্য Edge-এ পরিচিত সমস্যা

নিম্নলিখিত বিভাগে, প্রাইভেট ক্লাউডের জন্য Edge-এর পরিচিত সমস্যাগুলি বর্ণনা করা হয়েছে।

এলাকা পরিচিত সমস্যা
প্রাইভেট ক্লাউডের জন্য Edge 4.53.01 NGINX দুর্বলতা মূল্যায়ন (CVE-2026-42945)

NGINX-এ ngx_http_rewrite_module-কে প্রভাবিত করে এমন একটি দুর্বলতা (CVE-2026-42945) প্রকাশ করা হয়েছে। প্রাইভেট ক্লাউডের জন্য Apigee Edge-এর সাথে অন্তর্ভুক্ত NGINX বাইনারিগুলি নিরাপত্তা স্ক্যানিং টুল ফ্ল্যাগ করতে পারে কারণ এই মডিউলটি NGINX-এ স্ট্যাটিক কম্পাইল করা হয়।

প্রাইভেট ক্লাউডের জন্য Apigee Edge-এর উপর প্রভাব:

Apigee Edge for Private Cloud-এর ডিফল্ট, শিপ করা কনফিগারেশনে এই দুর্বলতার কোনও প্রভাব পড়ে না। CVE-2026-42945-এর এক্সপ্লয়টেবিলিটি নির্দিষ্ট NGINX কনফিগারেশন প্যাটার্নের উপর নির্ভর করে, বিশেষ করে একটি নির্দিষ্ট সিকোয়েন্সে rewrite ডাইরেক্টিভের ব্যবহার। এইসব প্যাটার্ন কোনও স্ট্যান্ডার্ড Apigee Edge for Private Cloud NGINX কনফিগারেশনে থাকে না।

ব্যবস্থা নিতে হবে:

  • প্রাইভেট ক্লাউড কনফিগারেশনের জন্য ডিফল্ট Apigee Edge-এর ক্ষেত্রে: কোনও প্যাচ, আপগ্রেড বা অপারেশনাল পরিবর্তন করার প্রয়োজন নেই। ডিফল্ট ইনস্টলেশনের ক্ষেত্রে CVE-2026-42945 সংক্রান্ত স্ক্যানারের ফলাফলকে ফলস পজিটিভ হিসেবে বিবেচনা করা যেতে পারে। আপনার দুর্বলতা ম্যানেজমেন্ট সিস্টেমে এই ব্যতিক্রম ডকুমেন্ট করার জন্য আপনি নিম্নলিখিত টেক্সট ব্যবহার করতে পারেন:

    CVE-2026-42945 — Accepted exception (false positive for Apigee Edge for Private Cloud). Apigee Edge for Private Cloud does not use the rewrite directive in any shipped NGINX configuration. The vulnerable code path in ngx_http_rewrite_module is configuration-gated and is not reachable in the default Apigee Edge for Private Cloud deployment.

  • কাস্টমাইজ করা NGINX কনফিগারেশনের জন্য: আপনার Apigee Edge for Private Cloud ইনস্টলেশনের মধ্যে (যেমন, /opt/nginx-এর অধীনে) NGINX কনফিগারেশন ফাইল ম্যানুয়ালি পরিবর্তন করে থাকলে, আপনার কাস্টমাইজেশনের মাধ্যমে অনিচ্ছাকৃতভাবে দুর্বল প্যাটার্ন যোগ করা হয়নি তা নিশ্চিত করতে আপনাকে নিম্নলিখিত সেল্ফ-চেক করতে হবে:
    1. রিরাইট ডাইরেক্টিভ চেক করুন: প্রতিটি NGINX নোডে, এই কমান্ডটি চালান: 
      sudo grep -rnI '^\s*rewrite\b' /opt/nginx
    2. ফলাফল বিশ্লেষণ করুন:
      • কমান্ড কোনও আউটপুট না দেখালে, আপনার সিস্টেম প্রভাবিত হয়নি।
      • ম্যাচ খুঁজে পাওয়া গেলে, প্রতিটি উদাহরণ পর্যালোচনা করুন। কোনও প্রদত্ত ব্লকের জন্য নিম্নলিখিত সব শর্ত পূরণ করা হলে, তবেই দুর্বলতাটি উপস্থিত থাকে:
        • rewrite ডাইরেক্টিভ ব্যবহার করা হয়।
        • একই কনফিগারেশন ব্লকের মধ্যে এটি ঠিক পরেই অন্য rewrite, if বা set নির্দেশিকা থাকে।
        • নির্দেশাবলীতে নামহীন PCRE ক্যাপচার গ্রুপ (যেমন, $1, $2, ইত্যাদি) ব্যবহার করা হয়।
        • নির্দেশাবলীর রিপ্লেসমেন্ট স্ট্রিংয়ে প্রশ্নচিহ্ন (?) আছে।
    3. হ্রাস করা (দুর্বল হলে): আপনার কাস্টম কনফিগারেশনের কোনও অংশের জন্য উপরের সব শর্ত সত্য হলে, এগুলি করে হ্রাস করুন:
      • পরিবর্ত স্ট্রিং থেকে প্রশ্নচিহ্ন (?) সরিয়ে দেওয়া।
      • নামহীন ক্যাপচার গ্রুপের পরিবর্তে নামযুক্ত PCRE ক্যাপচার গ্রুপ ব্যবহার করা।
      • চেন করা ডাইরেক্টিভের প্রয়োজনীয়তা আবার মূল্যায়ন করা।
প্রাইভেট ক্লাউডের জন্য Edge 4.53.00 440148595: End of Life Popup Warning Displayed Excessively

প্রাইভেট ক্লাউড 4.53.00 ও এর পরের যেকোনও ভার্সনের Edge-এ, UI একটি "মেয়াদ শেষ" (EOL) সংক্রান্ত সতর্কতা পপ-আপ দেখায়। এই সতর্কতা বারবার
দেখা যায় এবং এর ফ্রিকোয়েন্সি কমানো বা এটি বন্ধ করা যায় না।

এই EOL সতর্কতা বন্ধ করা বা এর ফ্রিকোয়েন্সি কমানোর কোনও পদ্ধতি বর্তমানে ব্যবহারকারীদের জন্য উপলভ্য নেই।

প্রাইভেট ক্লাউডের জন্য Edge 4.53.01 জাভা কলআউট

"BC" নাম ব্যবহার করে Bouncy Castle ক্রিপ্টোগ্রাফি প্রদানকারীকে লোড করার চেষ্টা করা গ্রাহকের Java কলআউট ব্যর্থ হতে পারে কারণ FIPS-কে সমর্থন করার জন্য ডিফল্ট প্রদানকারীকে Bouncy Castle FIPS-এ পরিবর্তন করা হয়েছে। ব্যবহার করার জন্য নতুন পরিষেবা প্রদানকারীর নাম হল "BCFIPS".
প্রাইভেট ক্লাউডের জন্য Edge 4.53.00 জাভা কলআউট

"BC" নাম ব্যবহার করে Bouncy Castle ক্রিপ্টোগ্রাফি প্রদানকারীকে লোড করার চেষ্টা করা গ্রাহকের Java কলআউট ব্যর্থ হতে পারে কারণ FIPS-কে সমর্থন করার জন্য ডিফল্ট প্রদানকারীকে Bouncy Castle FIPS-এ পরিবর্তন করা হয়েছে। ব্যবহার করার জন্য নতুন পরিষেবা প্রদানকারীর নাম হল "BCFIPS".
Edge for Private Cloud 4.52.01 Mint আপডেট

এই সমস্যাটি শুধুমাত্র সেইসব ব্যবহারকারীদের প্রভাবিত করে যারা MINT ব্যবহার করছেন বা ব্যক্তিগত ক্লাউড ইনস্টলেশনের জন্য Edge-এ MINT চালু করেছেন।

প্রভাবিত কম্পোনেন্ট: edge-message-processor

সমস্যা: আপনার মনিটাইজেশন চালু করা থাকলে এবং আপনি 4.52.01 ভার্সন ফ্রেশ ইনস্টল করলে অথবা আগের Private Cloud ভার্সন থেকে আপগ্রেড করলে, মেসেজ প্রসেসর সংক্রান্ত সমস্যার সম্মুখীন হবেন। ওপেন থ্রেডের সংখ্যা ধীরে ধীরে বাড়তে থাকবে, যার ফলে রিসোর্স শেষ হয়ে যাবে। edge-message-processor system.log-এ নিম্নলিখিত ব্যতিক্রম দেখা যায়:

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread
Apigee HTTP/2 সংক্রান্ত দুর্বলতা

HTTP/2 প্রোটোকলের একাধিক প্রয়োগে (CVE-2023-44487) সম্প্রতি একটি পরিষেবা অস্বীকার (DoS) সংক্রান্ত দুর্বলতা খুঁজে পাওয়া গেছে, যার মধ্যে প্রাইভেট ক্লাউডের জন্য Apigee Edge অন্তর্ভুক্ত। এই দুর্বলতার কারণে Apigee API ম্যানেজমেন্ট কার্যকারিতা DoS হতে পারে। আরও বিবরণের জন্য, Apigee Security Bulletin GCP-2023-032 দেখুন।

প্রাইভেট ক্লাউডের জন্য Edge-এর রাউটার ও ম্যানেজমেন্ট সার্ভার কম্পোনেন্ট ইন্টারনেটে এক্সপোজ করা হয় এবং সম্ভাব্য দুর্বল হতে পারে। যদিও Edge for Private Cloud-এর অন্যান্য Edge-নির্দিষ্ট কম্পোনেন্টের ম্যানেজমেন্ট পোর্টে HTTP/2 চালু করা আছে, তবে সেইসব কম্পোনেন্টের কোনওটিই ইন্টারনেটে এক্সপোজ করা হয় না। Cassandra, Zookeeper ও অন্যান্য নন-এজ কম্পোনেন্টে, HTTP/2 চালু করা নেই। প্রাইভেট ক্লাউডের জন্য Edge-এর দুর্বলতা সমাধান করতে আমরা আপনাকে নিম্নলিখিত ধাপগুলি অনুসরণ করার সাজেশন দিই:

আপনি Edge Private Cloud ভার্সন 4.51.00.11 বা এর পরের যেকোনও ভার্সন ব্যবহার করলে, এইসব ধাপ অনুসরণ করুন:

  1. ম্যানেজমেন্ট সার্ভার আপডেট করুন:

    1. প্রতিটি ম্যানেজমেন্ট সার্ভার নোডে, /opt/apigee/customer/application/management-server.properties খুলুন
    2. প্রপার্টি ফাইলে এই লাইনটি যোগ করুন: 
      conf_webserver_http2.enabled=false
    3. ম্যানেজমেন্ট সার্ভার কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-management-server restart

  2. মেসেজ প্রসেসর আপডেট করুন:

    1. প্রতিটি মেসেজ প্রসেসর নোডে, /opt/apigee/customer/application/message-processor.properties খুলুন
    2. প্রপার্টি ফাইলে এই লাইনটি যোগ করুন: 
      conf_webserver_http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-message-processor restart

  3. রাউটার আপডেট করুন:

    1. প্রতিটি রাউটার নোডে, /opt/apigee/customer/application/router.properties খুলুন
    2. প্রপার্টি ফাইলে এই লাইনটি যোগ করুন: 
      conf_webserver_http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-router restart

  4. QPID আপডেট করুন:

    1. প্রতিটি QPID নোডে, /opt/apigee/customer/application/qpid-server.properties খুলুন
    2. প্রপার্টি ফাইলে এই লাইনটি যোগ করুন: 
      conf_webserver_http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-qpid-server restart

  5. Postgres আপডেট করুন:

    1. প্রতিটি Postgres নোডে, /opt/apigee/customer/application/postgres-server.properties খুলুন
    2. প্রপার্টি ফাইলে এই লাইনটি যোগ করুন: 
      conf_webserver_http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-postgres-server restart

আপনি যদি 4.51.00.11-এর চেয়ে পুরনো Private Cloud ভার্সনের জন্য Edge ব্যবহার করেন, তাহলে এইসব ধাপ অনুসরণ করুন:

  1. ম্যানেজমেন্ট সার্ভার আপডেট করুন:

    1. প্রতিটি ম্যানেজমেন্ট সার্ভার নোডে, /opt/apigee/customer/application/management-server.properties খুলুন
    2. প্রপার্টি ফাইলে নিম্নলিখিত দুটি লাইন যোগ করুন: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. ম্যানেজমেন্ট সার্ভার কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-management-server restart

  2. মেসেজ প্রসেসর আপডেট করুন:

    1. প্রতিটি মেসেজ প্রসেসর নোডে, /opt/apigee/customer/application/message-processor.properties খুলুন
    2. প্রপার্টি ফাইলে নিম্নলিখিত দুটি লাইন যোগ করুন: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-message-processor restart

  3. রাউটার আপডেট করুন:

    1. প্রতিটি রাউটার নোডে, /opt/apigee/customer/application/router.properties খুলুন
    2. প্রপার্টি ফাইলে নিম্নলিখিত দুটি লাইন যোগ করুন: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-router restart

  4. QPID আপডেট করুন:

    1. প্রতিটি QPID নোডে, /opt/apigee/customer/application/qpid-server.properties খুলুন
    2. প্রপার্টি ফাইলে নিম্নলিখিত দুটি লাইন যোগ করুন: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-qpid-server restart

  5. Postgres আপডেট করুন:

    1. প্রতিটি Postgres নোডে, /opt/apigee/customer/application/postgres-server.properties খুলুন
    2. প্রপার্টি ফাইলে নিম্নলিখিত দুটি লাইন যোগ করুন: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. মেসেজ প্রসেসর কম্পোনেন্ট রিস্টার্ট করুন: 
      apigee-service edge-postgres-server restart
4.52 ভার্সনে আপডেট করার সময় Postgresql আপগ্রেড

Edge for Private Cloud 4.50 বা 4.51 ভার্সন থেকে 4.52 ভার্সনে আপগ্রেড করার সময় Apigee-postgresql-এ সমস্যা হচ্ছে। টেবিলের সংখ্যা ৫০০-এর বেশি হলে এইসব সমস্যা সাধারণত দেখা দেয়।

আপনি নিচে দেওয়া SQL কোয়েরি চালিয়ে Postgres-এ টেবিলের মোট সংখ্যা চেক করতে পারবেন:

select count(*) from information_schema.tables

সমস্যা সমাধানের বিকল্প: Apigee Edge 4.50.00 বা 4.51.00 থেকে 4.52.00 ভার্সনে আপডেট করার সময়, Apigee-postgresql আপগ্রেড করার আগে প্রাথমিক ধাপ সম্পূর্ণ করতে ভুলবেন না।
LDAP নীতি

149245401: JNDI-এর জন্য কনফিগার করা LDAP কানেকশন পুল সেটিংস LDAP রিসোর্স রিফ্লেক্ট করে না এবং JNDI ডিফল্ট প্রতিবার একবার ব্যবহারযোগ্য কানেকশন তৈরি করে। এর ফলে, কানেকশন খোলা হচ্ছে এবং প্রতিবার একবার ব্যবহারের জন্য বন্ধ করা হচ্ছে, এর ফলে LDAP সার্ভারে প্রতি ঘণ্টায় অসংখ্য কানেকশন তৈরি হচ্ছে।

সমস্যা সমাধানের বিকল্প:

LDAP কানেকশন পুলের প্রপার্টি পরিবর্তন করতে, সব LDAP নীতি জুড়ে গ্লোবাল পরিবর্তন সেট করতে নিম্নলিখিত ধাপগুলি অনুসরণ করুন।

  1. আগে থেকে না থাকলে, একটি কনফিগারেশন প্রপার্টি ফাইল তৈরি করুন: 
    /opt/apigee/customer/application/message-processor.properties
  2. ফাইলে নিম্নলিখিতগুলি যোগ করুন (আপনার LDAP রিসোর্স কনফিগারেশন সংক্রান্ত প্রয়োজনীয়তার উপর ভিত্তি করে Java Naming and Directory Interface (JNDI) প্রপার্টির ভ্যালু পরিবর্তন করুন)। 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. নিশ্চিত করুন যে ফাইলটি /opt/apigee/customer/application/message-processor.properties apigee:apigee-এর মালিকানাধীন।
  4. প্রতিটি মেসেজ প্রসেসর রিস্টার্ট করুন।

আপনার কানেকশন পুল JNDI প্রপার্টি কাজ করছে কিনা তা যাচাই করতে, আপনি সময়ের সাথে সাথে LDAP কানেকশন পুলের আচরণ পর্যবেক্ষণ করতে tcpdump পারফর্ম করতে পারেন।
অনুরোধ প্রসেস করার ক্ষেত্রে বেশি লেটেন্সি

139051927: Message Processor-এ প্রক্সি প্রসেসিংয়ের বেশি লেটেন্সি দেখা গেছে, যা সব API Proxy-কে প্রভাবিত করছে। উপসর্গের মধ্যে রয়েছে, স্বাভাবিকের তুলনায় ২০০-৩০০ মিলি সেকেন্ড বেশি সময় ধরে প্রসেস করা API উত্তর এবং কম TPS থাকলেও এগুলি র্যান্ডম হতে পারে। মেসেজ প্রসেসর কানেকশন তৈরি করে এমন ৫০টির বেশি টার্গেট সার্ভার থাকলে এটি হতে পারে।

মূল কারণ: মেসেজ প্রসেসর একটি ক্যাশে রাখে যা টার্গেট সার্ভারে আউটগোয়িং কানেকশনের জন্য HTTPClient অবজেক্টের সাথে টার্গেট সার্ভার URL ম্যাপ করে। ডিফল্ট হিসেবে এই সেটিং ৫০-এ সেট করা থাকে, যা বেশিরভাগ ডিপ্লয়মেন্টের জন্য খুব কম হতে পারে। কোনও ডিপ্লয়মেন্টে সেট-আপে একাধিক সংস্থা/পরিবেশের কম্বিনেশন থাকলে, এবং মোট ৫০টির বেশি টার্গেট সার্ভার থাকলে, টার্গেট সার্ভার URL ক্যাশে থেকে বার বার সরিয়ে দেওয়া হয়, যার ফলে লেটেন্সি হয়।

যাচাইকরণ: টার্গেট সার্ভার URL সরিয়ে দেওয়ার কারণে লেটেন্সি সংক্রান্ত সমস্যা হচ্ছে কিনা তা নির্ধারণ করতে, "onEvict" বা "Eviction" কীওয়ার্ডের জন্য Message Processor system.logs সার্চ করুন। লগে তাদের উপস্থিতি থেকে বোঝা যায় যে টার্গেট সার্ভার URL HTTPClient ক্যাশে থেকে সরিয়ে দেওয়া হচ্ছে কারণ ক্যাশের সাইজ খুব ছোট।

সমস্যা সমাধানের বিকল্প: প্রাইভেট ক্লাউডের জন্য Edge-এর ভার্সন 19.01 ও 19.06-এর ক্ষেত্রে, আপনি HTTPClient ক্যাশে এডিট ও কনফিগার করতে পারবেন, /opt/apigee/customer/application/message-processor.properties:

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

তারপর মেসেজ প্রসেসর রিস্টার্ট করুন। সব মেসেজ প্রসেসরের জন্য একই পরিবর্তন করুন।

৫০০ হল একটি উদাহরণ। আপনার সেট-আপের জন্য অপ্টিমাল ভ্যালু মেসেজ প্রসেসর কানেক্ট করতে পারে এমন টার্গেট সার্ভারের সংখ্যার চেয়ে বেশি হতে হবে। এই প্রপার্টির মান বেশি সেট করলে কোনও পার্শ্বপ্রতিক্রিয়া হয় না এবং এর একমাত্র প্রভাব হল মেসেজ প্রসেসর প্রক্সি অনুরোধ প্রসেস করার সময় উন্নত হয়।

মনে রাখবেন: Edge for Private Cloud ভার্সন 50.00-এ ডিফল্ট সেটিং হিসেবে ৫০০ আছে।
কী-ভ্যালু ম্যাপের জন্য একাধিক এন্ট্রি

157933959: একই কী ভ্যালু ম্যাপ (KVM) স্কোপে একই সাথে ইনসার্ট ও আপডেট করা হলে, তা সংস্থা বা এনভায়রনমেন্ট লেভেলে অসঙ্গতিপূর্ণ ডেটা ও আপডেট মিস হয়ে যাওয়ার কারণ হয়।

মনে রাখবেন: এই সীমাবদ্ধতা শুধুমাত্র Edge for Private Cloud-এর ক্ষেত্রে প্রযোজ্য। Edge for Public Cloud এবং হাইব্রিড ক্লাউডে এই সীমাবদ্ধতা নেই।

প্রাইভেট ক্লাউডের জন্য Edge-এ ওয়ার্কঅ্যারাউন্ডের জন্য, apiproxy স্কোপে KVM তৈরি করুন।