本文目的：
本文适用于在 OS400 服务器上进行 Apusic403 安装、部署人员
本文内容：
1 、系统环境检查
2 、 Apusic403 的安装、部署
3 、常见问题及解决方案
一、系统环境检查
硬件环境： IBM AS/400
软件环境：
IBM OS/400
、
Apusic AS
应用环境检查：
A 、 JDK 的环境检查：
|
变量名
|
变量值
|
|
JAVA_HOME |
该处需要配置
IBM JDK |
如果未设置此环境变量，需要在 $APUSIC_HOME/bin/setenv 文件里指定，参看【 Apusic403 的安装、部署】
B 、 IP Host 表配置检查：请确认您 OS/400 的 TCP/IP 配置正确 . 比如 , 一定要正确配置 Domain 信息 , 并把此服务器的主机名 ( 短主机名和带 Domain 信息的全限定主机名 ) 注册进了本地的 HostTable ，具体操作如下图所示：
|
分别对应：
服务器真实
IP
服务器
HostName
|
二、 Apusic403 的安装、部署
A 、将 Apusic403 的安装包解压 / 复制到 OS400 的 root/var 目录下
|
此处为 OS400 真实服务器 IP |
B 、检查 Apusic 安装目录中 setenv 及 startapusic 文件，如果系统环境变量中没有设置 JAVA_HOME 需要在 setenv 中设置，打开 setenv 文件，添加一行代码：
export JAVA_HOME=/QIBM/ProdData/Java400/jdk14 (JDK 的安装目录 ), 如下：
|
此处为 OS400 真实服务器 IP |
C 、 Apusic 的管理控制平台使用到 AS400 的 localhost 的设置，如果操作系统设置不当，将导致 Apusic 管理控制平台不能正常登陆和停止 Apusic 服务器将出现问题，解决该问题，可以将硬件的物理地址写入 Apusic 的配置文件中，即在 Apusic 的安装目录的 config 目录中的 Apusic.conf 文件，添加如下配置：
<SERVICE
CLASS="com.apusic.net.Muxer"
>
<ATTRIBUTE NAME="Port" VALUE="6888"/>
<ATTRIBUTE NAME="Address" VALUE="192.168.1.3"/>
<ATTRIBUTE NAME="Backlog" VALUE="50"/>
......
</SERVICE>
|
分别为 2 台 AS400 真实服务器 IP |
注意：红色字体部分根据服务器具体
IP
地址填写
D 、启动 Apusic 服务器：在 AS400 服务器主菜单界面使用“ qsh ”命令进入文件系统，使用“ cd /var/apusic/bin ”命令打开 Apusic 服务器 bin 目录，使用“ ./startapusic & ”命令启动 Apusic 应用服务器。
启动 Apusic 服务器；
E 、停止 Apusic 服务器：进入 $APUSIC_HOME/bin 目录，
|
此处为服务器真实 IP 地址 |
运行
停止 Apusic 服务器；
三、常见问题及解决方案
本文档中使用的客户端软件使用的是
IBM
个人通信软件。
注意本文档中的涉及文件夹名称、路径名称、及相关内容要根据实际场景进行调整。
常见问题
1
：
服务器启动时报以下类似错误：
IOP00710208: (INTERNAL) Unable to determine local hostname from InetAddress.getLocalHost().getHostName()"
at ....
......
Caused by: java.net.UnknownHostException: HQOASVR1.PBC.GOV.CN: Host HQOASVR1.PBC.GOV.CN not found
at ....
......
解决方案：
检查 IP Host 表配置检查（本文档系统环境检查部分 B 节）。
常见问题
2
：
服务器启停正常，但无法在客户端通过浏览器进入 web 管理控制台。
解决方案：
该问题在非 Windows 、 Linux 系统下经常发生，一般需请研发部支持。
常见问题
3
：
服务器启动显示正常，但无法通过 admin/admin 在客户端浏览器登录 web 管理控制台，此问题常发生在默认未指定服务器 ip ，在 Apusic 初次运行后系统配置有改变时。
解决方案：
参看本文档 Apusic403 的安装、部署 C 小节部分，指定服务器实际 IP 地址。