WebSphere WebSphere Enterprise Service Bus V6.0.1 操作系统: AIX, HP-UX, Linux, Solaris, Windows

错误消息:安装、概要文件的创建和扩充

下面列示了在安装 WebSphere ESB 时最常见的一些错误消息。

注: 有关在安装 WebSphere Application Server Network Deployment 时可能生成的消息的信息,请参阅 WebSphere Application Server Network Deployment 信息中心中提供的故障诊断信息。

如果没有看到与您的问题类似的问题,或者所提供的信息无法解决您遇到的问题,请访问 WebSphere ESB 支持以获取进一步的帮助。

节点名无效/主机名无效/单元名无效:名称以无效字符开头。

检查节点名、主机名和单元名是否包含有效的字符序列。可使用 IBM 提供的缺省值,或者确保这些名称没有使用禁用字符,如下所述:

节点名或单元名中不能有任何空格,并且不允许使用下列字符:/ \ * , : ; = + ? | < > & % ’ "。主机名中不能有任何空格,并且不能以上述任何字符开头,也不能用方括号([ ])将它括起来。

JDBC 驱动程序类路径文件所在的位置无效。

此消息的其余内容是:The following files could not be found. list of files Please reenter the directory for the Location of the JDBC driver classpath files。对于给定面板的数据库配置,“概要文件向导”将验证 JDBC 驱动程序是否具有必需的 JAR 文件。如果“概要文件向导”无法验证存在这些文件(每 种数据库类型具有不同的文件集),则此消息将随文件列表一起出现。这应该可以帮助您找到要指定的正确 目录。

概要文件正在使用中。继续前,请停止服务器。

如果现有概要文件当前正在运行,则“概要文件向导”将不会扩充它。您不需要退出“概要文件向导”;只需关闭服务器,然后继续执行“概要文件向导”。

不支持同时创建、扩充或删除概要文件。

此消息的其余内容是:Wait until the current creation or deletion operation is complete before continuing. 当正在创建、扩充或删除概要文件时,将对概要文件注册表进行全局锁定。此锁定阻止同时进行其他更改(创建/扩充/删除)。

解决方案:一次只运行任何“概要文件向导”的一个实例。继续前,请等待其他创建、扩充或删除过程完 成。如果您确定没有其他创建、扩充或删除过程在运行,则手工解除先前的安装尝试中可能留下的 profileRegistry.xml 锁定。要解除此锁定,删除 install_root/properties/profileregistry.xml_LOCK 文件即可。

安装向导无法安装 WebSphere ESB

日志文件的条目是:The Installation Wizard cannot install WebSphere ESB. The installation response file for WebSphere Application Server Network Deployment, responsefile.nd.txt, was not found.

可能的解决方案为:如果已将安装映像从一个位置复制到另一个位置(例如,在 Windows平台上,从产品 CD 复制到 C:\ 驱动器中),则应确保还要复制 WAS 目录(该目录中包含 responsefile.nd.txt 文件),并且该目录与安装映像的 WBI 目录位于同一根目录中。

找不到受支持的 IBM JDK。

日志文件的条目是:Supported IBM JDK was not found. The IBM JDK shipped with this product must be located at <install_image_root>/JDK. Please correct this problem and try again.

可以采用的解决方案是:如果已将安装映像从一个位置复制到另一个位置(例如,在 Windows平台上,从产品 CD 复制到 C:\ 驱动器中),则应确保还要复制 JDK 目录,并且该目录与安装映像的 WBI 目录位于同一根目录中。然后再次启动安装程序(在 Linux 或 UNIX 操作系统上,运行 WBI/install;或在 Windows 操作系统上,运行 WBI\install.exe)。

找不到受支持版本的 IBM WebSphere Application Server

日志文件的条目是:A supported version of IBM WebSphere Application Server was not found. The installation files for the version of IBM WebSphere Application Server Network Deployment shipped with this product must be located at <install_image_root>/WAS. Please correct this problem and try again.

如果在安装映像的根目录中未检测到随 WebSphere ESB 一起提供的该版本的 WebSphere Application Server Network Deployment,并且您正在尝试安装 WebSphere Application Server Network Deployment 的新实例以便与 WebSphere ESB 配合使用,或者安装向导正在尝试将现有 WebSphere Application Server 安装升级到受支持的级别,则会发生此错误。

