install_vertica 选项

下表描述了所有 install_vertica 脚本选项。大多数选项都有长短两种形式 — 例如 \--hosts 和 -s。

install_vertica 至少需要两个选项：

• --hosts / -s

• --rpm / -r | --deb

例如：

 # /opt/vertica/sbin/install_vertica --hosts node0001,node0002,node0003 \
            --rpm /tmp/vertica-10.1.1-0.x86_64.RHEL6.rpm

有关最低安装要求的详细信息，请参阅执行基本安装。

--help

显示此脚本的帮助。

\--accept-eula -Y

以静默方式接受 EULA 协议。在多节点安装时，此选项将在安装结束时与管理工具元数据同时传播到整个群集。

请将此选项与 --license (-L) 结合使用以激活许可证。

\--add-hosts host-list -A host-list

将要添加到现有 Vertica 群集的逗号分隔的主机列表。

--add-hosts 会通过将主机添加到数据库群集，然后重新配置 Spread，以修改现有的 Vertica 安装。这对提高系统性能或将数据库设为 K-safe 非常有用。

如果已使用 --point-to-point (-T) 将 spread 配置为在现有群集内使用直接点对点通信，则在添加新主机时也必须使用此类通信；否则，新主机会自动使用 UDP 广播流量，从而导致群集通信问题，进而导致 Vertica 无法正常运行。例如：

--add-hosts host01
--add-hosts 192.168.233.101

还可以将此选项与 update_vertica 脚本一起使用。有关详细信息，请参阅添加节点。

\--broadcast -U

指定 Vertica 通过 spread 在子网中的节点之间使用 UDP 广播流量。默认情况下，自动使用此选项。广播流量支持的 spread 守护程序数量不超过 80 个。使用大型群集模式时，节点数量可能会超过 80 个，这时将无法在每个节点上安装一个 spread 守护程序（请参阅大型群集）。

不要将此选项与 --point-to-point (-T) 结合使用。

将配置从 --broadcast (-U)（默认值）更改为 --point-to-point (-T) 或执行相反方向的更改时，还必须指定 --control-network (-S)。

--clean

强制清理之前存储的配置文件。如果需要更改群集中包含的主机，请使用此选项。仅当没有定义任何数据库时使用此选项。

此选项不能与 update_vertica 结合使用。

\--config-file file -z file

接受 --record-config 创建的现有属性文件。此属性文件包含映射到 install_vertica 脚本中的选项的键/值设置，其中许多布尔实参默认设为 false。

\--control-network { bcast-addess | default } -S { bcast-addess | default }

设置为以下实参之一：

• bcast-addess：一个广播网络 IP 地址，可用于在子网上配置不同于其他 Vertica 数据通信的 spread 通信。

• default

重要

bcast-addess 必须至少匹配数据库中部分节点的子网。如果地址不匹配数据库中任何节点的子网，则安装程序将会显示错误并停止运行。如果提供的地址匹配部分节点的子网，但不匹配所有节点的子网，则安装程序将会显示警告，但安装仍会继续。

理想情况下，--control-network 的值应匹配所有节点子网。

在更改 spread 相关的选项时，还可以使用此选项强制执行群集范围的 spread 重新配置。

\--data-dir data-directory -d data-directory

指定数据库数据和编录文件的目录。有关详细信息，请参阅在安装期间指定磁盘存储位置。

当心

在此设置中，请勿将一个共享目录用于多个节点。每个节点的数据目录和编录目录必须不同。多个节点不能写入相同的数据目录和编录目录。

默认值： /home/dbadmin

\--dba-group group -g group

DBA 用户的 UNIX 组。

默认值： verticadba。

\--dba-user dba-username -u dba-username

要创建的 数据库超级用户系统帐户的名称。只有此帐户可以运行管理工具。如果忽略此选项，则默认数据库管理员帐户名称为 dbadmin。

对于以 root 身份完成的新安装，此选项是可选项，但是在升级或使用 sudo 安装时则必须指定。升级时，请使用此选项指定之前的同一 DBA 帐户名称。如果使用 sudo 安装，则 dba-username 必须已经存在。

如果手动创建该用户，请修改用户的 .bashrc 文件以包含以下行： PATH=/opt/vertica/bin:$PATH 以便 dbadmin 用户可以轻松启动 vsql 和 admintools 等 Vertica 工具。

\--dba-user-home dba-home-directory -l dba-home-directory

数据库管理员的主目录。

