আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
লক্ষণ
Edge UI অথবা Edge ম্যানেজমেন্ট API কলের মাধ্যমে API প্রক্সি রিভিশনগুলো ডেপ্লয় করার সময় " Unexpected error occurred while processing the updates " এই এররটি দেখা দেয়।
ত্রুটির বার্তা
Error in deployment for environment sit.
The revision is deployed and traffic can flow, but flow may be impared. com.apigee.kernel.exceptions.spi.UncheckedException{ code = messaging.runtime.UpdateFailed, message = Unexpected error occurred while processing the updates, associated contexts = []}সম্ভাব্য কারণসমূহ
এই ত্রুটির বিভিন্ন কারণ থাকতে পারে। নিচে কয়েকটি নমুনা কারণ দেওয়া হলো:
| কারণ | বিস্তারিত | জন্য |
| স্মৃতির বাইরে | মেসেজ প্রসেসরের জাভা হিপ স্পেস শেষ হয়ে যাওয়ায় এপিআই প্রক্সি ডেপ্লয়মেন্ট ব্যর্থ হয়েছে। | প্রাইভেট ক্লাউড ব্যবহারকারীরা |
| এপিআই প্রক্সি বান্ডেলে ত্রুটি | এপিআই প্রক্সি বান্ডেলে এমন ত্রুটি রয়েছে যা এপিআই প্রক্সি ডেপ্লয়মেন্ট ব্যর্থ হওয়ার কারণ হতে পারে। | ব্যক্তিগত এবং পাবলিক ক্লাউড ব্যবহারকারীরা |
প্রথমে চেষ্টা করার সাধারণ পদক্ষেপগুলো
-
/opt/apigee/var/log/apigee/edge-message-processor/logs/system.logএ মেসেজ প্রসেসর লগে কোনো ডেপ্লয়মেন্ট ত্রুটি বা এক্সেপশন স্ট্যাক ট্রেস আছে কিনা তা পরীক্ষা করুন। - আপনি সাধারণত একটি স্ট্যাক ট্রেস দেখতে পান, যা ডিপ্লয়মেন্ট ত্রুটির কারণ সম্পর্কে তথ্য প্রদান করে। কারণটি বোঝার জন্য অনুগ্রহ করে স্ট্যাক ট্রেসটি ভালোভাবে পড়ুন।
স্মৃতির বাইরে
রোগ নির্ণয়
দ্রষ্টব্য: শুধুমাত্র এজ প্রাইভেট ক্লাউড ব্যবহারকারীরাই নিম্নলিখিত ধাপগুলো সম্পন্ন করতে পারবেন। আপনি যদি এজ পাবলিক ক্লাউড ব্যবহার করেন, তাহলে Apigee সাপোর্টের সাথে যোগাযোগ করুন।
- আপনি
/opt/apigee/var/log/apigee/edge-message-processor/logs/system.logএ নিচের চিত্রে দেখানো ব্যতিক্রমটির মতো একটি ব্যতিক্রম দেখতে পারেন:Apigee-Main-4 ERROR BOOTSTRAP - RuntimeConfigurationServiceImpl.dispatchToListeners() : RuntimeConfigurationServiceImpl.dispatchToListeners : Error occurred while dispatching the request DeployEvent{organization=‘myorg', application='person-credentials-api', applicationRevision='275', deploymentSpec=basepath=/;env=dev;, deploymentID=null} to com.apigee.application.bootstrap.listeners.MessageProcessorBootstrapListener@5db88cb8 com.apigee.kernel.exceptions.spi.UncheckedException: Unexpected error occurred while processing the updates at com.apigee.entities.AbstractConfigurator.throwUncheckedException(AbstractConfigurator.java:280) ~[config-entities-1.0.0.jar:na] at com.apigee.messaging.configuration.MessageProcessorServiceImpl.configure(MessageProcessorServiceImpl.java:665) ~[message-processor-1.0.0.jar:na] at com.apigee.application.bootstrap.listeners.MessageProcessorBootstrapListener.configureMessageProcessorService(MessageProcessorBootstrapListener.java:54) ~[application-bootstrap-1.0.0.jar:na] at com.apigee.application.bootstrap.listeners.MessageProcessorBootstrapListener.deploy(MessageProcessorBootstrapListener.java:29) ~[application-bootstrap-1.0.0.jar:na] …<snipped> at com.apigee.application.bootstrap.proto.RuntimeConfig_ConfigRPCService_BlockingSkeleton$1.run(RuntimeConfig_ConfigRPCService_BlockingSkeleton.java:38) [application-bootstrap-1.0.0.jar:na] at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:471) [na:1.7.0_75] at java.util.concurrent.FutureTask.run(FutureTask.java:262) [na:1.7.0_75] at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145) [na:1.7.0_75] at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [na:1.7.0_75] at java.lang.Thread.run(Thread.java:745) [na:1.7.0_75] Caused by: java.lang.OutOfMemoryError: Java heap space
- "Caused by: java.lang.OutofMemoryError: Java Heap space" বার্তাটি নির্দেশ করে যে মেসেজ প্রসেসরের জাভা হিপ স্পেস শেষ হয়ে গেছে।
সমাধান
দ্রষ্টব্য: শুধুমাত্র এজ প্রাইভেট ক্লাউড ব্যবহারকারীরাই নিম্নলিখিত ধাপগুলো সম্পন্ন করতে পারবেন। আপনি যদি এজ পাবলিক ক্লাউড ব্যবহার করেন, তাহলে Apigee সাপোর্টের সাথে যোগাযোগ করুন।
মেসেজ প্রসেসরগুলিতে সর্বোচ্চ জাভা হিপ স্পেস বৃদ্ধি করুন।
সর্বোচ্চ জাভা হিপ স্পেস JVM প্রপার্টি -Xmx দ্বারা নিয়ন্ত্রিত হয়। মেসেজ প্রসেসরগুলিতে জাভা হিপ স্পেস বাড়ানোর ধাপগুলি নিচে দেওয়া হলো:
- জাভা হিপ স্পেস কী পরিমাণ মেমরি বাড়ানো যেতে পারে তা নির্ণয় করুন:
-
/opt/apigee/edge-message-processor/bin/setenv.shফাইলে সর্বোচ্চ হিপ স্পেস (max_mem)-এর জন্য সেট করা বর্তমান মান পরীক্ষা করুন। - সিস্টেমে /proc/meminfo কমান্ড ব্যবহার করে MemTotal (মোট ব্যবহারযোগ্য র্যামের পরিমাণ) এবং MemFree (সিস্টেমে অব্যবহৃত ফিজিক্যাল র্যামের পরিমাণ) জানুন।
- নিশ্চিত করুন যে উপরের তথ্যে একই সিস্টেমে বিদ্যমান এজ রাউটার ইত্যাদির মতো অন্য যেকোনো প্রসেস দ্বারা ব্যবহৃত মেমরি অন্তর্ভুক্ত রয়েছে।
- উপরোক্ত তথ্যের ভিত্তিতে, মেসেজ প্রসেসরের জন্য জাভা হিপ স্পেস কী পরিমাণ বাড়ানো যেতে পারে তা নির্ণয় করুন।
- উদাহরণস্বরূপ, যদি মেসেজ প্রসেসরের বর্তমান সর্বোচ্চ হিপ স্পেস ১০২৪ মেগাবাইট, মোট মেমরি ৮ জিবি (৮১৯২ মেগাবাইট) এবং খালি মেমরি ৫ জিবি (৫১২০ মেগাবাইট) হয়, তাহলে আপনি সর্বোচ্চ জাভা হিপ স্পেস বাড়িয়ে ৩ জিবি (৩০৭২ মেগাবাইট) করতে পারবেন।
- জাভা হিপ স্পেস কী পরিমাণে বাড়াতে হবে তা নির্ধারণে সহায়তার প্রয়োজন হলে, Apigee Support-এর সাথে যোগাযোগ করুন।
-
- নিম্নলিখিত ফাইলটি তৈরি করুন, যদি এটি আগে থেকে বিদ্যমান না থাকে:
/opt/apigee/customer/application/message-processor.properties
- ফাইলটিতে বর্ধিত হিপ সেটিং (যেমন, 3072M) সহ নিম্নলিখিত লাইনটি যোগ করুন:
bin_setenv_max_mem=3072m
- ফাইলটি সংরক্ষণ করুন।
- মেসেজ প্রসেসরটি পুনরায় চালু করুন:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- আপনার যদি একাধিক মেসেজ প্রসেসর থাকে, তাহলে সমস্ত মেসেজ প্রসেসরের ক্ষেত্রে ৩ থেকে ৬ নম্বর ধাপগুলো পুনরাবৃত্তি করুন।
যদি সমস্যাটি অব্যাহত থাকে, তাহলে Apigee Support-এর সাথে যোগাযোগ করুন .
এপিআই প্রক্সি বান্ডেলে ত্রুটি
এপিআই প্রক্সিতে ব্যবহৃত কোনো পলিসিতে ত্রুটি থাকলে, " Unexpected error occurred while processing the updates " এই ত্রুটি সহ ডেপ্লয়মেন্টটি ব্যর্থ হবে।
উদাহরণস্বরূপ, এই কমিউনিটি পোস্টটি দেখুন।
রোগ নির্ণয়
দ্রষ্টব্য: শুধুমাত্র এজ প্রাইভেট ক্লাউড ব্যবহারকারীরাই নিম্নলিখিত ধাপগুলো সম্পন্ন করতে পারবেন। আপনি যদি এজ পাবলিক ক্লাউড ব্যবহার করেন, তাহলে Apigee সাপোর্টের সাথে যোগাযোগ করুন।
- এপিআই প্রক্সি ডেপ্লয়মেন্ট সম্পর্কিত এক্সেপশন বা এররের জন্য মেসেজ প্রসেসর লগ চেক করুন। সমস্যাটির সমাধানের জন্য এপিআই প্রক্সি বান্ডেলে কী পরিবর্তন করতে হবে, সে সম্পর্কে এররটি আপনাকে তথ্য দেবে।
- যদি মেসেজ প্রসেসর লগ-এ কোনো ত্রুটির বার্তা না দেখা যায়, তাহলে এপিআই প্রক্সির রিভিশন হিস্ট্রিতে থাকা ডিফারেন্সগুলো পরীক্ষা করুন। যদি পুরোনো রিভিশনগুলো কোনো সমস্যা ছাড়াই ডেপ্লয় হয়, তাহলে কী কোড পরিবর্তন করা হয়েছিল তা পর্যালোচনা করুন।
সমাধান
- সমস্যাটির সমাধানের জন্য এপিআই প্রক্সি বান্ডেলে প্রয়োজনীয় পরিবর্তন করুন।
- এপিআই প্রক্সিতে করা কোডের যে পরিবর্তনগুলো ডেপ্লয়মেন্টের জন্য সমস্যা তৈরি করেছিল, সেগুলো পূর্বাবস্থায় ফিরিয়ে আনুন।
যদি সমস্যাটি অব্যাহত থাকে, তাহলে আরও সহায়তার জন্য Apigee Support-এর সাথে যোগাযোগ করুন।