數(shù)據(jù)訪問服務安裝部署說明

一、必備環(huán)境說明

>系統(tǒng)版本：Windowserver2008及以上版本

>HS版本：7.0及以上版本，具體安裝說明參見《Window

Server2008_iis安裝.doc》或是《WindowServer2012_iis安裝.docx》,

也可以上網(wǎng)查詢安裝方法。

>.NetFramework版本：4.6及以上，具體安裝說明參見《DocNet4.6

安裝說明.txt》,也可以上網(wǎng)查詢安裝方法。

>.NetCore版本：2.2及以上，具體安裝說明參見《DotNetCore安裝

說明.txt》,也可以上網(wǎng)查詢安裝方法。

>數(shù)據(jù)庫：MySQL數(shù)據(jù)庫及單獨賬號如果沒有現(xiàn)成的MySQL數(shù)據(jù)庫,

就需要安裝，MySQL數(shù)據(jù)庫安裝參見《MySql安裝部署說明.docx》，

也可以上網(wǎng)查詢安裝方法。

針對以上環(huán)境特殊說明：

1、確保操作系統(tǒng)補丁已經(jīng)安裝

2、嚴格按照文檔提供方法和順序進行軟件及環(huán)境安裝

3、針對V2.0.1.以后的版本，更新前必須準備三個數(shù)據(jù)

庫：數(shù)據(jù)訪問服務本身數(shù)據(jù)庫、平臺庫（認證庫）和

數(shù)據(jù)字典庫。

4、以下部署安裝步驟，要認真閱讀和嚴格執(zhí)行。

5、如果是升級數(shù)據(jù)訪問服務，更新前重啟HS,防止文

件被占用，導致更新失敗。

6、如果是覆蓋式更新，更新完成之后,請手動清除緩存。

7、如果升級為V2.0.L版本，確保服務器安裝.net4.6.

二、安裝

執(zhí)行數(shù)據(jù)訪問安裝包""，按照安裝步驟及說明進行安裝。

1、第一步必備環(huán)境確認

如果已經(jīng)安裝過，會提示是否卸載界面，如下圖：

根據(jù)實際需要決定是否卸載，如果需要卸載則點擊"是"，不需要卸載，停

止安裝則點擊"否"按鈕。

注意：(1)如果是升級，為了沿用原有配置信息，通常選擇"否"；

(2)理論上一臺服務器值允許運行一個數(shù)據(jù)訪問服務，目前還沒有對運

行多套進行處理。

o安裝-處訪問服務x

許可協(xié)議

繼續(xù)安裝前請閱讀下列重要信息。

?仔細閱讀下列許可協(xié)議。您在繼續(xù)安裝前必須同意這些協(xié)議條款。

安裝數(shù)據(jù)訪問服務需要具備的環(huán)境如下：

系僦本：Windowserver2008R2spi及本

IIS版本：7.0及以上版本

.NetCoreRuntime版本：2.0及以上

.NetCoreWindowsHosting版本：1.0及以上

，匚7Tti'ImCdc淑rtS4'EV

O我同意此協(xié)議(A)

⑥我不同意亞松議?]

漢威科技——二^

下一步3)>取消

注意許可協(xié)議內(nèi)容，數(shù)據(jù)訪問服務運行所需必備環(huán)境，認真閱讀并檢查。

2安裝-數(shù)據(jù)訪問服務一X

許可協(xié)議

繼續(xù)安裝前請閱讀下列重要信息。

清仔細閱讀下列許可協(xié)議。您在繼續(xù)安裝前必須同意這些協(xié)議條款。

安裝數(shù)據(jù)訪問服務需要具備的環(huán)境如下：

本：Windowserver2008R2spi及l(fā)iLt?本

HS版本：7。及以上版本

.NetCoreRuntime版本：2.0及以上

.NetCoreWindowsHosting版本：1.0及以上

也rteq.KC1/匚'ZE'J—=I'ITXV

o我不同意此協(xié)議也)

漢威哥技一

