wiki:GENIRacksHome/OpenGENIRacks/AdministrationTools

Version 1 (modified by Jeanne Ohren, 5 years ago) (diff)

--

HealthCheck

The healthcheck.py script must be run in a root shell as it requires admin privileges for several operations. To use this tool, run the following commands from the control node:

cd /home/gram/gram/src/gram/am/gram
sudo bash
source /etc/novarc
export PYTHONPATH=$PYTHONPATH:/home/gram/gram/src
python healthcheck.py

Healthcheck performs various checks including:

  • Checking the state of the GRAM services
  • Checking the state of the OpenStack services
  • Checking if the management namespace exists and is properly configured
  • Checking that the compute hosts are reachable
  • Checking that the AM in functioning by doing Allocate-Provision-Delete

If it detects errors, it prints out warnings and attempts to fix them.

Occasionally, after restart, there is an issue with OpenStack where the management namespace is not instantiated. In this case, healthcheck will attempt to recover the namespace by restarting the Quantum-L3 agent up to 10 times. If this does not work, as a last resort, the admin can tear down the recreate the management and public networks. Healthcheck will prompt to recreate the network.

  • Before recreating the networks, the old ones must be removed.

The simplest method is to use the Horizon browser interface to delete the routers and networks. Then use healthcheck to recreate these components.