如果已将安装映像从一个位置复制到另一个位置(例如,在 Windows平台上,从产品 CD 复制到 C:\ 驱动器中),则应确保还要复制 WAS 目录,并且该目录与安装映像的 WBI 目录位于同一根目录中。

系统上的可用磁盘空间不足。

LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上:日志文件的条目是:There is insufficient free disk space on the system. /tmp Required: 535 MB. Available: n MB. Please ensure there is enough free disk space on all required filesystems and retry the operation.

在 Linux 和 UNIX 平台上,当 WebSphere ESB 安装向导以静默方式安装 WebSphere Application Server Network Deployment 时,或者需要将 WebSphere Application ServerWebSphere Application Server Network Deployment 的现有安装升级到受支持的级别时,总共需要 535 MB 的 /tmp 磁盘空间。

先前进行的 WebSphere ESB 卸载失败。

日志文件的条目是:A previous attempt to uninstall WebSphere ESB failed for the following installation location: <install_root>. Follow the instructions on preparing for reinstallation after a failed uninstallation in the product information center to uninstall WebSphere ESB and then reinstall the product before attempting to use it.

如果您试图对不再有效的 WebSphere ESB 安装添加功能部件或者启动“概要文件向导”,则在安装向导中会发生此错误。

有关更多信息,请参阅有关在卸载失败之后准备重新安装的指示信息。

WebSphere ESB 安装无效

日志文件的条目是:The selected installation of WebSphere ESB is no longer valid since the underlying WebSphere ESBproduct has been uninstalled. Please uninstall WebSphere ESBfrom the following location: <install_root>. You must then reinstall WebSphere ESB before attempting to use the product.

如果您试图对由于已经卸载了底层的 WebSphere Application Server 而不再有效的 WebSphere ESB 安装添加功能部件或者启动“概要文件向导”,则在安装向导中就会发生此错误。

信息:因为其他产品正在使用 Common Event Infrastructure 应用程序,所以未卸载它。

当卸载 WebSphere ESB 时,如果有除了您正在卸载的 WebSphere ESB 实例之外的产品在使用 Common Event Infrastructure 应用程序,则会产生此消息。

信息:因为 Common Event Infrastructure 应用程序正在使用 WebSphere Application Server,所以未卸载它。

当卸载 WebSphere ESB 时,如果另一个使用 Common Event Infrastructure 的产品仍在使用底层的 WebSphere Application Server,并因此而无法卸载 WebSphere Application Server 时,就会产生此消息。

找不到合适的 JVM。

如果产生了以下消息:“找不到合适的 JVM。请使用 -is:javahome <JAVA HOME DIR> 选项来再次运行该程序”,则是因为找不到随 WebSphere ESB 一起提供的 JDK。如果已将安装映像从一个位置复制到另一个位置(例如,在 Windows平台上,从产品 CD 复制到 C:\ 驱动器中),则应确保还要复制 JDK 目录,并且该目录与安装映像的 WBI 目录位于同一根目录中。

错误:输入行太长

For Windows platforms 在 Windows 平台上:这是一个概要文件创建错误。在安装期间或使用“概要文件向导”时,可能会发生此错误。

安装问题(仅适用于完整安装)

install_root\profiles\default\logs 目录下的日志中的以下错误指示 wsadmin 操作未能为完整安装创建概要文件。故障原因是:命令字符串上的文件路径和节点名的长度导致整个命令超过了操作系统对命令长度的限制。
输入行太长。

安装目录路径不能超过 60 个字符。

  • 选项 1:如果安装失败,请使用更短的目录路径和更短的节点名来重新安装 WebSphere ESB

    在定制安装期间,“节点名”字段可用。缺省节点名的长度通常都足够短。应尽可能避免使用长度超过 10 个字符的节点名。

  • 选项 2:如果安装已成功,但 ISMPWSProfileLaunchAction 失败了,则使用“概要文件向导”来创建概要文件。创建概要文件时,应使用更短的目录路径、概要文件名和节点名。

    可以选择您自己的概要文件路径,例如,可以选择 C:\profiles

    可以选择您自己的概要文件名。

    install_root/logs/wbi/log.txt 文件中验证 ISMPConfigManagerLaunchAction 是否成功。

    log.txt 文件中检查下列消息,以确定安装是否已成功。如果已成功,则可以运行“概要文件向导”来创建缺省概要文件。
    (date time), Install,
         com.ibm.ws.install.ni.ismp.actions.ISMPConfigManagerLaunchAction,
         msg1, INSTCONFSUCCESS: Post-installation configuration is successful.
    (date time), Install,
         com.ibm.ws.install.ni.ismp.actions.ISMPWSProfileLaunchAction,
         err, INSTCONFFAILED: Cannot complete required configuration actions
         after the installation. The configuration failed. The installation is
         not successful. Refer to
         C:\Program Files\IBM\WebSphere\ProcServer\logs\wasprofile\
            wasprofile_create_default.log for more details.
    (date time), Install,
         com.ibm.ws.install.ni.ismp.actions.ISMPLogFileAction,
         msg1, Profile Creation is finished.
    (date time), Install,
         com.ibm.ws.install.ni.ismp.actions.ISMPLogSuccessMessageAction,
         msg1, INSTCONFFAILED