默认值： /home/dbadmin。

\--dba-user-password dba-password -p dba-password

数据库管理员帐户的密码。如果未提供该密码，脚本将会提示输入密码并且不会回显输入。

--dba-user-password-disabled

禁用 --dba-user 的密码。此实参将阻止安装程序提示输入 --dba-user 的密码。可以稍后使用 passwd 等标准用户管理工具分配密码。

\--failure-threshold [ threshold-arg ]

当达到指定的故障阈值时停止安装，其中，threshold-arg 可以是以下值之一：

• HINT：在安装测试期间遇到 HINT 或更严重的问题时停止安装。HINT 配置是应该执行的设置，但如果忽略该设置，数据库的运行也不会受到明显的负面影响。

• WARN：在遇到 WARN 或更严重的问题时停止安装。WARN 问题可能会影响数据库的性能。但用于基本测试时，或对于 Community Edition 用户而言，如果不要求极端性能，也可以忽略 WARN 问题。

• FAIL：在遇到 FAIL 或更严重的问题时停止安装。FAIL 问题可能造成严重不利的性能后果，如果不加以解决，在后期可能造成处理问题。但即使忽略 FAIL 问题，仍可启动 Vertica。

• HALT：在遇到 HALT 或更严重的问题时停止安装。如果选择此选项，数据库可能无法启动。不支持在生产环境中使用。

• NONE：不停止安装。数据库可能无法启动。不支持在生产环境中使用。

默认值： WARN

\--hosts host-list -s host-list

要包括在群集中的逗号分隔的主机名或 IP 地址列表，其中，host-list 不得包含空格。例如：

--hosts host01,host02,host03
-s 192.168.233.101,192.168.233.102,192.168.233.103
  

需要满足以下要求：

• 如果升级现有的 Vertica 安装，请使用之前使用的相同主机名。

• 主机的 IP 地址或主机名必须唯一。列出的同一主机不得使用多个 IP 地址/主机名。

--ipv4

群集中的主机通过 IPv4 网络地址标识。这是默认行为。

--ipv6

