ibmint stop server 命令

使用 ibmint stop server 命令可停止集成服务器。

用法说明

不能使用 ibmint stop server 命令来停止独立集成服务器。 有关停止独立集成服务器的更多信息,请参阅停止集成服务器

支持的平台

  • Windows
  • Linux®
  • Linux on POWER ®
  • Z 上的Linux
  • AIX®
  • IBM z/OS® 容器扩展 ( ) zCX

语法

读取语法图跳过可视语法图ibmint stop serverserverName  --integration-nodenodeName--integration-node-filefilePath--admin-hosthost--admin-port端口--integration-nodenodeName--admin-uriURI--integration-nodenodeName--https--cacertcertFile--cacert-passwordcacertPassword--insecure--no-https--immediate--timeout-seconds--tracefilePath--help

参数

serverName
集成服务器的名称。

您必须至少指定一个参数,以下列形式之一标识目标集成节点 (a)、(b)、(c)、(d) 或 (e):

(a)
--integration-node nodeName
本地定义的集成节点的名称。
(b)
--integration-node-file filePath
此参数用于标识包含远程集成节点连接详细信息的 .broker 文件的名称。 指定此参数时,请包括位置(路径)和文件名。 运行此命令时,您必须确保该位置可供访问。 不能在同一命令中使用 --integration-node--integration-node-file

如果多个用户希望连接到同一个集成节点或集成服务器,或者您要使用 SSL 之类的高级连接参数,请使用此选项。 有关详细信息,请参阅通过创建.broker 文件连接到集成节点

如果您希望运行一个使用 SSL 通过受保护通道来管理远程集成节点或集成服务器的命令,那么必须使用 IBM_JAVA_OPTIONS 环境变量为连接指定密钥库和信任库密码。 有关更多信息,请参阅解决运行命令时出现的问题

(c)
--integration-nodenodeName--admin-host 主机 --admin-port 端口
对于不需要高级连接参数的连接,这些参数用于标识远程集成节点的节点名主机端口
  • --integration-node nodeName:此参数对于验证是可选的。
  • --admin-host: 运行集成节点的计算机的主机名或 IP 地址。
  • --admin-port port:Web 用户界面 HTTP 连接侦听器所侦听的端口。
(d)
--admin-uri 通用资源识别号
远程集成服务器的 URI,格式为 tcp://[user[:password]@]host:port。 您可以选择指定 --integration-node 参数,用 --admin-uri 进行验证。

如果要以特定用户身份来连接到受保护的集成节点,请按以下格式以 URI 形式提供安全凭证:tcp://user:password@hostname。 如果您的密码包含 URI 保留字符,必须将这些字符转换为百分比编码的格式。 有关更多信息,请参阅 " 解决运行命令时出现的问题 "中的 " 尝试连接远程主机名时,正确的 URL 和密码会返回错误 BIP1939 "。

(e)
--admin-uri URI --cacert cacertFile--cacert-passwordcacertPassword
远程集成服务器的 URI,格式为 ssl://[user[:password]@]host:port。 之后可选择有关 REST 通信的选项。

若要通过安全连接连接到集成服务器,您可以使用 参数 --cacert 指定证书文件的路径(格式可以是 PEM、 P12 或 JKS),并使用 --cacert-password 参数指定受密码保护的 cacert 文件的密码。

如果要以特定用户身份来连接到受保护的集成节点,请按以下格式以 URI 形式提供安全凭证:tcp://user:password@hostname。 如果您的密码包含 URI 保留字符,必须将这些字符转换为百分比编码的格式。 有关更多信息,请参阅 " 解决运行命令时出现的问题 "中的 " 尝试连接远程主机名时,正确的 URL 和密码会返回错误 BIP1939 "。

--https
(可选)指定 HTTPS 用于与集成节点或服务器的连接。 如果既未指定 --https 也未指定 --no-https ,则首先使用 HTTPS 尝试连接,如果第一次尝试失败,则不使用 HTTPS。
--no-https
(可选)指定与集成节点或服务器的连接不使用 HTTPS。 如果既未指定 --https 也未指定 --no-https ,则首先使用 HTTPS 尝试连接,如果第一次尝试失败,则不使用 HTTPS。
--cacert cacertFile
(可选)指定用于验证集成节点或服务器的证书文件(格式为 PEM、 P12 或JKS)的路径。 如果未指定 cacert 文件且启用了默认 admin-ssl,则 cacert 文件默认为 admin-ssl 的默认 pem 文件。
  • --cacert 参数只有在 HTTPS 用于连接时才有效,因此不能与 --no-https 参数一起设置。 您可以设置 --cacert--https 参数已设置时,或在 和 --no-https --https 参数均未设置时(此时默认使用 SSL )。
  • 只有指定了 --admin-host 参数,或指定了以 ssl:// 开头的 URI 的 --admin-uri 参数,才能设置 --cacert 参数。
--cacert-password cacertPassword
(可选)密码保护的 cacert 文件的密码。
  • --cacert-password 参数只有在 HTTPS 用于连接且已设置 --cacert 参数的情况下才有效。 不能与 --no-https 参数一起设置。
  • 只有指定了 --admin-host 参数,或指定了以 ssl:// 开头的 URI 的 --admin-uri 参数,才能设置 --cacert-password 参数。
--insecure
(可选)指定不验证集成节点或服务器返回的证书。
  • --insecure 参数只有在 HTTPS 用于连接时才有效,因此不能与 --no-https 参数一起设置。 您可以设置 --insecure--https 参数已设置时,或在 和 --no-https --https 参数均未设置时(此时默认使用 SSL )。
  • 只有指定了 --admin-host 参数,或指定了以 ssl:// 开头的 URI 的 --admin-uri 参数,才能设置 --insecure 参数。
--immediate
使集成服务器立即关闭。
--timeout-seconds seconds
等待集成服务器停止的最大秒数( 缺省值为 60)。
--trace filePath
(可选)使用此参数将详细的内部跟踪发送到指定的文件。
--help
(可选)使用此参数来显示有关该命令的帮助信息。

示例

要停止集成节点 myNODE 上的集成服务器 myServer
ibmint stop server  myServer --integration-node myNODE
使用包含远程集成节点的连接详细信息的 .broker 文件,在远程机器上停止集成服务器 myRemoteServer1 。 指定 120 秒的超时,并将详细的内部跟踪发送至指定的文件:
ibmint stop server myRemoteServer1 --integration-node-file C:\files\myConnectionFile.broker --timeout-seconds 120 --trace C:\files\myTraceFile.txt 
停止 IP 地址为 9.20.5.10 的远程机器上由端口 1234 上的集成节点 myRemoteNode2 管理的集成服务器 myRemoteServer2
ibmint stop server myRemoteServer2 --integration-node myRemoteNode2 --admin-host 9.20.5.10 --admin-port 1234