v2.0
- About PTK
- Quick Start
- Guidance
- Preparing Configuration File
- Checking the System
- Deploy Database Cluster
- Manage Clusters
- Show Cluster List
- Show Cluster Status
- Start Database
- Stop Database
- Restart Database
- Rebuild Database
- Switchover
- Failover
- Show Plugin Information
- Install Plugins
- Upgrade Database
- Scale-out Cluster
- Scale-in Cluster
- Show Database HBA
- Set Database HBA
- Show Database Parameters
- Set Database Parameters
- Show Cluster Topology Configuration
- Show Cluster Meta Information
- Update Cluster Comment
- Update Database IP
- Role Management
- Install CM
- Uninstall CM
- Manage Cluster VIP
- Install MogHA Service
- Uninstall MogHA Service
- Rename Cluster
- Create Empty Cluster
- Throw Out A Node
- Takeover A Node
- Manage Cluster
- Uninstall Database Cluster
- Collect OS Information
- Download MogDB Installer
- Encrypt Sensitive Information
- Upgrade PTK
- PTKC
- Compatible With Higher Versions of MogDB
- Reference
- Samples of Configuration Files
- Commands
- ptk
- ptk completion
- ptk view-static-config
- ptk init-cluster
- ptk collect
- ptk rec-guc
- ptk cache
- ptk gen-ptkc
- ptk manage
- ptk demo
- ptk meta
- ptk version
- ptk self
- ptk gen-om-xml
- ptk env
- ptk gen-static-config
- ptk cluster
- ptk cluster createdb
- ptk cluster uninstall-compat-tools
- ptk cluster install-compat-tools
- ptk cluster install-mogila
- ptk cluster rename
- ptk cluster throwout
- ptk cluster takeover
- ptk cluster uninstall-cm
- ptk cluster install-cm
- ptk cluster gen-cert-files
- ptk cluster load-cm-vip
- ptk cluster del-kerberos-auth
- ptk cluster add-kerberos-auth
- ptk cluster uninstall-kerberos-server
- ptk cluster install-kerberos-server
- ptk cluster is-in-upgrade
- ptk cluster upgrade-rollback
- ptk cluster upgrade-commit
- ptk cluster upgrade
- ptk cluster demote
- ptk cluster promote
- ptk cluster refresh
- ptk cluster shell
- ptk cluster modify-comment
- ptk cluster show-config
- ptk cluster set-guc
- ptk cluster show-guc
- ptk cluster set-hba
- ptk cluster show-hba
- ptk cluster scale-out
- ptk cluster scale-in
- ptk cluster uninstall-mogha
- ptk cluster install-mogha
- ptk cluster list-plugins
- ptk cluster install-plugin
- ptk cluster inspect
- ptk cluster failover
- ptk cluster switchover
- ptk cluster build
- ptk cluster status
- ptk cluster restart
- ptk cluster stop
- ptk cluster start
- ptk uninstall
- ptk ls
- ptk install
- ptk exec
- ptk template
- ptk encrypt
- ptk checkos
- ptk download
- ptk candidate
- Troubleshooting
- FAQ
- Release Notes
- Community
- Appendix: YAML Syntax
ptk install
ptk install
installs a MogDB or Uqbar database cluster.
Syntax
ptk install [flags]
Example
# Simplest command to install the database (require network)
# It will download latest MogDB installation package from internet and deploy to target hosts
ptk install -f <CONFIG.yaml>
# If you have previously performed checkos command and fixed them,
# you can skip unnecessary secondary checks by adding the '-skip-check-os' parameter
ptk install -f <CONFIG.yaml> --skip-check-os
# If you do not want to interact during the installation process
# you can specify '-y' to accept all questions automatically
ptk install -f <CONFIG.yaml> -y
# If your machine is unable to connect to the Internet,
# you can install it by specifying a local database package
ptk install -f <CONFIG.yaml> -p <LOCAL_DB_PACKAGE>
# If you want to install the cm component, you can specify the '--install-cm' parameter
ptk install -f <CONFIG.yaml> --install-cm
# Of course, you can freely combine multiple parameters to meet specific usage scenarios
ptk install -f <CONFIG.yaml> -p <LOCAL_DB_PACKAGE> -y --skip-check-os --comment 'greate db'
# There are many other parameters in the ptk install command. We look forward to your exploration and discovery.
Option
-y, --assumeyes
- Description: automatically replies yes to all questions.
- Data type: boolean
- Default value: false
--comment string
- Description: adds a comment for the current cluster.
- Data type: string
- Default value: ""
--cpu string
- Description: specifies the CPU model. You can run
ptk candidate cpu
to query the supported CPU models. - Data type: string
- Default value: ""
--db-conf-file string
- Description: Specify a custom database parameter configuration file in the same format as postgresql.conf
- Data type: string
- Default value: ""
--db-version string
-
Description: Specify the database package version if use online package
Type 'ptk candidate db' to show available version
This flag only support MogDB
-
Data type: string
-
Default value: 5.0.8
--default-guc
- Description: uses the default GUC parameters which are not automatically optimized.
- Data type: boolean
- Default value: false
--enable-dss
- Description: enable DSS component.
- Data type: bool
- Default value: false
-e, --env strings
- Description: adds the environment variables to the configuration file of the system user.
- Data type: strings
- Default value: []
-f, --file string
- Description: specifies the configuration file of a cluster.
- Data type: string
- Default value: ""
--install-cm
- Description: installs the CM component.
- Data type: boolean
- Default value: false
--launch-db-timeout duration
- Description: starts the database timeout duration.
- Data type: duration
- Default value: 10m
--no-cache
- Description: specifies that the installation package in the local cache is not used.
- Data type: boolean
- Default value: false
--not-limit-cm-nodes
- Description: No restriction that the number of CM nodes be odd.
- Data type: bool
- Default value: false
-p, --pkg string
- Description: specifies the file path or URL of a database installation package.
- Data type: string
- Default value: ""
--post-run string
- Description: specifies the path for storing the bash script to be executed on each server after successful deployment.
- Data type: string
- Default value: ""
--pre-run string
- Description: specifies the path for storing the bash script to be executed on each server before successful deployment.
- Data type: string
- Default value: ""
--skip-check-distro
- Description: skips checking system distributions.
- Data type: boolean
- Default value: false
--skip-check-hostname
- Description: skips checking hostname.
- Data type: boolean
- Default value: false
--skip-check-os
- Description: skips the check of system environment.
- Data type: boolean
- Default value: false
--skip-check-package
- Description: skips md5 checksums on installers and sha256 checksums on internal packages.
- Data type: boolean
- Default value: false
--skip-create-user
- Description: skips the creation of a system user.
- Data type: boolean
- Default value: false
--skip-gen-ptkc
- Description: skips the generation of the ptkc tool.
- Data type: boolean
- Default value: false
--skip-launch-db
- Description: skips database startup.
- Data type: boolean
- Default value: false
--skip-load-vip
- Description: skips load vip after deploying CM
- Data type: boolean
- Default value: false
--skip-rollback
- Description: skips rollback for installation failures.
- Data type: boolean
- Default value: false
Option Inherited from the Parent Command
--disable-color
- Description: Disable color logs.
- Data type: bool
- Default value: false
--disable-debug-log
- Description: not generate debug log files.
- Data type: bool
- Default value: false
--disable-progressbar
- Description: No progress bar globally.
- Data type: bool
- Default value: false
-h, --help
- Description: outputs the help information for installation.
- Data type: boolean
- Default value: false
--log-file string
- Description: specifies the file path to which the run log is stored.
- Data type: string
- Default value: ""
--log-format string
- Description: specifies the output format of a run log. The value can be text and json.
- Data type: string
- Default value: text
--log-level string
- Description: specifies the run log level. The value can be debug, info, warning, error, and panic.
- Data type: string
- Default value: info
--silence
- Description: Logs are not printed to standard output.
- Data type: bool
- Default value: false
--skip-fix-ssh
-
Description: skips SSH connection fixing through interaction.
-
Data type: boolean
-
Default value: false
Added Version
v0.1
More Command
- ptk - A provisioning toolkit for MogDB.