PTK 介紹

PTK (Provisioning Toolkit) 是一款針對(duì) MogDB 數(shù)據(jù)庫(kù)開(kāi)發(fā)的軟件安裝和運(yùn)維工具，僅需要執(zhí)行一行命令即可幫助用戶便捷地完成 MogDB 數(shù)據(jù)庫(kù)的安裝部署。

建議將 PTK 部署在運(yùn)維管理平臺(tái)，方便統(tǒng)一管理多套數(shù)據(jù)庫(kù)集群。

官方文檔地址：https://docs.mogdb.io/zh/ptk/v0.2/overview

與 OM 對(duì)比

?PTKOM支持系統(tǒng)Windows、Linux、MacOSLinux支持版本MogDB 所有版本MogDB 3.0 及以下所有版本軟件下載在線 / 離線離線部署方式與數(shù)據(jù)庫(kù)解偶，可管理多套數(shù)據(jù)庫(kù)集群與數(shù)據(jù)庫(kù)部署在一起，一對(duì)一管理軟件升級(jí)與數(shù)據(jù)庫(kù)解偶，自升級(jí)需要與數(shù)據(jù)庫(kù)同步升級(jí)數(shù)據(jù)庫(kù)安裝即支持根據(jù)系統(tǒng)自動(dòng)選擇， 也支持離線指定僅支持離線指定內(nèi)核參數(shù)自動(dòng)生成修復(fù)文本，可一鍵修復(fù)有些參數(shù)值有待優(yōu)化配置文件通俗易懂目錄地址設(shè)置不當(dāng)會(huì) preinstall 失敗網(wǎng)絡(luò)檢測(cè)多 IP 自動(dòng)探活-兼容性兼容 gs_om，會(huì)創(chuàng)建 gs_om 需要的靜態(tài)文件-

安裝部署

下載 PTK

--在線下載[root@node1 software]# curl --proto '=https' --tlsv1.2 -sSf https://cdn-mogdb.enmotech.com/ptk/install.sh | shinfo: downloading ptk packageWarning: Not enforcing strong cipher suites for TLS, this is potentially less secureDetected shell: bashShell profile: ?/root/.bash_profileptk has been added to PATH in /root/.bash_profileopen a new terminal or source /root/.bash_profile to active itInstalled path: /root/.ptk/bin/ptk[root@node1 software]# source ~/.bash_profile[root@node1 software]# ptk --versionPTK Version: v0.2.3Go Version: go1.17.1Build Date: 2022-07-04T13:06:48ZGit Hash: d064a36--離線下載參考： https://docs.mogdb.io/zh/ptk/v0.2/install

配置文件

配置文件可以自己根據(jù)官方文檔自己寫，也可以使用命令生成配置文件模版

生成配置文件

[root@node1 ~]# cd ~/.ptk/ [root@node1 .ptk]# ptk template > config.yaml

編輯配置文件

--密碼加密[root@node1 .ptk]# ptk encrypt ommomm: pTk6YjM5YWY4MmM8QzxCPEU/Qm5UWFZGXzB4bldmcHI3T1lKMEVXeXltZzVBemU3V3EwcWpvbXJrM2dlSzg=[root@node1 .ptk]# ptk encrypt MogDB@0701MogDB@0701: pTk6MDQ2Y2U0ZDE8QzxCPEU/RE8ycy1UZFpEZ0xSMU9PQzRZMkpoY2JuT0x2Z05FbG9pZDlBMm5hZlFEVzQ=--編輯后配置文件展示[root@node1 .ptk]# cat config.yaml |grep -v '#'global: ?cluster_name: "MogDB3.0" ?user: "omm" ?group: "dbgrp" ?db_password: "pTk6MDQ2Y2U0ZDE8QzxCPEU/RE8ycy1UZFpEZ0xSMU9PQzRZMkpoY2JuT0x2Z05FbG9pZDlBMm5hZlFEVzQ=" ?db_port: 26000 ?cm_server_port: 15300 ?base_dir: "/opt/mogdb" ?app_dir: "/opt/mogdb/app" ?log_dir: "/opt/mogdb/log" ?data_dir: "/data/mogdb" ?tool_dir: "/opt/mogdb/tool" ?cm_dir: "/opt/mogdb/cm" ?ssh_option: ? ? port: 22 ? ? user: root ? ? password: "pTk6MDQ2Y2U0ZDE8QzxCPEU/RE8ycy1UZFpEZ0xSMU9PQzRZMkpoY2JuT0x2Z05FbG9pZDlBMm5hZlFEVzQ="db_servers: ?- host: "192.168.122.221" ? ?db_port: 26000 ? ?ha_port: 26001 ? ?role: "primary" ?- host: "192.168.122.157" ? ?db_port: 26000 ? ?ha_port: 26001 ? ?role: "standby" ?- host: "192.168.122.68" ? ?db_port: 26000 ? ?ha_port: 26001 ? ?role: "standby"

檢查操作系統(tǒng)

檢查命令

ptk checkos -i A1,A2,A3 ? # 要檢查多個(gè)狀態(tài)，請(qǐng)按以下格式輸入項(xiàng)目：“-i A1,A2,A3”。ptk checkos -i A ? ? ? ? ?# 檢查全部檢查項(xiàng)ptk checkos -i A --detail # 加上--detail 會(huì)顯示詳細(xì)信息詳細(xì)信息請(qǐng)查看幫助文檔 ptk checkos --help

檢查等級(jí)

• OK：符合預(yù)期值，滿足安裝需求

• Warning: 不符合預(yù)期值，但可以滿足安裝需求

• Abnormal: 不滿足安裝要求，可能會(huì)導(dǎo)致安裝過(guò)程失敗，需根據(jù) PTK 給出的修改建議腳本，人工執(zhí)行修改

