在OS400服务器上部署Apusic应用服务器（转自北方区域中心）

<!----> <o:p> </o:p>

本文目的：

本文适用于在 OS400 服务器上进行 Apusic403 安装、部署人员

<o:p>   </o:p>

本文内容：

1 、系统环境检查

2 、 Apusic403 的安装、部署

3 、常见问题及解决方案

<o:p>   </o:p>

一、系统环境检查

    硬件环境： IBM AS/400

       软件环境： IBM OS/400 、 Apusic AS<!----><st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">4.0.3</st1:chsdate> 、 IBM JDK1.4.2

<o:p>   </o:p>

应用环境检查：

A 、 JDK 的环境检查：

变量名 <o:p> </o:p>	变量值 <o:p> </o:p>
JAVA_HOME	该处需要配置 IBM JDK<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">1.4.2</st1:chsdate> 的安装目录

如果未设置此环境变量，需要在 $APUSIC_HOME/bin/setenv 文件里指定，参看【 Apusic403 的安装、部署】

<o:p>   </o:p>

B 、 IP Host 表配置检查：请确认您 OS/400 的 TCP/IP 配置正确 . 比如 , 一定要正确配置 Domain 信息 , 并把此服务器的主机名 ( 短主机名和带 Domain 信息的全限定主机名 ) 注册进了本地的 HostTable ，具体操作如下图所示：

<!----> <v:shapetype id="_x0000_t75" stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"> <v:stroke joinstyle="miter"> </v:stroke> <v:formulas> <v:f eqn="if lineDrawn pixelLineWidth 0"> </v:f> <v:f eqn="sum @0 1 0"> </v:f> <v:f eqn="sum 0 0 @1"> </v:f> <v:f eqn="prod @2 1 2"> </v:f> <v:f eqn="prod @3 21600 pixelWidth"> </v:f> <v:f eqn="prod @3 21600 pixelHeight"> </v:f> <v:f eqn="sum @0 0 1"> </v:f> <v:f eqn="prod @6 1 2"> </v:f> <v:f eqn="prod @7 21600 pixelWidth"> </v:f> <v:f eqn="sum @8 21600 0"> </v:f> <v:f eqn="prod @7 21600 pixelHeight"> </v:f> <v:f eqn="sum @10 21600 0"> </v:f> </v:formulas> <v:path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"> </v:path> <o:lock aspectratio="t" v:ext="edit"> </o:lock> </v:shapetype> <v:shape id="_x0000_i1027" style="WIDTH: 414.75pt; HEIGHT: 323.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image001.jpg" o:title="00036"> </v:imagedata> </v:shape>

<v:shape id="_x0000_i1028" style="WIDTH: 414.75pt; HEIGHT: 323.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image003.jpg" o:title="00037"> </v:imagedata> </v:shape>

