1. 前言

1.1. 读者对象及用途

《EXPRESSCLUSTER® X SingleServerSafe操作指南》的读者对象为导入系统后进行维护和操作的系统管理员，就EXPRESSCLUSTER X SingleServerSafe的操作方法进行说明。

1.2. 本手册的构成

1.3. 本手册记述的术语

为提高与集群软件EXPRESSCLUSTER X SingleServerSafe X 的操作性等方面的兼容性，本手册中介绍的EXPRESSCLUSTER X SingleServerSafe，与之使用了相同的画面及命令。因此，采用了部分集群相关的术语。

请参照下列术语的说明来阅读本手册。

集群，集群系统

导入了EXPRESSCLUSTER X SingleServerSafe的单一服务器的系统

集群关闭/重启

导入了EXPRESSCLUSTER X SingleServerSafe的系统的关闭/重启

集群资源

EXPRESSCLUSTER X SingleServerSafe所使用的资源

集群对象

EXPRESSCLUSTER X SingleServerSafe所使用的各种资源的对象

失效切换组

汇集了EXPRESSCLUSTER X SingleServerSafe所使用的组资源(应用程序，服务等)的组

1.4. EXPRESSCLUSTER X SingleServerSafe 手册体系

EXPRESSCLUSTER X SingleServerSafe的手册分为以下3类。各指南的标题及用途如下所示。

《EXPRESSCLUSTER X SingleServerSafe 安装指南》(Install Guide)

本手册的读者对象为使用了EXPRESSCLUSTER X SingleServerSafe导入系统的系统工程师，对EXPRESSCLUSTER X SingleServerSafe安装工作的步骤进行说明。

《EXPRESSCLUSTER X SingleServerSafe 设置指南》(Configration Guide)

本手册的读者对象为导入使用EXPRESSCLUSTER X SingleServerSafe的系统的系统工程师以及导入系统后进行维护和操作的系统管理员。对EXPRESSCLUSTER X SingleServerSafe构建工作的步骤进行说明。

《EXPRESSCLUSTER X SingleServerSafe 操作指南》(Operation Guide)

本手册的读者对象为导入使用了EXPRESSCLUSTER X SingleServerSafe的系统后，进行维护和操作的系统管理员。手册说明了EXPRESSCLUSTER X SingleServerSafe的操作方法。

1.5. 本手册的标记规则

在本手册中，需要注意的事项，重要的事项以及相关信息等用如下方法标记

注解

表示虽然比较重要，但是并不会引起数据损失或系统以及机器损伤的信息。

重要

表示为避免数据损失和系统，机器损坏所必需的信息。

参见

表示参考信息的位置。

另外，在手册中使用以下标记法。

标记

使用方法

例
[ ]方括号
在命令名的前后，
显示在画面中的字句 (对话框，菜单等) 的前后。
点击[启动]。
[详细信息]对话框

命令行中的[ ]方括号

表示括号内的值可以不予指定(可省)。

clpstat -s [-h host_name]

等宽字体

路径名，命令行，系统输出(消息，提示等)，目录，文件名，函数，参数

c:\Program files\EXPRESSCLUSTER SSS
粗体
表示用户在命令提示符后实际输入的值。
输入以下内容。
clpcl -s -a
斜体
用户将其替换为有效值后输入的项目。

clpstat -s [-h host_name]

EXPRESSCLUSTER X SingleServerSafe 在本手册的图中，为了表示EXPRESSCLUSTER X SingleServerSafe，使用该图标。

1.6. 最新信息来源

关于最新的产品信息，请参考以下Web站点。

https://www.nec.com/global/prod/expresscluste

2. EXPRESSCLUSTER X SingleServerSafe 命令参考

本章中说明了在EXPRESSCLUSTER X SingleServerSafe 中可以使用的命令。

为提高与集群软件EXPRESSCLUSTER X的操作性等方面的兼容性，EXPRESSCLUSTER X SingleServerSafe与之使用了相同的命令。

本章中介绍了以下内容。

2.1. 通过命令行操作

EXPRESSCLUSTER X SingleServerSafe中准备了通过命令提示符执行的多种命令。构筑集群或无法使用Cluster WebUI时很方便。命令行可以进行在Cluster WebUI中可执行的上述种类的操作。

注解

通过查出监视资源异常的设置，在复原对象中指定组资源(应用程序资源，...)，监视资源查出异常时进行复原运行的迁移时(重新启动 -> 最终动作) 请不要执行以下命令或对Cluster WebUI中的服务及组进行控制。

  • 服务的停止/挂起

  • 组的启动/停止

由于监视资源异常而进行复原运行的迁移时执行上述控制，则该组的其它组资源可执行不会停止。
此外，即使处于监视资源异常状态，若执行了最终动作，即可执行上述控制。

2.2. 命令列表

2.3. 显示状态 (clpstat命令)

显示EXPRESSCLUSTER X SingleServerSafe 的状态及设置信息。

命令行
clpstat -s [--long]
clpstat -g
clpstat -m
clpstat -i [--detail]
clpstat --cl [--detail]
clpstat --sv [--detail]
clpstat --grp [<grpname>] [--detail]
clpstat --rsc [<rscname>] [--detail]
clpstat --mon [<monname>] [--detail]
说明

显示EXPRESSCLUSTER X SingleServerSafe的状态及设置信息。

选项
-s
无选项

显示状态。

--long

在最后显示集群名，资源名等名称

-g

显示组。

-m

显示各监视资源的状态。

-i

显示全体的设置信息。

--cl

显示设置信息。

--sv

显示服务器的设置信息。

--grp [<grpname>]

显示组的设置信息。通过指定组名，只能显示指定的组信息。

--rsc [<rscname>]

显示组资源的设置信息。通过指定组资源名，只能显示指定的组资源信息。

--mon [<monname>]

显示监视资源的设置信息。通过指定监视资源名，只能显示指定的监视资源信息。

--detail

通过使用该选项，可以显示更加详细的设置信息。

返回值

0

成功

上述以外

异常
备注

根据配置信息显示选项的不同组合，可以多种形式显示信息。

注意事项
请由具有Administrator权限的用户执行本命令。
没有指定参数或指定了-s参数的情况下，集群名，资源名等名，在中途不会被输出。
错误消息

消息

原因/处理方法

Log in as administrator.

将由具有Administrator权限的用户执行。

Invalid configuration file. Create valid cluster configuration data.

请使用Cluster WebUI创建正确的集群配置信息。

Invalid option.

请指定正确的选项。

Could not connect to the server. Check if the cluster service is active.

请确认EXPRESSCLUSTER服务是否已启动。

Invalid server status.

请确认EXPRESSCLUSTER服务是否已启动。

Server is not active. Check if the cluster service is active.

请确认EXPRESSCLUSTER服务是否已启动。

Invalid server name. Specify a valid server name in the cluster.

请指定集群内正确的服务器名。

Invalid heartbeat resource name. Specify a valid heartbeat resource name in the cluster.

请指定集群内正确的心跳资源名。

Invalid network partition resource name. Specify a valid network partition resource name in the cluster.

请指定集群内正确的网络分区解决资源名。

Invalid group name. Specify a valid group name in the cluster.

请指定集群内正确的组名。

Invalid group resource name. Specify a valid group resource name in the cluster.

请指定集群内正确的组资源名。

Invalid monitor resource name. Specify a valid monitor resource name in the cluster.

请指定集群内正确的监视资源名。

Connection was lost. Check if there is a server where the cluster service is stopped in the cluster.

请确认集群内是否存在EXPRESSCLUSTER服务已停止的服务器。

Invalid parameter.

可执行是命令的参数中设置了非法的值。

Internal communication timeout has occurred in the cluster server. If it occurs frequently, set the longer timeout.
EXPRESSCLUSTER的内部通信中发生了超时。
如果频繁发生超时，请延长内部通信超时。

Internal error. Check if memory or OS resources are sufficient.

请确认是否是内存不足或OS资源不足。

The cluster is not created.

请做成集群的配置文件并上传。

Could not connect to the server. Internal error. Check if memory or OS resources are sufficient.

请确认是否是内存不足或OS资源不足。

Cluster is stopped. Check if the cluster daemon is active.

请确认是否启动了EXPRESSCLUSTER Daemon。

Cluster is suspended. To display the cluster status, use --local option.

集群处于挂起状态。请指定--local选项显示集群状态。

2.4. 操作服务 (clpcl命令)

操作EXPRESSCLUSTER X SingleServerSafe服务。

命令行
clpcl -s
clpcl -t [-w <timeout>] [--apito timeout]
clpcl -r [-w <timeout>] [--apito timeout]
clpcl --return
clpcl --suspend [--force] [-w <timeout>] [--apito timeout]
clpcl --resume
说明

执行EXPRESSCLUSTER X SingleServerSafe服务的启动，停止，复归，暂停，复原等命令。

选项
-s

启动EXPRESSCLUSTER X SingleServerSafe服务。

-t

停止EXPRESSCLUSTER X SingleServerSafe服务。

-r

重启EXPRESSCLUSTER X SingleServerSafe服务。

--return

复归EXPRESSCLUSTER X SingleServerSafe服务。

--suspend

暂停EXPRESSCLUSTER X SingleServerSafe服务。

--resume

复原EXPRESSCLUSTER X SingleServerSafe服务。

-w <timeout>
只有使用-t, -r, --suspend选项时，指定clpcl命令等待EXPRESSCLUSTER X SingleServerSafe服务停止或等待完成挂起的等待时间。单位为秒。
未指定timeout时将一直等待。
timeout中指定了"0"时，不作等待。
未指定-w选项(默认值)时，等待时间为(心跳超时×2)秒。
--force

由于和--suspend选项一起使用，不管服务器状态，强行执行挂起。

--apito timeout
可以秒为单位指定EXPRESSCLUSTER Daemon的停止，重新启动，挂起的等待时间(内部通信超时)。可指定为1-9999的值。
不指定[--apito]选项时，请按照集群属性的内部通信超时所设置的值，进行等待。
返回值

0

成功

0 以外

异常
备考
指定-s或—resume选项来执行本命令时，在对象服务器中处理开始时返回控制。
指定-t或--suspend选项来执行本命令时，等待处理结束后返回控制。
指定-r选项来执行本命令时，对象服务器的EXPRESSCLUSTER X SingleServerSafeDaemon服务从暂停到启动时返回控制。
请使用clpstat命令确认EXPRESSCLUSTER X SingleServerSafeDaemon服务是否未启动或挂起。
注意事项
请以拥有Administrator权限的用户身份执行该命令。
组在启动处理中，停止处理中不能执行该命令。
请在EXPRESSCLUSTER X SingleServerSafe服务处于已启动的状态下执行挂起。
执行复原时，请使用clpstat命令确认EXPRESSCLUSTER X SingleServerSafe服务是否未启动。
关于挂起/复原
要更新集群配置信息，升级EXPRESSCLUSTER X SingleServerSafe等时，可以在继续操作业务时停止EXPRESSCLUSTER X SingleServerSafe服务。此种状态称为挂起。从挂起状态返回到普通的业务状态叫做复原。
对服务器请求挂起/复原处理。请在服务器的EXPRESSCLUSTER X SingleServerSafeDaemon已启动的状态下执行挂起。
在挂起状态下，启动的资源保持启动状态，停止EXPRESSCLUSTER X SingleServerSafe服务，会导致以下功能停止。

  • 停止所有监视资源。

  • 无法操作组及组资源。(启动，停止)

  • 不能使用以下命令。

    • clpcl的-resume以外的其他选项

    • clpstdn

    • clpgrp

    • clprsc

    • clptoratio

    • clpmonctrl

