Google is committed to advancing racial equity for Black communities. See how.

Unable to start Edge components

These topics explain how to troubleshoot issues encountered while starting Apigee Edge components such as Router, Message Processor, Management Server, and ZooKeeper.

Unable to start Router

You may observe the following error when trying to start the Router:

Error message

apigee-service: edge-router: Not running (DEAD)
apigee-all: Error: status failed on [edge-router]

Diagnostic information

If you need assistance from Apigee Support on this issue, then gather the following diagnostic information and share it in the support case:

Diagnostic information Where can I gather this information? How do I gather this information?
Router logs Router
tar cvzf /tmp/router_logs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/logs/system.log /opt/apigee/var/log/edge-router/logs/startupruntimeerror.log /opt/apigee/var/log/edge-router/logs/configurations.log

Unable to start Message Processor

You may observe the following error when trying to start the Message Processor:

Error message

apigee-service: edge-message-processor: Not running (DEAD)
apigee-all: Error: status failed on [edge-message-processor]

Diagnostic information

If you need assistance from Apigee Support on this issue, then gather the following diagnostic information and share it in the support case:

Diagnostic information Where can I gather this information? How do I gather this information?
Message Processor logs Message Processor
tar cvzf /tmp/rmp_logs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system* /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerror.log /opt/apigee/var/log/edge-message-processor/logs/configurations.log

Unable to start Management Server

You may observe the following error when trying to start the Management Server:

Error message

apigee-service: edge-management-server: Not running (DEAD)
apigee-all: Error: status failed on [edge-management-server]

Diagnostic information

If you need assistance from Apigee Support on this issue, then gather the following diagnostic information and share it in the support case:

Diagnostic information Where can I gather this information? How do I gather this information?
Management Server logs Management Server
tar cvzf /tmp/ms_logs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-management-server/logs/system* /opt/apigee/var/log/edge-management-server/logs/startupruntimeerror.log

Unable to start ZooKeeper

Playbooks

This section provides information and guidance on some specific procedures that can be followed for troubleshooting and resolving issues with starting ZooKeeper servers.

Problem Error message or description Playbook
Unable to start ZooKeeper apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] Unable to start ZooKeeper

Diagnostic information

If you need assistance from Apigee Support on this issue, then gather the following diagnostic information and share it in the support case:

Diagnostic information Where can I gather this information? How do I gather this information?
ZooKeeper logs and associated files ZooKeeper
tar cvzf /tmp/zookeeper_logs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/apigee-zookeeper/*.log opt/apigee/apigee-zookeeper/conf/zoo.cfg /opt/apigee/data/apigee-zookeeper/data/myid

Netstat output ZooKeeper
netstat -anlp | grep 2181  | tee /tmp/zookeeper_netstat_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt

Compress all the diagnostic data ZooKeeper
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/zookeeper_*