<v:shapetype id="_x0000_t61" path="m,l0@8@12@24,0@9,,21600@6,21600@15@27@7,21600,21600,21600,21600@9@18@30,21600@8,21600,0@7,0@21@33@6,xe" o:spt="61" coordsize="21600,21600" adj="1350,25920"> <v:stroke joinstyle="miter"> </v:stroke> <v:formulas> <v:f eqn="sum 10800 0 #0"> </v:f> <v:f eqn="sum 10800 0 #1"> </v:f> <v:f eqn="sum #0 0 #1"> </v:f> <v:f eqn="sum @0 @1 0"> </v:f> <v:f eqn="sum 21600 0 #0"> </v:f> <v:f eqn="sum 21600 0 #1"> </v:f> <v:f eqn="if @0 3600 12600"> </v:f> <v:f eqn="if @0 9000 18000"> </v:f> <v:f eqn="if @1 3600 12600"> </v:f> <v:f eqn="if @1 9000 18000"> </v:f> <v:f eqn="if @2 0 #0"> </v:f> <v:f eqn="if @3 @10 0"> </v:f> <v:f eqn="if #0 0 @11"> </v:f> <v:f eqn="if @2 @6 #0"> </v:f> <v:f eqn="if @3 @6 @13"> </v:f> <v:f eqn="if @5 @6 @14"> </v:f> <v:f eqn="if @2 #0 21600"> </v:f> <v:f eqn="if @3 21600 @16"> </v:f> <v:f eqn="if @4 21600 @17"> </v:f> <v:f eqn="if @2 #0 @6"> </v:f> <v:f eqn="if @3 @19 @6"> </v:f> <v:f eqn="if #1 @6 @20"> </v:f> <v:f eqn="if @2 @8 #1"> </v:f> <v:f eqn="if @3 @22 @8"> </v:f> <v:f eqn="if #0 @8 @23"> </v:f> <v:f eqn="if @2 21600 #1"> </v:f> <v:f eqn="if @3 21600 @25"> </v:f> <v:f eqn="if @5 21600 @26"> </v:f> <v:f eqn="if @2 #1 @8"> </v:f> <v:f eqn="if @3 @8 @28"> </v:f> <v:f eqn="if @4 @8 @29"> </v:f> <v:f eqn="if @2 #1 0"> </v:f> <v:f eqn="if @3 @31 0"> </v:f> <v:f eqn="if #1 0 @32"> </v:f> <v:f eqn="val #0"> </v:f> <v:f eqn="val #1"> </v:f> </v:formulas> <v:path o:connecttype="custom" o:connectlocs="10800,0;0,10800;10800,21600;21600,10800;@34,@35"> </v:path> <v:handles> <v:h position="#0,#1"> </v:h> </v:handles> </v:shapetype> <v:shape id="_x0000_s1046" style="MARGIN-TOP: 15.6pt; Z-INDEX: 21; LEFT: 0px; MARGIN-LEFT: 324pt; WIDTH: 2in; TEXT-INDENT: 0px; POSITION: absolute; HEIGHT: 62.4pt; TEXT-ALIGN: left" type="#_x0000_t61" adj=",27537" strokeweight="2.25pt" strokecolor="red"> <v:textbox>

分别对应： <o:p> </o:p>

服务器真实 IP<o:p></o:p>

服务器 HostName<o:p></o:p>

<o:p>   </o:p>

</v:textbox> </v:shape> <v:rect id="_x0000_s1045" style="MARGIN-TOP: 85.8pt; Z-INDEX: 20; LEFT: 0px; MARGIN-LEFT: 180pt; WIDTH: 2in; POSITION: absolute; HEIGHT: 101.4pt; TEXT-ALIGN: left" filled="f" strokeweight="2.25pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1029" style="WIDTH: 414.75pt; HEIGHT: 323.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image007.jpg" o:title="00038"> </v:imagedata> </v:shape>

<o:p>   </o:p>

二、 Apusic403 的安装、部署

A 、将 Apusic403 的安装包解压 / 复制到 OS400 的 root/var 目录下

<v:shape id="_x0000_s1035" style="MARGIN-TOP: 75.4pt; Z-INDEX: 10; LEFT: 0px; MARGIN-LEFT: -53.85pt; WIDTH: 117pt; TEXT-INDENT: 0px; POSITION: absolute; HEIGHT: 39pt; TEXT-ALIGN: left" type="#_x0000_t61" adj="20492,-6729" strokecolor="red"> <v:textbox style="mso-next-textbox: #_x0000_s1035">

此处为 OS400 真实服务器 IP

</v:textbox> </v:shape> <v:rect id="_x0000_s1030" style="MARGIN-TOP: 44.2pt; Z-INDEX: 5; LEFT: 0px; MARGIN-LEFT: 33.75pt; WIDTH: 56.25pt; POSITION: absolute; HEIGHT: 15.6pt; TEXT-ALIGN: left" filled="f" strokeweight="1.5pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1030" style="WIDTH: 414.75pt; HEIGHT: 299.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image011.jpg" o:title="00001"> </v:imagedata> </v:shape>

B 、检查 Apusic 安装目录中 setenv 及 startapusic 文件，如果系统环境变量中没有设置 JAVA_HOME 需要在 setenv 中设置，打开 setenv 文件，添加一行代码：

