金蝶Apusic中介軟體中部署 SuperMap iServer

作者：MR

一、系統配置要求

本文使用軟體版本為iServer8.1.1 、金蝶9.0；64位作業系統為Windows 10_1607 和 Ubuntu14.04_server。 檔案如下：

supermap_iserver_8.1.1a_war.zipAAS-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:WORKAASLinux：/opt/AAS

配置金蝶許可

將收到的許可檔案重新命名為license.xml 放到金蝶解壓目錄即可，本文放到以下目錄：

Windows： F:WORKAASLinux：/opt/AAS

啟動、關閉&管理金蝶服務

可以通過指令碼啟動金蝶中介軟體。指令碼位置：

Windows下：{金蝶安裝目錄}domains{域}instartapusic.cmd、stopapusic.cmd （雙擊或cmd視窗運行）Linux下：{金蝶安裝目錄}/domains/{域}/bin/startapusic、stopapusic (bash或shstartapusic或stopapusic)

預設域是mydomain，所以本文的啟動關閉指令碼路徑是：

Windows：F:WORKAASdomainsmydomaininstartapusic.cmd、stopapusic.cmdLinux：/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_x64objectsjavainLinux:/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_66setPATH=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_66PATH=/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:WORKAASdomainsmydomainapplicationsLinux：/opt/AAS/domains/mydomain/applications

可以在金蝶Web管理控制檯應用管理中管理iServer，如圖：

修改金蝶設定

金蝶中介軟體中可能限制了http方法，此時需要修改中介軟體設定。瀏覽器訪問金蝶Web管理控制檯，在系統參數-Apusic參數中刪除apusic.http.disabledMethod項，如圖：

若有http請求方法限制，上述修改操作完成後，需要重啟金蝶。

部署完成，iServer訪問地址：http://{IP或域名}:6888/iserver（以金蝶Web管理控制檯-應用管理-檢視應用模組-訪問應用進入的地址為準）。