• ExecuteError: 執(zhí)行錯(cuò)誤，該等級(jí)表示 PTK 在檢查時(shí)執(zhí)行命令失敗，可能為用戶環(huán)境工具缺失或內(nèi)部 BUG，需根據(jù)實(shí)際錯(cuò)誤提示進(jìn)行修正

在安裝數(shù)據(jù)庫(kù)之前，需確保所有的檢查項(xiàng)都在 OK 或 Warning 級(jí)別，如果存在 Abnormal 的檢查結(jié)果，在安裝時(shí)會(huì)報(bào)錯(cuò)退出。

--檢查所有節(jié)點(diǎn)[root@node1 .ptk]# ptk checkos -i A -f config.yamlINFO[2022-07-06T09:48:23.777] local ip: 192.168.122.221[host 192.168.122.221]: not found tool: bzip2[host 192.168.122.221]: not found tool: lsof[host 192.168.122.221]: not found tool: ifconfig[host 192.168.122.221]: not found package: numactl[host 192.168.122.68]: not found tool: bzip2[host 192.168.122.68]: not found tool: lsof[host 192.168.122.68]: not found package: numactl[host 192.168.122.157]: not found tool: bzip2[host 192.168.122.157]: not found tool: lsof[host 192.168.122.157]: not found package: numactlPlease installed the above missing packages first before do other operations[PTK-4010] the system does not meet installation requirements--安裝依賴包[root@node1 .ptk]# yum -y install bzip2.x86_64 bzip2-devel.x86_64 lsof.x86_64 numactl.x86_64 numactl-devel.x86_64 net-tools.x86_64--再次檢查[root@node1 .ptk]# ptk checkos -i A -f config.yaml--執(zhí)行系統(tǒng)檢查，不但會(huì)將不符合安裝需求的檢查項(xiàng)列出來(lái)，還會(huì)生成一個(gè)修復(fù)腳本，腳本的格式為root_fix_os.%Y.%m%d.%H%M%S.sh

--執(zhí)行修復(fù)腳本 在集群內(nèi)所有節(jié)點(diǎn)執(zhí)行，腳本內(nèi)容略 [root@node1 .ptk]# bash root_fix_os.2022.0707.000721.sh

集群安裝驗(yàn)證

[root@node1 .ptk]# ptk install -y -f config.yaml --install-cm...[root@node1 .ptk]# ptk ls ?cluster_name | ? ? ? instances ? ? ? | user | ?data_dir ? | db_version---------------+-----------------------+------+-------------+-------------- ?MogDB3.0 ? ? | 192.168.122.221:26000 | omm ?| /data/mogdb | MogDB-3.0.0 ? ? ? ? ? ? ? | 192.168.122.157:26000 | ? ? ?| ? ? ? ? ? ? | ? ? ? ? ? ? ? | 192.168.122.68:26000 ?| ? ? ?| ? ? ? ? ? ? |[root@node1 .ptk]# ptk cluster status -n MogDB3.0[ ? Cluster State ? ]database_version : MogDB-3.0.0cluster_name : MogDB3.0cluster_state ? : Normalcurrent_az ? ? ? : AZ_ALL[ ?Datanode State ? ] ? id ?| ? ? ? ip ? ? ? ?| port ?| user | instance | db_role | state-------+-----------------+-------+------+----------+---------+--------- ?6003 | 192.168.122.68 ?| 26000 | omm ?| dn_6003 ?| primary | Normal ?6001 | 192.168.122.221 | 26000 | omm ?| dn_6001 ?| standby | Normal ?6002 | 192.168.122.157 | 26000 | omm ?| dn_6002 ?| standby | Normal

集群卸載

[root@node1 .ptk]# ptk uninstall -n MogDB3.0=============================global: ?cluster_name: MogDB3.0 ?user: omm ?group: dbgrp ?app_dir: /opt/mogdb/app ?data_dir: /data/mogdb ?log_dir: /opt/mogdb/log ?tool_dir: /opt/mogdb/tool ?tmp_dir: /opt/mogdb/tmp ?cm_server_port: 15300db_servers:- host: 192.168.122.68 ?db_port: 26000 ?role: primary ?az_name: AZ1 ?az_priority: 1- host: 192.168.122.221 ?db_port: 26000 ?role: standby ?az_name: AZ1 ?az_priority: 1- host: 192.168.122.157 ?db_port: 26000 ?role: standby ?az_name: AZ1 ?az_priority: 1=============================Do you really want to uninstall this cluster? Please confirm carefully[Y|Yes](default=N) YDo you want to delete db data '/data/mogdb'?[Y|Yes](default=N) YDo you want to delete user 'omm'?[Y|Yes](default=N) Y...PTK 命令參考ptk candidate - 打印 PTK 支持的軟件版本列表ptk checkos - 檢查集群服務(wù)器系統(tǒng)依賴是否滿足安裝數(shù)據(jù)庫(kù)需求ptk encrypt - 提供一個(gè)便捷的方式來(lái)加密您的文本或密碼ptk env - 打印 PTK 環(huán)境變量信息ptk install - 基于給定的拓?fù)渑渲貌渴餗ogDB數(shù)據(jù)庫(kù)集群ptk ls - 列出所有MogDB集群列表ptk self - 操作 PTK 自身安裝包ptk cluster -數(shù)據(jù)庫(kù)集群操作ptk template - 打印配置模板ptk uninstall - 卸載 MogDB 數(shù)據(jù)庫(kù)集群ptk gen-om-xml - 生成 gs_om 的 XML 配置文件ptk version - 打印 PTK 版本ptk completion - 為指定的 shell 生成自動(dòng)補(bǔ)全腳本