export JAVA_HOME=/QIBM/ProdData/Java400/jdk14  (JDK 的安装目录 ), 如下：

<v:shape id="_x0000_s1042" style="MARGIN-TOP: 85.8pt; Z-INDEX: 17; LEFT: 0px; MARGIN-LEFT: -36pt; WIDTH: 117pt; TEXT-INDENT: 0px; POSITION: absolute; HEIGHT: 39pt; TEXT-ALIGN: left" type="#_x0000_t61" adj="20492,-6729" strokecolor="red"> <v:textbox style="mso-next-textbox: #_x0000_s1042">

此处为 OS400 真实服务器 IP

</v:textbox> </v:shape> <v:rect id="_x0000_s1041" style="MARGIN-TOP: 62.55pt; Z-INDEX: 16; LEFT: 0px; MARGIN-LEFT: 69.75pt; WIDTH: 56.25pt; POSITION: absolute; HEIGHT: 15.6pt; TEXT-ALIGN: left" filled="f" strokeweight="1.5pt" strokecolor="red"> </v:rect> <v:rect id="_x0000_s1037" style="MARGIN-TOP: 156pt; Z-INDEX: 12; LEFT: 0px; MARGIN-LEFT: 2in; WIDTH: 63pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" filled="f" strokeweight="2.25pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1031" style="WIDTH: 414.75pt; HEIGHT: 309.75pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image016.png" o:title=""> </v:imagedata> </v:shape>

<v:shapetype id="_x0000_t67" path="m0@0l@1@0@1,0@2,0@2@0,21600@0,10800,21600xe" o:spt="67" coordsize="21600,21600" adj="16200,5400"> <v:stroke joinstyle="miter"> </v:stroke> <v:formulas> <v:f eqn="val #0"> </v:f> <v:f eqn="val #1"> </v:f> <v:f eqn="sum height 0 #1"> </v:f> <v:f eqn="sum 10800 0 #1"> </v:f> <v:f eqn="sum width 0 #0"> </v:f> <v:f eqn="prod @4 @3 10800"> </v:f> <v:f eqn="sum width 0 @5"> </v:f> </v:formulas> <v:path o:connecttype="custom" o:connectlocs="10800,0;0,@0;10800,21600;21600,@0" textboxrect="@1,0,@2,@6" o:connectangles="270,180,90,0"> </v:path> <v:handles> <v:h position="#1,#0" yrange="0,21600" xrange="0,10800"> </v:h> </v:handles> </v:shapetype> <v:shape id="_x0000_s1027" style="WIDTH: 36pt; HEIGHT: 29.1pt; mso-position-horizontal-relative: char; mso-position-vertical-relative: line" type="#_x0000_t67"> <v:textbox style="LAYOUT-FLOW: vertical-ideographic"> </v:textbox> <!----> <w:wrap type="none"> </w:wrap> <w:anchorlock> </w:anchorlock> </v:shape>

<v:rect id="_x0000_s1038" style="MARGIN-TOP: 85.8pt; Z-INDEX: 13; LEFT: 0px; MARGIN-LEFT: 18pt; WIDTH: 2in; POSITION: absolute; HEIGHT: 15.6pt; TEXT-ALIGN: left" filled="f" strokeweight="2.25pt" strokecolor="red"> </v:rect>     <v:shape id="_x0000_i1032" style="WIDTH: 414.75pt; HEIGHT: 299.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image020.jpg" o:title="00011"> </v:imagedata> </v:shape>

<o:p>   </o:p>

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"/><o:p></o:p>

    <ATTRIBUTE NAME="Backlog" VALUE="50"/>

    ......

</SERVICE>

<v:shape id="_x0000_s1044" style="MARGIN-TOP: 85.8pt; Z-INDEX: 19; LEFT: 0px; MARGIN-LEFT: -36pt; WIDTH: 117pt; TEXT-INDENT: 0px; POSITION: absolute; HEIGHT: 39pt; TEXT-ALIGN: left" type="#_x0000_t61" adj="20492,-6729" strokecolor="red"> <v:textbox style="mso-next-textbox: #_x0000_s1044">