错误消息

消息

原因/处理方法

Log in as administrator.

请以拥有Administrator权限的用户身份执行该命令。

Invalid configuration file. Create valid cluster configuration data .

请用Cluster WebUI创建正确的集群配置信息。

Invalid option.

请指定正确的选项。

Performed stop processing to the stopped cluster service.

对已停止的EXPRESSCLUSTER服务执行了停止处理。

Performed startup processing to the active cluster service.

对已启动的EXPRESSCLUSTER服务执行了启动处理。

Command timeout.

命令超时。

Failed to return the server. Check the status of failed server.

复原服务器失败。请确认处理失败的服务器的状态。

Could not connect to the server. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Could not connect to the data transfer server. Check if the server has started up.

请确认是否启动了服务器。

Failed to obtain the list of nodes. Specify a valid server name in the cluster.

请指定集群中正确的服务器名。

Failed to obtain the service name.

获取服务名失败。

Failed to operate the service.

服务控制失败。

Resumed the cluster service that is not suspended.

对不是挂起状态的EXPRESSCLUSTER服务执行了恢复处理。

Invalid server status.

请确认是否启动了EXPRESSCLUSTER服务。

Server is busy. Check if this command is already run.

可执行已经执行本命令。请确认。

Server is not active. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

There is one or more servers of which cluster service is active. If you want to perform resume, check if there is any server whose cluster service is active in the cluster.

执行恢复时，请确认集群中是否有已启动EXPRESSCLUSTER服务的服务器。

All servers must be activated. When suspending the server, the cluster service need to be active on all servers in the cluster.

执行挂起时，需要集群中的所有服务器都启动EXPRESSCLUSTER服务。

Resume the server because there is one or more suspended servers in the cluster.

集群中有挂起的服务器，请执行恢复。

Invalid server name. Specify a valid server name in the cluster.

请指定集群中正确的服务器名。

Connection was lost. Check if there is a server where the cluster service is stopped in the cluster.

请确认集群中是否有停止了EXPRESSCLUSTER服务的服务器。

invalid parameter.

命令参数中可执行设置了错误的值。

Internal communication timeout has occurred in the cluster server. If it occurs frequently, set the longer timeout.
EXPRESSCLUSTER的内部通信超时。
如果频繁出现该现象，请将内部通信超时设为更长的时间。

Processing failed on some servers. Check the status of failed servers.
对所有的服务器执行了停止处理时，有处理失败的服务器。
请确认处理失败的服务器的状态。

Internal error. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

2.5. 服务器关机 (clpstdn命令)

关闭服务器。

命令行

clpstdn [-r]

说明

停止，关闭服务器的EXPRESSCLUSTER X SingleServerSafe服务。

选项
无选项

关闭服务器。

-r

关闭重起服务器。

返回值

0

成功

0 以外

异常
备考

本命令在组停止处理结束后返回控制。

注意事项
请以拥有Administrator权限的用户身份执行该命令。
组在启动处理中，停止处理中不能执行该命令。
错误消息

请参考"操作服务 (clpcl命令)"。

2.6. 操作组 (clpgrp 命令)

操作组。

命令行
clpgrp -s [<grpname>] [--apito timeout]
clpgrp -t [<grpname>] [--apito timeout]
説明

执行组的启动，停止。

选项
-s [<grpname>]

启动组。指定组名，则仅启动指定的组。如果未指定组名，则启动所有组。

-t [<grpname>]

停止组。指定组名，则仅停止指定的组。如果未指定组名，则停止所有组。

--apito timeout
可以秒为单位指定组的启动，停止，移动，迁移的等待时间(内部通信超时)。可指定为1-9999的值。
不指定[--apito]选项时，请按照集群属性的内部通信超时所设置的值，进行等待。
返回值

0

成功

0 以外

异常
注意事项
请以拥有Administrator权限的用户身份执行该命令。
必须启动EXPRESSCLUSTER X SingleServerSafe服务。
错误消息

消息

原因/处理

Log in as administrator.

请以拥有Administrator权限的用户身份执行。

Invalid configuration data. Create valid cluster configuration data.

请使用Cluster WebUI创建正确的集群配置信息。

Invalid option.

请指定正确的选项。

Could not connect to the server. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Invalid server status. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Server is not active. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Invalid server name. Specify a valid server name in the cluster.

请指定集群中正确的服务器名。

Connection was lost. Check if there is a server where the cluster service is stopped in the cluster.

请确认集群中是否有停止了EXPRESSCLUSTER服务的服务器。

Invalid parameter.

命令参数中可执行设置了错误的值。

Internal communication timeout has occurred in the cluster server. If it occurs frequently, set the longer timeout.
EXPRESSCLUSTER的内部通信超时。
如果频繁出现该现象，则请将内部通信超时设为更长的时间。

Invalid server. Specify a server that can run and stop the group, or a server that can be a target when you move the group.
启动，停止，移动组的目标服务器有误。
请指定正确的服务器。

Could not start the group. Try it again after the other server is started, or after the Wait Synchronization time is timed out.

请等待其它服务器启动或等待启动等待时间超时，启动组。

No operable group exists in the server.

请确认请求处理的服务器中是否存在可处理的组。

The group has already been started on the local server.

请通过Cluster WebUI或[clpstat]命令确认组的状态。

The group has already been started on the other server. To start /stop the group on the local server, use -f option.
请通过Cluster WebUI或[clpstat]命令确认组的状态。
如果要在本地服务器上启动/停止其它服务器上启动的组，请执行组的移动，或加上[-f]选项执行。

The group has already been stopped.

请通过Cluster WebUI或[clpstat]命令确认组的状态。

Failed to start one or more resources. Check the status of group.

请通过Cluster WebUI或[clpstat]命令确认组的状态。

Failed to stop one or more resources. Check the status of group.

请通过Cluster WebUI或[clpstat]命令确认组的状态。

The group is busy. Try again later.

组正处于启动处理或停止处理中，请稍后再执行。

An error occurred on one or more groups. Check the status of group.

请通过Cluster WebUI或[clpstat]命令确认组的状态。

Invalid group name. Specify a valid group name in the cluster.

请指定集群中的正确的组名。

Server is isolated.

服务器处于保留(宕机后重启)状态。

Some invalid status. Check the status of cluster.

出现某种错误的状态。请确认集群的状态。

Log in as administrator.

内存不足或OS的资源不足。请确认。

Server is not in a condition to start group. Critical monitor error is detected.
请通过Cluster WebUI或[clpstat]命令确认服务器的状态。
在准备启动组的服务器中检测出包含在可排除列表中的监视器的异常。

There is no appropriate destination for the group. Critical monitor error is detected.
请通过Cluster WebUI或[clpstat]命令确认服务器的状态。
在其他服务器中检测出包含在可排除列表中的监视器的异常。

2.7. 收集日志 (clplogcc命令)

收集日志。

命令行

clplogcc [-t collect_type] [-o path] [--local] [--evt event_type ...]

说明

收集日志，OS信息等。

选项
无

收集日志。

-t collect_type

指定日志收集模式。如果省略则日志收集模式为type1。

-o path

指定收集文件的输出目标。如果省略则将日志输出到安装路径的tmp下。

--local

不经过数据传送服务器收集本地服务器的日志。

--evt event_type
指定收集的事件日志的种类。
省略时收集应用程序日志，系统日志，安全日志。
如果指定none，则不收集事件日志。
仅在[--local]选项被指定时有效。
详细请参考"指定收集的事件日志种类(--evt 选项)"。
返回值

0

成功

0 以外

异常
备注

由于日志文件使用zip压缩，因此请使用zip解压缩程序对其进行解压缩。

注意事项

请以拥有Administrator权限的用户身份执行该命令。

执行结果

该命令的结果所显示的处理过程如下所示。

处理过程

说明

Preparing

初始化中

Connecting

服务器连接中

Compressing

日志文件压缩中

Transmitting

日志文件发送中

Disconnecting

服务器切断中

Completion

收集日志结束

执行结果(服务器状态)如下所示。