“概要文件向导”问题

profile_root\logs 目录下的日志中的以下错误指示 wsadmin 操作未能创建概要文件。profile_root 变量表示 WebSphere ESB 概要文件的安装位置(缺省情况下,在 Linux 和 UNIX 平台上,安装位置为 install_root/profiles/profile_name;在 Windows 平台上为 install_root\profiles\profile_name)。故障原因是:命令字符串上的文件路径、单元名和节点名的长度导致整个命令超过了操作系统对命令长度的限制。
输入行太长。

profile_root 中的字符数不能超过 80 个。

如果目录路径不超过 80 个字符并且仍存在问题,请编辑 install_root\bin\setupCmdLine.bat 文件,以让它使用 Windows 的 subst 命令。subst 命令会将整个路径映射至一个虚拟驱动器。在编辑该文件之后,再次运行“概要文件向导”。如果更改 setupCmdLine.bat 文件也不能修正该问题,则可以使用更短的安装路径(例如,C:\WPS)来安装 WebSphere ESB

有关如何编辑 setupCmdLine.bat 文件的描述,请参阅 WebSphere Application Server Network Deployment 信息中心中“启动或使用 wsadmin 命令时发生问题”的“输入行太长”部分。

注意:在安装期间将扩展下列文件系统

For AIX platforms 在 AIX 平台上:可以为 AIX 上的目录分配扩展空间。如果安装向导没有足够 的空间,则 InstallShield for MultiPlatforms(ISMP)将发出一个动态增加空间分配的系统调用以获取 更多空间。当对 /usr 目录执行此操作时,您可能看到的消息与以下示例相似:

NOTE: The following file systems will be expanded during the installation: /usr

磁盘空间比所需的少 nn Mbyte。安装无法继续。

LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上:如果不可动态地扩展文件系统,则磁盘空间量不足将导致产生与以下示例类似的消息:

The disk space is 33 Mbyte less than required. The installation cannot continue.

指定另一个目录或者执行手工卸载

此错误指示您在使用卸载程序来除去产品之前删除了安装根目录。现在,您正在尝试重新安装到同一目录中。

要修正该问题,必须除去那些会妨碍您将产品重新安装到原始目录中的注册表项。

要采用这种方法来“清理”系统,请参阅有关在卸载失败之后准备重新安装的指示信息。

$TMP/log.txt 文件中的警告条目是:
(Month day, year time), Install,
   com.ibm.ws.install.ni.ismp.actions.ISMPWarningDialogAction,
   wrn, Specify a different directory or perform a manual uninstall
   to remove all packages before reinstalling to the same directory.

写入文件时出错 = 可能没有足够的临时磁盘空间。

Error writing file =  There may not be enough temporary disk space.
Try using -is:tempdir to use a temporary directory on a partition
 with more disk space.

当您未提供足够的临时空间来创建概要文件时,会发生此错误。在创建概要文件之前,验证您是否至少 有 40 MB 的可用临时空间。

有关创建概要文件的更多信息,请参阅使用“概要文件向导”创建和扩充概要文件

错误:localhost 不是用于远程访问的有效主机名

当您输入 localhost 作为“概要文件向导”中“主机名”字段的值时,就会发生此错误。

主机名是用于安装节点的物理机器的网络名。主机名必须解析为服务器上的物理网络节点。当服务器上存在多个网卡时,主机名或 IP 地址必须解析为其中一个网卡。远程节点使用主机名来连接至此节点并与它通信。选择一个网络中的其他机器可以访问到的主机名非常重要。不要对此值使用普通的 localhost 标识。