I下一步(助>I取消

如果滿足必須環(huán)境滿足，則可以選擇"我同意此協(xié)議"，然后點擊"下一步"

進行安裝。

2、第二步安裝目錄選擇

按照說明選擇數(shù)據(jù)訪問服務的安裝路徑后，然后點擊"下一步"繼續(xù)安裝。

注意：1.數(shù)據(jù)訪問服務有時需要連接oralce，所以安裝路徑中不能出現(xiàn)"("

或是"7,否則會出現(xiàn)oracle數(shù)據(jù)庫訪問不通的情況，后續(xù)修改相當麻煩,切

忌、切忌……！

2.最好選擇新的安裝目錄，避免沖掉原來程序，方便備份

3、第三步服務安裝

確認安裝目錄無誤后，點擊"安裝"按鈕進行安裝。

如果已經(jīng)安裝過，但是沒有卸載干凈的，而且安裝目錄與以前安裝相同，可

能會提示一下界面：

選擇"自動關閉該應用程序"后（查看進程"HwWatcher"進程，手動關閉進

程），點擊"下一步"繼續(xù)安裝。

如果360阻止時，請點擊允許運行

Q.；JS.^^gg饋x

這是敲詐病毒，會勒索您的錢財

風險程序:fifaC:\Users\Administrator\Desktop

\DasSetUp2.19.09.26.exe

發(fā)起來源：C:\Users\Administrator\is-OGIF9.tmp

\DasSetUp2.19.09.26.tmp

目標:C:\HanWeiVR據(jù)訪問服務19.09.26\DasManage\lib

\dhtmlx5.0\samples\dhtmlxCarouseKcommon\imgs\3jpg

敲詐分毒會將電腦中文檔、圖片、數(shù)據(jù)等資料全部加空隱意,并以此

向您勒索高額錢財.建議立即阻止！

阻止本射作(27)

安裝完成后顯示如下界面：

選中"運行數(shù)據(jù)訪問服務"然后點擊"完成"按鈕，完成數(shù)據(jù)訪問服務的安裝。

二、部署配置

完成數(shù)據(jù)訪問服務的安裝后，運行數(shù)據(jù)訪問服務，會出現(xiàn)數(shù)據(jù)訪問服務的部

署配置界面，按照配置說明，進行配置及部署。

注意：如果要修改配置，可以通過先找到數(shù)據(jù)訪問服務的安裝目錄，然后運

行"部署配置.exe"啟動配置。

1、第一步服務網(wǎng)站配置

首先，如下圖提示是否導入配置文件，沒有配置文件，則點擊"否"即可

這里可以數(shù)據(jù)訪問服務部署到新建網(wǎng)站下，也可以部署到已有網(wǎng)站下，具體

操作說明如下：

(1)創(chuàng)建新網(wǎng)站

按照說明填寫新網(wǎng)站信息，包括網(wǎng)站名稱、綁定端口、應用程序池等信息八

網(wǎng)站名稱：要求網(wǎng)站名稱不能與已有網(wǎng)站重名

綁定端口：網(wǎng)站端口，數(shù)字類型，不能與已有網(wǎng)站端口重復

應用程序池：可以填寫應用程序池名稱，新建應用程序池(應用程序池名稱

不能和已有應用程序池重復),也可以選擇已有應用程序池。點擊"選擇"按鈕，

彈出一下界面：

選擇應用程序池

應用程序地：

雕k

版O

托

管

馥

$::V4根

a

運

伊

原

安裝程序檢測應用程序池的配置信息，抓取符合條件的應用程序，供選擇,

選擇后，點擊"確定"按鈕，否則點擊"取消"按鈕。

(2)部署已有網(wǎng)站下

可以把數(shù)據(jù)訪問服務配置到已有網(wǎng)站下，取消"創(chuàng)建新網(wǎng)站"選框，則進入

已有網(wǎng)站選擇操作界面。

選擇已有網(wǎng)站名稱則會把已有網(wǎng)站的端口及應用程序池提取到頁面上如下圖：

由于通過程序獲取到的服務器IP不準確，所以需要配置檢查，如果和預設

不一致，需要手動修改，并確認，如果確認無誤后，點擊"下一步"按鈕，繼續(xù)

后續(xù)配置。

注意：如果IP設置不準確，會影響數(shù)據(jù)訪問服務管理的正常運行。

2、第二步應用程序配置

數(shù)據(jù)訪問服務應用程序配置，數(shù)據(jù)訪問服務應用程序包括五個，分別為認證

服務SSOService、數(shù)據(jù)訪問服務DasService、FasService文件服務、RasService

報表服務和服務管理DasManage,界面如下圖：

網(wǎng)站應用程序的名稱是固定的，但是對應的引用程序池是可以修改的，用戶

可以修改應用程序池名稱，新建應用應用程序池，也可以選擇已有應用程序池,

界面如下：

安裝程序檢測應用程序池的配置信息，抓取符合條件的應用程序，供選擇,

選擇后，點擊"確定"按鈕，否則點擊"取消"按鈕。

數(shù)據(jù)訪問服務部署配置1*1

通過以下配置搭建"數(shù)據(jù)訪問服務"網(wǎng)站的應用程

序,如果存在相同名稱的則修改原應用程序，否則新建

應用顆,具體操伽下：

注意：應用程序地，不能與其它網(wǎng)站或是應用程序共用，

如果默認應用程序池已被使用，請重新命名程序池!

|上一步||下一步|

應用程序配置信息確認無誤后，點擊"下一步"按鈕，繼續(xù)后續(xù)配置。

3、第三步服務數(shù)據(jù)庫配置

數(shù)據(jù)訪問服務的數(shù)據(jù)庫配置，該數(shù)據(jù)庫存儲數(shù)據(jù)訪問服務中配置的接口配置

信息。

注意：

＞目前數(shù)據(jù)訪問服務數(shù)據(jù)庫，只支持MySQL數(shù)據(jù)庫，該數(shù)據(jù)庫賬號要有

建表、操作數(shù)據(jù)等權限。

＞該數(shù)據(jù)庫數(shù)據(jù)表及數(shù)據(jù)可以為空，在數(shù)據(jù)訪問服務安裝部署完后，運行

數(shù)據(jù)服務管理，進行數(shù)據(jù)庫初始化操作。

填寫完數(shù)據(jù)庫連接配置信息后，點擊"測試運行”進程數(shù)據(jù)庫連接測試，確

保數(shù)據(jù)庫連接配置正確。

|數(shù)據(jù)訪問康務部署配置x1

服務數(shù)據(jù)庫配置

數(shù)據(jù)庫類型：您MySQLOOracle

登錄用戶名：I

登錄密碼：,****~j

認X1

8.1.187

I醞I

上一步下一步

配置完成后，點擊"下一步"按鈕，繼續(xù)后續(xù)配置。

4、第四步服務平臺認證配置

由于數(shù)據(jù)訪問服務在訪問接口時有認證，認證目前使用的是平臺的用戶認

證體系，所以需要配置平臺的數(shù)據(jù)庫連接信息，如下圖：

注意：(1)目前數(shù)據(jù)訪問服務使用的用戶密碼認證方式，后續(xù)會建成平臺的

Token認證，平臺數(shù)據(jù)庫配置會換成Token認證地址配置。

(2)可以設置平臺認證庫為平臺4還是平臺5數(shù)據(jù)庫，因為平臺4和

平臺5的數(shù)據(jù)庫表結(jié)構(gòu)不一致，所以認證語句不一致，需要標識一下。

(3)還可以選擇"同一賬號只允許一客戶端在線"設置，如果選中

一個賬號只能一臺機器登錄，再次登錄會吧上次登錄人踢下來。

填寫完數(shù)據(jù)庫連接配置信息后，點擊"測試運行”進程數(shù)據(jù)庫連接測試，確

保數(shù)據(jù)庫連接配置正確。

配置完成后，點擊"下一步"按鈕，繼續(xù)后續(xù)配置。

5、第五步數(shù)據(jù)字典庫配置

為了滿足數(shù)據(jù)訪問服務支持批量生成數(shù)據(jù)訪問服務接口（單表）功能，通過

引用數(shù)據(jù)字典庫，基于數(shù)據(jù)字典庫中表及其字段數(shù)據(jù)，動態(tài)生成數(shù)據(jù)訪問服務的

查詢和保存服務。具體數(shù)據(jù)字典庫配置界面，如下：

所訪問服務般配置X

數(shù)據(jù)字典數(shù)據(jù)庫配置

上一步II下一步I

6、第六步服務其他認證配置

數(shù)據(jù)訪問服務除了提供平臺認證方式外，還提供第三方認證，例如中石化認

證、ad域認證、漢威考勤認證等，根據(jù)實際需求配置響應的認證方式，具體如

下圖：

數(shù)據(jù)訪問服務部署配置X

標識：［unity一1添加刪除

unity

認證方式

O平臺庫@漢威認證

□認證通過后，如果無用戶信息，是否自動添加到平臺中

認證配置：漢，認證密置信息清嚴格參寰部著手副埴寫！

{AuthType:url:*http：//sasp.slo￡.com:9006/SiamService,asmx*)

上一步|FT|

數(shù)據(jù)訪問服務一個服務提供多套認證，通過標識區(qū)分，可以點擊“添加"按

鈕添加認證方式，在應用使用時，根據(jù)標識獲取相應的認證配置，做響應的判斷，

認證配置格式具體如下：

漢威服務認證：

1）中石化統(tǒng)一認證方式，編寫格式

{AuthType:"2",url:":9006/"}

2）AD域

{AuthType:"5",adPath:"LDAP://china",suffix:""}

3）中石油

{AuthType:"6",url:":9080/SSOServices/services/SSOServiceImpl?wsdl

"}

4）平臺服務

{AuthType:"l",url:n:86/update/,,,className:"ptinterface"}

5）Dll認證：

{AuthType:n4",fileName:n",className:"hHandle",url:"",appkey:"1041n

,appSecrect:"1041_yczm"}

由于第三方認證通過后，平臺庫中沒有驗證通過用戶的信息時，應用有可

能會出錯，所以這里可以設置，第三方認證通過后，是否檢測平臺中有沒有該用

戶信息，如果沒有就添加。

配置完成后，點擊"下一步"按鈕，繼續(xù)后續(xù)配置。

注意如果這一步出錯，請將安裝目錄下的"SSOService"->"Config"->

刪除后重新打開"部署配置.exe",重新配置.

認證方式對應的編號枚舉列表，如下：

III<summary>

///無

III</summary>

None=0,

///<summary>

///漢威認證

III〈/summary〉

Simple=1,

///<summary>

///Sinopec

III</summary>

Sinopec=2,

III<summary>

///rest服務

III</summary>

Rest=3,

///<summary>

///dll認證

III</summary>

Dll=4,

III<summary>

///ad域認證

III</summary>

AD=5,

III<summary>

III中石油認證

III</summary>

UnifyEntry=6,

7、第七步文件存儲部署配置

數(shù)據(jù)訪問服務支持文件上傳和文件的下載，需要配置文件存儲路徑，這里

可以配置多個標識的文件存儲地址，在訪問時，通過標識判斷使用按個路徑，如

下圖：

數(shù)據(jù)訪問服務默認會有兩個標識的路徑信息分別為vmd、wdk、resources

和isip5ocx,而且路徑也是默認的，需要按照實際情況修改，也可以點擊“添

加"按鈕進行路徑標識的添加，如下圖：

如果需要創(chuàng)建虛擬目錄的可以選中"是否創(chuàng)建虛擬目錄"，方便后續(xù)應用中

使用。配置完成后，點擊"下一步"按鈕，繼續(xù)后續(xù)配置。

8、第八步執(zhí)行部署配置

執(zhí)行網(wǎng)站及應用程序的配置及配置文件的修改，在運行提示框中，會提示

執(zhí)行操作情況，如下圖：

配置完成后，提示如下圖，點擊"完成"按鈕，退出部署配置。

注意：在執(zhí)行配置的過程中，會有些意外情況，導致配置不成功，則不成

功的需要用戶進行手動配置，具體怎么操作，在配置運行提示中會有相關提示,

在此不再做詳細介紹。

9、第九步服務運行測試

在完成安裝配置后，部署程序會打開數(shù)據(jù)訪問服務管理頁面，如下圖，具

體操作說明詳見《數(shù)據(jù)訪問服務管理用戶操作手冊.doc》。

注意：如果數(shù)據(jù)訪問服務數(shù)據(jù)庫的表和數(shù)據(jù)沒有初始化，則可以進入服務

管理中的“系統(tǒng)設置""數(shù)據(jù)庫設置""數(shù)據(jù)初始化"進行數(shù)據(jù)庫初始化。

三、配置修改

如果修改數(shù)據(jù)訪問服務的配置信息，可以通過先找到數(shù)據(jù)訪問服務的安裝目

錄，然后運行"部署配置.exe"啟動配置。

具體流程與"二、部署配置"的操作步驟一致，如果某些步驟不需要修改，

直接點擊"下一步"跳過即可。

附件一相關問題解決方法

一、部署配置相關問題解決

如果第一步遇到如下問題：

會訪問服務部等配置x

未知錯誤(0x8000500。)。

|▼詳細信息S)繼續(xù)(C)退出⑹

可能的原因：iis沒裝或是iis裝的不全

解決方法：安裝iis相關功能，特別是兼容性配置一定要選擇裝,具體看iis安裝

指南.docx

二、跨域問題解決

如果數(shù)據(jù)訪問服務訪問接口時，出現(xiàn)跨域問題，可以通過設置iis的允許跨

域解決，具體設置步驟為：

(1)打開iis的"http響應標頭"設置，如下圖：

號DESKTOPT11HRN5痂

S3：_______?丁申en-?至學二手通知

ASPKT

?WtbSite曲國?毛桀,&J!

JMEf*SJM￡T??55.N￡TWESJMEfSMTP電子frSttSttIWi

HRKd

0皿內(nèi)目做身

添加Access-Control-Allow-Origin和Access-Control-Allow-Headers,

具體內(nèi)容如下：

Access-Contro1-A11ow-Origin:*

Access-Control-Allow-Headers:RunMode,Token,Debug,FilePath,SystemID,Content-type,X-Reque

sted-With,ModulelD,CallCode,ActionType,DebugStatus,FileName,DestName,DestPath,DirPath,FileTy

pe,Size,AttrCase,Offset,StartIndex,PageSize,ByteFeiIds,Docid,WdkHost,EcyLogin,然后重試。

(2)如果通過以上操作解決了跨域的問題，可以嘗試將

Access-Control-Allow-Origin和Access-Control-Allow-Headers設置刪除,

然后再重試訪問，如果依然存在跨域問題，則重復步驟(1),不再進行步驟(2).

三、運行32位與64位問題解決

如果數(shù)據(jù)報表服務在部署后，訪問遇到以下錯誤:

錯誤信息!X

試圖加載格式不正確的程序。(ExceptionfromHRESULT:0x80070C0B)

就需要檢查報表服務是否以64位運行如果不是以64位運行那就檢查。

Netcore安裝是否支持64位，如果netcore支持64位，就檢查系統(tǒng)環(huán)境變量。

修改環(huán)境變量Path:將C:\ProgramFiles\dotnet\修改先于C:\Program

Files(x86)\dotnet\，修改完環(huán)境變量后,重啟服務器。

四、數(shù)據(jù)訪問服務登錄出錯解決1

可以F12查看請求信息，打開認證的請求url,拷貝url內(nèi)容到瀏覽器中打

開，杳看具體錯誤內(nèi)容。相關錯誤提示如下：

HTTP瞰500.19InternalServerLrror

無HM*初頁?,網(wǎng)為逕?的?義ten■看兒依.

gh*IISWebCore

imBe9mRftqucst

IHIWF*Mt—

CGKW0x80070003

WAD:\K*nwe?\ft9R^^fltM\DaaServ>oe\5-BveF?ie\we

bxofv6Q

url應該是：

http:〃xxxxx/DxsSeavice/Tok/nAuth/Hom/PoHe?3■。日in=dbadmin&ennodnpwd=MT工z&hwdhxrad

=GFd8Q

解決方法：

(1)如果出錯就要直看系統(tǒng)補丁是否安裝

(2)Dotnet框架是否安裝

(3)vjredist.重新裝一下

(4)重啟服務器

五、數(shù)據(jù)訪問服務登錄出錯解決2

如果登錄時彈出一下錯誤:

:C^BOCTTPEht?lPUBIJC*-//*3C//DTDXKITO.1.0Strict//ElT"http〃c

2：<htmlx?ln.s="lttp://w*w3.org/1999/xhtBl*>

3<bead>

4,titie>US8.5詳細錯誤一50019-InternalServerErrorC/title>

5type=*text/css*>

6<i—

7body{?argin：0;font-size：.7e?;font-family：VerdaneuArial,Helveticasan

8code{n?argin：0：cx>lor：1006600;￡ont-se：1.1e?;￡ozit-weight：bold;}

9coxtfigsourcecode{￡ont-siz?：.8?;color：*000000:}

1。pre{*ar^in：0;￡ont~size：1.49；*ordrrap：br2alrord;}

11nLol{margin：lOpx0lOpx5px:}|

1r?..q,?.f?1

解決方法：iis安裝的不全，沒裝導致，打開iis安裝，參考iis安裝部署說明安

裝即可。

六、數(shù)據(jù)訪問服務數(shù)據(jù)亂碼問題解決

如果數(shù)據(jù)訪問服務界面數(shù)據(jù)出現(xiàn)亂碼，如下圖:

說明數(shù)據(jù)集編碼與導入的數(shù)據(jù)文件編碼格式不一致導致。

(1)要求mysql數(shù)據(jù)庫在安裝，必須選用Utf8格式；如果不是以上要求，請修

改，數(shù)據(jù)庫安裝編碼需要通過配置文件修改，具體操作請查閱百度;

(2)要求數(shù)據(jù)庫創(chuàng)建時，基字符集選用Utf8數(shù)據(jù)庫排序規(guī)則選擇：

utf8_general_ci.如果數(shù)據(jù)庫不是該編碼，則修改數(shù)據(jù)庫或是刪除后重新創(chuàng)建即

可。

七、打開IIS7.0網(wǎng)頁時收到“