执行结果(服务器状态

说明

Normal

正常结束了。

Canceled

由用户取消了。

Invalid Parameters

参数无效。

Compresion Error

发生了压缩错误。

Cmunication Error

发生了发送错误。

Timeout

超时。

Busy

服务器正忙。

No Free Space

磁盘没有剩余空间。

File I/O Error

发生了文件I/O错误。

Unknown Error

因其它的错误导致失败。
错误消息

消息

原因/处理

Log in as administrator.

请以拥有Administrator权限的用户执行。

Invalid option.

请指定正确的选项。

Collect type must be specified 'type1' or 'type2' or 'type3' or 'type4' or 'type' or'type6'. Incorrect collection type is specified.

收集类型指定有误。

Specifiable number of servers is the max number of servers that can constitute a cluster.

可指定的服务器数为可进行集群配置的最大服务器数。

Failed to obtain properties.

获取属性失败。

Failed to obtain the list of nodes. Specify a valid server name in the cluster.

请指定集群中正确的服务器名。

Invalid server name. Specify a valid server name in the cluster.

请指定集群中正确的服务器名。

Failed to collect log.

收集日志失败。

Server is busy. Check if this command is already run.

可执行已执行该命令。请确认。

Internal error. Check if memory or OS resources are sufficient.

内存不足或OS的资源不足。请确认。

2.7.1. 收集指定类型的日志 (-t 选项)

只想收集指定类型的日志时，请使用clplogcc命令指定 -t 选项执行。
日志的收集类型可指定最大为type1 ~ 6。

type1

type2

type3

type4

type5

type6

  1. 默认收集信息

✓

✓

✓

n/a

n/a

n/a

  1. 事件日志

✓

✓

✓

✓

n/a

n/a

  1. Windows错误报告

✓

✓

✓

✓

n/a

n/a

  1. 用户dump

✓

✓

n/a

n/a

n/a

n/a

  1. 诊断程序报告

✓

✓

n/a

n/a

n/a

n/a

  1. 注册表

✓

✓

✓

n/a

n/a

n/a

  1. 脚本

✓

✓

✓

n/a

n/a

n/a

  1. ESMPRO/AC，ESMPRO/UPSC的日志

✓

✓

✓

n/a

n/a

n/a

  1. HA 日志

n/a

✓

n/a

n/a

n/a

n/a

  1. 镜像统计信息

n/a

n/a

n/a

n/a

n/a

n/a

  1. 集群统计信息

n/a

n/a

n/a

n/a

n/a

✓

  1. 系统统计信息

✓

✓

✓

n/a

n/a

✓
如下执行命令行。
执行示例：以收集类型type2收集日志时。
# clplogcc -t type2

未指定选项时的日志收集类型为type1。

默认收集信息

  • EXPRESSCLUSTER X SingleServerSafe服务器的各模块日志

  • EXPRESSCLUSTER X SingleServerSafe服务器的各模块的属性信息(dir)

    • bin下

    • alert\bin，webmgr\bin下

    • %SystemRoot%\system32\drivers下

  • EXPRESSCLUSTER X SingleServerSafe的版本信息

  • OS信息

  • 更新日志

  • License信息

  • 设置文件

  • 策略文件

  • 共享内存的dump

  • EXPRESSCLUSTER的状态(clpstat --local的执行结果)

  • 主机名，域名信息(hostname的执行结果)

  • 网络信息(netstat的执行结果)

  • IP路径表信息(route print的执行结果)

  • 进程存在状况(tasklist的执行结果)

  • ipconfig (ipconfig的执行结果)

  • 文件的共享设置(net share的执行结果)

  • 会话信息(net session的执行结果)

  • Windows防火墙的设定(netsh的执行结果)

  • SNP (Scalable Networking Pack)的设定(netsh的执行结果)

  • task scheduler的设定(schtasks的执行结果)

  • VSS的shadow copy area使用状况 (vssadmin list shadowstorage 的执行结果)

事件日志

  • 应用程序日志(AppEvent.Evt，Application.evtx, Application.txt)

  • 系统日志(SysEvent.Evt，System.evtx, System.txt)

  • 安全日志 (SecEvent.Evt, Security.evtx, Security.tx)

Windows错误报告

  • ***.wer

用户dump

  • ***.mdmp

诊断程序报告

  • msinfo32.exe命令的执行结果

注册表

  • EXPRESSCLUSTER X SingleServerSafe服务器的注册表信息

    • HKLM\SOFTWARE\NEC\EXPRESSCLUSTER X SINGLESERVERSAFE\Alert

    • HKLM\SOFTWARE\NEC\EXPRESSCLUSTER X SINGLESERVERSAFE\MirrorList

    • HKLM\SOFTWARE\NEC\EXPRESSCLUSTER X SINGLESERVERSAFE\RC

    • HKLM\SOFTWARE\NEC\EXPRESSCLUSTER X SINGLESERVERSAFE\VCOM

    • diskfltr的注册表信息

  • OS的注册表信息

    • HKLM\SYSTEM\CurrentControlSet\Services\Disk

    • HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\DOS Devices

    • HKLM\SYSTEM\MountedDevices

    • HKLM\SYSTEM\CurrentControlSet\Enum\SCSI

    • HKLM\SYSTEM\CurrentControlSet\Enum\STORAGE

    • HKLM\SYSTEM\CurrentControlSet\Services\symc8xx

    • HKLM\SYSTEM\CurrentControlSet\Control\FileSystem

脚本

Cluster WebUI创建的组启动/停止脚本
如果指定了上述以外的用户定义脚本则由于不包含在日志收集的采集信息中，需要另外采集。

ESMPRO/AC，ESMPRO/UPSC的日志

通过执行acupslog.exe命令收集的文件

HA 日志

  • 系统资源情报

  • JVM监视日志

  • 系统监视日志

镜像统计信息

此版本中不能收集。

集群统计信息

  • 集群统计信息

    • Perf\cluster 下

系统统计信息

  • 系统统计信息

    • perf\system 下

2.7.2. 日志文件的输出目标 (-o 选项)

  • 文件名保存为"服务器名-log.zip"。

  • 由于日志文件使用zip压缩，因此请使用zip解压缩程序对其进行解压缩。

未指定-o选项时

在安装路径的tmp下输出日志。

指定-o选项时

若执行以下命令，则将日志输出到指定的目录 C:\tmp 下。

# clplogcc -o C:\tmp

2.7.3. 指定收集的事件日志种类(--evt 选项)

可指定日志收集时所收集信息中包含的事件日志的种类。
接在[--evt]选项之后，指定收集事件日志的如下所示任意一个或一个以上组合。

事件日志的种类

指定文字

应用程序日志

app

系统日志

sys

安全日志

sec

不收集

none

例)收集系统日志和安全日志时

# clplogcc --local --evt sys sec

  • 仅在[--local]选项被指定时有效。

2.7.4. 采集OS紧急关机时的信息

在服务器出现因内部状态异常导致关机等异常关机时，采集OS的资源信息。
采集的信息如下。

  • 信息

    • EXPRESSCLUSTER服务器的部分模块的日志

  • 执行命令产生的信息

    • 主机名，域名信息(hostname的执行结果)

    • 网络信息(netstat的执行结果)

    • 进程存在状况(tasklist的执行结果)

    • ipconfig (ipconfig 的执行结果)

    • 文件的共享设置(net share的执行结果)

    • 会话信息(net session的执行结果)

这些信息是日志收集的默认收集信息，无需另行采集。

2.8. 反映配置信息，备份配置信息 (clpcfctrl命令)

2.8.1. 反映配置信息 (clpcfctrl --push)

在服务器上反映配置信息。

命令行

clpcfctrl --push -[w] [-x <path>] [-p <portnumber>] [--nocheck]

说明

向服务器上反映Cluster WebUI创建的配置信息。

选项
--push
反映时指定。
不能省略。
-x

反映指定目录下的配置信息时，进行指定。

-w
表示配置信息文件的字符编码为SJIS。
一般本选项可以省略。
-p
指定数据发送端口的端口号。
省略时使用初始值。一般无需指定
--nocheck

不执行必要的检查操作，直接发送配置信息。为反映已发送的配置信息，请手动执行必要的操作。

返回值

0

成功

0以外

异常
注意事项
请以拥有Administrator权限的用户身份执行该命令。
反映配置信息时，比较现在的配置信息与将要反映的配置信息。
配置内容有变更时，输出以下的消息。按照消息指示，执行集群服务操作/组操作以后，请再次执行本命令。

消息

处理方法

Please stop EXPRESSCLUSTER Server.

请停止服务器。

Please suspend EXPRESSCLUSTER Server.

请暂停服务器。

Please stop the following groups.

请停止变更设置的组。

Reboot of a cluster is necessary to reflect setting.

反映设置时，请停止并重启集群。

To apply the changes you made, restart the EXPRESSCLUSTER Web Alert service.

要反映设置，请重启EXPRESSCLUSTER Web Alert服务。

To apply the changes you made, restart the EXPRESSCLUSTER Manager service.

要反映设置，请重启EXPRESSCLUSTER Manager服务。

To apply the changes you made, restart the EXPRESSCLUSTER Information Base service.

要反映设置，请重启EXPRESSCLUSTER Information Base服务。

To apply the changes you made, restart the EXPRESSCLUSTER API service.

要反映设置，请重启EXPRESSCLUSTER API服务。

To apply the changes you made, restart the EXPRESSCLUSTER Node Manager service.

要反映设置，请重启EXPRESSCLUSTER Node Manager服务。

Start of a cluster is necessary to reflect setting.

首次构建时的消息。请启动集群。

--nocheck选项只用于维护步骤等特别的用途。平时请不要使用。

错误消息

消息

原因/处理

Log in as administrator.

请以拥有Administrator权限的用户身份执行该命令。

This command is already run.

已启动该命令。

Invalid option.

选项有误。请确认选项。

Invalid mode. Check if --push or --pull option is specified.

请确认是否指定了[--push]。

Invalid host name. Server specified by -h option is not included in the configuration data

配置信息中不包含[-h]指定的服务器。请确认指定的服务器名或IP地址是否正确。

Failed to initialize the xml library. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

Failed to load the configuration file. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

Failed to change the configuration file. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

Failed to load the all.pol file. Reinstall the cluster.

请重装EXPRESSCLUSTER服务器。

Failed to load the cfctrl.pol file. Reinstall the cluster.

请重装EXPRESSCLUSTER服务器。

Failed to get the install path. Reinstall the cluster.

请重装EXPRESSCLUSTER服务器。

Failed to initialize the trncl library. Check if memory or OS resources are sufficient.

内存不足或OS的资源不足。请确认。

Failed to connect to trnsv. Check if the other server is active.

与服务器连接失败。请确认是否启动了其它服务器。

Failed to get the list of node. Check if the server name or ip addresses are correct.

请确认服务器和IP地址是否正确。

File delivery failed. Failed to deliver the configuration data. Check if the other server is active and run the command again.
发送配置信息失败。请确认是否启动了其它服务器。
启动服务器后请再次执行命令。

Multi file delivery failed. Failed to deliver the configuration data. Check if the other server is active and run the command again.
发送配置信息失败。请确认是否启动了其它服务器。
启动服务器后请再次执行命令。

Failed to deliver the configuration data. Check if the other server is active and run the command again.
发送配置信息失败。请确认是否启动了其它服务器。
启动服务器后请再次执行命令。

Failed to upload the configuration file. Check if the other server is active and run the command again.

发送配置信息失败。请确认是否启动了其它服务器。

Canceled to deliver the configuration file since it failed to connect to one or more server. If you want to deliver the configuration file to servers that can be connected, run the command again with "--force" option.

中止了配置信息的发送。有服务器连接失败。如果仅想对可连接的服务器发送配置信息，则请使用[--force]选项再次执行命令。

The directory "work" is not found. Reinstall the cluster.

请重新安装EXPRESSCLUSTER服务器。

Failed to make a working directory.

内存不足或OS资源不足。请确认。

The directory does not exist.

内存不足或OS资源不足。请确认。

This is not a directory.

内存不足或OS资源不足。请确认。

The source file does not exist.

内存不足或OS资源不足。请确认。

The source file is a directory.

内存不足或OS资源不足。请确认。

The source directory does not exist.

内存不足或OS资源不足。请确认。

The source file is not a directory.

内存不足或OS资源不足。请确认。

Failed to change the character code set (EUC to SJIS).

内存不足或OS资源不足。请确认。

Failed to change the character code set (SJIS to EUC).

内存不足或OS资源不足。请确认。

Failed to allocate memory.

内存不足或OS资源不足。请确认。

Failed to change the directory.

内存不足或OS资源不足。请确认。

Failed to make a directory.

内存不足或OS资源不足。请确认。

Failed to remove the directory.

内存不足或OS资源不足。请确认。

Failed to remove the file.

内存不足或OS资源不足。请确认。

Failed to open the file.

内存不足或OS资源不足。请确认。

Failed to read the file.

内存不足或OS资源不足。请确认。

Failed to copy the file.

内存不足或OS资源不足。请确认。

Failed to create the mutex.

内存不足或OS资源不足。请确认。

Internal error. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

