[AIX Solaris HP-UX Linux Windows][IBM i]

命令行工具问题

对有关使用命令行工具的各种问题进行故障诊断。

您遇到的是哪类问题？
[AIX Solaris HP-UX Linux Windows][IBM i]

节点联合期间，addNode.sh 脚本或 BBOWADDN 作业失败。

仅当定制期间在 Deployment Manager 上运行 BBODCFGW 作业时，才会出现此错误。 BBODCFGW 将具有 Web 服务器的非受管节点添加至 Deployment Manager，从而导致基本服务器中的节点联合失败。

要解决此问题，在所有节点联合到单元中之前，请不要在 Deployment Manager 上配置 BBODCFGW 作业。 另外，在所有节点已联合前，请不要在单元中添加任何非受管节点。 可在受管节点上配置 Web 服务器而不会出现任何问题。

[AIX Solaris HP-UX Linux Windows][IBM i]

在 Red Hat Linux 机器上启用 DEBUG 的情况下，当启动应用程序服务器时，将禁用即时 (JIT) 编译器

在 Red Hat Linux 机器上启用软件开发者工具箱 (SDK) DEBUG 的情况下，当启动应用程序服务器时，将禁用即时 (JIT) 编译器，即使它设置为启用也是如此。 要验证此设置，请检查 SystemOut.log 或 startServer.log 文件。

使用管理控制台可以移除 Java 进程定义的下列 DEBUG 选项。 -Xdebug -Xnoagent

注: 本主题引用一个或多个应用程序服务器日志文件。 作为建议的替代方法，您可以将服务器配置为使用高性能可扩展日志记录 (HPEL) 日志和跟踪基础结构，而不是在分布式系统和 IBM® i 系统上使用 SystemOut.log ， SystemErr.log， trace.log和 activity.log 文件。 您还可以将 HPEL 与本机 z/OS® 日志记录工具结合使用。 如果您正在使用 HPEL，那么可以从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。 有关使用 HPEL 的更多信息，请参阅 有关使用 HPEL 对应用程序进行故障诊断的信息。
[AIX Solaris HP-UX Linux Windows][IBM i]

当配置库包含服务器定义时，startServer.sh 或 stopServer.sh 命令未能启动或停止服务器。

如果 startServer.sh 或 stopServer.sh 命令尝试启动或停止非 Java 进程，那么将出现此问题。 要解决此问题，请使用 -nowait 选项来启动或停止服务器，例如：
startServer.sh webserver1 -nowait
stopServer.sh webserver1 -nowait
[Windows][IBM i]

未指示服务器已在 Windows 上启动

当尝试从命令行启动已经启动的服务器时，系统未指示服务器已启动并且正在运行。 在 Windows 上运行 startManager.bat 时，将在命令返回前显示以下输出：

ADMU7701I: Because dmgr is registered to run as a Windows Service, the request to start this server will be completed by starting the associated Windows Service.

运行 startServer.bat 时，将在命令返回前显示以下输出：

ADMU7701I: Because server1 is registered to run as a Windows Service, the request to start this server will be completed by starting the associated Windows Service.

运行 WASService.exe 时，将在命令返回前显示以下输出：

Starting Service: service name

要检查服务器是否已启动或服务是否正在运行，请使用 serverStatus server_name 命令或 WASService -status service_name 命令。

[Windows]

将一个或多个 % 字符用作参数值的一部分

% 字符是 Microsoft Windows 操作系统使用的特殊字符。 如果在 Microsoft Windows 操作系统上运行，并且：
  • 调用某个命令或 .bat 文件（例如 profile_root 目录中的 stopServer.bat），并且该命令或 .bat 文件包含对 installation_root 目录中某个 .bat 文件的调用，以及
  • 将一个或多个 % 字符用作参数值的一部分

您必须为参数值中包含的每个 % 字符使用两个 % 字符 (%%) 以防止作为参数值一部分的 % 字符被操作系统使用。

例如，如果您希望将 was%admin 用作 -password 参数值，那么您必须指定以下命令：

wsadmin.bat -username wsadmin -password was%%admin

而不是：

wsadmin.bat -username wsadmin -password was%admin

ADMU0125E: 将新节点的时钟更改为在 Deployment Manager 时钟的 {0} 分钟以内

