درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
استقرار نسخههای بازبینی کارگزار نیابتی میانای برنامهسازی کاربردی ازطریق «میانای کاربر Edge» یا «میانای برنامهسازی کاربردی مدیریت» با خطای مهلت زمانی ناموفق است.
پیام های خطا
Click to change deployment status. The revision is deployed and traffic can flow, but flow may be impaired. Error: Call timed out; either server is down or server is not reachable
علل احتمالی
دلایل معمول این مشکل عبارتاند از:
| علت | جزئیات | برای |
| مشکل اتصالپذیری شبکه | خرابی ارتباط بین «سرور مدیریت» و «پردازشگر پیام» بهدلیل مشکلات اتصالپذیری شبکه یا قوانین دیوار آتش. | فقط کاربران «فضای ابری خصوصی» |
| بسته پراکسی API بزرگ | اگر بسته پراکسی API ازنظر اندازه بزرگ باشد، ممکن است فعالسازی «پردازشگر پیام» زمان زیادی طول بکشد و منجر به اتمام زمان RPC شود. | کاربران فضای ابری خصوصی و عمومی |
مشکل اتصالپذیری شبکه
توجه: فقط کاربران «ابر خصوصی Edge» میتوانند مراحل زیر را انجام دهند. اگر در Edge Public Cloud هستید، با پشتیبانی Apigee Edge تماس بگیرید.
تشخیص
- بااستفاده از فراخوانی مدیریت API زیر، وضعیت استقرار را برای میانای برنامهسازی کاربردی خاصی که خطا را نشان میدهد دریافت کنید:
curl -v http://<management-server-IPaddress>:<port#>/organizations/<orgname>/environments/<envname>/apis/<apiname>/deployments -u <username>
برونداد نمونه که خطا را نشان میدهد:
{ "error": "Call timed out; either server is down or server is not reachable", "status": "error", "type": [ "message-processor" ], "uUID": "ebbc1078-cbde-4a00-a7db-66a3c1b2b748" }, { "status": "deployed", "type": [ "message-processor" ], "uUID": "204e2b7e-52f7-46d9-b458-20f9bfb51e6d" }, { "status": "deployed", "type": [ "router" ], "uUID": "967e63c6-ee95-47c0-9608-f4a32638fb1e" }, { "status": "deployed", "type": [ "router" ], "state" : "error" }
برونداد نمونه بالا نشان میدهد که خطا در یکی از «پردازندههای پیام» با شناسه UUID «
ebbc1078-cbde-4a00-a7db-66a3c1b2b748» رخ داده است. - براساس برونداد وضعیت استقرار برای پراکسی API، با شناسه UUID مربوطه که خطا را نشان داده است به هریک از «پردازشگرهای پیام» وارد شوید و مراحل زیر را انجام دهید:
- بررسی کنید که آیا «پردازشگر پیام» در درگاه ۴۵۲۸ گوش میدهد:
netstat -an | grep LISTEN | grep 4528
اگر «پردازشگر پیام» در درگاه ۴۵۲۸ گوش نمیدهد، «پردازشگر پیام» را بازراهاندازی کنید: Processor:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- بااستفاده از فراخوانی میانای برنامهسازی کاربردی مدیریت که در مرحله ۱ بالا نشان داده شده است، وضعیت استقرار کارگزار نیابتی میانای برنامهسازی کاربردی را دوباره بررسی کنید. اگر خطایی وجود نداشته باشد، این نشان میدهد که مشکل برطرف شده است.
- بررسی کنید که آیا «پردازشگر پیام» در درگاه ۴۵۲۸ گوش میدهد:
- اگر مشکل ادامه داشت، اتصالپذیری از «سرور مدیریت» به «پردازشگر پیام» در درگاه ۴۵۲۸ را بااستفاده از مراحل زیر آزمایش کنید:
- اگر telnet دردسترس است، از telnet استفاده کنید:
telnet <MessageProcessor_IP> 4528
- اگر telnet دردسترس نیست، از netcat برای بررسی اتصالپذیری به این روش استفاده کنید:
nc -vz <MessageProcessor_IP> 4528
- اگر پاسخ «اتصال رد شد» یا «اتصال منقضی شد» دریافت کردید، با تیم عملیات شبکه خود تماس بگیرید.
- اگر telnet دردسترس است، از telnet استفاده کنید:
- اتصالپذیری از «پردازشگر پیام» به «سرور مدیریت» در درگاه ۴۵۲۶ را
بااستفاده از مراحل زیر آزمایش کنید:
- اگر telnet دردسترس است، از telnet استفاده کنید:
telnet <management-server-IP> 4526
- اگر telnet دردسترس نیست، از netcat برای بررسی اتصالپذیری به این روش استفاده کنید:
nc -vz <management-server-IP> 4526
- اگر پاسخ «اتصال رد شد» یا «اتصال زمانبندیشده قطع شد» دریافت کردید، با تیم عملیات شبکه خودتان تماس بگیرید.
- اگر telnet دردسترس است، از telnet استفاده کنید:
- با تیم عملیات شبکه خود همکاری کنید و موارد زیر را انجام دهید:
- مطمئن شوید پروتکل RPC در هر دو «سرور مدیریت» و «پردازنده پیام» مجاز باشد.
- هرگونه محدودیت دیوار آتش یا قوانین امنیتی را که بین «سرورهای مدیریت» و «پردازشگرهای پیام» راهاندازی شده است بردارید تا امکان اتصال به درگاه ۴۵۲۶ در سرور مدیریت و اتصال از «سرور مدیریت» به «پردازشگرهای پیام» در درگاه ۴۵۲۸ فراهم شود.
- وضعیت استقرار را دوباره بررسی کنید (به مرحله ۱ در بالا مراجعه کنید). اگر هیچ خطایی نمیبینید، این نشان میدهد که خطا برطرف شده است.
- اگر مشکل ادامه داشت، بررسی کنید که آیا «پردازشگر پیام» مشکل شبکه دارد یا نه. اگر
مشکل شبکه وجود دارد، بازراهاندازی «پردازنده پیام» خاصی که خطای پایان یافتن مهلت زمانی را نشان میدهد (طبق
برونداد وضعیت استقرار) ممکن است مشکل را برطرف کند:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- اگر مشکل همچنان ادامه داشت، گزارشهای «سرور مدیریت» را در اینجا بررسی کنید:
(
/opt/apigee/var/log/edge-management-server/logs/system.log).خطای اتمام مهلت زمانی «تماس نمونه» از «گزارش سرور مدیریت»
2016-05-17 09:29:56,448 org:myorg env:prod qtp281969267-360792 ERROR DISTRIBUTION - RemoteServicesConfigEventHandler.configureServers() : exception for server with uuid e1381db7-d83b-4752-ae04-2de33f07e555 : cause = RPC Error 504: Call timed out communication error = true com.apigee.rpc.RPCException: Call timed out at com.apigee.rpc.impl.AbstractCallerImpl.handleTimeout(AbstractCallerImpl.java:64) ~[rpc-1.0.0.jar:na] at com.apigee.rpc.impl.RPCMachineImpl$OutgoingCall.handleTimeout(RPCMachineImpl.java:483) ~[rpc-1.0.0.jar:na] at com.apigee.rpc.impl.RPCMachineImpl$OutgoingCall.access$000(RPCMachineImpl.java:402) ~[rpc-1.0.0.jar:na] at com.apigee.rpc.impl.RPCMachineImpl$OutgoingCall$1.run(RPCMachineImpl.java:437) ~[rpc-1.0.0.jar:na] at io.netty.util.HashedWheelTimer$HashedWheelTimeout.expire(HashedWheelTimer.java:532) ~[netty-all-4.0.0.CR1.jar:na] at io.netty.util.HashedWheelTimer$Worker.notifyExpiredTimeouts(HashedWheelTimer.java:430) ~[netty-all-4.0.0.CR1.jar:na] at io.netty.util.HashedWheelTimer$Worker.run(HashedWheelTimer.java:371) ~[netty-all-4.0.0.CR1.jar:na] at java.lang.Thread.run(Thread.java:745) ~[na:1.7.0_79]
اگر خطایی مشابه آنچه در مثال بالا نشان داده شده است مشاهده کردید، مهلت زمانی RPC را در «سرور مدیریت» افزایش دهید تا اگر شبکه کند شد، به «سرور مدیریت» فرصت کافی برای اتصال به «پردازشگر پیام» داده شود.
وضوح
توجه: فقط کاربران «ابر خصوصی Edge» میتوانند مراحل زیر را انجام دهند. اگر در Edge Public Cloud هستید، با پشتیبانی Apigee Edge تماس بگیرید.
- برای افزایش مهلت زمانی RPC، مراحل زیر را انجام دهید:
- اگر فایل ازقبل وجود ندارد، آن را در
/opt/apigee/customer/application/management-server.propertiesماشین «سرور مدیریت» ایجاد کنید. - خط زیر را به این فایل اضافه کنید:
conf_cluster_rpc.connect.timeout=<time in seconds>
مقدار پیشفرض مهلت زمانی RPC برابر با ۱۰ است و توصیه میشود آن را به ۴۰ ثانیه افزایش دهید. آن را بهصورت زیر تنظیم کنید:
conf_cluster_rpc.connect.timeout=40
- مطمئن شوید که این فایل متعلق به apigee است:
chown apigee:apigee /opt/apigee/customer/application/management-server.properties
- بازراهاندازی سرور مدیریت:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- اگر بیشاز یک «سرور مدیریت» دارید، مراحل بالا را در همه «سرورهای مدیریت» تکرار کنید.
- پراکسی API را در «میانای کاربر Edge» یا بااستفاده از فراخوانی «میانای برنامهسازی کاربردی مدیریت Edge» مستقر کنید. اگر پراکسی API بدون هیچ مشکلی پیادهسازی شود، این نشان میدهد که مشکل برطرف شده است.
- اگر فایل ازقبل وجود ندارد، آن را در
- اگر مشکل ادامه داشت، فرمان
tcpdump را از «سرور مدیریت» و «پردازشگر پیام» جمعآوری کنید. فرمان tcpdump را در هریک از سرورها فعال کنید و سپس استقرار «پراکسی میانای برنامهسازی کاربردی» را از «واسط کاربر» یا بااستفاده از «میانای برنامهسازی کاربردی مدیریت» آغاز کنید:
- فرمان tcpdump زیر را از «سرور مدیریت» اجرا کنید:
tcpdump -i any -s 0 host <message-processor-IP address> -w <File name>
- فرمان tcpdump زیر را از «پردازشگر پیام» اجرا کنید:
tcpdump -i any -s 0 host <management-server-IP address> -w <File name>
- برای دریافت کمک در زمینه تجزیهوتحلیل tcpdump و عیبیابی بیشتر مشکل، با پشتیبانی Apigee Edge تماس بگیرید.
- فرمان tcpdump زیر را از «سرور مدیریت» اجرا کنید:
بزرگ دسته پراکسی API
تشخیص
- اندازه بسته پراکسی API را که خطای استقرار برای آن مشاهده میشود بررسی کنید.
- اگر اندازه بهطور معقولی بزرگ باشد (۱۰ مگابایت یا بیشتر)، دراینصورت بسیار محتمل است که «پردازنده پیام» برای فعال کردن پراکسی میانای برنامه کاربردی به زمان بیشتری نیاز داشته باشد.
- اگر اندازه بسته «پراکسی API» بیشتر از ۱۵ مگابایت است، به بسته «پراکسی API» بزرگتر از ۱۵ مگابایت بروید.
وضوح
توجه: فقط کاربران «ابر خصوصی Edge» میتوانند مراحل زیر را انجام دهند. اگر در Edge Public Cloud هستید، با پشتیبانی Apigee Edge تماس بگیرید.
زمان اتمام RPC را در «سرور مدیریت» افزایش دهید تا «پردازشگر پیام» زمان کافی برای فعال کردن دستههای پراکسی API بزرگ داشته باشد. برای افزایش مقدار مهلت زمانی RPC، مراحل زیر را انجام دهید:
- اگر فایل
/opt/apigee/customer/application/management-server.propertiesازقبل وجود ندارد، آن را در ماشین «سرور مدیریت» ایجاد کنید. - خط زیر را به این فایل اضافه کنید:
conf_cluster_rpc.connect.timeout=<time in seconds>
مقدار پیشفرض مهلت زمانی RPC برابر با ۱۰ است و توصیه میشود آن را به ۴۰ ثانیه افزایش دهید. آن را بهصورت زیر تنظیم کنید:
conf_cluster_rpc.connect.timeout=40
- مطمئن شوید که این فایل متعلق به apigee است:
chown apigee:apigee /opt/apigee/customer/application/management-server.properties
- بازراهاندازی سرور مدیریت:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- اگر بیشاز یک «سرور مدیریت» دارید، مراحل بالا را در همه «سرورهای مدیریت» تکرار کنید.
اگر مشکل برطرف نشد، برای دریافت راهنمایی بیشتر با پشتیبانی Apigee Edge تماس بگیرید.