Failed to check server property. Check if the server name or ip addresses are correct.

请确认服务器和IP地址是否正确。

Please stop the following resources.

请停止要进行变更的资源。

2.8.2. 备份配置信息(clpcfctrl --pull)

备份配置信息。

命令行

clpcfctrl --pull [-w] [-x <path>] [-p <portnumber>]

说明

为了在Cluster WebUI上使用，备份配置信息。

选项
--pull
备份时指定。
不能省略。
-x

在指定目录下备份配置信息。

-w

用字符编码SJIS保存配置信息。

-p
指定数据发送端口的端口号。
省略时使用初始值。一般无需指定。
返回值

0

成功

0以外

异常
注意事项

请以拥有Administrator权限的用户身份执行该命令。

错误消息

消息

原因/处理

Log in as administrator.

请以拥有Administrator权限的用户身份执行该命令。

This command is already run.

已启动。

Invalid option.

选项有误。请确认选项。

Invalid mode. Check if --push or --pull option is specified.

请确认是否指定了[--pull]。

Failed to initialize the xml library. Check if memory or OS resources are sufficient.

内存不足或OS的资源不足。请确认。

Failed to load the configuration file. Check if memory or OS resources are sufficient.

内存不足或OS的资源不足。请确认。

Failed to change the configuration file. Check if memory or OS resources are sufficient.

内存不足或OS的资源不足。请确认。

Failed to load the all.pol file. Reinstall the cluster.

请重装EXPRESSCLUSTER服务器。

Failed to load the cfctrl.pol file. Reinstall the cluster.

请重装EXPRESSCLUSTER服务器。

Failed to get the install path. Reinstall the cluster.

请重装EXPRESSCLUSTER服务器。

Failed to initialize the trncl library. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

Failed to connect to trnsv. Check if the other server is active.

连接服务器失败。请确认是否启动了其它服务器。

The directory "work" is not found. Reinstall the cluster.

请重装EXPRESSCLUSTER服务器。

Failed to make a working directory.

内存不足或OS资源不足。请确认。

The directory does not exist.

内存不足或OS资源不足。请确认。

This is not a directory.

内存不足或OS资源不足。请确认。

The source file does not exist.

内存不足或OS资源不足。请确认。

The source file is a directory.

内存不足或OS资源不足。请确认。

The source directory does not exist.

内存不足或OS资源不足。请确认。

The source file is not a directory.

内存不足或OS资源不足。请确认。

Failed to change the character code set (EUC to SJIS).

内存不足或OS资源不足。请确认。

Failed to change the character code set (SJIS to EUC).

内存不足或OS资源不足。请确认。

Failed to allocate memory.

内存不足或OS资源不足。请确认。

Failed to change the directory.

内存不足或OS资源不足。请确认。

Failed to make a directory.

内存不足或OS资源不足。请确认。

Failed to remove the directory.

内存不足或OS资源不足。请确认。

Failed to remove the file.

内存不足或OS资源不足。请确认。

Failed to open the file.

内存不足或OS资源不足。请确认。

Failed to read he file.

内存不足或OS资源不足。请确认。

Failed to write the file.

内存不足或OS资源不足。请确认。

Failed to copy the file.

内存不足或OS资源不足。请确认。

Failed to create the mutex.

内存不足或OS资源不足。请确认。

Internal error. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

2.9. 超时临时调整 (clptoratio命令)

延长，显示当前的超时倍率。

命令行
clptoratio -r <ratio> -t <time>
clptoratio -i
clptoratio -s
说明

暂时延长下列各种超时值。

  • 资源监视

  • 警报同步服务

  • WebManager服务

显示当前超时倍率。

选项
-r ratio
指定超时倍率。请设置为大于等于1的整数值。最大超时倍率为10000倍。
如果指定"1"，则与-i选项一样，可将已更改的超时倍率还原。
-t time
指定延长期间。
可指定分m，小时h，日d。最大延长期间为30日。
例)2m，3h，4d
-i

还原更改的超时倍率。

-s

参考当前的超时倍率。

返回值

0

成功

0 以外

异常
备注
如果执行服务器关机，则设置的超时倍率无效。
-s选项可查看的只有当前的超时倍率。不能查看延长期间的剩余时间等。
使用状态显示命令可参考原来的超时值。

监视资源超时

# clpstat --mon 监视资源名 --detail
注意事项
请以拥有Administrator权限的用户身份执行该命令。
请在启动了EXPRESSCLUSTER X SingleServerSafe服务的状态下执行。
设置超时倍率时，请务必指定延长期间。但如果超时倍率指定为"1"，则无法指定延长期间。
指定延长期间时不能指定为"2m3h"等组合。
执行示例

例1: 将超时倍率设为3天2倍时

# clptoratio -r 2 -t 3d

例2: 还原超时倍率时

# clptoratio -i

例3: 参考当前超时倍率时

# clptoratio -s
present toratio : 2

即可知当前的超时倍率为2。

错误消息

消息

原因/处理

Log in as administrator.

请以拥有Administrator权限的用户身份执行。

Invalid configuration file. Create valid cluster configuration data.

请使用Cluster WebUI创建正确的集群配置信息。

Invalid option.

请指定正确的选项。

Specify a number in a valid range.

请指定正确范围内的数字。

Specify a correct number.

请指定正确的数字。

Scale factor must be specified by integer value of 1 or more.

请将倍率指定为大于等于1的整数值。

Specify scale factor in a range less than the maximum scale factor.

请指定不超过最大倍率的倍率。

Set the correct extension period. Ex) 2m, 3h, 4d

请设置正确的延长期间。

Set the extension period in a range less than the maximum extension period.

请指定不超过最大延长期间的延长期间。

Could not connect to the server. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Server is not active. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Connection was lost. Check if there is a server where the cluster service is stopped in the cluster.

请确认集群中是否有停止了EXPRESSCLUSTER服务的服务器。

Invalid parameter.

命令参数中可执行设置了错误的值。

Internal communication timeout has occurred in the cluster server. If it occurs frequently, set the longer timeout.
EXPRESSCLUSTER的内部通信超时。
如果频繁出现该现象，则请将内部通信超时设为更长的时间。

Processing failed on some servers. Check the status of failed servers.
有处理失败的服务器。
请确认集群中的服务器状态。请在启动了集群中的所有服务器的状态下执行。

Internal error. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

2.10. 日志级别/大小更改 (clplogcf命令)

更改和显示日志级别，日志输出文件大小的设置。

命令行

clplogcf -t <type> -l <level> -s <size>

说明
更改日志级别，日志输出文件大小的设置。
显示当前的设置值。
选项
-t
指定要更改设置的模块类型。
省略-l或-s时，显示指定的模块类型中设置的信息。可指定的类型请参考"-t选项中可以指定的类型"表。
-l
指定日志级别。
可指定的日志级别如下。
1，2，4，8，16，32
数值越大输出的日志越详细。
-s
指定要输出日志的文件的大小。
单位是byte。
无

显示当前设置的所有信息。

返回值

0

成功

0以外

异常
备注

EXPRESSCLUSTER X SingleServerSafe输出的日志在各类型上使用2个日志文件。因此需要2倍于-s所指定的磁盘容量。

注意事项
请以拥有Administrator权限的用户身份执行该命令。
执行本命令需要EXPRESSCLUSTER X SingleServerSafe事件服务处于运行状态。
将服务器重启后变更的设定内容会被还原为原来的设定。
执行示例

例1: 更改pm的日志级别时

# clplogcf -t pm -l 8

例2: 参考pm的日志级别，日志文件大小时

# clplogcf -t pm
TYPE, LEVEL, SIZE
pm, 8, 1000000

例3: 显示当前的设置值

# clplogcf
TYPE, LEVEL, SIZE
trnsv, 4, 1000000
xml, 4, 1000000
logcf, 4, 1000000
错误消息

消息

原因/处理

Log in as administrator.

请以拥有Administrator权限的用户身份执行该命令。

Invalid option.

选项有误。请确认选项。

Failed to change configuration. Check if the event service is running.

可执行未启动EXPRESSCLUSTER Event服务。

Invalid level.

指定的级别有误。

Invalid size.

指定的大小有误。

Failed to initialize the xml library. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

Failed to print current configuration. Check if the event service is running.

可执行未启动EXPRESSCLUSTER Event 服务。
[-t]选项中可以指定的类型

类型

模块

说明

alert

clpaltinsert.exe

警报

apicl

clpapicl.dll

API客户端Library

apisv

clpapisv.dll

API服务器

appli

clpappli.dll

应用程序资源

appliw

clpappliw.dll

应用程序监视资源

bwctrl

clpbwctrl.exe

集群启动同步等待处理控制命令

cfchk

clpcfchk.exe

集群配置检查命令

cfctrl

clpcfctrl.exe

集群生成，集群信息备份命令

cl

clpcl.exe

集群操作命令

clpdnld

clpdnld.exe

Downloader

clpgetsvcstat

clptrnsv.exe

事务服务器

clpshmstat

clpshmstat.dll

节点状态管理Library

commcl

clpcommcl.dll

通用通信客户端Library

diskperf

clpdiskperf.dll

磁盘性能日志输出用库

diskutil

clpdiskutil.dll

镜像磁盘/磁盘共同Library

diskw

clpdiskw.dll

磁盘RW监视资源

down

clpdown.exe

服务器关闭命令

event

clpevent.dll

事件日志

exping

clpexpng.dll

Ping执行管理

genw

genw.dll

自定义监视资源

grp

clpgrp.exe

组启动，停止，移动，迁移命令

hblog

clplanhb.dll

内核模式LAN心跳资源

healthchk

clphealthchk.exe

进程健全性确认命令

ibsv

clpibsv.exe

Information Base服务

ipw

clpipw.dll

IP监视资源

lankhb

clplanhb.dll

内核模式LAN心跳资源

lcns

clplcns.dll

LicenseLibrary

logc

clplogc.dll

日志收集Library

logcc

clplogcc.exe

日志收集命令

logcf

clplogcf.exe

日志级别，大小更改命令

logcmd

clplogcmd.exe

警报输出命令

mail

clpmail.exe

Mail信息

mgtmib

clpmgtmib.dll

SNMP联动库

miiw

clpmiiw.dll

NIC Link Up/Down监视资源

monctrl

clpmonctrl.exe

监视资源控制命令

mrw

clpmrw.dll

消息接收监视资源

mtw

clpmtw.dll

Multi-Target监视资源

nm

clpnm.exe

节点地图管理

perfc

clpperfc.exe

集群统计信息显示命令

pm

clppm

进程管理

pmsvc

clppmsvc.exe

进程管理

psw

clppsw.dll

进程名监视资源

ptun

clpptun.dll

参数调试

ptunlib

clpptun.dll

参数调试

rc

clprc.exe

组，组资源管理

rc_ex

clprc.exe

组，组资源管理

regctrl

clpregctrl.exe

重启次数控制命令

resdllc