分别为 2 台 AS400 真实服务器 IP

</v:textbox> </v:shape> <v:rect id="_x0000_s1043" style="MARGIN-TOP: 62.55pt; Z-INDEX: 18; LEFT: 0px; MARGIN-LEFT: 69.75pt; WIDTH: 56.25pt; POSITION: absolute; HEIGHT: 15.6pt; TEXT-ALIGN: left" filled="f" strokeweight="1.5pt" strokecolor="red"> </v:rect> <v:rect id="_x0000_s1039" style="MARGIN-TOP: 78pt; Z-INDEX: 14; LEFT: 0px; MARGIN-LEFT: 2in; WIDTH: 81pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" filled="f" strokeweight="2.25pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1033" style="WIDTH: 414.75pt; HEIGHT: 309.75pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image024.png" o:title=""> </v:imagedata> </v:shape>

<v:shape id="_x0000_s1026" style="WIDTH: 36pt; HEIGHT: 29.1pt; mso-position-horizontal-relative: char; mso-position-vertical-relative: line" type="#_x0000_t67"> <v:textbox style="LAYOUT-FLOW: vertical-ideographic"> </v:textbox> <w:wrap type="none"> </w:wrap> <w:anchorlock> </w:anchorlock> </v:shape>

<v:rect id="_x0000_s1040" style="MARGIN-TOP: 39pt; Z-INDEX: 15; LEFT: 0px; MARGIN-LEFT: 36pt; WIDTH: 279pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" filled="f" strokeweight="2.25pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1034" style="WIDTH: 343.5pt; HEIGHT: 152.25pt" type="#_x0000_t75" o:borderrightcolor="this" o:borderbottomcolor="this" o:borderleftcolor="this" o:bordertopcolor="this"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image027.png" o:title=""> </v:imagedata> <w:bordertop type="single" width="4"> </w:bordertop> <w:borderleft type="single" width="4"> </w:borderleft> <w:borderbottom type="single" width="4"> </w:borderbottom> <w:borderright type="single" width="4"> </w:borderright> </v:shape>

注意：红色字体部分根据服务器具体 IP 地址填写 <o:p> </o:p>

<o:p>   </o:p>

D 、启动 Apusic 服务器：在 AS400 服务器主菜单界面使用“ qsh ”命令进入文件系统，使用“ cd /var/apusic/bin ”命令打开 Apusic 服务器 bin 目录，使用“ ./startapusic & ”命令启动 Apusic 应用服务器。

<o:p>   </o:p>

<v:rect id="_x0000_s1036" style="MARGIN-TOP: 241.8pt; Z-INDEX: 11; LEFT: 0px; MARGIN-LEFT: 54pt; WIDTH: 27pt; POSITION: absolute; HEIGHT: 15.6pt; TEXT-ALIGN: left" filled="f" strokeweight="1.5pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1035" style="WIDTH: 414.75pt; HEIGHT: 323.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image030.jpg" o:title="00002"> </v:imagedata> </v:shape>

<v:shape id="_x0000_s1028" style="MARGIN-TOP: 0px; Z-INDEX: 3; LEFT: 0px; MARGIN-LEFT: 189pt; WIDTH: 36pt; POSITION: absolute; HEIGHT: 29.1pt; TEXT-ALIGN: left" type="#_x0000_t67"> <v:textbox style="LAYOUT-FLOW: vertical-ideographic"> </v:textbox> </v:shape> <o:p>   </o:p>

<o:p>   </o:p>

<v:rect id="_x0000_s1031" style="MARGIN-TOP: 226.2pt; Z-INDEX: 6; LEFT: 0px; MARGIN-LEFT: 54pt; WIDTH: 99pt; POSITION: absolute; HEIGHT: 15.6pt; TEXT-ALIGN: left" filled="f" strokeweight="1.5pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1036" style="WIDTH: 414.75pt; HEIGHT: 323.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image033.jpg" o:title="00003"> </v:imagedata> </v:shape>

<o:p>   </o:p>

