金蝶Apusic中间件中部署 SuperMap iServer

作者：MR

一、系统配置要求

本文使用软件版本为iServer8.1.1 、金蝶9.0；64位操作系统为Windows 10_1607 和 Ubuntu14.04_server。
文件如下：

supermap_iserver_8.1.1a_war.zip
AAS-V9.0_20170309.zip

Windows和Linux下安装部署过程相同。

二、安装金蝶

金蝶中间件需要jdk环境，所以需要先安装jdk，jdk版本应同时高于金蝶、iServer要求的版本。本文使用的金蝶要求jdk1.6及以上、iServer8.1.1要求jre1.8及以上，所以这里使用JDK1.8(64位)。

安装JDK

可以使用安装包也可以使用解压包，这里省略。

安装金蝶

解压AAS-V9.0_20170309.zip 文件即可，本文解压到以下目录：

Windows：F:WORKAAS
Linux：/opt/AAS

配置金蝶许可

将收到的许可文件重命名为license.xml 放到金蝶解压目录即可，本文放到以下目录：

Windows： F:WORKAAS
Linux：/opt/AAS

启动、关闭&管理金蝶服务

可以通过脚本启动金蝶中间件。脚本位置：

Windows下：{金蝶安装目录}domains{域}instartapusic.cmd、stopapusic.cmd （双击或cmd窗口运行）
Linux下：{金蝶安装目录}/domains/{域}/bin/startapusic、stopapusic (bash或shstartapusic或stopapusic)

默认域是mydomain，所以本文的启动关闭脚本路径是：

Windows：F:WORKAASdomainsmydomaininstartapusic.cmd、stopapusic.cmd
Linux：/opt/AAS/domains/mydomain/bin/startapusic、stopapusic

首次启动验证许可通过后，会提示设置管理员密码，管理员用户名是：admin

管理金蝶服务

浏览器访问：

http://{hostname}:6888/admin

本机访问可以将{hostname}替换成localhost或127.0.0.1；非本机访问则使用域名或IP。

其他可以参考金蝶安装目录下的readme.html。

部署iServer

解压supermap_iserver_8.1.1a_war.zip 得到以下文件:

support_win_x64.zip （Windows下iServer依赖的SuperMapiObjects Java包）
support_linux_x64.tar.gz（Linux下iServer依赖的SuperMapiObjects Java包）
iserver.war（iServer部署包）
iserver#iClient.war（iServer自带iClient示范程序部署包）
iserver#help.war（iServer自带帮助文档部署包）
Guide_smiserver_war_chn.pdf（iServer安装说明）
BUILD_14511_15（iServer版本号）

在金蝶中部署，需要先将iserver#iClient.war、iserver#help.war依次重命名为：iClient.war、help.war。

配置iServer依赖环境

Windows上解压support_win_x64.zip，本文解压到D:SuperMap。
Linux上解压support_linux_x64.tar.gz(命令：tar-zxvf {*.tar.gz文件}{解压路径，不写解压到当前路径})，本文解压到：/opt
配置iServer依赖环境的方式有两种：设置系统环境变量、修改中间件相关脚本。

方式一：设置环境变量

本文在PATH中增加以下路径：

Windows: D:SuperMapsupport_win_x64objectsjavain
Linux:/opt/support_linux_x64/objectsjava/bin

方式二：修改启动脚本

Windows下，{金蝶安装目录}domains{域}insetenv.cmd或者{金蝶安装目录}insetenv.cmd文件第一行之后，比如remset JAVA_HOME variablehere.这句注释之后添加以下内容，本文：F:WORKAASinsetenv.cmd：

remrem后面的是注释，也可以在这里设置中间件使用的jdk路径
remset JAVA_HOME=D:Program FilesJavajdk1.8.0_66
setPATH=D:SuperMapsupport_win_x64objectsjavain;%PATH%

Linux下，{金蝶安装目录}/domains/{域}/bin/setenv或者 {金蝶安装目录}/bin/setenv文件第一行之后，比如#set JAVA_HOME variable here.这句注释之后添加以下内容，本文：/opt/AAS/bin/setenv：

##后面的是注释，也可以在这里设置中间件使用的jdk路径
#JAVA_HOME=/opt/jdk1.8.0_66
PATH=/opt/support_linux_x64/objectsjava/bin:$PATH

检查iServer依赖环境&安装iServer许可

Linux下，可以通过运行support_linux_x64.tar.gz解压目录下的一个脚本来检查安装iServer依赖，先进入该目录，然后执行以下命令：

./dependencies_check_and_install.shinstall -y

若安装的iServer没有该脚本，请参考iServer帮助文档解决Linux下依赖问题。

安装许可

Windows下，进入support_win_x64.zip解压目录下的SuperMapLicenseCenter目录，运行SuperMap.LicenseCenter.exe即可，初次安装SuperMapGIS软件运行该程序会安装许可驱动并自带3个月试用许可。
Linux下，进入support_linux_x64.tar.gz解压目录/SuperMap_License/Support下，执行以下操作：

tar-xvf aksusbd-2.4.1-i386.tar #解压许可驱动安装包，以实际版本为准
cdaksusbd-2.4.1-i386 #进入安装目录，以实际解压目录为准
./dinst#安装许可驱动

首次安装自带3个月试用许可。

部署iServer

将iserver.war、iClient.war、help.war放到{金蝶安装目录}/domains/{域}/applications目录下即可，比如本文放到以下目录:

Windows：F:WORKAASdomainsmydomainapplications
Linux：/opt/AAS/domains/mydomain/applications

可以在金蝶Web管理控制台应用管理中管理iServer，如图：

修改金蝶设置

金蝶中间件中可能限制了http方法，此时需要修改中间件设置。浏览器访问金蝶Web管理控制台，在系统参数-Apusic参数中删除apusic.http.disabledMethod项，如图：

若有http请求方法限制，上述修改操作完成后，需要重启金蝶。

部署完成，iServer访问地址：http://{IP或域名}:6888/iserver（以金蝶Web管理控制台-应用管理-查看应用模块-访问应用进入的地址为准）。