群集中的主机通过 IPv6 网络地址标识。在 --hosts 列表中传递 IPv6 地址时，必须指定此选项。如果在 --hosts 选项中使用主机名，则名称必须解析为 IPv6 地址。此选项自动启用 --[point-to-point](#pointToPoint) 选项。

\--large-cluster [ num-control-nodes | default]

将启用大型群集功能，其中名为 控制节点的节点子集连接到 Spread 以发送和接收广播消息。对于企业模式下的具有超过 50 个节点的群集，请考虑使用此选项。如果在企业模式下安装到 120 个或更多节点，或者在 Eon 模式下安装到 16 个或更多节点，Vertica 会自动启用此功能。

为该选项提供以下实参之一：

• num-control-nodes：将新数据库中的控制节点数设为该值与 --hosts 值之中的较小值。对于企业模式，设置整个群集中控制节点的数量。在 Eon 模式下，设置初始默认子群集中的控制节点数。此值必须介于 1 到 120 之间（包含）。
• default：Vertica 将控制节点数设为 --hosts (-s) 中列出的群集节点总数的平方根。

有关详细信息，请参阅在安装 Vertica 时启用大型群集。

默认值： default

\--license { licensefile | CE } -L { licensefile | CE }

以静默方式自动将许可证密钥部署到 /opt/vertica/config/share。在多节点安装中，–-license 选项还将许可证应用于 --hosts host_list 中声明的所有节点。要激活许可证，请将此选项与 –-accept-eula 选项结合使用。如果不使用 –-accept-eula 选项，在连接到数据库时，系统会要求接受 EULA。接受 EULA 后，许可证便会激活。

如果使用 CE 指定，则会自动部署包含在下载内容中的社区版许可证密钥。您无需指定许可证文件。

例如：

--license CE
--license /tmp/vlicense.dat

--no-system-configuration

指定安装程序不对系统属性进行任何更改。默认情况下，安装程序会执行系统配置更改，以满足服务器要求。

如果使用此选项，安装程序会针对不满足要求的配置设置发出警告或失败，并指出它将自动配置这些设置。

此选项对创建或更新用户帐户没有影响。

\--point-to-point -T

将 spread 配置为在所有 Vertica 节点之间使用直接点对点通信。如果节点不在同一子网中，请使用此选项。此外，对于所有虚拟环境安装，不论虚拟服务器是否在同一子网中，也请使用此选项。

Vertica 中的点对点通信所支持的 spread 守护程序最大数量为 80 个。使用大型群集模式时，节点数量可能会超过 80 个，这时将无法在每个节点上安装一个 spread 守护程序。

不要将此选项与 --broadcast (-U) 结合使用。

启用 --ipv6 选项后，将自动启用此选项。

将配置从 --broadcast (-U)（默认值）更改为 --point-to-point (-T) 或执行相反方向的更改时，还必须指定 --control-network (-S)。

\--record-config filename -B filename

接受文件名，该文件名与命令行选项联合使用时，将创建可与 --config-file (-z) 配合使用的属性文件。该选项将创建属性文件并退出；它不会影响安装。

\--remove-hosts host-list -R host-list

将要从现有的 Vertica 群集中移除的逗号分隔的主机列表。

--remove-hosts 会通过将主机从数据库群集中移除，然后重新配置 spread，以修改现有的 Vertica 安装。这在移除废弃或过度配置的系统时非常有用。例如：

--remove-hosts host01
  
-R 192.168.233.101
  

如果使用 --point-to-point (-T) 将 spread 配置为在现有群集内使用直接点对点通信，则在移除主机时也必须使用此类通信；否则，主机会自动使用 UDP 广播流量，从而导致群集通信问题，进而导致 Vertica 无法正常运行。

移除节点中所述的 update_vertica 脚本会调用 install_vertica 脚本来执行安装更新。您可以将 install_vertica 或 update_vertica 脚本与此选项配合使用。

\--rpm package-name -r package-name \--deb package-name

RPM 或 Debian 软件包的名称。例如：

--rpm vertica-12.0.x.x86_64.RHEL6.rpm

如果安装或升级多个节点并且这些节点没有安装最新的服务器软件包，或者正在添加新节点，则必须提供安装软件包。install_vertica 和 update_vertica 脚本会按顺序将服务器软件包复制到其他节点并安装该软件包。

提示

如果安装或升级大量节点，请考虑在所有节点上手动安装该软件包，然后再运行升级脚本，因为如果脚本不需要按顺序在每个节点上传并安装软件包，其运行速度将会更快。

\--spread-logging -w

配置 spread，以将日志记录输出到 /opt/vertica/log/spread_hostname.log。此选项不适用于升级。

注意

除非 Vertica 技术支持要求，否则不要启用 spread 日志记录。

\--ssh-identity file -i file

已经在主机之间配置无密码 ssh 的情况下使用的 root 私钥文件。在使用此选项之前，验证普通 SSH 无需密码也能正常工作。该文件可以是私钥文件（例如 id_rsa）或 PEM 文件。不要与 --ssh-password (-P) 选项配合使用。

Vertica 接受下列做法：

• 通过提供未使用密码保护的 SSH 私钥。使用此方法时，无法使用 sudo 命令运行 install_vertica 脚本。

• 通过提供使用密码保护的私钥和使用 SSH 代理。请注意，sudo 在被调用时，通常会重置环境变量。具体而言，可能会重置 SSH 代理所需的 SSH_AUTHSOCK 变量。因此，请配置系统维护 SSH_AUTHSOCK，或使用与以下类似的方法调用 install_vertica：

  sudo SSH_AUTHSOCK=$SSH_AUTHSOCK /opt/vertica/sbin/install_vertica ...
  

\--ssh-password password -P password

默认用于每个群集主机的密码。如果忽略此选项，并且也不指定 --ssh-identity (-i)，则脚本会根据需要提示输入密码并且不会回显输入。

不要将此选项与 --ssh-identity (-i) 一起使用。

重要

如果以 root 用户身份运行 install_vertica 脚本，请指定 root 密码：

# /opt/vertica/sbin/install_vertica -P <span class="code-variable">root-passwd</span>

如果使用 sudo 命令运行 install_vertica 脚本，请指定运行 install_vertica 的用户的密码，而不是 root 密码。例如，如果 dbadmin 用户使用 sudo 运行 install_vertica，并且密码为 dbapasswd，则将密码指定为 dbapasswd：

$ sudo /opt/vertica/sbin/install_vertica -P <span class="code-variable">dbapasswd</span>

\--temp-dir directory

用于管理用途的临时目录。如果是 /opt/vertica 内的目录，则由安装程序创建。否则，群集中的所有节点上都应该已经存在该目录。该位置应允许 dbadmin 写入权限。

注意

这不是数据库的临时数据位置。

默认值： /tmp