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