如果您在同一台计算机上定义一些具有唯一 IP 地址的共存节点,则在域名服务器(DNS)查找表中定义每个 IP 地址。独立服务器的配置文件不会为具有单个网络地址的一台机器上的多个 IP 地址提供域名解析。

您为主机名指定的值被用作独立 WebSphere ESB 的配置文档中 hostName 属性的值。采用下列其中一种格式来指定主机名的值:
  • 标准域名服务器(DNS)主机名字符串,例如,xmachine.manhattan.ibm.com
  • 缺省的简短 DNS 主机名字符串,例如,xmachine
  • 数字 IP 地址,例如,127.1.255.3

标准 DNS 主机名具有非常明了且灵活的优点。您可以在不需要更改 WebSphere ESB 配置的情况下灵活地更改主机系统的实际 IP 地址。在使用“动态主机配置协议”(DHCP)来指定 IP 地址时,如果 您打算频繁更改 IP 地址,则此主机名的值非常有用。这种格式的缺点是对 DNS 的依赖。如果 DNS 不可用,则无 法建立连接。

简短主机名也是可以动态解析的。可以在本地 hosts 文件中重新定义短名称格式,因此,即使与网络的连接已断开,系统也可以运行 WebSphere ESB。在 hosts 文件中将短名称定义为 127.0.0.1(本地回送),以便在断开连接的情况下运行。这种格式的缺点是要依赖 DNS 来进行远程访问。如果 DNS 不可用,就无法建立连接。

数字 IP 地址的优点是不需要通过 DNS 进行名称解析。在 DNS 不可用的情况下,远程节点也可以连接至 您使用数字 IP 地址命名的节点。这种格式的缺点是数字 IP 地址是固定的。每当您更改机器的 IP 地址时,都必须更改配置文档中 hostName 属性的设置。因此,如果您使用 DHCP 或者要定期更改 IP 地址,则不要使用数字 IP 地址。这种格式的另一个缺点是:如果主机与网络的连接已断开,您就不能使用节点。

安装程序未能成功地将产品信息添加到 RPM 数据库中。

LINUX platforms 在 Linux 平台上:如果 install_root/logs/wbi/log.txt 文件的最后一行类似于以下示例,则问题可能是 RedHat Package Manager(RPM)数据库已损坏:
(date, time),
Plugin.Install,
com.ibm.wizard.platform.linux.LinuxProductServiceImpl,
wrn, The installer could not successfully add the product
information into the RPM database. Installation will continue
as this is not critical to the installation of the product.
运行以下命令来验证问题是毁坏了 RPM 数据库:
rpm -q --all

如果该命令被挂起,则问题就是毁坏了 RPM 数据库。

错误:java.io.IOException: konqueror: 未找到

LINUX platforms UNIX platforms 在 Linux 和 UNIX 平台上:“ISMP 启动浏览器”操作在 Linux 和 UNIX 系统上抛出了以下异常:

com.installshield.wizardx.actions.LaunchBrowserAction, err, java.io.IOException:
konqueror: not found
STACK_TRACE: 11
java.io.IOException: konqueror: not found
       at java.lang.UNIXProcess.forkAndExec(Native Method)
       at java.lang.UNIXProcess.<init>(UNIXProcess.java:72)
       at java.lang.Runtime.execInternal(Native Method)
       at java.lang.Runtime.exec(Runtime.java:602)
       at java.lang.Runtime.exec(Runtime.java:524)
       at java.lang.Runtime.exec(Runtime.java:490)
       at com.installshield.util.BrowserLauncher.openURL
(BrowserLauncher.java:578)
       at com.installshield.wizardx.actions.LaunchBrowserAction.execute
(LaunchBrowserAction
.java:62)
       at com.installshield.wizard.RunnableWizardBeanContext.run
RunnableWizardBeanContext.
java:21)

此操作搜索 Netscape、Mozilla 或 Konqueror 浏览器以显示一个 HTML 页或 Web 站点。对于 WebSphere Application Server 的 Web 服务器插件,目标页是插件路线图。尽管“ISMP 启动浏览器”操作可能找到 Mozilla 或 Netscape,但仍然抛出了此异常并且记录一条日志条目。

可以安全地忽略此错误。


参考主题

使用条款 | 评价此页

Timestamp icon上次更新时间: 3 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\doc\iins_errinstall.html

(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)