clpresdllc.dll

资源控制Library

rm

clprm.dll

监视器管理

script

clpscript.dll

脚本资源

scrpc

clpscrpc.exe

脚本

scrpl

clpscrpl.exe

脚本

sem

clpsem.dll

信号量Library

service

clpservice.dll

服务资源

servicew

clpservicew.dll

服务监视资源

shmcm

clpshmcm.dll

共享内存Library

shmevt

clpshmevt.dll

事件Library

shmnm

clpshmnm.dll

共享内存Library

shmrm

clpshmrm.dll

共享内存Library

snmpmgr

clpsnmpmgr.dll

SNMP Trap接收Library

startup

clpstartup.exe

Startup

stat

clpstat.exe

状态显示命令

stdn

clpstdn.exe

集群关机命令

toratio

clptoratio.exe

超时倍率更改命令

trap

clptrap.exe

SNMP Trap发送命令

trncl

clptrncl.dll

事务Library

rexec

clprexec.exe

外部监视联动处理请求命令

trnsv

clptrnsv.exe

事务服务器

userw

clpuserw.dll

用户空间监视资源

webalert

clpaltd.exe

警报同步

webmgr

clpwebmc.exe

WebManager服务

xml

xlpxml.dll

XMLLibrary

vmctrl

clpvmctrl.dll

VMCTRL Library
[-t]选项可指定的监视可选产品的类型

类型

模块

说明

db2w

clp_db2w.dll

DB2监视 (Database Agent)

ftpw

clp_ftpw.dll

FTP监视 (Internet Server Agent)

httpw

clp_httpw.dll

HTTP监视 (Internet Server Agent)

imap4w

clp_imap4w.dll

IMAP4监视 (Internet Server Agent)

jra

clpjrasvc.exe

JVM监视 (Java Resource Agent)

jraw

clpjraw.dll

JVM监视 (Java Resource Agent)

odbcw

clp_odbcw.dll

ODBC监视 (Database Agent)

oraclew

clp_oraclew.dll

Oracle监视 (Database Agent)

otxw

clp_otxw.dll

WebOTX监视 (Application Server Agent)

pop3w

clp_pop3w.dll

POP3监视 (Internet Server Agent)

psqlw

clp_psqlw.dll

PostgreSQL监视 (Database Agent)

smtpw

clp_smtpw.dll

SMTP监视 (Internet Server Agent)

sqlserverw

clp_sqlserverw.dll

SQL Server监视 (Database Agent)

sra

clpsraserviceproc.exe

系统监视/进程资源监视 (System Resource Agent)

sraw

clpsraw.dll

系统监视 (System Resource Agent)

psrw

clppsrw.dll

进程资源监视 (System Resource Agent)

tuxw

clp_tuxw.dll

Tuxedo监视 (Application Server Agent)

wasw

clp_wasw.dll

WebSphere监视 (Application Server Agent)

wlsw

clp_wlsw.dll

WebLogic监视 (Application Server Agent)

2.11. 管理License (clplcnsc 命令)

进行License的管理。

命令行
clplcnsc -i [licensefile...]
clplcnsc -l [-a]
clplcnsc -d serialno [-q]
clplcnsc -d -t [-q]
clplcnsc -d -a [-q]
clplcnsc --reregister licensefile...
说明

进行本产品的产品版/试用版License的注册，浏览，删除。

选项
-i [licensefile...]

如果指定License文件，则通过该文件获取并注册License信息。可以指定多个License文件。也可以指定通配符号。如果不指定，则通过交互方式输入并注册License信息。

-l [-a]

浏览已注册的License。显示的项目如下所示。

项目名

说明

Serial No

序列号 (仅产品版)

User name

用户名 (仅试用版)

Key

License Key

Licensed Number of CPU

License许可数(CPU个数)

Licensed Number of Computers

License许可数(节点个数)

Start date

有效期间开始日期 1 2

End date

有效期间终止日期 1 2

Status

License的状态

状态

说明

valid

有效

invalid

无效

unknown

不明

inactive

有效期间开始前 1 2

expired

有效期间终止后 1 2
1(1,2,3,4)

期间定制版License时显示。

2(1,2,3,4)

试用版License时显示。

未指定-a选项时，不显示状态为invalid，unknown， expired的License。
指定-a选项时，无论License的状态如何，显示全部的License。
-d <param>

param

serialno

删除指定序列号的License。

-t

删除已注册的全部试用版License。

-a

删除已注册的全部License。

-q

删除License时不显示确认信息。请同时指定-d选项。

--reregister licensefile...

请重新注册期间定制License。一般不需要执行该选项命令。

返回值

0

正常结束

1

取消

3

初始化错误

5

选项无效

8

其它内部错误
执行示例

  • 注册

    • 交互方式

      # clplcnsc -i

      产品版，期间定制版

      选择产品区分

      Selection of License Version
1.  Product Version
2.  Trial Version
e. Exit
Select License Version. [1, 2, or e (default:1)] ...

      输入序列号

      Enter serial number [ Ex. XXX0000000 ] ...

      输入License key

      Enter license key
[Ex. XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX] ...

      试用版

      选择产品区分

      Selection of License Version
1.  Product Version
2.  Trial Version
e. Exit
Select License Version. [1, 2, or e (default:1)] ...

      输入用户名

      Enter user name [ 1 to 63byte ] ...

      输入License key

      Enter license key
[Ex. XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX] ...

      指定License文件

      # clplcnsc -i /tmp/cpulcns.key

  • 参考

    # clplcnsc -l

    产品版

    < EXPRESSCLUSTER X SingleServerSafe <PRODUCT> >

Seq... 1
Serial No..... AAAAAAAA000001
Key..... A1234567-B1234567-C1234567-D1234567
Licensed Number of CPU... 2
Status... valid

Seq... 2
Serial No..... AAAAAAAA000002
Key..... E1234567-F1234567-G1234567-H1234567
Licensed Number of Computers... 1
Status... valid

    期间定制版

    < EXPRESSCLUSTER X SingleServerSafe <PRODUCT> >

Seq... 1
Serial No..... AAAAAAAA000001
Key..... A1234567-B1234567-C1234567-D1234567
Start date..... 2018/01/01
End date...... 2018/01/31
Status........... valid

Seq... 2
Serial No..... AAAAAAAA000002
Key..... E1234567-F1234567-G1234567-H1234567
Status........... inactive

    试用版

    < EXPRESSCLUSTER X SingleServerSafe <TRIAL> >

Seq... 1
Key..... A1234567-B1234567-C1234567-D1234567
User name... NEC
Start date..... 2018/01/01
End date...... 2018/02/28
Status........... valid

  • 删除

    # clplcnsc -d AAAAAAAA000001 -q

  • 删除

    # clplcnsc -d -t -q

  • 删除

    # clplcnsc -d -a

确认删除

Are you sure to remove the license? [y/n] ...
注意事项

请以拥有Administrator权限的用户身份执行该命令。

使用-d选项时，同时指定-a选项，试用版License和产品版License将被全部删除。仅删除试用版License时，请并用-t选项。如果删除了产品版License时，请重新注册产品版License。
参照License时，如果License中包含多个License，它们将分别显示。
错误消息

消息

原因/处理方法
Processed license num
(success : %d, error : %d).
处理的License数(成功: %d, 失败: %d)
失败数不为0时，说明某种原因下处理License失败。
请确认License信息是否正确。

Command succeeded.

命令成功。

Command failed.

命令失败。

Log in as administrator.

无执行命令的权限。请用有Administrator权限的用户执行。

Invalid cluster configuration data. Check the cluster configuration information.

集群配置信息无效。请使用Cluster WebUI确认集群配置信息。

Initialization error. Check if memory or OS resources are sufficient.

初始化失败。可执行是内存不足或OS资源不足。请确认。

The command is already run.

命令已经执行。

The license is not registered.

未注册License。

Could not opened the license file. Check if the license file exists on the specified path.

无法向License文件进行I/O。请确认License文件是否存在于指定的路径。

Could not read the license file. Check if the license file exists on the specified path.

无法向License文件进行I/O。请确认License文件是否存在于指定的路径。

The field format of the license file is invalid. The license file may be corrupted. Check the destination from where the file is sent.

License文件的域格式无效。可执行License文件有破损。请确认文件的发送源。

The cluster configuration data may be invalid or not registered.

可执行是集群配置信息无效或未被登录。请确认。

Failed to terminate the library. Check if memory or OS resources are sufficient.

可执行是内存不足或OS资源不足。请确认。

Failed to register the license. Check if the entered license information is correct.

请确认输入的License信息是否正确。

Failed to open the license. Check if the entered license information is correct.

请确认输入的License信息是否正确。

Failed to remove the license.

删除License失败。可执行是参数错误或内存不足或OS资源不足。请确认。

This license is already registered.
该License已注册。
请确认已注册的License。

This license is already activated.
该License已被使用。
请确认已注册的License。

This license is unavailable for this product.
该License不适用于该产品。
请确认License。

The maximum number of licenses was reached.
已达到可以注册的最大License数。
请删除到期的License。

Internal error. Check if memory or OS resources are sufficient.

可执行是内存不足或OS资源不足。请确认。

2.12. 消息输出 (clplogcmd命令)

将指定的消息登录到Alert日志的命令。

命令行

clplogcmd -m message[--alert] [--mail] [-i ID] [-l level]

注解

一般在服务器的构筑和操作中不必要执行该命令。该命令是在脚本资源的脚本中描述后使用的命令。

说明
在脚本资源的脚本中描述，将任意的消息输出到输出目标。
以以下形式输出消息。

[ID] message

选项
-m message
指定要输出的消息。不可省略。消息的最大大小是498字节。
消息中可使用英文，数字，记号 3 。
--alert
--mail
从alert，mail中指定输出对象 (可以指定多个)。
该参数可省略。省略时alert为输出对象。
有关输出对象的详细信息请参考«维护指南»的"维护信息"的"EXPRESSCLUSTER的目录结构"。
-i ID
指定消息ID。
该参数可省略。省略时，ID被设为1。
-l level
指输出警报的级别。
指定ERR，WARN，INFO中的任意一个。通过该级别指定Cluster WebUI上的Alert日志的图标。
该参数可省略。省略时，level被设为INFO。
详细信息请参考在线版手册。
返回值

0

成功

0 以外

异常
注意事项
请以拥有Administrator权限的用户身份执行该命令。
-i 选项的式样与Linux版不同。由于在Windows版中警报中输出的事件ID是固定的，所以不可更改。
执行示例
例1: 指定消息，消息ID，级别时
脚本资源的脚本中进行了以下描述时，消息被发送到Alert日志。
clplogcmd -m test1 -i 100 -l ERR
例2: 指定消息，输出对象，事件ID，级别时 (输出对象 mail)
脚本资源的脚本中进行了以下描述时，消息被发送到通过Cluster WebUI 的集群属性设置的邮件地址。关于设置邮件地址的详细信息请参考《EXPRESSCLUSTER X SingerServerSafe 设置指南》的"其他设置的详细信息" - "集群属性" - "Alert服务标签页"。
clplogcmd -m test2 --mail -i 100 -l ERR

