Apusic5.1故障诊断手册

Apusic5.1故障诊断手册

Apusic故障诊断手册

编 制 单 位：金蝶中间件有限公司 编 制 日 期：二〇〇八年十一月

Apusic5.1故障诊断手册

目 录

一、 前言 ............................................... 1

1.1.文档范围和读者............................................... 1 1.2.文档导航..................................................... 1 1.3.文档约定..................................................... 1

二、 常见问题解答及故障诊断 ............................. 1

2.1.支持的JDK及版本............................................. 1 2.2.如何设置环境变量............................................. 2 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

Apusic5.1故障诊断手册

一、 前言

1.1.文档范围和读者

该文档主要针对用到Apusic服务器的管理人员、运行维护人员和开发人员。

本文档主要描述了如何诊断Apusic应用服务器常见故障。 1.2.文档导航

以下是对本文档中各章节内容的概要介绍：

1.3.文档约定

$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

Apusic5.1故障诊断手册

2.2.如何设置环境变量

Windows下，通过set命令，如set JAVA_HOME=d:\java\jdk1.5.0。Linux/unix下，一般通过export命令，如export JAVA_HOME=/usr/java/jdk1.5.0 2.3.如何检查环境变量

Windows下，用set命令。Linux/unix下，用env命令。有关环境变量也有可能在可执行文件中进行设置。需要注意的几个环境变量：JAVA_HOME，path，classpath 2.4.数据库连接池JNDI名错误

JNDI名配置错误或者未配置好数据库源将导致以下异常：NotFoundException

与此相关的常见错误是JDBC驱动不在类路径上，将导致以下异常：classnotfound 2.5. JDK版本不一致错误

如果编译应用中的JDK，比Apusic运行环境的中JDK版本更高，就会出现ng.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"/>

Apusic5.1故障诊断手册

<formatter class="com.apusic.logging.SimpleFormatter"/> </handler> 2.7.类找不到异常

异常信息一般为ng.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 variable is needed to run this program 解决办法： 设置JAVA_HOME

Apusic5.1故障诊断手册

2.11.端口被占用的异常是什么

.BindException: Address already in use: bind

本文来源：https://www.bwwdw.com/article/gj04.html