MySQL Router 8.4  /  MySQL Router 應用程式  /  啟動 MySQL Router

5.1 啟動 MySQL Router

MySQL Router 需要組態檔。雖然 Router 會在預定的預設路徑清單中搜尋組態檔,但常見的做法是使用 --config 選項傳入組態檔來啟動 Router。

設定 MySQL Router 在主機重新啟動時自動啟動的程序,與 MySQL 伺服器所需的步驟類似,在 自動啟動與停止 MySQL 中有說明。

例如,當使用 systemd

$> sudo systemctl start mysqlrouter.service
$> sudo systemctl enable mysqlrouter.service

範例記錄輸出

啟動 MySQL Router 會產生數個記錄項目,例如在連線到沙箱化的 InnoDB Cluster 時

$> mysqlrouter --config=/path/to/file/my_router.conf
^C

$> less /path/to/log/mysqlrouter.log
2019-04-07 16:30:49 INFO    [0x7000022fc000] [routing:devCluster_default_ro] started: listening on 0.0.0.0:6447; read-only
2019-04-07 16:30:49 INFO    [0x70000237f000] [routing:devCluster_default_rw] started: listening on 0.0.0.0:6446; read-write
2019-04-07 16:30:49 INFO    [0x700002402000] [routing:devCluster_default_x_ro] started: listening on 0.0.0.0:64470; read-only
2019-04-07 16:30:49 INFO    [0x700002485000] [routing:devCluster_default_x_rw] started: listening on 0.0.0.0:64460; read-write
2019-04-07 16:30:49 INFO    [0x700002279000] Starting Metadata Cache
2019-04-07 16:30:49 INFO    [0x700002279000] Connections using ssl_mode 'PREFERRED'
2019-04-07 16:30:49 INFO    [0x700002279000] Connected with metadata server running on 127.0.0.1:3310
2019-04-07 16:30:49 INFO    [0x700002279000] Changes detected in cluster 'devCluster' after metadata refresh
2019-04-07 16:30:49 INFO    [0x700002279000] Metadata for cluster 'devCluster' has 1 replicasets:
2019-04-07 16:30:49 INFO    [0x700002279000] 'default' (3 members, single-master)
2019-04-07 16:30:49 INFO    [0x700002714000] Connected with metadata server running on 127.0.0.1:3310

記錄會顯示 MySQL Router 正在監聽四個埠,列出作用中的路由策略名稱、InnoDB Cluster 資訊等等。

例如,第一行列出名為 routing:devCluster_default_ro 的作用中路由策略,正在監聽埠 6447,且其模式為 read-only。MySQL Router 組態檔中的對應區段如下所示

[routing:devCluster_default_ro]
bind_address=0.0.0.0
bind_port=6447
destinations=metadata-cache://devCluster/default?role=SECONDARY
protocol=classic

請注意,名稱和埠直接取自組態檔。透過這種方式,您可以快速判斷哪些路由策略處於作用中。如果您正在執行多個 MySQL Router 實例,或載入多個組態檔,這會特別有用。

在 Windows 上,MySQL Router 可以安裝、移除或啟動服務。依預設,服務名稱為 MySQLRouter。如需其他資訊,請參閱 --service 以及 Windows 服務的相關命令列選項。

範例啟動與停止指令碼

使用 --directory 選項引導啟動 MySQL Router 會產生 bash 指令碼來啟動與停止 MySQL Router,其外觀類似於以下

// *** start.sh *********************** //

#!/bin/bash
basedir=/opt/myrouter
ROUTER_PID=$basedir/mysqlrouter.pid /usr/bin/mysqlrouter -c $basedir/mysqlrouter.conf &
disown %-

// *** stop.sh *********************** //

if [ -f /opt/myrouter/mysqlrouter.pid ]; then
  kill -HUP `cat /opt/myrouter/mysqlrouter.pid`
  rm -f /opt/myrouter/mysqlrouter.pid
fi