向mail 的发送对象发送以下内容的邮件。

Message:test2
Type: logcmd
ID: 100
Host: server1
Date: 2019/04/10 10:00:00
3

消息中含有记号时的注意事项如下。

  • 需要用""括起来的记号

    & | < >
    (例 在消息中指定"&"时，输出&。)

  • 需要在前面加\的记号

    \
    (例 在消息中指定\\时，输出\。)

  • 消息中含有空格时，需要用""括起来。

2.13. 控制监视资源 (clpmonctrl命令)

控制监视资源。

命令行
clpmonctrl -s [-m resource name] [-w wait time]
clpmonctrl -r [-m resource name] [-w wait time]
clpmonctrl -c [-m resource name]
clpmonctrl -v [-m resource name]
clpmonctrl -e -m resource_name
clpmonctrl -n [-m resource_name]
说明

暂停/重新启动监视资源。

选项
-s, --suspend

暂停监视。

-r, --resume

重新启动监视。

-c, --clear

重置回复操作回数。

-v, --view

表示回复操作回数。

-e, --error

将故障验证功能设为有效。请务必使用-m选项指定监视资源名。

-n, --normal

将故障验证功能设为无效。请务必使用-m选项指定监视资源名，此时只有该资源属于对象。省略-m选项时，所有监视资源属于对象。

-m, --monitor
指定要控制的监视资源。
可省略。省略时对所有监视资源进行控制。
-w, --wait
以监视资源为单位等待监视控制。(秒)
可省略。省略时的默认值是5秒。
返回值

0

正常结束

1

执行权限非法

2

选项非法

3

初始化错误

4

配置信息非法

5

监视资源未登录

6

指定监视资源非法

10

EXPRESSCLUSTER X SingleServerSafe未启动状态

11

EXPRESSCLUSTER X SingleServerSafe 服务挂起状态

90

监视控制等待超时

128

双重启动

255

其它内部错误
备注

对已经暂停的监视资源进行暂停或者对已经启动的监视资源进行重新启动操作时，本命令异常结束，监视资源状态不变化。

注意事项
请以拥有Administrator权限的用户身份执行该命令。
监视资源的状态通过状态显示命令或Cluster WebUI确认。
请通过clpstat命令或Cluster WebUI确认监视资源的状态处于"已启动"或"暂停"后执行。
如果在通过监视时机为"启动时"的监视资源将处于启动状态的对象资源暂时停止后，执行了对象资源或对象资源所属组的启动，则由于处于暂时停止状态的监视资源不会开始监视，故无法查出异常。
例如，下列情况即属于以上情形。

  1. 暂时停止了正在监视应用程序资源的应用程序监视。

  2. 重新启动应用程序资源或应用程序资源所属的组。

上述情况下，可以手动进行重新启动，同时也可以通过监视异常时的恢复操作进行重新启动。

如果监视资源的复归运行设置为以下，则-v选项中显示的"FinalAction Count" 会显示「最终运行前脚本」的执行次数。

  • 最终运行前执行脚本： 有效

  • 最终运行： "不操作"

错误消息

消息

原因/处理

Command succeeded.

命令成功。

You are not authorized to run the command. Log in as Administrator.

没有命令的执行权。请以拥有Administrator权限的用户身份执行命令。

Initialization error. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。

Invalid cluster configuration data. Check the cluster configuration information.

集群配置信息有误。请通过Cluster WebUI确认集群配置信息。

Monitor resource is not registered.

未登录监视资源。

Specified monitor resource is not registered. Check the cluster configuration information.
未登录指定的监视资源。
请通过Cluster WebUI确认集群配置信息。

The cluster has been stopped. Check the active status of the cluster service by using the command such as ps command.
集群处于停止状态。
请使用管理工具的[service]确认EXPRESSCLUSTER Server的启动状态。

The cluster has been suspended. The cluster service has been suspended. Check activation status of the cluster service by using a command such as the ps command.

集群处于挂起状态。请使用管理工具的[service]确认EXPRESSCLUSTER Server的启动状态。

Waiting for synchronization of the cluster... The cluster is waiting for synchronization. Wait for a while and try again.
集群处于同步等待状态。
请在集群同步等待结束后再次执行命令。

Monitor %1 was unregistered, ignored. The specified monitor resources %1is not registered, but continue processing. Check the cluster configuration data.
指定的监视资源中有未登录的监视资源，忽略，继续处理。
请通过Cluster WebUI确认集群配置信息。
%1：监视资源名

The command is already executed. Check the execution state by using the "ps" command or some other command.

已经执行命令。请使用task manager等确认执行状态。

Internal error. Check if memory or OS resources are sufficient.

内存不足或OS资源不足。请确认。
可指定-m选项的监视资源类型

类型

暂时停止/重新启动监视资源

复原操作次数的计数器的表示/复位

故障验证功能的

有效化/无效化

appliw

✓

✓

✓

diskw

✓

✓

✓

ipw

✓

✓

✓

miiw

✓

✓

✓

mtw

✓

✓

✓

servicew

✓

✓

✓

genw

✓

✓

✓

mrw

✓

✓

n/a

db2w

✓

✓

✓

fipw

✓

✓

✓

httpw

✓

✓

✓

imap4w

✓

✓

✓

odbcw

✓

✓

✓

oraclew

✓

✓

✓

pop3w

✓

✓

✓

psqlw

✓

✓

✓

smtpw

✓

✓

✓

sqlserverw

✓

✓

✓

tuxw

✓

✓

✓

wasw

✓

✓

✓

wlsw

✓

✓

✓

otxw

✓

✓

✓

jraw

✓

✓

✓

sraw

✓

✓

✓

psrw

✓

✓

✓

userw

✓

✓

✓

psw

✓

✓

✓

2.14. 控制组资源 (clprsc命令)

执行组资源的控制。

命令行
clprsc -s resource_name [-f] [--apito timeout]
clprsc -t resource_name [-f] [--apito timeout]
说明

启动/停止组资源。

选择
-s

启动组资源。

-t

停止组资源。

-f

启动组资源时，启动指定的组资源所依赖的所有的组资源。

--apito

停止组资源时，停止依赖指定组资源的所有组资源。

timeout
可以秒为单位指定组资源的启动，停止的等待时间(内部通信超时)。可指定为1-9999的值。
不指定[--apito]选项时，请按照集群属性的内部通信超时所设置的值，进行等待。
返回值

0

正常结束

0以外

异常结束
注意事项
请以拥有Administrator权限的用户执行该命令。
组资源的状态，请通过状态显示命令或者Cluster WebUI确认。
错误消息

消息

原因/处理

Log in as Administrator.

请以拥有Administrator权限的用户身份执行命令。

Invalid cluster configuration data. Check the cluster configuration information.

集群配置信息有误。请通过Cluster WebUI确认集群配置信息。

Invalid option.

请指定正确的选项。

Could not connect server. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Invalid server status. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Server is not active. Check if the cluster service is active.

请确认是否启动了EXPRESSCLUSTER服务。

Invalid server name. Specify a valid server name in the cluster.

请指定集群中正确的服务器名。

Connection was lost. Check if there is a server where the cluster service is stopped in the cluster.

请确认集群中是否有停止了EXPRESSCLUSTER服务的服务器。

Internal communication timeout has occurred in the cluster server. If it occurs frequently, set the longer timeout.
EXPRESSCLUSTER的内部通信超时。
如果频繁出现该现象，请将内部通信超时设为更长的时间。

The group resource is busy. Try again later.

因为组资源启动处理中或停止处理中，请稍候执行。

An error occurred on group resource. Check the status of group resource.

请通过Cluster WebUI或[clpstat]命令确认组资源的状态。

Could not start the group resource. Try it again after the other server is started, or after the Wait Synchronization time is timed out.

请等待其它服务器启动或等待启动等待时间超时，启动组资源。

No operable group resource exists in the server.

请确认请求处理的服务器中是否存在可处理的组资源。

The group resource has already been started on the local server.

请通过Cluster WebUI或[clpstat]命令确认组资源的状态。

The group resource has already been started on the other server. To start the group resource on the local server, stop the group resource.
请通过Cluster WebUI或[clpstat]命令确认组资源的状态。
在本地服务器启动组资源时，请停止组。

The group resource has already been stopped.

请通过Cluster WebUI或[clpstat]命令确认组资源的状态。

Failed to start group resource. Check the status of group resource.

请通过Cluster WebUI或[clpstat]命令确认组资源的状态。

Failed to stop resource. Check the status of group resource.

请通过Cluster WebUI或[clpstat]命令确认组资源的状态。

Depending resource is not offline. Check the status of resource.

因为依赖的组资源的状态不是停止完毕，不可以停止组资源。请停止依赖的组资源或者指定[-f]选项。

Depending resource is not online. Check the status of resource.

因为依赖的组资源的状态不是启动完毕，不可以启动组资源。请停止依赖的组资源或者指定[-f]选项。

Invalid group resource name. Specify a valid group resource name in the cluster.

组资源未登录。

Server is isolated.

服务器处于保留(宕机后重启)状态。

Internal error. Check if memory or OS resources are sufficient.

内存不足或OS的资源不足。请确认。

Server is not in a condition to start resource. Critical monitor error is detected.
请使用Cluster WebUI或[clpstat]命令确认组资源状态。
在准备启动组资源的服务器上检测出排除列表中包含的监视异常。

2.15. 集群间处理请求 (clprexec命令)

要求安装了EXPRESSCLUSTER X SingleServerSafe的其他服务器处理执行。

命令行
clprexec --script script_file -h IP [-p port_number] [-w timeout] [-o logfile_path]
clprexec --notice [mrw_name] -h IP [-k category[.keyword]] [-p port_number] [-w timeout] [-o logfile_path]
clprexec --clear [mrw_name] -h IP [-k category[.keyword]] [-p port_number] [-w timeout] [-o logfile_path]
说明

向其他集群的服务器发送指定的处理执行请求。

