AGENT-DEPLOY

On this page

Deploys a MemSQL Ops agent to another host. The deployed agent is automatically set as follower to the local MemSQL Ops agent.

This command requires valid SSH credentials to connect to the host where you plan to deploy the agent. The SSH credentials are stored for future use, and leveraged for other MemSQL Ops operations, such as AGENT-SSH.

Usage

usage: memsql-ops agent-deploy [--settings-file SETTINGS_FILE] [--async] -h
                               HOST [-P PORT] [-u USER] [-p [PASSWORD]]
                               [-i IDENTITY_FILE] [--agent-port AGENT_PORT]
                               [--ops-datadir OPS_DATADIR]
                               [--memsql-installs-dir MEMSQL_INSTALLS_DIR]
                               [--allow-no-sudo]

Deploy a MemSQL Ops agent to a host.

optional arguments:
  --settings-file SETTINGS_FILE
                        A path to a MemSQL Ops settings.conf file. If not set,
                        we will use the file in the same directory as the
                        MemSQL Ops binary.
  --async               If this option is true, we will exit without waiting
                        for the agent to be fully deployed.
  -h HOST, --host HOST  The hostname of the machine to deploy to.
  -P PORT, --port PORT  The SSH port for the machine to deploy to.
  -u USER, --user USER  The user on the remote machine to use. By default we
                        will use the same username as the user running this
                        command.
  -p [PASSWORD], --password [PASSWORD]
                        Password for the user on the remote machine. Leave
                        blank to read the MEMSQL_PASSWORD environment
                        variable, or have a password prompt if MEMSQL_PASSWORD
                        is not set.
  -i IDENTITY_FILE, --identity-file IDENTITY_FILE
                        Path to a private key file for logging into the remote
                        machine.
  --agent-port AGENT_PORT
                        The port on which we will run the newly-deployed
                        agent.
  --ops-datadir OPS_DATADIR
                        A directory to use as the agent's data directory. The
                        agent will put log files and so forth in this
                        directory. By default, we will use the agent's install
                        directory.
  --memsql-installs-dir MEMSQL_INSTALLS_DIR
                        A directory that we will install SingleStore nodes in. By
                        default, we will use the agent's data directory (see
                        --ops-datadir above).
  --allow-no-sudo       Do not throw an error if we cannot use sudo on the
                        remote machine.

Last modified: April 25, 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