nanny Overview for MariaDB Xpand

Overview

nanny ensures that all jobs needed for the successful function of Xpand are running.

  • The nanny process is launched automatically by the system init process.

  • The set of jobs to be run by nanny is initially configured via /opt/clustrix/etc/nanny.conf

  • All jobs for which nanny is responsible are designed to run indefinitely.

  • If any of nanny's monitored jobs stop for any reason, nanny will immediately attempt to restart it.

  • nanny allows stopping and starting of the jobs it controls via the clx utility or the nanny port (2424).

Jobs Controlled by nanny

The following jobs are kept running by nanny:

Job Name

Description

krobix

Main Xpand process.

  • Located at /opt/clustrix/bin/clxnode

  • Logs to /data/clustrix/log/clustrix.log (location configurable)

Activates:

  • control port (2048)

  • mysql port (3306)

  • health mon port (3581)

statd

Xpand Statistics Collection Script: Regularly collects and aggregates statistics for the UI or other management interfaces. For additional information, see "Monitoring with statd for MariaDB Xpand".

Actively run on one node in the cluster and other nodes are on standby in the event that node fails.

alerter

Monitors cluster and sends email per configuration. For additional information, see "Email Alerts for MariaDB Xpand".

Active on all nodes.

clxdbi

Interface required by the Xpand Graphical User Interface (clxgui).

clxgui

XpandGUI for MariaDB Xpand. Facilitates web-based cluster management.

nanny Commands

To run the nanny command of the clx utility, use the following syntax. The clx utility is located at /opt/clustrix/bin

shell> clx [options] nanny nanny_command [job_name]

This is a list of all the nanny commands available.

nanny_command

Description

add_job

Add a new job.

change_job

Change an existing job.

del_job

Delete a configured job.

help

List available commands.

show_job

Display information about a specific job.

show_jobs

List all configured jobs and their status.

start_job

Start a stopped job.

stop_job

Stop a running job.

version

Display the node version.