अपडेट प्रोसेस करने में गड़बड़ी हुई

Apigee Edge से जुड़े दस्तावेज़ देखे जा रहे हैं.
Apigee X से जुड़े दस्तावेज़ पर जाएं. info

समस्या का ब्यौरा

Edge यूज़र इंटरफ़ेस (यूआई) या Edge मैनेजमेंट एपीआई कॉल के ज़रिए, एपीआई प्रॉक्सी के बदलावों को डिप्लॉय करने में गड़बड़ी होती है. साथ ही, यह मैसेज दिखता है: "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 = []}

ये वजहें हो सकती हैं

इस गड़बड़ी की कई वजहें हो सकती हैं. यहां कुछ संभावित वजहें दी गई हैं:

सबसे पहले आज़माए जाने वाले सामान्य चरण

1. देखें कि मैसेज प्रोसेसर लॉग /opt/apigee/var/log/apigee/edge-message-processor/logs/system.log में, डिप्लॉयमेंट से जुड़ी कोई गड़बड़ी या अपवाद स्टैक ट्रेस तो नहीं है.
2. आम तौर पर, आपको स्टैक ट्रेस दिखता है. इससे डिप्लॉयमेंट में होने वाली गड़बड़ी की वजह के बारे में जानकारी मिलती है. वजह जानने के लिए, कृपया स्टैक ट्रेस को ध्यान से पढ़ें.

आउट ऑफ़ मेमोरी

संक्रमण की जांच

ध्यान दें: सिर्फ़ Edge Private Cloud के उपयोगकर्ता ही यह तरीका अपना सकते हैं. अगर आप Edge Public Cloud का इस्तेमाल कर रहे हैं, तो Apigee की सहायता टीम से संपर्क करें.

1. आपको मैसेज प्रोसेसर लॉग /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

2. Caused by: java.lang.OutofMemoryError: Java Heap space मैसेज से पता चलता है कि मैसेज प्रोसेसर में Java Heap स्पेस खत्म हो गया है.

रिज़ॉल्यूशन

ध्यान दें: सिर्फ़ Edge Private Cloud के उपयोगकर्ता ही यह तरीका अपना सकते हैं. अगर आप Edge Public Cloud का इस्तेमाल कर रहे हैं, तो Apigee की सहायता टीम से संपर्क करें.

मैसेज प्रोसेसर पर, ज़्यादा से ज़्यादा Java Heap स्पेस बढ़ाएं.

ज़्यादा से ज़्यादा Java Heap स्पेस को JVM प्रॉपर्टी -Xmx कंट्रोल करती है. मैसेज प्रोसेसर पर Java Heap स्पेस बढ़ाने के लिए, यह तरीका अपनाएं:

1. तय करें कि Java Heap स्पेस को कितनी मेमोरी से बढ़ाया जा सकता है:
   1. फ़ाइल /opt/apigee/edge-message-processor/bin/setenv.sh में, ज़्यादा से ज़्यादा Heap स्पेस, max_mem के लिए सेट की गई मौजूदा वैल्यू देखें
   2. सिस्टम पर /proc/meminfo कमांड का इस्तेमाल करके, MemTotal (इस्तेमाल की जा सकने वाली कुल रैम), MemFree (सिस्टम पर इस्तेमाल न की गई फ़िज़िकल रैम) की जानकारी पाएं.
      1. पक्का करें कि ऊपर दी गई जानकारी में, उसी सिस्टम पर मौजूद अन्य प्रोसेस (जैसे, Edge Router वगैरह) से इस्तेमाल की गई मेमोरी शामिल हो.
      2. ऊपर दी गई जानकारी के आधार पर, तय करें कि मैसेज प्रोसेसर के लिए Java Heap स्पेस को कितना बढ़ाया जा सकता है.
      3. उदाहरण के लिए, मैसेज प्रोसेसर पर मौजूदा ज़्यादा से ज़्यादा Heap स्पेस 1024 एमबी है, MemTotal 8 जीबी (8192 एमबी) है, और MemFree 5 जीबी (5120 एमबी) है. ऐसे में, ज़्यादा से ज़्यादा Java Heap स्पेस को 3 जीबी (3072 एमबी) तक बढ़ाया जा सकता है.
      4. अगर Java Heap स्पेस को कितना बढ़ाना है, यह तय करने में मदद चाहिए, तो Apigee की सहायता टीम से संपर्क करें.
2. अगर यह फ़ाइल पहले से मौजूद नहीं है, तो इसे बनाएं:

   /opt/apigee/customer/application/message-processor.properties

3. फ़ाइल में यह लाइन जोड़ें. इसमें, बढ़ा हुआ Heap सेटिंग (उदाहरण के लिए, 3072M) शामिल करें:

   bin_setenv_max_mem=3072m

4. फ़ाइल सेव करें.
5. मैसेज प्रोसेसर को रीस्टार्ट करें:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

6. अगर आपके पास एक से ज़्यादा मैसेज प्रोसेसर हैं, तो सभी मैसेज प्रोसेसर पर तीसरे से छठे चरण दोहराएं.

अगर समस्या बनी रहती है, तो Apigee सहायता टीम से संपर्क करें.

एपीआई प्रॉक्सी बंडल में गड़बड़ी

अगर एपीआई प्रॉक्सी में इस्तेमाल की गई किसी भी नीति में गड़बड़ियां हैं, तो डिप्लॉयमेंट में गड़बड़ी होगी. साथ ही, यह मैसेज दिखेगा: "Unexpected error occurred while processing the updates".

उदाहरण के लिए, यह कम्यूनिटी पोस्ट देखें.

संक्रमण की जांच

ध्यान दें: सिर्फ़ Edge Private Cloud के उपयोगकर्ता ही यह तरीका अपना सकते हैं. अगर आप Edge Public Cloud का इस्तेमाल कर रहे हैं, तो Apigee की सहायता टीम से संपर्क करें.

1. एपीआई प्रॉक्सी के डिप्लॉयमेंट से जुड़े अपवादों या गड़बड़ियों के लिए, मैसेज प्रोसेसर लॉग देखें. गड़बड़ी से आपको यह जानकारी मिलनी चाहिए कि समस्या को हल करने के लिए, एपीआई प्रॉक्सी बंडल में क्या बदलाव किए जाने चाहिए.
2. अगर मैसेज प्रोसेसर लॉग में गड़बड़ी के मैसेज नहीं दिखते हैं, तो एपीआई प्रॉक्सी के बदलाव के इतिहास में अंतर देखें. अगर पुराने बदलावों को बिना किसी समस्या के डिप्लॉय किया जाता है, तो देखें कि कोड में क्या बदलाव किए गए थे.

रिज़ॉल्यूशन

1. समस्या को हल करने के लिए, एपीआई प्रॉक्सी बंडल में ज़रूरी बदलाव करें.
2. एपीआई प्रॉक्सी में किए गए उन कोड बदलावों को वापस लाएं जिनकी वजह से डिप्लॉयमेंट में समस्या आ रही थी.

अगर समस्या बनी रहती है, तो ज़्यादा मदद पाने के लिए Apigee की सहायता टीम से संपर्क करें.