<v:shape id="_x0000_s1029" style="MARGIN-TOP: 7.8pt; Z-INDEX: 4; LEFT: 0px; MARGIN-LEFT: 180pt; WIDTH: 36pt; POSITION: absolute; HEIGHT: 29.1pt; TEXT-ALIGN: left" type="#_x0000_t67"> <v:textbox style="LAYOUT-FLOW: vertical-ideographic"> </v:textbox> </v:shape> <o:p>   </o:p>

<o:p>   </o:p>

<o:p>   </o:p>

<v:rect id="_x0000_s1032" style="MARGIN-TOP: 218.4pt; Z-INDEX: 7; LEFT: 0px; MARGIN-LEFT: 53.85pt; WIDTH: 81.15pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" filled="f" strokeweight="2.25pt" strokecolor="red"> </v:rect> <v:shape id="_x0000_i1037" style="WIDTH: 414.75pt; HEIGHT: 323.25pt" type="#_x0000_t75"> <v:imagedata src="file:///D:\Winbak\Temp\msohtml1\01\clip_image037.jpg" o:title="00004"> </v:imagedata> </v:shape>

启动 Apusic 服务器；

<o:p>   </o:p>

E 、停止 Apusic 服务器：进入 $APUSIC_HOME/bin 目录，

<v:shape id="_x0000_s1033" style="MARGIN-TOP: 0px; Z-INDEX: 8; LEFT: 0px; MARGIN-LEFT: 279pt; WIDTH: 2in; TEXT-INDENT: 0px; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" filled="f" type="#_x0000_t61" adj="-5535,28892" strokeweight="1.5pt" strokecolor="red"> <v:textbox>

此处为服务器真实 IP 地址

</v:textbox> </v:shape>               cd /var/apusic/bin

运行

<v:rect id="_x0000_s1034" style="MARGIN-TOP: 0px; Z-INDEX: 9; LEFT: 0px; MARGIN-LEFT: 207pt; WIDTH: 54pt; POSITION: absolute; HEIGHT: 15.6pt; TEXT-ALIGN: left" filled="f" strokeweight="1pt" strokecolor="red"> </v:rect> ./stopapusic admin admin iiop://11.129.2.43:6888<o:p></o:p>

停止 Apusic 服务器；

<o:p>   </o:p>

三、常见问题及解决方案

本文档中使用的客户端软件使用的是 IBM 个人通信软件。 <o:p> </o:p>

注意本文档中的涉及文件夹名称、路径名称、及相关内容要根据实际场景进行调整。 <o:p> </o:p>

<o:p>   </o:p>

常见问题 1 ： <o:p> </o:p>

服务器启动时报以下类似错误：

       IOP00710208: (INTERNAL) Unable to determine local hostname from InetAddress.getLocalHost().getHostName()"<o:p></o:p>

    at ....<o:p></o:p>

    ......<o:p></o:p>

    Caused by: java.net.UnknownHostException: HQOASVR1.PBC.GOV.CN: Host HQOASVR1.PBC.GOV.CN not found<o:p></o:p>

    at ....<o:p></o:p>

......<o:p></o:p>

解决方案： <o:p> </o:p>

       检查 IP Host 表配置检查（本文档系统环境检查部分 B 节）。

<o:p>   </o:p>

常见问题 2 ： <o:p> </o:p>

服务器启停正常，但无法在客户端通过浏览器进入 web 管理控制台。

解决方案： <o:p> </o:p>

       该问题在非 Windows 、 Linux 系统下经常发生，一般需请研发部支持。

<o:p>   </o:p>

常见问题 3 ： <o:p> </o:p>

       服务器启动显示正常，但无法通过 admin/admin 在客户端浏览器登录 web 管理控制台，此问题常发生在默认未指定服务器 ip ，在 Apusic 初次运行后系统配置有改变时。

解决方案： <o:p> </o:p>

       参看本文档   Apusic403 的安装、部署 C 小节部分，指定服务器实际 IP 地址。

<o:p>   </o:p>

<o:p>   </o:p>

<o:p>   </o:p>

<o:p>   </o:p>