Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

Info

The steps outlined below should not be done as a routine maintenance or upgrade procedure. These are intended for cases when Kafka Service fails to start or form a Kafka cluster and requests in MC2 and/or EQL/EDS are not being processed.

The following symptoms could be indicating of a problem with Kafka Service configuration, requiring a cleanup of Kafka Service logs:

  • The mc2/health REST endpoint shows the Kafka service as down

  • The Technical Certification fails to complete. See MC2 Installation Certification

  • There are EJM processes or EDS requests stuck in progress. The MC Console Message Detail Status screen or logs/starweb/eaglemc2s/extractservice/*extractservice* or logs/starweb/pyruleservice/*mcpy_exec* have errors similar to:

Code Block
Topic REGION.TOPICNAME not present in metadata after 60000 ms.

or:

Code Block
languagenone
Failed sending the request to Kafka for python rule execution. 
Topic REGION.eagle.eds.requests.v2 not present in metadata after 60000 ms.

Even in this case, before proceeding with log removal, check that Kafka Services is started on ALL servers on the region on which MC2 is running.

The steps for cleaning the logs are to be followed exactly. Cleaning the Kafka Service logs and configuration will result in loss of all messages and data which are in flight and currently processing in MC2.

To clean the Kafka Service logs and configuration follow these steps:

  1. Stop MC2 and kafka service on all nodes on which MC2 is running:

cd eaglemgr

./stop starweb extractservicelb extractserviceworker kafkaservice

2. Only after the services are stopped on ALL nodes, remove the kafka configuration and logs:

...

NOTE: Do not start kafka service on any of the nodes before the above steps are completed on ALL nodes.

3. Start Kafka Service on all nodes:

cd eaglemgr

./start starweb kafkaservice

...