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

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