此问题的变通方法是将节点上的时间调整至 Deployment Manager 的建议范围内。 验证时区是否正确并且该时区内的时间是否正确。 对于 AIX 系统，如果节点系统上的时间在 Deployment Manager 的 5 分钟内，请查看 /etc/environment 文件中的 timezone 设置。 验证 TZ= 属性的设置是否正确。 例如，在中部时区，它应该为 TZ=CST6CDT。 有关更多信息，请参阅 Files Reference Web 站点的环境文件部分。

stopServer 命令未能停止服务器，因为系统无法对无效主机名创建连接器

如果因为系统无法对无效主机名创建连接器而使 stopServer 命令未能停止服务器，那么可以使用下列其中一种方法来停止服务器：
  • 停止操作系统上的服务器进程（例如，在 AIX、HP-UX、Linux 或 Solaris 计算机上，发出 kill 命令）。

    或

  • 打开 wsadmin 工具，直接连接至服务器的连接器端口并对服务器的 MBean 调用 stop 方法。 建议使用此方法，因为它会缓慢关闭正在进行的工作。
    1. 发出以下命令以连接至服务器：
      wsadmin -host host_name  -port connector_port  -conntype [SOAP | RMI ] 
-user user_ID -password password
    2. 对服务器的 MBean 调用 stop 方法。 例如，在 Jython 中，您可以使用以下命令：
      serverMBean = AdminControl.completeObjectName("*,type=Server")
   AdminControl.invoke(serverMBean, "stop")
[AIX][Windows]

在命令行上输入密码

对于环境变量的指定和目录注释，存在操作系统差异。 使用 Windows 命令行时，将 $variable 替换为环境变量的 %variable% ，并将目录路径中的每个正斜杠 (/) 替换为反斜杠 (\)。 如果您要在 Windows 系统上使用 bash shell，那么可以使用 UNIX 约定。

在 Unix 类型的操作系统上，通常最好始终将与所有标记关联的字符串值封装在双引号 ("") 中。 如果以下字符出现在字符串值中，那么您还需要使用 "!" 字符对这些字符进行转义: "!" ， "" "，" ` "。 这将阻止某些命令行 shell 解释这些值中的特定字符。

一些用法示例如下：
gsk7capicmd -keydb -create -db "/tmp/key.kdb" -pw "j\!jj"
注: 当 gsk7capicmd 提示值 (例如，密码) 引用字符串并添加转义字符时，不应执行此操作，因为 shell 不再影响此输入。
[Windows]
stopserver server1 -username fn_wasadmin -password mypass35 -trace
[AIX]
stopserver server1 -username fn_wasadmin -password 'mypass35' -trace
避免麻烦: 通常，对于 ws_ant.sh 脚本，请对包含特殊字符的字符串使用单引号:
  • 对于包含单引号或双引号的字符串，请使用其他字符以将字符串括在其中。 例如，如果指定 bin/ws_ant.sh -f ant.xml -Dsystem.property='"a quoted String"'，那么该属性将设置为 "a quoted string"。 同样，如果指定 bin/ws_ant.sh -f ant.xml -Dsystem.peoperty="'a quoted string'"，那么该属性将设置为 'a quoted string'。

    同一字符串中不能同时包括单引号和双引号。

  • 对于包含左引号的字符串，请使用单引号将字符串括在其中并对左引号使用反斜杠以进行转义。 例如，如果指定 bin/ws_ant.sh -f ant.xml -Dsystem.property='\`a quoted string\`'，那么该属性将设置为 `a quoted string`。
  • 对于包含反斜杠的字符串，请使用单引号将字符串括在其中并使用反斜杠进行转义。 例如，如果指定 bin/ws_ant.sh -f ant.xml -Dsystem.property='c:\\Program Files\\IBM'。 那么属性将设置为 c:\Program Files\IBM。
  • 对于包含美元符号的字符串，请使用单引号将字符串括在其中并使用反斜杠进行转义。 例如，如果指定 bin/ws_ant.sh -f ant.xml -Dsystem.property='\$3.99'，那么该属性将设置为 $3.99。

[AIX Solaris HP-UX Linux Windows][IBM i]如果这些步骤都无法修复您的问题，请通过查看可用的联机支持 (提示和技巧，技术说明和修订) 来检查是否已识别并记录该问题。 如果您的问题未列示在此处，请联系 IBM 支持。