Oracle® Solaris Cluster 参考手册

退出打印视图

更新时间: 2014 年 7 月,E51743-01
 
 

scinstall (1M)

名称

scinstall - 初始化 Oracle Solaris Cluster 软件并建立新的群集节点

用法概要

/usr/cluster/bin/scinstall -i -F [-C clustername] 
     [-T authentication-options] [-o]] [-A adapter-options] 
     [-B switch-options] [-m cable-options] [-w netaddr-options]
/usr/cluster/bin/scinstall -i -N cluster-member [-C clustername] 
     [-A adapter-options] [-B switch-options] [-m cable-options]
/usr/cluster/bin/scinstall -c net-image-source -U password-file 
     -h nodename -n nodeip-mac-options -W software-specs -F 
     [-C clustername] [-T authentication-options [-A adapter-options] 
     [-B switch-options] [-m cable-options] [-w netaddr-options]
/usr/cluster/bin/scinstall -c net-image-source -U password-file 
     -h nodename -n nodeip-mac-options -W software-specs 
     -N cluster-member [-C clustername] [-A adapter-options] 
     [-B switch-options] [-m cable-options]
/usr/cluster/bin/scinstall -c archive=archive-location[::cert=cert-file::
     key=key-file],action=initial -U password-file -h nodename
     -n nodeip-mac-options -F [-C clustername] [-f hostnames-map-file]
     [-T authentication-options] [-A adapter-options] 
     [-B switch-options] [-m cable-options] [-o] [-w netaddr-options]
/usr/cluster/bin/scinstall -c archive=archive-location[::cert=cert-file::
     key=key-file],action=initial -U password-file -h nodename
     -n nodeip-mac-options -N cluster-member [-C clustername] [-f hostnames-map-file]
     [-T authentication-options] [-A adapter-options] 
     [-B switch-options] [-m cable-options] [-o] [-w netaddr-options]
/usr/cluster/bin/scinstall -c archive=archive-location[::cert=cert-file::
     key=key-file],action=restore -h nodename [-F[-o]]
     -C clustername -n nodeip-mac-options [-T secureAI=yes]
/usr/cluster/bin/scinstall -c archive=archive-location[::cert=cert-file::
     key=key-file],action=replicate -h nodename [-F[-o]] 
     -C clustername -n nodeip-mac-options
     [-T node=archive-source-node::node-to-install[,...] [,secureAI=yes]
     [-f hostnames-map-file] [-w netaddr-options] -U password-file
/usr/cluster/bin/scinstall -u upgrade-modes [upgrade-options]
/usr/cluster/bin/scinstall -u update upgrade-options [pkg_fmri_pattern ...]
/usr/cluster/bin/scinstall -r [-N cluster-member]
scinstall -p [-v]

描述


注 -  Oracle Solaris Cluster 软件包括面向对象的命令集。虽然 Oracle Solaris Cluster 软件仍支持原始的命令集,但是 Oracle Solaris Cluster 过程文档仅使用面向对象的命令集。有关面向对象的命令集的更多信息,请参见 Intro(1CL) 手册页。

scinstall 命令可执行许多 Oracle Solaris Cluster 节点创建和升级任务,如下所述。

  • scinstall 的“初始化”格式 (–i) 将建立一个节点,作为新的 Oracle Solaris Cluster 配置成员。此格式将在新的群集中建立第一个节点 (–F),或者向现有群集添加一个节点 (–N)。应始终从创建群集的节点或者要添加到群集中的节点运行 scinstall 命令的此格式。

  • scinstall 的“添加安装客户机”格式 (–c) 可以建立指定的 nodename,将其作为运行该命令的自动化安装程序 (Automated Installer, AI) 安装服务器上的定制 AI 客户机。应始终从 AI 安装服务器运行 scinstall 命令的此格式。

  • scinstall 的“删除”格式 (–r) 可以从群集节点中删除群集配置信息并卸载 Oracle Solaris Cluster 软件。

  • scinstall 的“升级”格式 (–u) 具有多种模式和选项,可以升级 Oracle Solaris Cluster 节点。应始终从要升级的节点运行 scinstall 命令的此格式。

  • scinstall 的“显示发行版”格式 (–p) 可以显示从中运行该命令的节点上安装的 Oracle Solaris Cluster 软件的发行版和软件包版本信息。

如果不指定选项,scinstall 命令将尝试在交互模式下运行。

应该以超级用户的身份运行 scinstall 命令的所有格式(“显示发行版”格式 (–p) 除外)。

ha-cluster/system/install 软件包包括 scinstall 命令的副本。

只能从全局区域运行此命令。

选项

基本选项

下列选项控制了该命令的基本格式和功能。

不能在同一命令行上组合使用下列选项。

–c

指定 scinstall 命令的“添加安装客户机”格式。此选项会建立指定的 nodename,作为发出该命令的自动化安装程序 (Automated Installer, AI) 服务器上的定制 AI 客户机。此 –c 选项接受以下两种规范:-c net-image-source-c archive=archive-location[::cert=cert-file::key=key-file],action={initial/restore|replicate}.

仅可以在全局区域中使用此选项。

在使用 AI 从 IPS 系统信息库安装 Oracle Solaris 和 Oracle Solaris Cluster 软件包并配置新群集时,必须指定 net-image-source。它可以是基于群集节点的体系结构(SPARC 或 i386),您可从中检索 install-imagesolaris-auto-install IPS 软件包的系统信息库:

-c publisher=repo[::cert=cert-file=key-file],arch={sparc|i386}

net-image-source 也可以是 Oracle Solaris 发行版的 AI ISO 映像文件。该文件必须可从已经建立且配置为安装群集节点的 AI 服务器访问:-c iso-file

在使用统一归档文件自动安装群集或恢复群集节点时,使用 archive=archive-location,action={initial|restore|replicate} 命令。此命令指定统一归档文件的位置,并且可以是文件系统上能够从 AI 服务器、HTTP 位置或 HTTPS 位置访问的归档文件的完整路径。如果要访问 HTTPS 位置,必须指定 SSL 密钥和证书文件。您还必须指定归档文件的预定用途:是配置新群集 (action=initial)、恢复节点 (action=restore) 还是从具有相同硬件配置的现有群集复制一个新群集 (action=replicate)。在使用 restore 操作时,归档文件必须属于以前在要恢复的同一个节点上创建的归档文件的恢复类型。

此命令格式有助于将每个群集节点(或 nodename)建立为已建立的自动化安装程序安装服务器上的定制 AI 客户机,从而可以通过 AI 服务器实现完全自动化的群集安装。

对于 Oracle Solaris Cluster,可以定制 AI 清单文件。请参见Oracle Solaris Cluster 软件安装指南 中的如何安装和配置 Oracle Solaris 和 Oracle Solaris Cluster 软件(IPS 系统信息库)安装 Oracle Solaris 11.2 系统

在使用 scinstall 命令将某个节点设置为定制 Oracle Solaris Cluster AI 客户机之前,必须先建立 AI 安装服务器。有关设置 AI 安装服务器的更多信息,请参见 安装 Oracle Solaris 11.2 系统 中的第 8  章 设置 AI 服务器

–i

指定 scinstall 命令的“初始化”格式。此命令格式将会建立一个节点作为新的群集成员。该新节点就是您从中发出 scinstall 命令的节点。

仅可以在全局区域中使用此选项。

如果将 –F 选项与 –i 一起使用,scinstall 会将节点建立为新群集中的第一个节点。

如果将 –o 选项与 –F 选项一起使用,scinstall 将会建立单节点群集。

如果将 –N 选项与 –i 一起使用,scinstall 会将节点添加到现有的群集。

–p

显示从中运行该命令的节点上安装的 Oracle Solaris Cluster 软件的发行版和软件包版本信息。只有这种格式的 scinstall 才不需要以超级用户的身份运行。

仅可以在全局区域中使用此选项。

–r

删除群集配置信息并从群集节点卸载 Oracle Solaris Cluster 框架和数据服务软件。然后,可以从群集中重新安装节点或删除节点。必须在您要卸载的节点上,从群集软件未占用的目录中运行该命令。该节点必须处于非群集模式。

仅可以在全局区域中使用此选项。

–u

在从中调用 scinstall 命令的节点上升级 Oracle Solaris Cluster 软件。scinstall 的升级格式有多种操作模式,具体由 upgrade-mode 指定。有关特定于您要执行的升级类型的信息,请参见下面的“升级选项”。

仅可以在全局区域中使用此选项。

附加选项

您可以将附加选项与基本选项结合使用,以修改每种命令格式的默认行为。有关其中哪些选项能够合法地与哪些 scinstall 命令格式结合使用的更多详细信息,请参阅“用法概要”部分。

支持下列附加选项:

–h nodename

指定节点名称。–h 选项只有与命令的“添加安装客户机”(–c) 格式结合使用时才合法。

nodename 是要为定制 AI 安装设置的群集节点(即 AI 安装客户机)的名称。

–v

以详细模式显示发行版信息。–v 选项只有与命令的“显示发行版”(–p) 格式结合使用时才合法,可用于指定详细模式。

在“显示发行版”的详细模式下,还会显示安装的每个 Oracle Solaris Cluster 软件包的版本字符串。

–F [config-options]

在群集中建立第一个节点。–F 选项只有与命令的“初始化”(–i) 或“添加安装客户机”(–c) 格式结合使用时才合法。

在第一个节点已完全实例化为群集成员,并已准备好执行所有与添加新群集节点关联的必要任务之前,将会阻止建立辅助节点。如果将 –F 选项与 –o 选项一起使用,则会在群集创建过程中创建一个单节点群集,且无法添加任何其他节点。

–f hostnames-map-file

指定包含旧主机名和新主机名对列表的文本文件,这些主机名对将用来从其他群集来复制群集,或者将一个恢复归档文件与 initial 操作一起使用来构建一个全新的群集。该文件可以包含多行,每行包含两列。第一列是在其中创建归档文件的源群集中所使用的主机名或 IP 地址。第二列是新群集的对应主机名或 IP 地址。这些主机名可以用于逻辑主机名、共享地址资源或区域群集。

source-cluster-zc-hostname1          target-cluster-zc-hostname1
source-cluster-zc-hostname2          target-cluster-zc-hostname2
source-cluster-lh1          target-cluster-lh1
source-cluster-lh2          target-cluster-lh2

仅可以在全局区域中使用此选项。

–N cluster-member [ config-options]

指定群集成员。–N 选项只有与命令的“初始化”(–i)、“添加安装客户机”(–c) 或“删除”(–r) 格式结合使用时才合法。

–i–c 选项一起使用时,–N 选项将用于向现有群集添加其他节点。指定的 cluster-member 通常是为群集建立的第一个群集节点的名称。但是,cluster-member 可以是已作为群集成员参与的任何群集节点的名称。正在初始化的节点将被添加到 cluster-member 已是其活动成员的群集。将新节点添加到现有群集的过程包括更新指定的 cluster-member 上的配置数据,以及在新节点的本地文件系统上创建配置数据库的副本。

–r 选项一起使用时,–N 选项将会指定 cluster-member,这可以是群集中作为活动群集成员的其他任何节点。scinstall 命令将会联系指定的 cluster-member,以便对群集配置进行更新。如果不指定 –N 选项,scinstall 将会尽量尝试找到可联系的现有节点。

配置选项

config-options–F 选项一起使用。

/usr/cluster/bin/scinstall{–i | –c net-image-source –U password-file –h nodename -n nodeip-mac-options -W software-spec} –F [–C clustername] [–T authentication-options] [–A adapter-options] [–B switch-options] [–m endpoint=[this-node]:name[@port],endpoint= [node:]name[@port]] [–o] [–w netaddr-options]
/usr/cluster/bin/scinstall {–i | –c net-image-source –U password-file –h nodename -n nodeip-mac-options -W software-spec} –N cluster-member [–C clustername] [–A adapter-options] [–B switch-options] [–m endpoint=cable-options]
–m cable-options

指定群集互连连接。仅当同时指定了 –F–N 选项时,该选项才合法。

–m 选项可以通过配置用于连接群集传输适配器和交换机上各个端口的电缆,来帮助建立群集互连拓扑。使用此命令格式配置的每条新电缆将在当前节点上的群集传输适配器与群集传输交换机上的某个端口,或者群集中另一个现有节点上的某个适配器之间建立连接。

如果不指定 –m 选项,scinstall 命令将尝试配置默认电缆。但是,如果使用 scinstall 的某个给定实例配置了多个传输适配器或交换机,scinstall 将无法构建默认设置。默认设置是配置一条从单独配置的传输适配器到单独配置(或默认)的传输交换机的电缆。

–m cable-options 如下所示。

–m endpoint=[this-node]:
name[@port],endpoint=[
node:]name[@port]

–m 选项的语法表明,在两个端点中,必须至少有一个是要配置的节点上的适配器。对于该端点,不需要明确指定 this-node。下面是添加电缆的示例:

–m endpoint=:net1,endpoint=switch1

在本示例中,该节点(即 scinstall 要配置的节点)上的 net1 传输适配器的端口 0 已通过电缆连接到传输交换机 switch1 上的某个端口。switch1 上使用的端口号默认为该节点的节点 ID 号。

对于出现的每个 –m 选项,必须始终指定两个 endpoint 选项。选项参数的 name 组成部分用于指定电缆某一个端点上的群集传输适配器或群集传输交换机的名称。

  • 如果指定 node 组成部分,则 name 将是传输适配器的名称。

  • 如果不指定 node 组成部分,则 name 将是传输交换机的名称。

如果不指定 port 组成部分,scinstall 命令将尝试采用默认端口名称。适配器的默认 port 始终为 0。交换机端点的默认端口 name 等于要添加到群集的节点的节点 ID。

有关 port 分配和其他要求的更多信息,请参阅 clinterconnect(1CL) 手册页。

必须先配置电缆两个端点上的适配器和/或交换机(参见 –A–B),然后才能配置电缆。

–n nodeip-mac-options

指定节点的 IP 地址和 MAC 地址。仅当同时指定了 –c 选项时,该选项才合法。

–n nodeip-mac-options 的语法如下所示:

-n ip=node-ipaddr/N,mac=
mac-address
–o

指定单节点群集的配置。仅当同时还指定了 –i–F 选项时,该选项才合法。

其他 –F 选项也受支持,但不是必需的。如果未指定群集名称,则会将节点名称用作群集名称。可以指定传输配置选项,这些选项将存储在 CCR 中。建立单节点群集后,不必配置法定设备或禁用 installmode

–w netaddr-options

指定用于专用互连或群集传输的网络地址。仅当同时指定了 –F 选项时,该选项才合法。

使用该选项可以指定要在专用互连上使用的专用网络地址。当默认的专用网络地址与企业中已用的某个地址发生冲突时,可以使用该选项。还可以使用该选项来定制预留给专用互连使用的 IP 地址范围的大小。有关更多信息,请参见 networks(4)netmasks(4) 手册页。

如果不指定该选项,用于专用互连的默认网络地址将为 172.16.0.0。默认网络掩码为 255.255.240.0。此 IP 地址范围最多支持 62 个节点、10 个专用网络、12 个区域群集以及三个独占 IP 区域群集。

–w netaddr-options 如下所示:


–w netaddr=netaddr[,netmask=
netmask]
–w netaddr=netaddr[,maxnodes=
nodes,maxprivatenets=maxprivnets,\
numvirtualclusters=zoneclusters, numxipvirtualclusters=
xipzoneclusters]
–w netaddr=netaddr[,netmask=
netmask,maxnodes=nodes,\maxprivatenets=
maxprivnets\
,numvirtualclusters=zoneclusters]
netaddr=netaddr

指定专用网络地址。此地址的最后两个八位字节必须始终为零。

[netmask=netmask]

指定网络掩码。指定的值必须提供大于或等于默认值的 IP 地址范围。

要分配一个小于默认值的 IP 地址范围,请指定 maxnodesmaxprivatenetsnumvirtualclusters 操作数。

[,maxnodes=nodes,maxprivatenets= maxprivnets,numvirtualclusters=zoneclusters ]

指定群集曾预期包含的最大节点数、专用网络数和区域群集数。该命令使用这些值来计算专用互连支持指定数目的节点、专用网络和区域群集所需的最小网络掩码。nodes 的最大值是 62,最小值是 2。maxprivnets 的最大值为 128,最小值为 2。可以对 zoneclusters 设置 0 值。

[,netmask=netmask,maxnodes= nodes,maxprivatenets=maxprivnets\ ,numvirtualclusters=zoneclusters]

指定网络掩码以及群集曾预期包含的最大节点数、专用网络数和区域群集数。必须指定一个足以容纳指定数量的 nodesprivnetszoneclusters 的网络掩码。nodes 的最大值是 62,最小值是 2。privnets 的最大值是 128,最小值是 2。可以为 zoneclusters 设置 0 值。

如果仅指定 netaddr 子选项,该命令将分配默认网络掩码 255.255.240.0。生成的 IP 地址范围最多可容纳 62 个节点、10 个专用网络和 12 个区域群集。

建立群集后,若要更改专用网络地址或网络掩码,请使用 cluster 命令或 clsetup 实用程序。

–A adapter-options

指定传输适配器以及(可选)传输类型。仅当同时指定了 –F–N 选项时,该选项才合法。

每指定一个 –A 选项,就会配置一个连接到运行 scinstall 命令的节点的群集传输适配器。

如果未指定 –A 选项,则会尝试使用默认的适配器和传输类型。默认的传输类型为 dlpi。在 SPARC 平台上,默认的适配器为 hme1

如果适配器传输类型为 dlpi,则无需指定 trtype 子选项。在这种情况下,您可以使用下列两种格式之一来指定 –A adapter-options


–A [trtype=type,]name=adaptername[,vlanid=
vlanid][,other-options]
–A adaptername
[trtype=type]

指定适配器的传输类型。请将 trtype 选项与每个要指定适配器传输类型的 –A 选项一起使用。dlpi 就是一个传输 type 示例。

默认的传输类型为 dlpi

name=adaptername

指定适配器名称。要指定 adaptername,必须将 name 子选项与出现的每个 –A 选项一起使用。adaptername 的构造方式为 device name 后面紧跟 physical-unit 编号,例如 hme0

如果未随 –A 选项指定其他子选项,可以将 adaptername 指定为 –A 选项的独立参数(即 –A adaptername)。

vlanid=vlanid

指定带标记的 VLAN 适配器的 VLAN ID。

[other-options]

指定其他适配器选项。如果某个特定适配器提供其他任何选项,则可以使用 –A 选项指定这些选项。

–B switch-options

指定传输交换机(又称为传输结点)。仅当同时指定了 –F–N 选项时,该选项才合法。

每指定一个 –B 选项,就会配置一个群集传输交换机。这种设备的示例包括但不限于以太网交换机、其他各种类型的交换机和环网。

如果不指定 –B 选项,将第一个节点实例化为群集节点时,scinstall 将会尝试添加默认交换机。默认情况下,当您将其他节点添加到群集时,不会添加任何其他交换机。但是,您可以明确添加这些交换机。默认交换机的名称为 switch1,类型为 switch

如果交换机类型为 switch,则无需指定 type 子选项。在这种情况下,您可以使用下列两种格式之一来指定 –B switch-options

-B [type=type,]name=name[,
other-options]
-B name

如果某个群集传输交换机已配置为指定的交换机 name,则 scinstall 会显示消息并忽略 –B 选项。

如果使用直接以电缆连接的传输适配器,则不需要配置任何传输交换机。为避免配置默认传输交换机,请使用以下特殊 –B 选项:

–B type=direct
[type=type]

指定传输交换机类型。可以将 type 选项与出现的每个 –B 选项一起使用。以太网交换机就是类型为 switch 的群集传输交换机的示例。有关更多信息,请参见 clinterconnect(1CL) 手册页。

可以将 type 子选项指定为 direct,以抑制对任何默认交换机进行配置。仅包括直连传输适配器的传输配置中不存在交换机。如果 type 子选项设置为 direct,则无需使用 name 子选项。

name=name

指定传输交换机名称。除非 typedirect,否则,必须将 name 子选项与出现的每个 –B 选项一起使用才能指定传输交换机 namename 的长度最多可为 256 个字符,由字母或数字组成,第一个字符为字母。每个传输交换机名称在群集名称空间中必须唯一。

如果不需要将其他子选项与 –B 一起使用,可以将交换机 name 指定为 –B 的独立参数(即 –B name)。

[other-options]

指定其他传输交换机选项。如果某个特定交换机类型提供其他选项,则可以使用 –B 选项指定这些选项。有关可以用于交换机的任何特殊选项的信息,请参阅 clinterconnect(1CL) 手册页。

–C clustername

指定群集的名称。仅当同时指定了 –F–N 选项时,该选项才合法。

  • 如果配置的节点是新群集中的第一个节点,则默认的 clustername 与您配置的节点的名称相同。

  • 如果您配置的节点正被添加到现有群集,则默认的 clusternamecluster-member 所属的群集的名称。

如果指定的 clustername 不同于 cluster-member 所属的群集的名称,则会出现错误。

–T authentication-options

指定群集的节点验证选项。仅当同时指定了 –F 选项时,该选项才合法。

使用该选项可为尝试将自身添加到群集配置的节点建立验证策略。具体而言,就是当某台计算机请求将自身作为群集节点添加到群集时,执行检查以确定该节点是否有权加入。如果请求加入的节点具有权限,则该节点将通过验证,并可以加入群集。

设置群集中的第一个节点时,只能将 –T 选项与 scinstall 命令一起使用。如果需要在已建立的群集上更改验证列表或策略,请使用 claccess 命令。

默认设置是允许任何计算机将自身添加到群集。

–T authentication-options 如下所示。

–T node=nodename[,…][,authtype=authtype][,secureAI=yes]
–T node=archive-source-node::node-to-install[,…][,authtype=authtype][,secureAI=yes]
–T secureAI=yes
node=nodename[,…]

指定要添加到节点验证列表的节点名称。对于要复制的所有节点必须指定节点对。必须为 –T 选项至少指定一个 node 子选项。该选项用于将节点名称添加到可将自身配置为群集中节点的节点的列表。如果验证列表为空,任何节点都可以请求将自身添加到群集配置。但是,如果列表至少包含一个名称,将会使用验证列表验证所有这种请求。您随时可以使用 claccess 命令或 clsetup 实用程序从某一个活动的群集节点修改或清除此节点列表。

node=archive-source-node::node-to-install[,…]

node=archive-source-node::node-to-install 选项指定节点名称对。第一个节点名称是在其中创建归档文件的节点,第二个节点名称是要从该归档文件安装的新群集中的节点。只有当从一个群集上所创建的归档文件复制其他群集时才使用此规范,新群集节点的硬件配置必须与在其中创建归档文件的源群集节点的硬件配置相同(或者是源群集节点的硬件配置的超集)。

[authtype=authtype]

initialize -iadd install client -c 格式(在使用 net-image-source 时)格式的 scinstall 群集配置指定节点验证类型。当前支持的 authtype 只有 dessys(或 unix)。如果不指定 authtype,默认值为 sys

您可以根据需要指定 des (Diffie-Hellman) 验证,先将条目加入到每个要添加的群集节点的 publickey(4) 数据库,然后运行 scinstall 命令的 –T 选项。

您随时可以使用 claccess 命令或 clsetup 实用程序从某一个活动的群集节点更改验证类型。

[secureAI=yes]

指定使用 AI 安全安装,仅当使用 AI 安装群集软件时有效。如果没有指定 secureAI=yes,默认操作是执行传统 AI 安装。在使用安全安装方法从归档文件恢复节点时,只需指定 -T secureAI=yes。不需要指定 node=nodename[,...]authtype=authtype

–U password-file

指定包含 root 用户密码的文件的名称。仅当同时指定了 –c 选项时,该选项才合法。

在 Oracle Solaris 的初始安装和配置期间,该选项可以实现 root 用户密码的自动设置。用户将创建一个文件,其中包含用作所安装系统的 root 用户密码的文本。通常,password-file 位于已经建立的 AI 安装服务器上,或者可以通过该服务器访问。该服务器已配置用于安装 nodename 安装客户机。scinstall 实用程序将会检索该文件的内容,并将这些内容提供给 Oracle Solaris 配置实用程序。

–W software-specs

指定一个或多个发行者和软件包系统信息库的位置。此外,还指定使用 AI 安全安装所需的公钥和 SSL 证书信息。此选项仅在将 –c 选项指定为从 IPS 系统信息库安装时才合法。

–W software-specs 如下所示:

–W publisher=
repo[::key=
key-file::cert=certificate-file] \
::pkg[,…][:::
publisher=repo[::key=key-file::cert=
certificate-file]::pkg[,…]]…

请注意,为方便阅读,–W 选项跨多行显示,不过您应该使用一个未换行的字符串指定该选项。

–W 选项语法中,publisher 是发布者名称 ha-clustersolarisrepo 是系统信息库位置,key-filecertificate-file 是通过 HTTPS 系统信息库安全安装所需的公钥和 SSL 证书信息,pkg 是软件包名称。

要使用安全的 HTTPS 系统信息库安装 Oracle Solaris 或 Oracle Solaris Cluster,您需要提供公钥和 SSL 证书的信息。您可以从 http://pkg-register.oracle.com 站点请求和下载公钥和 SSL 证书。

升级选项

用于标准(非滚动)升级、滚动升级和双分区升级的 –u upgrade-modesupgrade-options 如下所述。

标准(非滚动)和滚动升级

使用 –u update 模式可以在标准(非滚动)升级或滚动升级模式下,将群集节点升级到更高的 Oracle Solaris Cluster 软件发行版。

  • 标准(或非滚动)升级过程可以升级某个非活动的引导环境 (boot environment, BE),同时,您的群集节点可继续为群集请求提供服务。如果未指定现有的非活动 BE,scinstall 实用程序将自动创建一个新 BE。完成升级后,scinstall 实用程序将激活升级的 BE,并通知用户将节点重新引导至升级后的 BE 中。

  • 滚动升级过程一次只会使一个群集节点脱离生产环境。此过程只能用于将 Oracle Solaris 和/或 Oracle Solaris Cluster 软件升级到已安装版本的更新发行版。当您升级某个节点时,群集服务将继续在其余群集节点上运行。升级某个节点后,您可以将它重新加入群集,并针对要升级的下一个节点重复该过程。升级所有节点后,必须对某一个群集节点运行 scversions 命令,以将群集提升到升级版本。在运行此命令之前,更新发行版中引入的某些新功能可能不可用。

  • (可选)可以指定当前映像中已经安装的软件包 FMRI。

适用于标准和滚动模式的 –u updateupgrade-options 如下所示。

/usr/cluster/bin/scinstall -u update [–b be-name] [–L {accept | licenses | accept,licenses | licenses,accept}] [pkg_fmri_pattern ...]
–b be-name

指定要分配给新引导环境 (boot environment, BE) 的名称。如果不指定该选项,scinstall 将为新 BE 分配名称。该名称基于当前 BE 的名称,格式为 currentBE-N,其中后缀 -N 是一个递增编号。第一个新 BE 的名称为 currentBE-1,第二个新 BE 的名称为 currentBE-2,依此类推。如果删除了某个 BE,并且存在一个后缀编号更大的 BE 名称,那么,已删除 BE 的名称不会留给下一个新 BE 重新使用。例如,如果存在 BE sc4.0sc4.0-1sc4.0-2,而 sc4.0-1 已被删除,那么,下一个新 BE 的名称将是 sc4.0-3

如果指定的 BE 名称已存在,则命令将会退出并显示一个错误。

–L {accept | licenses | accept,licenses | licenses,accept }

指定是否接受和/或显示所升级到的软件包的许可证。

accept 参数对应于 pkg 命令的 --accept 选项,licenses 参数对应于 --licenses 选项。

指定 –L accept 选项表示您同意并接受所更新的软件包的许可证。如果有任何软件包要求接受许可证,而您未提供该选项,更新操作将失败。

指定 –L licenses 显示所更新的软件包的所有许可证。

如果在 –L 选项中同时指定了 acceptlicenses,将显示并接受所更新的软件包的许可证。指定 acceptlicenses 参数的顺序不会影响该命令的行为。

scinstall -u update 命令支持为要更新的软件包指定 pkg_fmri_patterns

[pkg_fmri_pattern...]

指定要更新的软件包。当前的映像中必须已安装这些软件包。如果所提供的 pkg_fmri_pattern 模式中包含星号 (*),则会更新当前映像中安装的所有软件包。

双分区升级

用于双分区升级的 –u upgrade-modesupgrade-options 可以执行双分区升级的多个阶段。在双分区升级过程中,首先是将群集节点分成两个组或两个分区。接下来,在升级一个分区的同时,另一个分区提供群集服务。然后,将服务切换到已升级的分区,升级剩余的分区,将第二个分区中已升级的节点重新加入由升级的第一个分区构成的群集。用于双分区升级的 upgrade-modes 还包括在双分区升级期间发生故障后的恢复模式。

双分区升级模式与 –u update 升级模式一起使用。有关更多信息,请参见Oracle Solaris Cluster Upgrade Guide

用于双分区升级的 –u upgrade-modesupgrade-options 如下所示:

/usr/cluster/bin/scinstall -u begin -h nodelist
/usr/cluster/bin/scinstall -u plan
/usr/cluster/bin/scinstall -u recover
/usr/cluster/bin/scinstall -u status
/usr/cluster/bin/scinstall -u apply
/usr/cluster/bin/scinstall -u status
apply

指定一个分区的升级已完成。在已升级的分区中的所有节点都升级后,在该分区中的任意节点上运行这种格式的命令。

apply 升级模式执行以下任务:

第一个分区

从第一个分区中的节点上运行时,apply 升级模式会使第一个分区中的所有节点准备好运行新软件。

当第一个分区中的节点准备好支持群集服务时,该命令会在第二个分区中的节点上远程执行脚本 /etc/cluster/ql/cluster_pre_halt_apps/etc/cluster/ql/cluster_post_halt_apps。这些脚本用于调用用户编写的脚本,这样可以停止不受资源组管理器 (Resource Group Manager, RGM) 控制的应用程序,例如 Oracle Real Application Clusters (Oracle RAC)。

  • cluster_pre_halt_apps 脚本在受 RGM 控制的应用程序停止之前运行。

  • cluster_post_halt_apps 脚本在受 RGM 控制的应用程序停止之后、节点停止之前运行。


注 -  运行 apply 升级模式之前,请根据需要修改脚本模板,以调用您编写的其他脚本来停止节点上的某些应用程序。将修改后的脚本以及修改后的脚本调用的用户编写的脚本放在第一个分区中的每个节点上。这些脚本将从第一个分区中的任意一个节点上运行。要停止在第一个分区中多个节点上运行的应用程序,请相应地修改用户编写的脚本。未修改的脚本不执行任何默认操作。

第二个分区上的所有应用程序均停止后,该命令会停止第二个分区中的节点。关闭操作会启动切换,将应用程序和数据服务切换到第一个分区中的节点。然后,该命令将第二个分区中的节点引导到群集模式。

如果某个资源组由于其节点列表仅包含第一个分区的成员而脱机,则该资源组将重新联机。如果某个资源组的节点列表中没有属于第一个分区的节点,则该资源组仍处于脱机状态。

第二个分区

从第二个分区中的节点上运行时,apply 升级模式会使第二个分区中的所有节点准备好运行新软件。然后,该命令将节点引导到群集模式。第二个分区中的节点重新加入由第一个分区中的节点构成的活动群集。

如果某个资源组由于其节点列表仅包含第二个分区的成员而脱机,则该资源组将重新联机。

所有节点均重新加入群集后,该命令将执行最终处理,重新配置法定设备,并恢复法定投票计数。

begin

指定要分配给您升级的第一个分区的节点,并启动双分区升级过程。从群集中的任意节点上运行这种格式的命令。在使用 plan 升级模式后使用此升级模式,可以确定可能的分区方案。

首先,begin 升级模式记录要分配给每个分区的节点。接下来,在一个节点上停止所有应用程序,然后升级模式关闭该节点。关闭操作会启动切换,将该节点上的每个资源组切换到属于第二个分区的节点上,前提是该节点在资源组节点列表中。如果某个资源组的节点列表中没有属于第二个分区的节点,则该资源组仍处于脱机状态。

然后,该命令在第一个分区中剩余的每个节点上重复这一系列操作,一次处理一个节点。

在第一个分区升级期间,第二个分区中的节点一直正常运行。法定设备暂时不配置,法定投票计数在节点上暂时发生变化。

plan

查询群集存储配置,并显示满足共享存储要求的所有可能的分区方案。从群集中的任意节点上运行这种格式的命令。这是您在双分区升级过程中运行的第一个命令。

双分区升级要求每个共享存储阵列都必须至少可由每个分区中的一个节点进行物理访问。

plan 升级模式可以返回零个、一个或多个分区解决方案。如果未返回任何解决方案,则群集配置不适合双分区升级。请改用标准升级方法。

对于任何分区解决方案,您都可以选择任一分区组作为要升级的第一个分区。

recover

如果在双分区升级过程中出现致命错误,请恢复节点上的群集配置。在群集中的每个节点上运行这种格式的命令。

您必须在运行该命令之前关闭群集并将所有节点引导到非群集模式。

一旦发生致命错误,即使在运行 recover 升级模式后,也无法恢复或重新启动双分区升级。

recover 升级模式可以将群集配置系统信息库 (Cluster Configuration Repository, CCR) 数据库恢复到双分区升级开始之前的原始状态。

以下列表描述在哪些情况下使用 recover 升级模式,以及在哪些情况下执行其他步骤。

  • 如果在 –u begin 处理过程中发生故障,请运行 –u recover 升级模式。

  • 如果在 –u begin 处理完成之后、发出第二个分区的关闭警告之前发生故障,请确定出错的位置:

    • 如果在第一个分区中的某个节点上发生故障,请运行 –u recover 升级模式。

    • 如果在第二个分区中的某个节点上发生故障,则无需执行任何恢复操作。

  • 如果在发出第二个分区的关闭警告之后、第二个分区上开始 –u apply 处理过程之前发生故障,请确定出错的位置:

    • 如果在第一个分区中的某个节点上发生故障,请运行 –u recover 升级模式。

    • 如果在第二个分区中的某个节点上发生故障,请将发生故障的节点重新引导到非群集模式。

  • 如果在第二个分区上完成 –u apply 处理过程之后、升级完成之前发生故障,请确定出错的位置:

    • 如果在第一个分区中的某个节点上发生故障,请运行 –u recover 升级模式。

    • 如果在第一个分区中的某个节点上发生故障,但是第一个分区一直在提供服务,请重新引导发生故障的节点。

    • 如果在第二个分区中的某个节点上发生故障,请运行 –u recover 升级模式。

在所有情况下,您都可以采用标准升级方法继续手动升级,该操作要求关闭所有群集节点。

status

显示双分区升级的状态。可能的状态如下所示:

Upgrade is in progress

scinstall -u begin 命令已运行,但是双分区升级尚未完成。

如果在双分区升级过程中出现致命错误,群集也会报告该状态。在这种情况下,即使在执行恢复过程并采用标准升级方法完成群集升级后,该状态也不会清除

Upgrade not in progress

尚未发出 scinstall -u begin 命令,或者双分区升级已成功完成。

从群集中的一个节点上运行 status 升级模式。节点可以处于群集模式或非群集模式。

无论发出命令的节点处于双分区升级过程中的哪个阶段,报告的状态对于群集中的所有节点都有效。

双分区升级模式支持以下选项:

–h nodelist

指定您分配给第一个分区的所有节点的空格分隔列表。您应从 plan 升级模式显示的输出中选择这些节点,将其作为您使用的分区方案中某个分区的有效成员。群集中您未指定给 begin 升级模式的其余节点将分配给第二个分区。

该选项仅对于 begin 升级模式有效。

示例

建立双节点群集

以下示例使用 Oracle Solaris Cluster 软件为基于 SPARC 的平台上的 Oracle Solaris 11 建立一个典型的双节点群集。该示例假定 Oracle Solaris Cluster 软件包已安装在节点上。

node1 上,发出以下命令:

node1# /usr/cluster/bin/scinstall -i -F

node2 上,发出以下命令:

node2# /usr/cluster/bin/scinstall -i -N node1

建立单节点群集

以下命令将在接受所有默认值的情况下,使用 Oracle Solaris Cluster 软件为基于 SPARC 的平台上的 Oracle Solaris 11 建立一个单节点群集。该示例假定 Oracle Solaris Cluster 软件包已安装在节点上。

# /usr/cluster/bin/scinstall -i -F -o

在 AI 服务器上添加具有网络映像 ISO 文件的安装客户机

以下示例在某个双节点群集中,为基于 SPARC 的平台上的 Oracle Solaris 11 设置一个 AI 安装服务器,以安装并初始化 Oracle Solaris Cluster 软件。

在安装服务器上,发出以下命令。请注意,为方便阅读,–W 选项跨多行显示,不过您应该使用一个未换行的字符串指定该选项。

# usr/cluster/bin/scinstall –c /export/home/11-ga-ai-x86.iso -h phys-schost-1 \ 
-U /export/pwdfile \ 
-C schost \ 
-F \ 
-W solaris=http://ipkg.us.oracle.com/solaris11/release::\
entire,server_install:::ha-cluster=cluster-repository::\
ha-cluster-framework-full,ha-cluster-data-services-full,
ha-cluster-geo-full \ 
-n ip=10.255.85.163/24,mac=12:34:56:78:90:ab \ 
-T node=phys-schost-1,node=phys-schost-2,authtype=sys \ 
-w netaddr=172.16.0.0,netmask=255.255.240.0,maxnodes=62,\
maxprivatenets=10,numvirtualclusters=12,numxipvirtualclusters=3 \ 
-A trtype=dlpi,name=e1000g1 -A trtype=dlpi,name=nxge1 \ 
-B type=switch,name=switch1 -B type=switch,name=switch2 \ 
-m endpoint=:e1000g1,endpoint=switch1 \ 
-m endpoint=:nge1,endpoint=switch2 

# usr/cluster/bin/scinstall –c /export/home/11-ga-ai-x86.iso -h phys-schost-2 \ 
-U /export/pwdfile \ 
-C schost \ 
-N phys-schost-1 \ 
-W solaris=http://ipkg.us.oracle.com/solaris11/release::\
entire,server_install:::ha-cluster=cluster-repository::\
ha-cluster-framework-full,ha-cluster-data-services-full,\ 
ha-cluster-geo-full \ 
-n ip=10.255.85.164/24,mac=12:34:56:78:90:ab \ 
-A trtype=dlpi,name=e1000g1 -A trtype=dlpi,name=nxge1 \ 
-m endpoint=:e1000g1,endpoint=switch1 \ 
-m endpoint=:nge1,endpoint=switch2

执行双分区升级

以下示例使用双分区方法将某个群集的框架和数据服务软件升级到下一个 Oracle Solaris Cluster 发行版。本例在基于 SPARC 的平台上使用适用于 Solaris 11 的 Oracle Solaris Cluster 版本。本例查询群集的有效分区方案,将节点分配给分区,重新引导第一个分区中的节点,在第一个分区升级后使其恢复正常运行并重新引导第二个分区中的节点,在第二个分区升级后使其返回群集。

# /usr/cluster/bin/scinstall -u plan
  Option 1
    First partition
      phys-schost-1
    Second partition
      phys-schost-2
…
# /usr/cluster/bin/scinstall -u begin -h phys-schost-1 phys-schost-3

ok boot -x
 
(Upgrade the node in the first partition)
 
phys-schost-1# /usr/cluster/bin/scinstall -u apply
ok boot -x
 
(Upgrade the node in the second partition)
 
phys-schost-2# /usr/cluster/bin/scinstall -u apply

升级框架和数据服务软件(标准升级或滚动升级)

以下示例将某个群集的框架和数据服务软件升级到下一个 Oracle Solaris Cluster 发行版。请在每个群集节点上执行这些操作。


注 -  对于滚动升级,请在使用 clnode evacuate 命令将所有资源组和设备组移到要保留在群集中的其他节点之后,一次在一个节点上执行这些操作。
# /usr/cluster/bin/scinstall -u update
# init 6

从归档文件恢复第一个节点

以下示例使用一个安全的 AI 安装从保存在文件系统(可从 AI 服务器访问)上的归档文件恢复第一个节点。

# /usr/cluster/bin/scinstall -c archive=file:///net/storagenode/export/archive
     /phys-schost-1-recovery-archive,action=restore \
-h phys-schost-1 \
-C schost =\
-F \
-n ip=10.255.85.163/24,mac=12:34:56:78:90:ab \
-T secureAI=yes

从归档文件恢复其他节点

以下示例使用一个安全的 AI 安装从以前在其他节点上创建的归档文件恢复这些其他节点。

# /usr/cluster/bin/scinstall -c archive=file:///net/storagenode/export/archive
     /phys-schost-2-recovery-archive,action=restore \
-h phys-schost-2 \
-C schost =\
-n ip=10.255.85.164/24,mac=12:34:56:78:90:cd \
-T secureAI=yes

执行非安全复制

以下示例执行非安全复制。

# /usr/cluster/bin/scinstall -c archive=file:///net/storagenode/export/archive
     /source-node-1-archive,action=replicate \
-h phys-schost-1 \
-C schost \
-F \
-n ip=10.255.85.163/24,mac=12:34:56:78:90:ab \
-T node=phys-schost-1,node=phys-schost-2,secureAI=yes \
-U /export/pwdfile
# /usr/cluster/bin/scinstall -c archive=file:///net/pnass3/export/archive
     /vzono1a.clone,action=replicate \
-h phys-schost-2 \
-C schost \
-n ip=10.255.85.164/24,mac=12:34:56:78:90:cd \
-U /export/pwdfile

在 AI 服务器上添加具有 IPS 系统信息库的安装客户机

下面的几个示例使用一个安全的 AI 安装从 IPS 系统信息库安装和配置双节点 x86 群集。

# /usr/cluster/bin/scinstall -c solaris=http://ipkg.us.oracle.com/solaris11
     /release::arch=i386 -h phys-schost-1 \
-C schost \
-F \
-W solaris=http://ipkg.us.oracle.com/solaris11/release::entire,server_install:::
     ha-cluster=http://ipkg.us.oracle.com/ha-cluster/release::ha-cluster-framework-full \
-n ip=10.255.85.163/24,mac=12:34:56:78:90:ab \
-T node=phys-schost-1,node=phys-schost-2,authtype=sys,secureAI=yes \
-w netaddr=172.16.0.0,netmask=255.255.240.0,maxnodes=32,maxprivatenets=10,
     numvirtualclusters=12,numxipvirtualclusters=3 \
-A trtype=dlpi,name=net1 -A trtype=dlpi,name=net3 \
-B type=switch,name=switch1 -B type=switch,name=switch2 \
-m endpoint=:net1,endpoint=switch1 \
-m endpoint=:net3,endpoint=switch2 \
-P task=quorum,state=INIT -P task=security,state=SECURE \
-U /export/pwdfile
# /usr/cluster/bin/scinstall -c solaris=http://ipkg.us.oracle.com/solaris11
     /release::arch=i386 -h phys-schost-2 \
-C schost \
-N phys-schost-1 \
-W solaris=http://ipkg.us.oracle.com/solaris11/release::entire,server_install:::
     ha-cluster=http://ipkg.us.oracle.com/ha-cluster/release::ha-cluster-framework-full  \
-n ip=10.255.85.164/24,mac=12:34:56:78:90:ab \
-A trtype=dlpi,name=net1 -A trtype=dlpi,name=net3 \
-m endpoint=:net1,endpoint=switch1 \
-m endpoint=:net3,endpoint=switch2 \
-U /export/pwdfile

退出状态

返回以下退出值:

0

成功完成。

non-zero

发生错误。

文件

/etc/cluster/ql/cluster_post_halt_apps

/etc/cluster/ql/cluster_pre_halt_apps

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
可用性
ha-cluster/system/install
接口稳定性
Evolving(发展中)

另请参见

Intro(1CL)claccess(1CL)clinterconnect(1CL)clnode(1CL)clsetup(1CL)cluster(1CL)newfs(1M)scversions(1M)netmasks(4)networks(4)lofi(7D)

Oracle Solaris Cluster 软件安装指南 Oracle Solaris Cluster 系统管理指南 Oracle Solaris Cluster Upgrade Guide