U8移動應(yīng)用服務(wù)器安裝配置指南

...wd......wd......wd...U8移動應(yīng)用服務(wù)器安裝配置指南適用范圍本文檔適用于U8+V11.1、V12.0移動應(yīng)用服務(wù)器的安裝配置。V11.1安裝移動應(yīng)用服務(wù)器本環(huán)節(jié)適用于以下用戶環(huán)境：之前未使用移動應(yīng)用產(chǎn)品的新用戶實施之前使用了舊版本移動服務(wù)器，需要進展版本升級或解決兼容性問題的用戶環(huán)境安裝前的準備工作舊版本服務(wù)器檢查與卸載在U8+V11.1標準產(chǎn)品安裝光盤中，包含了移動應(yīng)用服務(wù)器的舊版本安裝包，局部用戶環(huán)境可能已安裝了此版本的服務(wù)器。因為后續(xù)版本迭代，舊版本服務(wù)器已不能跟新的客戶端App保持兼容，在后續(xù)工程實施中，不再使用舊版本服務(wù)器安裝包。因此，在實施之前，需要檢查用戶環(huán)境是否已安裝了舊版本服務(wù)器，如果已安裝，需要先行卸載。確認是否已安裝過移動應(yīng)用服務(wù)器：移動應(yīng)用服務(wù)通常部署在U8應(yīng)用服務(wù)器上，在U8應(yīng)用服務(wù)器上檢查相應(yīng)的程序安裝信息即可確認是否安裝有移動服務(wù)器。檢查U8Soft目錄中，是否有MAServer目錄，如果沒有，那么說明未安裝服務(wù)器；如果有MAServer目錄，檢查MAServer目錄文件構(gòu)造，舊版本目錄構(gòu)造如下所示：其中，顯著的標志包括：目錄中有ant、ejb、framework等子文件夾。如果目錄構(gòu)造符合舊版本特征，需要先行卸載，卸載方法：在Windows“添加刪除程序〞或開場菜單中，選擇相應(yīng)的菜單或產(chǎn)品卸載快捷方式，并在卸載后按提示重啟機器。如果MAServer目錄文件構(gòu)造符合新版本特征，那么說明已安裝新的移動應(yīng)用服務(wù)器版本，可不執(zhí)行卸載，只需要更新相關(guān)補丁即可。新版本服務(wù)器目錄構(gòu)造為：其中顯著的特性包括：目錄中包含tomcat子目錄。JDK安裝配置U8移動應(yīng)用服務(wù)器需要JDK6及更新版本的支持。安裝之前，確認環(huán)境是否已安裝了相應(yīng)版本的JDK并作了正確的配置。安裝JDK：檢查Windows“添加刪除程序〞中是否有“JAVASEDevelopmetKit〞相關(guān)程序項。如未安裝，請從以下鏈接下載安裝：://oracle/technetwork/java/javase/downloads/java-archive-downloads-javase6-419409.html#jdk-6u26-oth-JPR根據(jù)32位或64位操作系統(tǒng)，分別選擇相應(yīng)的版本下載安裝。安裝本卷須知：JDK安裝程序的默認安裝路徑為：C:\ProgrameFiles\Java\，該路徑中包含空格，建議在安裝過程中修改默認路徑為C:\JAVA\jdk1.6.0_XX類似的路徑，以方便后續(xù)配置。獲取安裝文件隨U8產(chǎn)品安裝盤發(fā)布的移動應(yīng)用服務(wù)器安裝文件已過時，需要從應(yīng)用中心下載新的安裝文件。應(yīng)用中心安裝文件下載地址：://as.yonyouup/app/U8+/v111crm在該頁面中找到如下位置：安裝文件共包含兩局部：產(chǎn)品安裝包：移動應(yīng)用服務(wù)器2.6安裝程序累積補丁包：移動應(yīng)用服務(wù)器補丁201XXXXX(累積補丁包鏈接名稱會隨著補丁發(fā)布迭代變更，同時只保存最后一次發(fā)布的補丁)安裝服務(wù)器與補丁下載后的安裝文件如下所示：其中，V111_26_U8MA.exe是產(chǎn)品安裝包，maserver_v11.1_path_XXXXXXXX.exe是累積補丁包。安裝產(chǎn)品安裝包產(chǎn)品安裝包在安裝之前會進展以下檢查：檢查是否安裝了JDK，如未安裝會提示并中止安裝；檢查是否安裝了舊版本服務(wù)器，如已安裝會提示卸載；檢查是否安裝了U8應(yīng)用服務(wù)器，如果已安裝將使用U8安裝目錄作為默認安裝目錄，未安裝U8里需要手工指定安裝路徑。請根據(jù)以上檢查提示進展操作并完成安裝。安裝完成后會提示需要重啟機器，此時可暫時不重啟，等累積補丁安裝后再重啟。安裝累積補丁包累積補丁包是RAR自解壓文件〔后續(xù)將調(diào)整為MSI安裝文件，安裝方式會略有不同〕。安裝步驟：在Windows服務(wù)管理器中停頓u8maservice服務(wù)?？稍诿钚兄羞\行以下命令停頓：netstopu8maservice雙擊累積補丁文件執(zhí)行安裝，Windows2003以上系統(tǒng)需要在文件上右鍵“以管理員身份運行〞。在安裝界面選擇MAServer安裝目錄，RAR無法獲取MAServer安裝路徑，需要手工設(shè)置，通常位于X:\U8Soft\MAServer，其中X為U8安裝目錄所在盤符。確認并完成安裝。安裝U8產(chǎn)品模塊補丁移動應(yīng)用產(chǎn)品依賴U8各業(yè)務(wù)模塊的基本功能，移動產(chǎn)品的迭代更新通常需要業(yè)務(wù)模塊補丁配合實現(xiàn)，部署移動應(yīng)用服務(wù)器后，需要通過ISD更新U8模塊補丁以支持移動應(yīng)用相關(guān)功能。根基模塊補丁〔應(yīng)用服務(wù)器必須安裝〕：移動應(yīng)用，CP-U8V11.1-XXXXX-XXXXXX-MA.msi門戶，CP-U8V11.1-XXXXX-XXXXXX-DP.msi除此之外，使用各App或功能時需要安裝的模塊補丁：移動審批：根基檔案，CP-U8V11.1-XXXXX-XXXXXX-BA.msi工作流，CP-U8V11.1-XXXXX-XXXXXX-WF.msiCRM，CP-U8V11.1-XXXXX-XXXXXX-TU.msi〔移動審批支持CRM對象，模塊依賴〕移動CRM：CRM，CP-U8V11.1-XXXXX-XXXXXX-TU.msi銷售管理，CP-U8V11.1-XXXXX-XXXXXX-SA.msi〔使用CRM中的訂單錄入功能等〕在U8客戶端使用移動模板配置時，客戶端必須安裝：移動應(yīng)用，CP-U8V11.1-XXXXX-XXXXXX-MA.msi應(yīng)用服務(wù)器安裝時應(yīng)選擇相應(yīng)賬套進展升級。具體補丁安裝方法請參考ISD文檔。V12安裝移動應(yīng)用服務(wù)器V12移動應(yīng)用服務(wù)器安裝程序與U8安裝程序集成，在安裝U8應(yīng)用服務(wù)器時可選集成安裝，以下兩種方式均可：全產(chǎn)品模式安裝，該安裝類型將自動安裝移動應(yīng)用服務(wù)器：“服務(wù)器〞或“自定義〞安裝，默認勾選移動應(yīng)用服務(wù)器：V12安裝盤自動安裝JDK并配置JAVA環(huán)境，不需要單獨安裝配置。V12移動應(yīng)用補丁通過ISD安裝移動應(yīng)用模塊補丁〔MA〕和相關(guān)業(yè)務(wù)模塊補丁即可。移動應(yīng)用服務(wù)配置本環(huán)節(jié)適用于V11.1和V12移動應(yīng)用服務(wù)器配置。配置服務(wù)器參數(shù)啟動配置界面可通過開場菜單、快捷方式等啟動服務(wù)器配置工具，或直接在U8Maserver目錄雙擊config.bat運行配置工具。配置移動服務(wù)地址和端口參數(shù)參數(shù)說明：服務(wù)器地址：使用本機IP地址或機器名，當使用IP地址時，服務(wù)進程只綁定該IP地址；使用機器名時，服務(wù)進程綁定本機分配的所有IP地址。點擊“自動綁定本機IP〞按鈕，會使用機器名作為配置值。服務(wù)端口：服務(wù)使用的端口號，默認為8080或8090，可修改為服務(wù)器未使用的任意端口，但需要確保該端口沒有被其他程序或服務(wù)使用。報表服務(wù)端口：如環(huán)境中安裝了移動報表服務(wù)，該配置界面將顯示報表服務(wù)端口，配置規(guī)那么同上。本卷須知：此處配置的地址和端口是本機地址和端口，通常情況下，服務(wù)器只分配有局域網(wǎng)地址，在WIFI環(huán)境下，端App可通過此局域網(wǎng)IP訪問服務(wù)。通過移動網(wǎng)絡(luò)訪問還需要配置外網(wǎng)映射。此端口需要在該主機防火墻配置中開放訪問許可。配置U8應(yīng)用服務(wù)器信息參數(shù)說明：應(yīng)用服務(wù)器地址：U8應(yīng)用服務(wù)器IP或機器名，如果移動應(yīng)用服務(wù)器和U8應(yīng)用服務(wù)器是一臺主機，可以使用，否那么需要指定明確的IP地址或機器名。應(yīng)用服務(wù)器IIS端口：指定U8應(yīng)用服務(wù)器IIS端口，該端口不能隨意指定，需要跟應(yīng)用服務(wù)器的IIS端口一致，通常情況下，IIS端口是80?？稍贗IS管理控制臺中查看IIS綁定的端口號〔運行〔WIN+R〕輸入inetmgr即可翻開IIS管理控制臺〕。配置以上兩項后，可點擊“檢查U8應(yīng)用服務(wù)器是否可用〞鏈接，將自動翻開應(yīng)用服務(wù)器的移動服務(wù)接口信息頁面，根據(jù)頁面顯示狀態(tài)可判斷IIS服務(wù)是否正常，正常的信息頁面類似下面的界面：如該頁面不可用或包含錯誤信息，請參考常見問題環(huán)節(jié)進展排查。認證方式配置認證方式支持加密許可模式和移動運營模式，請根據(jù)客戶實際購置許可的情況配置。加密許可模式即傳統(tǒng)的軟/硬加密狗模式。移動運營模式是按服務(wù)期限授權(quán)的控制模式，具體細節(jié)請參考移動運營平臺相關(guān)文檔。運營模式配置界面：點擊“導入授權(quán)文件〞按鈕，彈出選擇授權(quán)文件對話框，選擇導從移動運營平臺導出的授權(quán)文件〔***.properties〕；輸入“管理員賬號〞，“管理員密碼〞；〔目前階段這兩個參數(shù)僅用于兼容處理，可隨意輸入〕點“保存〞；保存信息配置信息。測試連接功能用于兼容處理，會有異常拋出，可忽略。登錄服務(wù)運營平臺和移動服務(wù)網(wǎng)關(guān)鏈接，可翻開相關(guān)網(wǎng)站的頁面。其他配置項該節(jié)點用于配置日志和管理選項，通常不需修改，保持默認即可。以上配置完成后，點擊確定，移動服務(wù)將啟用新的配置參數(shù)自動重啟服務(wù)。本卷須知：移動服務(wù)器配置中修改認證方式后，需要同步重啟IIS，才能使用設(shè)置生效。配置應(yīng)用服務(wù)器相關(guān)參數(shù)U8應(yīng)用服務(wù)器需要與移動服務(wù)進程交互，所以需要在U8應(yīng)用服務(wù)器配置中配置移動應(yīng)用地址。從開場菜單啟動U8應(yīng)用服務(wù)器配置工具，在服務(wù)器參數(shù)配置節(jié)點輸入配置的服務(wù)器地址和端口，格式為：IP(或機器名):端口本卷須知：設(shè)置移動服務(wù)器地址后，需要同步重啟IIS，才能使用設(shè)置生效。外網(wǎng)端口映射移動服務(wù)只能綁定到服務(wù)器主機的IP地址，該IP地址通常是局域網(wǎng)地址，不能通過互聯(lián)網(wǎng)或移動網(wǎng)絡(luò)訪問。如果服務(wù)器使用局域網(wǎng)IP，通常需要在路由器配置中設(shè)置端口映射，以便通過外網(wǎng)IP地址訪問移動服務(wù)。路由器端口映射一般是在路由器配置中，增加虛擬服務(wù)實現(xiàn)，如：把路由器8080端口映射到服務(wù)器主機的8080端口，其中服務(wù)器端口是服務(wù)器配置環(huán)節(jié)中指定的移動服務(wù)端口，路由器端口根據(jù)設(shè)備廠商的差異，可以使用跟服務(wù)器一致的端口，或者可以修改為其他的端口。具體細節(jié)請跟客戶IT維護人員確認。經(jīng)過路由器端口映射后，可通過路由器IP和端口訪問移動服務(wù)，如：移動服務(wù)器IP地址為，端口號為8080，映射為路由器端口8080，路由器IP為02，那么可通過WIFI訪問:8080，或通過移動網(wǎng)絡(luò)訪問02:8080。服務(wù)啟動和停頓移動應(yīng)用服務(wù)注冊為Windows服務(wù)項，服務(wù)名為u8maservice，可通過Windows服務(wù)管理控制臺、任務(wù)管理器或net命令啟動、停頓服務(wù)。服務(wù)啟動后，可通過在瀏覽器輸入URL：://IP:端口訪問服務(wù)器信息頁面，確認服務(wù)是否正常啟動，如：://:8080://02:8080通過在URL中分別使用內(nèi)外網(wǎng)IP測試，可判斷路由器端口映射是否正常。UU集成配置V12支持UU與移動應(yīng)用App集成，提供消息和跳轉(zhuǎn)服務(wù)。需要在UU管理控制臺中設(shè)置移動應(yīng)用服務(wù)器地址，該地址需要配置為路由器映射IP和端口：移動網(wǎng)關(guān)配置移動網(wǎng)關(guān)主要功能：設(shè)備管理功能，實現(xiàn)設(shè)備的禁用、啟用，APP產(chǎn)品的禁用、啟用功能。移動端設(shè)備操作日志的查看、分析，app的操作分析、登陸排行、接入方式統(tǒng)計等功能。移動網(wǎng)關(guān)地址：://m.yonyouup在移動應(yīng)用配置界面、U8門戶中均有入口可進入〔V11.1需要安裝門戶模塊補丁〕。網(wǎng)關(guān)的登錄賬號為U8應(yīng)用服務(wù)器的服務(wù)識別碼，密碼為用友優(yōu)普提供的服務(wù)密碼。即為注冊加密狗時，彈出的服務(wù)識別碼和密碼登陸成功后點擊【公司信息維護】后進入如下界面：點擊修改按鈕，在移動服務(wù)器外網(wǎng)地址欄中，輸入服務(wù)器外網(wǎng)IP和端口，即經(jīng)過映射的路由器IP和端口，如：://02:8080點擊【確定】按鈕保存設(shè)置。檢測配置是否成功：重啟加密服務(wù)后，登錄移動網(wǎng)關(guān)，選中企業(yè)名稱，點擊【查看許可】，如果顯示設(shè)備許可點數(shù)，那么表示配置成功，反之那么會提示配置移動服務(wù)器外網(wǎng)URL。在設(shè)備管理頁面，禁用某設(shè)備，如果禁用成功，那么環(huán)境配置成功。如果提示網(wǎng)絡(luò)連接失敗〔無網(wǎng)絡(luò)問題情況下〕那么表示配置失敗。配置失敗如何修改：檢查移動應(yīng)用服務(wù)器是否正常啟動。檢查U8應(yīng)用服務(wù)器端移動服務(wù)器地址及端口號是否配置正確。檢查移動網(wǎng)關(guān)端移動應(yīng)用服務(wù)器外網(wǎng)地址是否配置正確。檢查移動應(yīng)用服務(wù)器外網(wǎng)是否連接正常。移動網(wǎng)關(guān)操作移動設(shè)備許可數(shù)查看：登錄成功后點擊【公司信息維護】，進入如下頁面：點擊選中“河北師大〞，點擊【查看許可】，即彈出相關(guān)移動產(chǎn)品的授權(quán)許可數(shù)量和已用數(shù)量。例如以以下列圖：設(shè)備管理如果，你想禁用或啟用某個設(shè)備的話，登錄成功后點擊【設(shè)備管理】，如以以下列圖：選中要禁用的設(shè)備，點擊其后【禁用】按鈕，該設(shè)備即被禁用。該設(shè)備登錄任意一個u8移動產(chǎn)品均提示：該設(shè)備已被停用?！沧ⅲ航迷O(shè)備后同時禁用了產(chǎn)品〕。禁用后效果如以以下列圖：啟用某設(shè)備時，需要兩步，點擊該設(shè)備后的【重新啟用】按鈕。如以以下列圖：選中該設(shè)備，點擊【應(yīng)用設(shè)置】，勾選該設(shè)備需要用的應(yīng)用?！沧ⅲ簡⒂迷O(shè)備時不會同時啟用app產(chǎn)品，故需手動啟用〕。同理，如果想禁用某設(shè)備上的app應(yīng)用，只需要將應(yīng)用設(shè)置中的app前的勾去掉即可〔啟用該app，即勾上〕。如以以下列圖：訪問日志登錄成功后點擊【訪問日志】按鈕，可查看員工的操作日志，同時可按日期、設(shè)備、模塊、操作類型等進展搜索。同時，點擊日志中登錄操作后的經(jīng)緯度，可在地圖上查看該人員的登錄地點。如以以下列圖：統(tǒng)計報表登錄成功后點擊【統(tǒng)計報表】，彈出菜單欄，可分別按照：app登錄排行、app接入方式統(tǒng)計、操作分析等進展統(tǒng)計，具體見以以下列圖：App登錄排行：可查看本企業(yè)中app使用情況App接入方式統(tǒng)計：可查看員工使用何種聯(lián)網(wǎng)方式來登錄APP操作分析：可查看每個員工在后臺所做的操作地理分析登錄成功后點擊【地理分析】按鈕?？刹榭幢竟締T工在全國各地的登錄情況。如以以下列圖：常見問題無法連接到服務(wù)器表現(xiàn)為：客戶端無法獲取賬套，或無法登錄，提示連接服務(wù)器超時等?？赡艿脑颍嚎蛻舳薎P地址、端口號輸入錯誤服務(wù)端防火墻或路由器配置錯誤移動服務(wù)未正常運行排查步驟：檢查端輸入的IP地址和端口號是否與服務(wù)配置的一致，使用移動網(wǎng)絡(luò)時只能訪問路由器IP和端口。檢查服務(wù)是否已正常啟動且WIFI環(huán)境可訪問：在移動服務(wù)器上，查看u8maservice服務(wù)項是否已啟動檢查u8soft\maserver\startup.log文件，是否記錄為服務(wù)器已正常啟動在移動服務(wù)器上，瀏覽器訪問URL:://服務(wù)器內(nèi)網(wǎng)IP:端口，檢查是否能翻開服務(wù)器信息頁面檢查防火墻設(shè)置是否已允許移動服務(wù)端口訪問網(wǎng)絡(luò)如果WIFI環(huán)境可訪問，檢查路由器配置端口映射是否正確通過瀏覽器訪問URL:://路由器外網(wǎng)IP:端口，檢查路由器配置是否可由外部訪問如路由器地址可通過外網(wǎng)訪問，檢查網(wǎng)絡(luò)是否連通。系統(tǒng)發(fā)生異常獲取賬套時提示“系統(tǒng)發(fā)生異常〞：通常是IIS異常，