排除初始安装的故障
通读下面的常见问题描述可以帮助您对安装问题进行故障排除。
问题:
安装失败时,安装程序日志未写入到 <安装目录>/installer/logs 的标准输出目录中。
操作:
在这种情况下,安装程序将显示其所产生的安装日志文件的位置。记下安装程序所指定的位置。日志文件的位置取决于在安装过程中安装失败的时间。有关详细信息,请参阅
安装日志文件。
问题:
在 Windows 上进行安装时,在安装完成前且 PTC 解决方案安装程序 (PSI) 关闭后,安装失败。
操作:
这可能是由于 Windchill 目录服务器或 Java 未安装在本地驱动器上。可在 WINDCHILLDS_PtcInstall.log 中找到以下错误:
javax.naming.CommunicationException: Could not connect to the LDAP Server
问题:
如果要在 IBM AIX 平台上安装 Windchill Directory Server,则安装可能会失败,并出现以下错误:
javax.naming.CommunicationException: Could not connect to the LDAP Server,
ldap port: 389 ldap manager: cn=Manager at com.ptc.ldapserver.install.
actions.CheckServerStatus.process(CheckServerStatus.java:78)
at com.ptc.windchill.install.framework.InstallAction.run(InstallAction.java:476)
默认情况下,IBM JVM 最初使用 Internet 协议版本 6 (IPv6) 实现所有网络访问,后面会使用 IPv4。如果站点的域名服务器未相应地设置为响应 IPv6 请求,则 IPv6 请求可能会在尝试使用 IPv4 前超时。例如,即便是获取本地主机名的简单请求也可能会导致这种超时。Windchill Directory Server代码会发出多个本地主机名请求,因此,在一些 AIX 站点上可能需要很长时间才能启动。
Windchill Directory Server安装进程只等待 120 秒供 Windchill Directory Server启动,然后再继续安装任务,并且必须运行该服务器才能成功完成安装。如果由于 DNS 超时而使 Windchill Directory Server的启动时间超过 120 秒,则 Windchill Directory Server的安装可能会失败,同时出现上述错误。虽然 Windchill Directory Server最终可能会启动,但是安装不会成功完成,并且您将不能连接到“控制面板”。
操作:
这是站点的 IPv6 DNS 配置以及 IBM JVM 对 IPv6 的使用方式方面的问题。有关该问题的详细信息,请参阅 IBM 站点上的信息,网址如下:
另请参阅以下链接提供的 RFC 4074:
解决该问题的方法之一是更新 DNS 以正确响应 IPv6 请求,如 RFC 4074 的第 3 部分所述。
纠正该问题后,重新运行安装程序。
或者,如果不使用 IPv6,可将以下行添加到 /etc/netsvc.conf 文件,从而将 IP 配置设置为只使用 IPv4:
hosts=bind4,local
使用 IPv4 来纠正导致 Windchill 目录服务器安装失败的超时问题。
纠正该问题后,重新运行安装程序。
问题:
在 UNIX 系统中,安装程序无法运行。
如果 TMP 目录不具备安装程序所需的磁盘空间,则可能会出现此问题。
操作:
请在启动了安装程序的 shell 中设置环境变量 LAX_DEBUG=1,然后重新启动安装程序。这会导致输出写入到控制台窗口中。
如果产生的输出表明执行此安装所需的 /tmp 磁盘空间大于可用磁盘空间,则可将 IATEMPDIR 环境变量设置为具有足够空闲磁盘空间的磁盘分区上的目录。然后重新启动安装程序。
要设置变量,请在再次运行此安装程序前,在 UNIX 命令行提示符下输入如下命令之一:
• 对于 Bourne shell (sh)、ksh、bash 和 zsh:
$ IATEMPDIR=/<your>/<free>/<space>/<directory>
$ export IATEMPDIR
• 对于 C shell (csh) 和 tcsh:
$ setenv IATEMPDIR /<your>/<free>/<space>/<directory>
问题:
安装程序找不到有效的 Java 虚拟机 (JVM)。
在下列情况下,可能会出现此问题:
• 如果您尝试使用位于 NoVM 目录中的可执行文件运行安装程序。
• 您尝试通过网络连接从 Windchill 第三方软件 CD 或 Windchill Services CD 安装某个产品,并且在您的本地计算机上没有受支持的 JVM。对于安装程序而言,支持的 JVM 版本为 Java 1.5。
可能会返回以下消息:
◦ The installer requires Java 1.5 in your path. (针对 UNIX)
◦ Could not find a valid JVM to load. (针对 Windows)。
操作:
如果您没有使用位于 CD 根目录中的安装脚本,请使用根目录中的安装脚本重新运行安装程序。从根目录运行安装程序可确保使用与安装程序捆绑在一起的 JVM。
如果通过网络连接进行安装,请找到受支持的 JVM 并使用安装命令重新运行安装程序 (以下列自变量作为命令行中的头两个自变量)。
UNIX:
<install_dir>/<setup_script> LAX_VM <java_install_dir>/bin/java
Windows:
<install_dir>/<setup_script> LAX_VM <java_install_dir>/bin/java.exe
其中 <install_dir> 是安装文件的目录路径,<setup_script> 是 CD 根目录中您要安装产品的安装脚本 (例如 setup_tomcat.vbs),<java_install_dir> 是 JVM 的安装目录。第二个自变量为实际 Java VM 可执行文件,而不是目录。如果传入任何其他自变量,则它们必须在这两个自变量之后。
Alternative Method:
从命令行运行安装脚本并包括 LAX_VM 选项的另一个方法是将 LAX_VM 环境变量设为将在命令行中使用的同一个值。设置此变量后,运行 CD 根目录中的安装脚本会将 LAX_VM 和 <java_install_dir>/bin/java 自动添加到您要启动的安装程序的命令行。
问题:
在 AIX 中,安装程序核心转储并且无法启动。
操作:
如果设置了 IBM_MIXED_MODE_THRESHOLD 环境变量,则可能会出现此问题。取消设置 IBM_MIXED_MODE_THRESHOLD 变量。
问题:
技术支持部门要求您提供关于安装程序如何启动以及使用何种 JRE 执行安装程序的其他诊断信息。
操作:
获取其他诊断信息的方法共有两种:
• 在某些 Windows 版本中,可以在按下 CTRL 键的同时双击位于 CD 根级的 setup.vbs 脚本。将会出现一个带有诊断信息的命令 shell 窗口。可将此信息复制到一个文件中,然后发送至技术支持部门。
• 在 UNIX 和 Windows 上,可将环境变量 LAX_DEBUG 设置为 1。然后执行 CD 根级的安装程序的设置脚本。诊断信息将显示在同一个命令窗口 (UNIX) 或弹出窗口 (Windows) 中。
问题:
安装程序无法运行。返回的错误消息表明未满足以下某个要求:
• 安装程序只在下列平台上运行:
AIX、HP-UX、Solaris、Windows 2000 或 Windows 2003
• 此安装程序要求在路径中有 Java 1.5 或更高版本。
操作:
请确保在受支持的平台上运行。虽然该消息并未指明支持 Windows XP,但安装程序同样可以在 Windows XP 上运行。
此外,请确保使用位于 CD 根目录中的脚本来运行安装程序。这样可确保使用与安装程序捆绑在一起的 Java 虚拟机。
问题:
有时安装程序似乎会跳过某个步骤。
操作:
安装程序的工作方式类似于向导程序,具有“下一步”和“上一步”按钮。在响应较慢的系统中,向导进入到下一步或上一步的速度可能比您预期的速度慢,而您可能又再次 (重复) 单击了“下一步”或“上一步”按钮。此鼠标单击事件会排队等候处理,并在系统响应时立即执行。这就会跳过预期的窗口而进入后面的窗口。
单击了“下一步”或“上一步”按钮后,请等待安装程序响应,然后进入到预期的窗口。
在正常的系统条件下,安装程序在各窗口之间前后移动时很少会有明显的延迟。
此问题已被归档为软件厂商 Macrovision 的错误。
问题:
在 Windows 中,安装程序的“取消安装”对话框要求获得用户界面焦点。
操作:
当您尝试通过“取消安装”对话框取消安装程序时,此窗口会在桌面上独占窗口焦点。
要释放焦点,请单击取消 (对话框右上角的 X) 或“恢复”按钮。
问题:
在安装期间,安装程序会显示下列内容:
操作:
出现此窗口表明安装程序无法从当前介质集中找到所需的文件。
如果是通过网络进行安装,该窗口可能指示通过网络的响应时间对于安装程序来说太长。单击“取消”并重新运行安装程序。如果再次显示窗口,请尝试在网络不太拥挤的情况下或通过其他网络来运行安装程序,或将安装文件复制到您的本地系统中。
如果从安装 CD 或本地目录安装,则安装数据集不完整。请再次尝试下载安装文件。如果还不能解决问题,请与技术支持部门联系以寻求帮助。
问题:
在 Windchill Index Search 中搜索关键字时,出现以下错误消息:
Resource limit Exceeded
问题:
如果 Windchill Index Search 服务器未运行,则 UNIX 系统会在数据加载过程中出现以下错误消息:
Indexing Queue is Experiencing Problems
操作:
PTC 建议您在数据加载期间禁用索引,并使用“批索引工具”使加载操作更为高效。
另外,还需要确保 Windchill Index Search 在启动数据加载前有足够的时间来完全启动,并且索引队列已就绪。您需要直接检查此情况。
如果错误仍然出现,则请手动启动 Windchill Index Search。请参阅“完成配置 - 手动步骤”中的相关信息。
| 索引错误在 Windchill Index Search 启动并正确运行后便可立即消除。然后,一切均应正常运行。 |
问题:
在 AIX 上,安装带有多个可选产品的 Windchill 解决方案失败。
操作
从 JDK 装载的最后一个 JAR 始终应当是 tools.jar。
AIX 限制 classpath,所以在安装的可选产品很多时较长的类路径会被截断。诊断此问题的最佳时机是在方法服务器日志上端列出的 classpath 的最后一行或几行被随意截断时,如下所示。另一个常见的附加现象是主体行异常
- wt.util.WTException: java.lang.NoClassDefFoundError:
com.sun.tools.javac.Main (also in the MethodServer log).
Example, Non-Working MethodServer Log
Mon 6/30/08 16:27:15: main: -----------------------------------
--------------------------------------------
Mon 6/30/08 16:27:15: main: INFO : wt.method.server.startup -
Starting MethodServer
Mon 6/30/08 16:27:15: main: INFO : wt.method.server.startup -
JVM id: 647398
Mon 6/30/08 16:27:15: main: INFO : wt.method.server.startup -
JVM: 1.6.0, IBM Corporation
Mon 6/30/08 16:27:15: main: INFO : wt.method.server.startup -
Class path =
Mon 6/30/08 16:27:15: main: /mnt/disk2/ptc/Windchill/codebase
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/activation.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ieWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-
INF/lib/ie3rdpartylibs.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ieWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/install.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/mail.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/Gantt.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-chart-
all.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-framework-
all.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-gantt-
all.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-
INF/lib/wc3rdpartylibs.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/prowtWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/wncWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/pdmlWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/sumaWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/scmiWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/pjlWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/GanttExplorer.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/tibjms.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ptlWeb.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/lib/servlet.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/lib/windu.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/lib/wnc.jar
Mon 6/30/08 16:27:15: main:
/mnt/disk2/ptc/Windchill/lib/pdml.jar
Mon 6/30/08 16:27:15: main: /mnt/disk2/ptc/
Mon 6/30/08 16:27:15: main: INFO : wt.method.server.startup -
Setting WTContext time zone to America/Chicago; offset: -5.0
Mon 6/30/08 16:27:15: main: INFO : wt.method.server.startup -
Setting default time zone to GMT; offset: 0.0
Example, Working MethodServer Log
Thu 6/26/08 18:20:36: main: -----------------------------------
--------------------------------------------
Thu 6/26/08 18:20:36: main: INFO : wt.method.server.startup -
Starting MethodServer
Thu 6/26/08 18:20:38: main: INFO : wt.method.server.startup -
JVM id: 466962
Thu 6/26/08 18:20:38: main: INFO : wt.method.server.startup -
JVM: 1.6.0, IBM Corporation
Thu 6/26/08 18:20:38: main: INFO : wt.method.server.startup -
Class path =
Thu 6/26/08 18:20:38: main: /mnt/disk2/ptc/Windchill/codebase
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/activation.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ieWeb.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ie3rdpartylibs.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ieWeb.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/install.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/mail.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/Gantt.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-chart-all.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-framework-all.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-gantt-all.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/wc3rdpartylibs.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/prowtWeb.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/wncWeb.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/pdmlWeb.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/sumaWeb.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/scmiWeb.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/lib/servlet.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/lib/windu.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/lib/wnc.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/lib/pdml.jar
Thu 6/26/08 18:20:38: main:
/mnt/disk2/ptc/Windchill/lib/scmi.jar
Thu 6/26/08 18:20:38: main:/mnt/disk2/ptc/Java/lib/tools.jar
Thu 6/26/08 18:20:38: main: INFO : wt.method.server.startup -
Setting WTContext time zone to America/Chicago; offset: -5.0
Thu 6/26/08 18:20:38: main: INFO : wt.method.server.startup -
Setting default time zone to GMT; offset: 0.0
问题:
在 UNIX 上以根用户身份安装时,PTC 解决方案安装程序将在单击“安装”后终止。
操作:
清除 SESSION_MANAGER 变量。如果以非根用户身份使用 PSI,则不会出现此问题。