Skip to content
logo
Percona ProxySQL Admin tool
Build the Percona Scheduler admin tool
Initializing search
    percona/proxysql-admin-tool-doc
    percona/proxysql-admin-tool-doc
    • Home
      • Use ProxySQL 1.x.x with ProxySQL Admin
      • Install ProxySQL 1.x.x
      • Install ProxySQL 1.X from a binary tarball
      • Configure ProxySQL 1.x.x
      • Download locations for ProxySQL 2.x.x and ProxySQL admin utilities
      • Install ProxySQL 2.x.x and the admin utilities
      • Install ProxySQL 2.x.x binary tarball
      • Build the Percona Scheduler admin tool
        • Build the module
        • Create an account
      • Start and stop ProxySQL
      • Upgrade ProxySQL
      • Uninstall ProxySQL 2.x.x
      • ProxySQL Admin tool changes
      • ProxySQL 2.x and proxysql-admin utility
      • The proxysql-admin functions
      • ProxySQL 2.x.x and Percona Scheduler Admin tool
      • Percona Scheduler Admin configuration
      • Percona Scheduler Admin statements
      • Percona Scheduler Admin options
      • Known issues in Percona Scheduler Admin
      • Release notes index
      • ProxySQL 2.4.7 and ProxySQL admin tools (2023-02-14)
      • ProxySQL 2.4.4-1.2 and ProxySQL admin tools (2022-11-08)
      • ProxySQL 2.4.4 and ProxySQL admin tools (2022-10-04)
      • ProxySQL 2.4.3 and ProxySQL admin tools (2022-08-31)
      • ProxySQL 2.4.2 and proxysql admin tools (2022-08-10)
      • ProxySQL 2.3.2-1.2, proxysql-admin, and percona-scheduler-admin (2022-06-15)
      • ProxySQL 2.3.2 and proxysql-admin (2021-11-03)
      • ProxySQL 2.2.0 and proxysql-admin (2021-08-10)
      • ProxySQL 2.1.1 and proxysql-admin (2021-07-09)
      • ProxySQL 2.0.18 and proxysql-admin (2021-04-19)
      • ProxySQL 2.0.17 and proxysql-admin (2021-04-06)
      • ProxySQL 2.0.15 and proxysql-admin (2020-11-17)
      • ProxySQL 2.0.14 and proxysql-admin (2020-09-24)
      • ProxySQL 2.0.13 and proxysql-admin (2020-08-05)
      • ProxySQL 2.0.12 and proxysql-admin (2020-06-11)
      • ProxySQL 2.0.7 and proxysql-admin (2019-10-23)
      • ProxySQL 2.0.6 and proxysql-admin (2019-08-21)
      • ProxySQL 2.0.5 and proxysql-admin (2019-11-23)
      • ProxySQL 2.0.4 and proxysql-admin (2019-05-28)
      • ProxySQL 2.0.3 and proxysql-admin (2019-05-07)
      • ProxySQL 1.4.16 and proxysql-admin (2020-02-11)
      • ProxySQL 1.4.12 and proxysql-admin (2018-11-13)
      • ProxySQL 1.4.8 and proxysql-admin (2018-05-22)
      • ProxySQL 1.4.7 and proxysql-admin (2018-04-16)
      • ProxySQL 1.4.6 and proxysql-admin (2018-03-12)
      • ProxySQL 1.4.5 and proxysql-admin (2018-02-15)
      • ProxySQL 1.4.4 and proxysql-admin (2018-01-18)
    • Build the module
    • Create an account

    Build the Percona Scheduler admin tool¶

    The Percona Scheduler Admin has two main files: the pxc_scheduler_handler binary and the percona_scheduler_admin script.

    The pxc_scheduler_handler does the following tasks:

    • Monitors the cluster’s health

    • Processes the cluster’s state and evaluates the scenario

    • Performs actions, such as failover in case of an incident

    The percona_scheduler_admin script runs and provides responses based on the configuration file for the pxc-scheduler_handler binary.

    Running pxc_scheduler_handler without percona_scheduler_admin requires manual intervention.

    Cloning a git project that contains submodules does not automatically check out the submodule content. The submodules require initialization and updating before they are functional.

    Build the module¶

    You can perform the submodule initialization by running the following statement:

    $> git submodule update --init
    

    Run the following command to build the scheduler submodule.

    $> build_scheduler.sh
    

    The pxc_scheduler_handler binary is located in the base directory.

    We do not recommend running multiple instances of the same binary. If you start a new instance when an instance of pxc_scheduler_handler is already running, the binary runs, but the second instance does the following:

    • Consumes network and system resources

    • Returns the same results since the multiple versions use the same configuration file

    Create an account¶

    Create an admin user account. Use this account for communication through ProxySQL and pxc_scheduler_handler.

    mysql> CREATE USER 'admin'@'192.%' IDENTIFIED WITH 'mysql_native_password'
    by 'admin';
    mysql> GRANT ALL PRIVILEGES ON *.* TO 'admin'@'192.%' WITH GRANT OPTION;
    

    See also

    Log file or lock file locations

    Contact us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.


    Last update: 2023-02-14
    Back to top
    Percona LLC and/or its affiliates, © 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.