Quick Start
Cluster Deployment
Data Model
Data Writing
Data Query
SQL Reference
Maintenance and Monitoring
Tool Guide
Troubleshooting
FAQ
The gpstart utility starts the MatrixDB cluster server processes. When starting a MatrixDB cluster, you are actually starting multiple postgres database server listener processes across the Master and all Segment instances. The gpstart tool manages the startup of these instances, launching them in parallel.
| Option | Description |
|---|---|
| -a | Do not prompt for user confirmation. |
| -B parallel_processes | Number of Segments to start in parallel. If not specified, the tool launches up to 64 parallel processes, depending on the total number of Segment instances to be started. |
| -d master_data_directory | Data directory of the Master host. Defaults to the value set in $MASTER_DATA_DIRECTORY. |
| -l logfile_directory | Directory to write log files. Default is ~/gpAdminLogs. |
| -m | Start only the Master instance, which may be useful for maintenance tasks. After using this option, connections to the Master are allowed only in utility mode. For example:PGOPTIONS='-c gp_role=utility' psql |
| -q | Run in quiet mode. Command output does not display on screen, but is still written to the log file. |
| -R | Start the MatrixDB system in restricted mode (only database superusers can connect). |
| -t timeout_seconds | Specify the timeout period (in seconds) to wait for Segment instances to come online. Startup may take longer if a Segment was abnormally shut down (e.g., due to power failure or termination of its postgres process), because of recovery and validation procedures. If not specified, the default timeout is 60 seconds. |
| --skip-heap-checksum-validation | When specified at startup, skips heap checksum consistency checks between Master and Segments. Starting MatrixDB without this validation may lead to data loss. Use this option only when necessary to bypass heap checksum errors during data recovery or debugging. |
| -v | Display detailed status, progress, and error messages. |
| -y | Do not start the Standby instance. By default, the Standby instance and synchronization process are started. |
| -? or -h or --help | Show help information. |
| --version | Show version information. |
Start the MatrixDB cluster without prompting for confirmation:
gpstart -a