Port details |
- percona-orchestrator Replication topology manager for MySQL
- 3.2.6.16_4 databases
=2 3.2.6.16_2Version of this port present on the latest quarterly branch. - Maintainer: zi@FreeBSD.org
 - Port Added: 2024-04-05 15:00:06
- Last Update: 2025-08-07 00:02:46
- Commit Hash: 5361068
- People watching this port, also watch:: jdictionary, py311-Automat, py311-python-gdsii, py311-PyOpenGL, p5-Sane
- License: APACHE20
- WWW:
- https://github.com/percona/orchestrator
- Description:
- Orchestrator is a replication topology manager for MySQL.
Features include:
* The topology and status of the replication tree is automatically detected
and monitored.
* Either a GUI, CLI or API can be used to check the status and perform
operations.
* Supports automatic failover of the master, and the replication tree can
be fixed when servers in the tree fail - either manually or automatically.
* It is not dependent on any specific version or flavor of MySQL (MySQL,
Percona Server, MariaDB or even MaxScale binlog servers).
* Orchestrator supports many different types of topologies, from a single
master -> slave to complex multi-layered replication trees consisting of
hundreds of servers.
* Orchestrator can make topology changes and will do so based on the state
at that moment; it does not require a configuration to be defined with what
corresponds to the database topology.
* The GUI is not only there to report the status - one of the cooler things
you can do is change replication just by doing a drag and drop in the web
interface (of course you can do this and much more through the CLI and API
as well).
¦ ¦ ¦ ¦ 
- Manual pages:
- FreshPorts has no man page information for this port.
- pkg-plist: as obtained via:
make generate-plist - Dependency lines:
-
- percona-orchestrator>0:databases/percona-orchestrator
- To install the port:
- cd /usr/ports/databases/percona-orchestrator/ && make install clean
- To add the package, run one of these commands:
- pkg install databases/percona-orchestrator
- pkg install percona-orchestrator
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above.- PKGNAME: percona-orchestrator
- Flavors: there is no flavor information for this port.
- distinfo:
- TIMESTAMP = 1745531504
SHA256 (percona-orchestrator-v3.2.6-16_GH0.tar.gz) = 8147cb8d9929ab8543d5cafb1b9db1961c1c74f78b97b5ce8591c60aa8955aea
SIZE (percona-orchestrator-v3.2.6-16_GH0.tar.gz) = 16140265
Packages (timestamps in pop-ups are UTC):
- Dependencies
- NOTE: FreshPorts displays only information on required and default dependencies. Optional dependencies are not covered.
- Build dependencies:
-
- go124 : lang/go124
- Runtime dependencies:
-
- bash>0 : shells/bash
- gsed>0 : textproc/gsed
- jq>0 : textproc/jq
- mysqld : databases/mysql80-server
- There are no ports dependent upon this port
Configuration Options:
- No options to configure
- Options name:
- databases_percona-orchestrator
- USES:
- go mysql:server shebangfix
- pkg-message:
- For install:
- #### Setup backend MySQL server
Setup a MySQL server for backend, and invoke the following:
CREATE DATABASE IF NOT EXISTS orchestrator;
CREATE USER 'orchestrator'@'127.0.0.1' IDENTIFIED BY 'orch_backend_password';
GRANT ALL PRIVILEGES ON `orchestrator`.* TO 'orchestrator'@'127.0.0.1';
Orchestrator uses a configuration file, located in:
/usr/local/etc/orchestrator/orchestrator.conf.json
Edit orchestrator.conf to match the above as follows:
...
"MySQLOrchestratorHost": "127.0.0.1",
"MySQLOrchestratorPort": 3306,
"MySQLOrchestratorDatabase": "orchestrator",
"MySQLOrchestratorUser": "orchestrator",
"MySQLOrchestratorPassword": "orch_backend_password",
...
#### Grant access to orchestrator on all your MySQL servers
CREATE USER 'orchestrator'@'orch_host' IDENTIFIED BY 'orch_topology_password';
GRANT SUPER, PROCESS, REPLICATION SLAVE, RELOAD ON *.* TO 'orchestrator'@'orch_host';
GRANT SELECT ON mysql.slave_master_info TO 'orchestrator'@'orch_host';
GRANT SELECT ON ndbinfo.processes TO 'orchestrator'@'orch_host'; -- Only for NDB Cluster
Replace `orch_host` with hostname or orchestrator machine (or do your
wildcards thing). Choose your password wisely. Modify the configuration file to
match:
"MySQLTopologyUser": "orchestrator",
"MySQLTopologyPassword": "orch_topology_password",
By default, orchestrator listens on 127.0.0.1:3000 and is configured to be
read-only. Please update the configuration file if you would like to change
this.
- Master Sites:
|
Commit History - (may be incomplete: for full details, see links to repositories near top of page) |
Commit | Credits | Log message |
3.2.6.16_4 07 Aug 2025 00:02:46
    |
