本文目的:
		
		
				本文适用于在
				
						OS400
						服务器上进行
						Apusic403
						安装、部署人员
				
		
		
				
						
								 
						
				
		
		
				本文内容:
		
		
				
						1
						、系统环境检查
				
		
		
				
						2
						、
						Apusic403
						的安装、部署
				
		
		
				
						3
						、常见问题及解决方案
				
		
		
				
						
								 
						
				
		
		
				一、系统环境检查
		
		
				
						
								    
						
						硬件环境:
						IBM AS/400
				
		
		
				
						
								       
						
						软件环境:
						IBM OS/400
						、
						
								Apusic AS4.0.3
						、
						IBM JDK1.4.2
				
		
		
				
						
								 
						
				
		
		
				应用环境检查:
		
		
				
						A
						、
						JDK
						的环境检查:
				
		
		
				
						
								| 
										 
												
														变量名
														
																
																
														
												
										 
								 | 
								
										 
												
														变量值
														
																
																
														
												
										 
								 | 
						
						
								| 
										 
												
														JAVA_HOME
												
										 
								 | 
								
										 
												该处需要配置
												
														IBM JDK1.4.2
														的安装目录
												
										 
								 | 
						
				
		
		
				
						如果未设置此环境变量,需要在
						
								$APUSIC_HOME/bin/setenv
						
				
				
						文件里指定,参看【
						
								Apusic403
						
				
				
						的安装、部署】
				
		
		
				
						
								 
						
				
		
		
				
						B
						、
						IP Host
						表配置检查:请确认您
						OS/400
						的
						TCP/IP
						配置正确
						. 
						比如
						,
						一定要正确配置
						Domain
						信息
						,
						并把此服务器的主机名
						(
						短主机名和带
						Domain
						信息的全限定主机名
						)
						注册进了本地的
						HostTable
						,具体操作如下图所示:
				
		
		
				
						
						
								
								
								
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
										
								
								
								
								
								
						
						
								
								
						
				
		
		
				
						
								
								
						
				
		
		
				
						
						
						
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
								
						
						
						
						
								
								
						
				
				
						
								
										
												
														
																
																		
																				分别对应:
																				
																						
																						
																				
																		 
																		
																				服务器真实
																				
																						IP
																				
																		 
																		
																				服务器
																				
																						HostName
																				
																		 
																		
																				
																						
																								 
																						
																				
																		 
																 
														 | 
												
										
								
						
				
				
						
						
				
				
						
								
										
										
								
						
				
		
		
				
						
								 
						
				
		
		
				
						
				
		
		
				二、
				
						Apusic403
						的安装、部署
				
		
		
				
						A
						、将
						Apusic403
						的安装包解压
						/
						复制到
						OS400
						的
						root/var
						目录下
				
		
		
				
						
								
						
				
				
						
						
				
				
						
								
										
										
								
						
				
		
		
				
						B
						、检查
						
								Apusic
						
						安装目录中
						setenv
						及
						startapusic
						文件,如果系统环境变量中没有设置
						JAVA_HOME
						需要在
						setenv
						中设置,打开
						setenv
						文件,添加一行代码:
				
		
		
				
						export JAVA_HOME=/QIBM/ProdData/Java400/jdk14  (JDK
						的安装目录
						),
						如下:
				
		
		
				
						
								
						
				
				
						
						
				
				
						
						
				
				
						
								
										
										
								
						
				
		
		
				
						
								
								
								
										
										
										
										
										
										
										
										
										
										
										
										
										
										
								
								
								
								
										
										
								
						
						
								
										
										
										
										
										
										
										
								
						
				
		
		
				
						
						
				
				
						
						
						
								    
						
						
								
								
						
				
		
		
				
						
								 
						
				
		
		
				
						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>
				
		
		
				
						
								
						
				
				
						
						
				
				
						
						
				
				
						
								
										
										
								
						
				
		
		
				
						
								
										
										
										
										
										
										
								
						
				
		
		
				
						
						
				
				
						
								
										
										
										
										
										
										
										
										
										
										
								
						
				
		
		
				
						注意:红色字体部分根据服务器具体
						
								IP
						
				
				
						地址填写
						
								
								
						
				
		
		
				
						
								 
						
				
		
		
				
						D
						、启动
						
								Apusic
						
						服务器:在
						AS400
						服务器主菜单界面使用“
						qsh
						”命令进入文件系统,使用“
						cd /var/apusic/bin
						”命令打开
						
								Apusic
						
						服务器
						bin
						目录,使用“
						./startapusic &
						”命令启动
						
								Apusic
						
						应用服务器。
				
		
		
				
						
								 
						
				
		
		
				
						
						
				
				
						
								
										
										
								
						
				
		
		
				
						
								
								
						
				
				
						
								 
						
				
		
		
				
						
								 
						
				
		
		
		
				
						
						
				
				
						
								
										
										
								
						
				
		
		
				
						
								 
						
				
		
		
				
						
								
								
						
				
				
						
								 
						
				
		
		
				
						
								 
						
				
		
		
				
						
								 
						
				
		
		
		
				
						
						
				
				
						
								
										
										
								
						
				
		
		
				启动
				
						
								Apusic
						
						服务器;
				
		
		
				
						
								 
						
				
		
		
				
						E
						、停止
						
								Apusic
						
						服务器:进入
						$APUSIC_HOME/bin
						目录,
				
		
		
				
						
								
						
				
				
						
								              cd /var/apusic/bin
				
		
		
				运行
		
		
				
				
				
						
								./stopapusic admin admin iiop://11.129.2.43:6888
						
				
		
		
				停止
				
						
								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
						地址。