选项
--script script_name
请求执行脚本。
在scirpt_name中指定要执行脚本(shell脚本及可执行文件等)的文件名。
需事先在以-h指定的各服务器上的EXPRESSCLUSTER X SingleServerSafe安装目录下的worktrnreq子目录下创建脚本。
--notice
向EXPRESSCLUSTER X SingleServerSafe服务器发送异常发生通知。
请在mrw_name中指定消息接收监视资源名。
省略监视资源名时，请使用-k选项指定消息接收监视资源的监视类型，监视对象。
--clear
请求将消息接收监视资源的状态从"异常"更改为"正常"。
请在mrw_name中指定消息接收监视资源名。
省略监视资源名时，请使用-k选项指定消息接收监视资源的监视类型，监视对象。
-h IP Address
请指定发出处理请求的EXPRESSCLUSTER X SingleServerSafe服务器的IP地址。
通过使用逗号隔开可指定多个IP地址，最多可指定32个IP地址。
※ 如省略本选项，则处理请求发行目标变成自身服务器。
-k category[.keyword]
指定[--notice]或[--clear]选项时，请在[category]中指定消息接收监视器上设定的监视类型。
指定消息接收监视资源的关键字时，请在[category]的后面通过逗号隔开进行指定。
-p port_number
指定端口号。
请在port_number中指定处理请求发行目标服务器中设置的数据传送端口号。
省略本选项时，使用缺省29002。
-o logfile_path
在ｌogfile_path指定输出本命令详细日志的文件路径。
文件中会保存1次命令的日志。
※ 未安装EXPRESSCLUSTER X SingleServerSafe的服务器不指定本选项时，则只变成标准输出。
-w timeout
指定命令的超时时间。不指定时，默认值为180秒。
最大可指定为5～999。
返回值

0

正常结束

0以外

异常结束
注意事项

使用[clprexec]命令发行异常发生通知时，需预先登录/启动EXPRESSCLUSTER X SingleServerSafe服务器中已设置的想要执行的异常时动作的消息接受监视资源。

拥有以-h选项指定的IP地址的服务器需满足以下条件。
=安装有EXPRESSCLUSTER X SingleServerSafe X3.0以上版本
= EXPRESSCLUSTER X SingleServerSafe已启动
( 除--script 选项以外时)
= mrw已设置/启动
( --notice, --clear 选项时)

[根据客户端IP地址限制连接]有效时，要追加执行[clprexec]命令设备的IP地址。

有关[根据客户端IP地址的连接限制] 请参考《EXPRESSCLUSTER X SingleServerSafe 设置指南》的"其他设置的详细信息"的"集群属性"的"WebManager标签页"。

执行示例

例1: 向EXPRESSCLUSTER X SingleServerSafe服务器1(10.0.0.1)发行脚本(script1.sh)执行请求时

# clprexec --script script1.bat -h 10.0.0.1
例2: 向EXPRESSCLUSTER X SingleServerSafe服务器1(10.0.0.1)发行异常发生通知
※ mrw1的设置 监视类型:earthquake，监视对象:scale3

  • 指定消息接收监视资源名时

    # clprexec --notice mrw1 -h 10.0.0.1 -w 30 -p /tmp/clprexec/clprexec.log

  • 指定消息接收监视资源中设置的监视类型和监视对象时

    # clprexec --notice -h 10.0.0.1 -k earthquake,scale3 -w 30 -p /tmp/clprexec/clprexec.log
例3: 向EXPRESSCLUSTER X SingleServerSafe服务器1(10.0.0.1)发行mrw1的监视状态更改请求
※ mrw1的设置 监视类型:earthquake，监视对象:scale3

  • 指定消息接收监视资源名时

    # clprexec --clear mrw1 -h 10.0.0.1

  • 指定消息接收监视资源中设置的监视类型和监视对象时

    # clprexec --clear -h 10.0.0.1 -k earthquake,scale3
错误消息

消息

原因/处理方法

success

-

Invalid option.

请确认命令的参数。

Could not connect to the data transfer servers. Check if the servers have started up.

请确认指定IP地址是否正确或拥有IP地址的服务器是否已启动。

Could not connect to all data transfer server.

请确认指定的IP地址是否正确，或使用此IP地址的服务器是否已启动。

Command timeout.

请确认拥有指定IP地址的服务器是否已完成处理。

All servers are busy.Check if this command is already run.

可执行已经执行本命令。请确认。

Group (%s) is offline.

请确认在发出处理请求的服务器中组是否已启动。

Group that specified resource(%s) belongs to is offline.

请确认指定资源所在组是否启动在处理要求的服务器上。

Specified script(%s) does not exist.

指定的脚本不存在。

%s %s : Specified resource(%s) is not exist.

指定的资源或者监视资源不存在。

%s %s : Specified resource(Category:%s, Keyword:%s) is not exist.

指定的资源或者监视资源不存在。

Specified group(%s) does not exist.

指定的组不存在。

This server is not permitted to execute clprexec.

请确认执行命令的服务器的IP地址是否已注册到限制Cluster WebUI连接的客户端IP地址列表中。

%s failed in execute.

请确认发行请求的目标EXPRESSCLUSTER服务器的状态。

2.16. 重启次数控制 (clpregctrl命令)

进行重启次数限制的控制。

命令行
clpregctrl --get
clpregctrl -g
clpregctrl --clear -t type -r registry
clpregctrl -c -t type -r registry
说明

在服务器上显示/初始化重启次数。

选项
-g, --get

显示重启次数信息。

-c, --clear

初始化重启次数。

-t type

指定要初始化重启次数的类型。可指定的类型是rc或rm。

-r registry

指定注册表名称。可指定的注册表名称是haltcount。

返回值

0

正常结束

1

执行权限无效

2

二重启动

3

选项无效

4

配置信息非法

10～17

内部错误

20～22

获取重启次数信息失败

90

内存定位失败
注意事项

请以拥有Administrator权限的用户身份执行该命令。

执行示例

  • 显示重启次数信息

    # clpregctrl -g
******************************
-------------------------
type : rc
registry : haltcount
comment : halt count
kind : int
value : 0
default : 0
-------------------------
type : rm
registry : haltcount
comment : halt count
kind : int
value : 3
default : 0
******************************
success.(code:0)

#

    例1，2初始化重启次数。

    例1: 因组资源异常而初始化重启次数时

    # clpregctrl -c -t rc -r haltcount
success.(code:0)
#

    例2: 因监视资源异常而初始化重启次数时

    # clpregctrl -c -t rm -r haltcount
success.(code:0)
#
错误消息

消息

原因/处理方法

Command succeeded.

命令成功。

Log in as Administrator.

没有命令的执行权限。请以拥有Administrator权限的用户身份执行。

The command is already executed.

命令已执行。

Invalid option.

选项错误。

Internal error. Check if memory or OS resources are sufficient.

可执行是内存不足或者OS资源不足。请确认。

2.17. 确认进程的健全性 (clphealthchk 命令)

确认进程的健全性。

命令行

clphealthchk [ -t pm | -t rc | -t rm | -t nm | -h]

注解

本命令在单一服务器上确认进程的健全性。请在要确认健全性的服务器上执行。

说明

确认单一服务器上的进程健全性。

选项
无

确认pm/rc/rm/nm的健全性。

-t <param>
  • pm
    确认pm的健全性。
    • rc
      确认rc的健全性。
    • rm
      确认rm的健全性。
    • nm
      确认nm的健全性。
-h

显示Usage。

返回值

0

正常结束

1

执行权限非法

2

二重启动

3

初始化错误

4

选项无效

10

进程失控监视功能未设置

11

集群未启动状态(包含集群启动处理中，集群停止处理中)

12

集群挂起状态

100

存在一定时间内没有更新健全性信息的进程

-t选项指定时，指定进程的健全性信息一定时间内未更新

255

其他内部错误
执行示例

例1：健全时

# clphealthchk
pm OK
rc OK
rm OK
nm OK

例2：clprc失控时

# clphealthchk
pm OK
rc NG
rm OK
nm OK
# clphealthchk -t rc
rc NG

例3：集群停止时

# clphealthchk
The cluster has been stopped
备注

集群停止或挂起时进程是停止的。

注意事项

请以拥有Administrator权限的用户身份执行该命令。

错误消息

消息

原因/处理方法

Log in as Administrator.

无执行命令的权限。请用有Administrator权限的用户执行。

Initialization error. Check if memory or OS resources are sufficient.

可执行是内存不足或OS资源不足。请确认。

Invalid option.

请指定正确的选项。

The function of process stall monitor is disabled.

进程失控监视功能无效。

The cluster has been stopped.

集群处于停止状态。

The cluster has been suspended.

集群处于挂起状态。

This command is already run.

本命令已被执行。

Internal error. Check if memory or OS resources are sufficient.

可执行是内存不足或OS资源不足。请确认。

2.18. 设定从集群外实行关闭操作系统时的动作(clpstdncnf 命令)

设定从集群外执行关闭操作系统时的动作。

命令行
clpstdncnf -e [time]
clpstdncnf -d
clpstdncnf -v
说明

设定从集群外执行关机时的动作。

选项
-e [time]
实行关闭操作系统时，time指定集群服务停止的等待时间。
Time以分钟单位，可指定为1-1440的值。
第2次以后可以不指定time。不指定时使用当前的设定值。
-d

实行关闭操作系统时，不等待集群服务停止。

-v

确认设定内容。

返回值

0

正常结束

0以外

异常结束
注意事项
请以拥有Administrator权限的用户身份执行该命令。
云等虚拟环境下，由虚拟化基础架构侧实行关闭客户机操作系统时，如果关闭客户机操作系统需要时间，则虚拟化基础架构侧可以强制停止虚拟机电源。
执行示例

例1:集群服务停止的等待时间为最长30分钟时

# clpstdncnf -e 30
Command succeeded.
# clpstdncnf -v
Mode : wait
Timeout : 30 min

例2: 不等待集群服务停止时

# clpstdncnf -d
Command succeeded.
# clpstdncnf -v
Mode : no wait
Timeout : 30 min

2.19. 显示集群统计信息(clpperfc 命令)

显示集群统计信息。

命令行
clpperfc --starttime -g group_name
clpperfc --stoptime -g group_name
clpperfc -g [group_name]
clpperfc -m monitor_name
说明

显示组的启动，停止时间的中位数(毫秒)。

显示监视资源的监视处理时间(毫秒)。

选项
--starttime -g group_name

显示组的启动时间的中位数。

--stoptime -g group_name

显示组的停止时间的中位数。

-g [group_name]

显示组的启动，停止时间的中位数。

省略groupname时，显示所有组的启动，停止时间的中位数。

-m monitor_name

显示最近的监视资源的监视处理时间。

返回值

0

正常结束

1

命令选项不正确

2

用户认证错误

3

配置信息加载错误

4

配置信息加载错误

5

初始化错误

6

内部错误

7

内部通信初始化错误

8

内部通信连接错误

9

内部通信处理错误

10

对象组检查错误

12

超时错误
执行示例 (显示组的启动时间的中位数时)
# clpperfc --starttime -g failover1
200
执行示例 (显示特定组的启动，停止时间的中位数时)
# clpperfc -g failover1
            start time    stop time
failover1          200          150
执行示例 (显示监视资源的监视处理时间时)
# clpperfc -m monitor1
100
备注

本命令输出的时间单位为毫秒。

无法取得有效的组的启动时间，停止时间时，显示 - 。

无法取得有效的监视资源的监视时间时，显示0。

注意事项

请有root权限的用户执行本命令。

错误消息

消息

原因/处理方法

Log in as Administrator.

请有Administrator权限的用户执行。

Invalid option.

命令选项不正确。请确认命令选项。

Command timeout.

执行命令超时。

Internal error.

