Apusic5.1故障诊断手册.docVIP

Apusic故障诊断手册 编 制 单 位：金蝶中间件有限公司 编 制 日 期：二〇〇八年十一月 目 录 一、 前言 1 1.1.文档范围和读者 1 1.2.文档导航 1 1.3.文档约定 1 二、 常见问题解答及故障诊断 1 2.1.支持的JDK及版本 1 2.2.如何设置环境变量 1 2.3.如何检查环境变量 2 2.4.数据库连接池JNDI名错误 2 2.5. JDK版本不一致错误 2 2.6.如何察看日志 2 2.7.类找不到异常 3 2.8.为何端口被占用 3 2.9.为何部署失败 3 2.10. 没有找到JDK环境的异常 3 2.11.端口被占用的异常是什么 4 前言 1.1.文档范围和读者 该文档主要针对用到Apusic服务器的管理人员、运行维护人员和开发人员。 本文档主要描述了如何诊断Apusic应用服务器常见故障。 1.2.文档导航 以下是对本文档中各章节内容的概要介绍： 章节 内容概述 1.前言 文档范围，约定等内容$APUSIC_HOME 表示Apusic应用服务器的安装目录，Windows下可能对应C:\Apusic-5.1，Linux或其它Unix下可能对应/opt/apusic-5.1。 $DOMAIN_HOME 表示$APUSIC_HOME/domains/[domainname]这样的目录 键名+键名 用加号连接的一组同时按下的键：Ctrl+C表示同时按下这两个键。 常见问题解答及故障诊断 2.1.支持的JDK及版本 SUN 1.5.0，IBM 1.5.0，HP 1.5.0，BEA JRocket 1.5.0 Windows下，通过set命令，如set JAVA_HOME=d:\java\jdk1.5.0。Linux/unix一般通过export命令，如export JAVA_HOME=/usr/java/jdk1.5.0 2.4.数据库连接池JNDI名错误 JNDI名配置错误或者未配置好数据库源将导致以下异常：javax.naming.NameNotFoundException 与此相关的常见错误是JDBC驱动不在类路径上，将导致以下异常：classnotfound 2.5. JDK版本不一致错误 如果编译应用中的JDK，比Apusic运行环境的中JDK版本更高，就会出现java.lang.UnsupportedClassVersionError，或者类似：“版本号带小数的‘49.0’太新，此工具无法 理解。”的错误提示。例如编译应用采用JDK1.6，而Apusic的运行环境采用JDK1.5。 2.6.如何察看日志 系统及应用日志保存在$DOMAIN_HOME/logs目录中,日志以循环写的方式进行记录，可以通过$DOMAIN_HOME/config/logging.xml进行设置日志文件的大小与数量. handler class=java.util.logging.FileHandler property name=level value=ALL/ property name=limit value=1000000/ property name=count value=10/ property name=pattern value=%h/logs/apusic.log/ property name=append value=true/ formatter class=com.apusic.logging.SimpleFormatter/ /handler 2.7.类找不到异常 异常信息一般为java.lang.NoClassDefFoundError,原因是类所在的jar文件不在类装载路径上，如log4j的jar文件,常用的解决的办法是将包含该类的jar文件拷贝到$DOMAIN_HOME/lib目录 2.8.为何端口被占用 Apusic启动时可能需要用的端口为:80 （默认是6888）,443 （默认是6889）；端口被占用的可能原因：已经启动了一个Apusic实例，未完全关闭相应端口或者指定端口被其他程序占用，用netstat命令查看 2.9.为何部署失败 部署失败的可能原因： 虚拟路径名重复（可以部署多个应用，不同的应用通过不同的虚拟路径进行访问，因此虚拟路径不允许重复） 配置文件有误 类装载有错误 类找不到 格式有误 访问数据库异常（有些应用在装载阶段进行访问数据库） 2.10. 没有找到JDK环境的异常 启动服务时报错： The JAVA_HOME environment variable is not defined This environment vari