Updated on 2022-07-29 GMT+08:00

gds_install

Context

gds_install is a script tool used to install GDS in batches, improving GDS deployment efficiency.

Precautions

  • Set environment variables before executing the script. For details, see "Importing Data > Using a Foreign Table to Import Data In Parallel > Installing, Configuring, and Starting GDS" in the Developer Guide.
  • The script must be executed in the Python 3 environment.
  • This script must be run by user root.
  • You need to check the permission on the upper-layer directory to ensure that the GDS user has the read and write permissions on the installation operation directory, installation directory, and installation package.
  • Cross-platform installation and deployment are not supported.
  • The node where the command is executed must be one of the installation and deployment nodes.
  • The passwords of all nodes specified by the --host parameter must be the same so that the script can perform remote deployment successfully.

Syntax

gds_install -I /path/to/install_dir -U user -G user_group --pkg /path/to/pkg.tar.gz --host [/path/to/hostfile | ipaddr1,ipaddr2...] [--ping-host [/path/to/hostfile | ipaddr1,ipaddr2...]]

Parameter Description

  • -I

    Installation directory.

    Default value: /opt/${gds_user}/packages/, in which ${gds_user} indicates the operating system user of the GDS service.

  • -U

    GDS user.

  • -G

    Group to which the GDS user belongs.

  • --pkg

    Path of the GDS installation package, for example, /path/to/GaussDB-8.1.1-REDHAT-x86_64bit-Gds.tar.gz.

  • --host

    IP addresses of the nodes to be installed. The value can be a file name or a string.

    • File format: Each IP address occupies a row, for example:

      192.168.2.200

      192.168.2.201

    • Character string format: IP addresses are separated by commas (,), for example:

      192.168.2.200,192.168.2.201

    The node where the command is executed must be one of the nodes to be deployed. The IP address of the node must be in the list.

  • --ping-host

    Destination IP address for the network ping check on each target node when gds_check is called.

    Value: IP address list in the file or string format. Generally, the value is the IP address of a DN, CN, or gateway.

    • File format: Each IP address occupies a row, for example:

      192.168.2.200

      192.168.2.201

    • String format: IP addresses are separated by commas (,), for example:

      192.168.2.200,192.168.2.201

  • -V

    Version information.

  • -h, --help

    Help information.

Examples

Install GDS on nodes 192.168.1.100 and 192.168.1.101, and specify the installation directory as /opt/gdspackages/install_dir. The GDS user is gds_test:wheel.

gds_install -I /opt/gdspackages/install_dir --host 192.168.1.100,192.168.1.101 -U gds_test -G wheel --pkg /home/gds_test/GaussDB-8.1.1-REDHAT-x86_64bit-Gds.tar.gz