AGGREGATOR SET AS MASTER

Promote a child aggregator to master aggregator.

Syntax

AGGREGATOR SET AS MASTER;

Remarks

  • This command should only be used in cases where the master aggregator is permanently lost. The command PROMOTE AGGREGATOR … TO MASTER is required for all other use cases that require the promotion of a child aggregator to master.

  • This command must be run on the child aggregator node to be promoted to master (see Node Requirements for SingleStore Commands ). If this command is run while your cluster has an online master aggregator, it will return an error.

  • For version 7.1 and older, see Previous Versions.

  • This command causes implicit commits. Refer to COMMIT for more information.

  • See the Permission Matrix for the required permission.

Example

AGGREGATOR SET AS MASTER;
Query OK, 1 row affected (1 min 22.41 sec)

Related Topics

Previous Versions

In previous versions of SingleStore, AGGREGATOR SET AS MASTER required the following procedure:

  1. Stop any DDL queries and writes to reference tables.

  2. Confirm that the cluster and reference databases (if any) are in sync between the master aggregator and child aggregator to be promoted. To check the position of databases, create a connection to the MemSQL node and run the SHOW DATABASES EXTENDED command.

  3. Disable detection of leaf failures and trigger failovers on the child aggregator. Set leaf_failure_detection variable on the target child aggregator to off. Perform this step from the master aggregator. If the current master aggregator is unresponsive, skip this step.

  4. Stop the master aggregator using the memsql-ops memsql-stop <master_aggregator_ID> or sdb-admin stop-node --memsql-id <master_aggregator_ID> command. Make sure the master aggregator is offline before proceeding.

  5. Clear the DNS cache on all the nodes in the cluster using the FLUSH HOSTS command.

  6. Promote the child aggregator to the master aggregator. Run the AGGREGATOR SET AS MASTER command on the target child aggregator. Execute the SELECT @@master_aggregator query. This query should return self.

  7. Enable leaf failure detection on the master aggregator. Set leaf_failure_detection variable to ON.

  8. Remove the old master aggregator from the cluster using REMOVE AGGREGATOR.

  9. Delete the old master aggregator. Run the memsql-ops memsql-delete <node_ID> or sdb-admin delete-node <node_ID> command.

Last modified: July 31, 2023

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

  1. (Optional) Run the following command to view the associated signature files.

    curl undefined
  2. Download the signature file from the SingleStore release server.

    • Option 1: Click the Download Signature button next to the SingleStore file.

    • Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.

    • Option 3: Run the following command to download the signature file.

      curl -O undefined
  3. After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

    echo -n undefined |
    cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
    --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
    --bundle undefined \
    --new-bundle-format -
    Verified OK