{
  "id": 19257965,
  "title": "Five Acceptance Steps as a Script: GBase Database Deployment Validation",
  "url": "https://urgent.news/2026/11/10/five-acceptance-steps-as-a-script-gbase-database-deployment-validation",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-11-10T01:16:45.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/mmllllzcn/five-acceptance-steps-as-a-script-gbase-database-deployment-validation-hj"
  },
  "original_language": "en",
  "account": "Deploying a GBase Database does not guarantee readiness for use. To ensure a successful installation, a series of acceptance steps must be followed. This article outlines five essential steps for validating a GBase Database deployment, along with a Bash script to automate the process.\n\nStep 1: Verify the Installation Result\nAfter running the installation command, examine its output. A successful installation returns a specific JSON structure. The script should focus on the return code, rather than simply checking for output. While installation success is the first checkpoint, it does not confirm all components are running or clients can connect.\n\nStep 2: Check Cluster Health\nUse the gha_ctl command to inspect the cluster's health. Review four key sections: gha_server, gtm, coordinator, and datanode. The acceptance criteria require no stopped or unstable instances, exactly one primary in each Data Node (DN) group, and all DCS nodes in a healthy state. The script should parse the monitoring output by section, rather than relying on fixed line numbers, as deployment layouts may vary.\n\nStep 3: Verify Listening Ports\nConfirm that the expected database services are listening for connections. Use the ss command to check for specific ports, such as 5432 or 15432, which should be defined in the deployment configuration. Additionally, check the listening address to ensure it matches the intended network access configuration. Simply verifying the port number may produce a false sense of readiness.\n\nStep 4: Test Database Connectivity\nUse the gsql command to execute a simple SQL statement, verifying that the target database instance can accept a client connection and execute a basic query. This step is more reliable for automation than waiting for an interactive prompt or manually checking the terminal. For GBase Database (8c), this step confirms the database can handle client connections and execute queries.\n\nStep 5: Validate Read and Write Operations\nThe final acceptance step should execute a complete create-insert-select sequence. Create a temporary database, table, insert data, then query the table to verify the operations succeed. After validation, remove the temporary database to clean up. This step provides stronger evidence that the database is ready for basic application integration.\n\nBuilding the Acceptance Script\nThe acceptance script follows a simple structure, with one function for each step. Functions include:\n- check_install: Verifies the installation result\n- check_cluster: Inspects the cluster's health using gha_ctl\n- check_ports: Validates expected listening ports and addresses\n- check_connection: Tests database connectivity with gsql\n- check_read_write: Validates read and write operations using create-insert-select\n\nThe script should print a PASS or FAIL message for each step, indicating success or failure. A log file is created to record execution details, including hostname and timestamp. The script adheres to three implementation principles: fail fast (stop when a critical step fails), keep execution records, and reuse deployment configuration.",
  "summary": "A successful installation does not necessarily mean a database is ready for use. For GBase Database(GBase 8c) , first-connection acceptance should verify more than whether the installation command returned successfully. Cluster health, listening ports, database connectivity, and basic read/write operations all need to be checked. Instead of running these commands manually after every deployment,…",
  "key_points": [
    "Verify installation result JSON structure",
    "Check cluster health with ghactl command",
    "Test create-insert-select operations"
  ],
  "editors_take": "Automating the validation process through structured scripts shifts database deployment from simple installation checks to a rigorous verification of cluster health, network connectivity, and functional data operations.",
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}