Adam Weinberger (adamw)  |
go ports: Bump for 1.24.6 |
3.2.6.16_3 09 Jul 2025 16:11:00
    |
Adam Weinberger (adamw)  |
many: Bump PORTREVISION for go-1.24.5 update |
3.2.6.16_2 06 Jun 2025 20:00:53
    |
Adam Weinberger (adamw)  |
various: Bump PORTREVISION after go124-1.24.4 update |
3.2.6.16_1 21 May 2025 19:58:15
    |
Adam Weinberger (adamw)  |
go: Bump go124-dependent ports
Earlier I bumped the default Go to 1.24. Ports that specify a lower
version will still build with those lower version (for now), so they
don't need a bumping. Instead I'm bumping anything that (now) has go124
as a dependency. |
3.2.6.16 28 Apr 2025 21:28:26
    |
Ryan Steinmetz (zi)  |
databases/percona-orchestrator: Update to v3.2.6-16
PR: 286328
Reported by: Chris Petrik <cpetrik@proton.me> |
3.2.6.12_7 02 Apr 2025 02:07:58
    |
Adam Weinberger (adamw)  |
go: Bump ports for go124 update |
3.2.6.12_6 05 Mar 2025 16:02:56
    |
Adam Weinberger (adamw)  |
Bump all go ports for yesterday's releases |
3.2.6.12_5 09 Aug 2024 06:24:08
    |
Ashish SHUKLA (ashish)  |
all: Bump after lang/go121 update |
3.2.6.12_4 03 Jul 2024 08:29:54
    |
Ashish SHUKLA (ashish)  |
all: Bump after lang/go121 update |
3.2.6.12_3 15 Jun 2024 09:52:17
    |
Ashish SHUKLA (ashish)  |
all: Bump after lang/go121 update
MFH: 2024Q2 |
3.2.6.12_2 13 May 2024 17:56:04
    |
Ashish SHUKLA (ashish)  |
all: Bump after lang/go121 update
MFH: 2024Q2 |
3.2.6.12_1 15 Apr 2024 08:20:04
    |
Ashish SHUKLA (ashish)  |
all: Bump after lang/go121 update
MFH: 2024Q2 |
3.2.6.12 05 Apr 2024 14:57:01
    |
Ryan Steinmetz (zi)  |
databases/percona-orchestrator: new port!
Orchestrator is a replication topology manager for MySQL.
Features include:
* The topology and status of the replication tree is automatically detected
and monitored.
* Either a GUI, CLI or API can be used to check the status and perform
operations.
* Supports automatic failover of the master, and the replication tree can
be fixed when servers in the tree fail - either manually or automatically.
* It is not dependent on any specific version or flavor of MySQL (MySQL,
Percona Server, MariaDB or even MaxScale binlog servers).
* Orchestrator supports many different types of topologies, from a single
master -> slave to complex multi-layered replication trees consisting of
hundreds of servers.
* Orchestrator can make topology changes and will do so based on the state
at that moment; it does not require a configuration to be defined with what
corresponds to the database topology.
* The GUI is not only there to report the status - one of the cooler things
you can do is change replication just by doing a drag and drop in the web
interface (of course you can do this and much more through the CLI and API
as well). |