内存不足或者OS资源不足。请确认。

2.20. 检查集群配置信息(clpcfchk 命令)

检查集群配置信息。

命令行
clpcfchk -o path [-i conf_path]
说明

根据集群配置信息确认设定值的妥当性。

选项
-o path

指定保存检查结果的目录。

-i conf_path

指定保存要检查的配置信息的目录。

省略时检查已反映的配置信息。

返回值

0

正常结束

0以外

异常结束
执行示例 (检查已反映的配置信息时)
# clpcfchk -o /tmp
server1 : PASS
执行示例 (检查已保存的配置信息时)
# clpcfchk -o /tmp -i /tmp/config
server1 : PASS
执行结果

在本命令结果中显示的检查结果(综合结果)如下所示。

检查结果(综合结果)

说明

PASS

没有问题。

FAIL
有问题。
请确认检查结果。
备注

只显示各个服务器的综合结果。

注意事项

请有root权限的用户执行本命令。

要使用Cluster WebUI 检查导出的配置信息时，请事先对其进行解压缩。

错误消息

消息

原因/处理方法

Log in as Administrator.

请有Administrator 权限的用户执行。

Invalid option.

请指定正确的选项。

Could not opened the configuration file. Check if the configuration file exists on the specified path.

指定的路径不存在。请指定正确的路径。

Server is busy. Check if this command is already run.

本命令已启动。

Failed to obtain properties.

获取属性失败。

Failed to check validation.

检查集群配置失败。

Internal error. Check if memory or OS resources are sufficient.

内存不足或者OS资源不足。请确认。

2.21. 添加防火墙的规则（clpfwctrl命令）

添加、删除在EXPRESSCLUSTER中使用的服务器的防火墙的"入站规则"。

命令行
clpfwctrl --add [--profile public | private | domain]
clpfwctrl --remove
clpfwctrl --help
说明

注解

该命令请在启用服务器的防火墙时执行。

注解

该命令在单个服务器上添加、删除防火墙的"入站规则"。需要在想添加、删除的所有服务器上执行。

注解

请在安装 EXPRESSCLUSTER 后和在反映配置信息后立即执行该命令。

为了能访问在 EXPRESSCLUSTER使用的端口号，添加防火墙的"入站规则"。另外，删除已添加的"入站规则"。
关于通过该命令设置的端口号、协议的详细内容，请参考《EXPRESSCLUSTER X SingleServerSafe安装指南》的"关于EXPRESSCLUSTER X SingleServerSafe"的"确认及准备安装前的服务器环境"的"确认防火墙的设置 (必须)"。
将 EXPRESSCLUSTER 使用的规则添加到具有以下组名和名称的"入站规则"中。相同组名已经添加时，删除一次后，再进行添加。请不要更改组名。

  • 组名

    • EXPRESSCLUSTER

  • 名称

    • EXPRESSCLUSTER (TCP-In)

    • EXPRESSCLUSTER (UDP-In)

    • EXPRESSCLUSTER (ICMPv4-In)

    • EXPRESSCLUSTER (ICMPv6-In)

选项
--add [--profile public | private | domain]

添加防火墙的"入站规则"。如果指定profile名，则添加已指定的profile。 profile名未指定时，指定"全部"。

--remove

删除已添加的防火墙的"入站规则"。

--help

显示Usage。

返回值

0

成功

0 以外

异常
注意事项
请具有Administrator权限的用户执行该命令。
该命令不进行"入站规则"的添加。如有需要请另行添加。
如果只注册了一次JVM监视资源，则该命令必须允许JVM监视资源的管理端口号。
执行示例

在profile中指定"全部"后添加"入站规则"时

# clpfwctrl.bat --add
Command succeeded.
执行示例

在profile中指定"域"和"个人"后添加"入站规则"时

# clpfwctrl.bat --profile domain private
Command succeeded.
执行示例

删除已添加的"入站规则"时

# clpfwctrl.bat --remove
Command succeeded.
错误消息

消息

原因/处理方法

Log in as Administrator.

请由具有Administrator权限的用户执行。

Invalid option.

请指定正确的选项。

Log directory is not found.

可能没有正确安装，或者没有执行权限。

Failed to register rule(CLUSTERPRO). Invalid port.

配置信息中设置了不正确的端口号。请确认配置信息。

Unsupported environment.

是不支持的OS环境。

Could not read xmlpath. Check if xmlpath exists on the specified path. (%1)
请确认xml路径是否在配置信息中存在。
%1：xml路径

Could not opened the configuration file. Check if the configuration file exists on the specified path. (%1)
请确认配置信息是否存在。
%1：xml路径

Could not read type. Check if type exists on the policy file. (%1)
请确认政策（policy）文件是否存在。
%1：xml路径

not exist xmlpath. (%1)
请确认xml路径是否在配置信息中存在。
%1：xml路径

Failed to obtain properties. (%1)
请确认xml路径是否在配置信息中存在。
%1：xml路径

Not exist java install path. (%1)
请确认Java安装路径是否存在。
%1 ：Java安装路径

Internal error. Check if memory or OS resources are sufficient. (%1)
可能内存不足或者OS的资源不足。请确认。
%1：xml路径

3. 注意限制事项

本章将说明注意事项，现有问题及其避免方法。

本章中介绍的内容如下。

3.1. 操作 EXPRESSCLUSTER X SingleServerSafe后

请注意操作开始后的现象。

3.1.1. 恢复运行中的操作限制

使用查出监视资源异常时的设置，为恢复对象指定组资源(应用程序资源，服务资源......)，请不要在查出监视资源异常时的恢复运行迁移中 (重新启动 -> 最终运行)，请根据Cluster WebUI和命令不要执行以下的操作。

  • 服务器的停止/挂起

  • 组的启动 / 停止

如果在监视资源异常，正在恢复运行时执行上述控制，该组的其他组资源可执行不会停止。
然而，监视资源异常时，如果执行了最终运行，则可以进行上述的控制。

3.1.2. 关于命令参考里没有记载的可执行文件和脚本文件

安装目录下存在命令篇中未被记载的执行形式的文件及脚本文件。但是，请不要在EXPRESSCLUSTER X SingleServerSafe以外执行。
不支持执行后的影响。

3.1.3. 关于Cluster WebUI

  • 如果在与连接目标无法通信的状态下进行操作，则等待控制返回可执行会花费些许时间。

  • 经由Proxy服务器时请对Proxy服务器进行设置，以便可以中转Cluster WebUI的端口号。

  • 经由Reverse Proxy服务器时，Cluster WebUI不能正常运行。

    对EXPRESSCLUSTER X SingleServerSafe进行升级后，请关闭所有运行中的Web浏览器。

    清空浏览器的缓存后再重启浏览器。

  • 使用比本产品更新的版本创建的集群配置信息，不能在本产品中使用。

  • 结束Web浏览器后(窗口边框中的[X]等)，可执行会弹出确认对话框。
    若要保存当前配置，请选择[留在此页]。
  • 刷新Web浏览器(菜单中的[刷新]及工具条上的[刷新]等)后，可执行会弹出确认对话框。
    若要保存当前配置，请选择[留在此页]。

  • 有关上述以外的 Cluster WebUI 注意事项和限制请参考在线版手册。

3.1.4. 关于EXPRESSCLUSTER X SingleServerSafe Disk Agent服务

EXPRESSCLUSTER X SingleServerSafe Disk Agent服务在EXPRESSCLUSTER X SingleServerSafe 中不使用。请别启动EXPRESSCLUSTER X SingleServerSafe Disk Agent服务。

3.1.5. 关于Windows Server 2012以后环境中的用户帐户控制的影响

Windows Server 2012以后中默认值的用户帐户控制 (UAC 是User Account Control的略称) 设置为有效。如果UAC有效时，对下述的功能产生影响。

监视资源

对下面所述的监视资源产生影响。

Oracle 监视资源

Oracle 监视资源中的认证方式为[OS认证]，且设置了Built-in Administrator以外的用户时，监视处理会失败。

3.1.6. 关于应用程序资源/脚本资源的画面显示

从EXPRESSCLUSTER X SingleServerSafe的应用程序资源及脚本资源启动的进程由会话0执行，因此，启动有GUI的进程时，将显示「检测对话型服务对话框」的弹出窗口，如不在该弹出窗口中选择「显示提示信息」，GUI将不会显示。

3.1.7. 关于网卡(NIC)二重化的环境

NIC二重化的环境中，启动OS 时初始化NIC有时需要花费点时间。如果初始化结束前就启动集群，启动内核模式，LAN心跳资源(lankhb)有可执行失败。此状态下，即便NIC的初始化已结束，内核模式和LAN心跳资源也不能返回正常状态。要从此状态进行复归，需要挂起集群后对集群进行复原。
此外，为避免上述现象的发生，推荐对网络初始化结束等待时间进行设置或者使用[ARMDELAY]命令推迟集群的启动时间。
  • 网络初始化等待时间
    即便没有到达设置的时间，如果网络的初始化已经结束，集群就会开始启动。

3.1.8. 关于EXPRESSCLUSTER X SingleServerSafe服务的登录账户

EXPRESSCLUSTER X SingleServerSafe服务的登录账户是设定为[本地系统账户]的。如果改变登录账户的设置可执行会导致集群无法正常运行。

3.1.9. EXPRESSCLUSTER X SingleServerSafe的常驻进程的监视

通过其他可以监视进程的软件来对EXPRESSCLUSTER X SingleServerSafe的常驻进程进行监视本身是没有问题的。但是，在进程异常结束时等情况下请不要对该进程进行再启动等的复归动作。

3.1.10. 关于JVM监视资源

  • 重启监视对象的Java VM时，请将JVM监视资源挂起，或者停止集群后再进行。

  • 变更设计内容时，需要进行集群的挂起和集群的复原。

  • 不支持监视资源的延迟警报。

3.1.11. 关于系统监视资源，进程资源监视资源

  • 变更设置内容时，需要进行集群的挂起。

  • 不支持监视资源的延迟警报。

  • 集群正在运行时更改了OS的日期或时间的情况，由于每隔10分钟进行一次解析处理，所以在最初的1回可执行会出现延迟。从而会导致以下的情况的发生，请根据需求对集群进行挂起集群和恢复集群操作。

    • 已经过了异常检出所要时间而无法检测出异常。

    • 在异常检出所要时间之前就已经检测出异常。

  • 系统监视资源的磁盘资源监视功能可以同时监视的最大磁盘数为26台。

3.1.12. 关于 [对话型服务对话框的检出]的弹出显示

设定了应用程序资源/脚本资源的[允许桌面对话] ，要显示[对话型服务对话框的检出]的弹出框，需要起动「Interactive Service Derection」服务。

作为缺省值，「Interactive Service Derection」服务的起动是无效的，依照以下的步骤使它变成有效。

参见

http://msdn.microsoft.com/en-us/library/windows/desktop/ms683502(v=vs.85).aspx
->[Using an Interactive Service]