数据访问服务安装部署说明环境说明

数据访问服务安装部署说明

一、必备环境说明

>系统版本：Windowserver2008及以上版本

>HS版本：7.0及以上版本，具体安装说明参见《Window

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

也可以上网查询安装方法。

>.NetFramework版本：4.6及以上，具体安装说明参见《DocNet4.6

安装说明.txt》,也可以上网查询安装方法。

>.NetCore版本：2.2及以上，具体安装说明参见《DotNetCore安装

说明.txt》,也可以上网查询安装方法。

>数据库：MySQL数据库及单独账号如果没有现成的MySQL数据库,

就需要安装，MySQL数据库安装参见《MySql安装部署说明.docx》，

也可以上网查询安装方法。

针对以上环境特殊说明：

1、确保操作系统补丁已经安装

2、严格按照文档提供方法和顺序进行软件及环境安装

3、针对V2.0.1.以后的版本，更新前必须准备三个数据

库：数据访问服务本身数据库、平台库（认证库）和

数据字典库。

4、以下部署安装步骤，要认真阅读和严格执行。

5、如果是升级数据访问服务，更新前重启HS,防止文

件被占用，导致更新失败。

6、如果是覆盖式更新，更新完成之后,请手动清除缓存。

7、如果升级为V2.0.L版本，确保服务器安装.net4.6.

二、安装

执行数据访问安装包""，按照安装步骤及说明进行安装。

1、第一步必备环境确认

如果已经安装过，会提示是否卸载界面，如下图：

根据实际需要决定是否卸载，如果需要卸载则点击"是"，不需要卸载，停

止安装则点击"否"按钮。

注意：(1)如果是升级，为了沿用原有配置信息，通常选择"否"；

(2)理论上一台服务器值允许运行一个数据访问服务，目前还没有对运

行多套进行处理。

o安装-处访问服务x

许可协议

继续安装前请阅读下列重要信息。

♦仔细阅读下列许可协议。您在继续安装前必须同意这些协议条款。

安装数据访问服务需要具备的环境如下：

系僦本：Windowserver2008R2spi及本

IIS版本：7.0及以上版本

.NetCoreRuntime版本：2.0及以上

.NetCoreWindowsHosting版本：1.0及以上

，匚7Tti'ImCdc淑rtS4'EV

O我同意此协议(A)

⑥我不同意亚松议®]

汉威科技——二^

下一步3)>取消

注意许可协议内容，数据访问服务运行所需必备环境，认真阅读并检查。

2安装-数据访问服务一X

许可协议

继续安装前请阅读下列重要信息。

清仔细阅读下列许可协议。您在继续安装前必须同意这些协议条款。

安装数据访问服务需要具备的环境如下：

本：Windowserver2008R2spi及liLt®本

HS版本：7。及以上版本

.NetCoreRuntime版本：2.0及以上

.NetCoreWindowsHosting版本：1.0及以上

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

o我不同意此协议也)

汉威哥技一

I下一步(助>I取消

如果满足必须环境满足，则可以选择"我同意此协议"，然后点击"下一步"

进行安装。

2、第二步安装目录选择

按照说明选择数据访问服务的安装路径后，然后点击"下一步"继续安装。

注意：1.数据访问服务有时需要连接oralce，所以安装路径中不能出现"("

或是"7,否则会出现oracle数据库访问不通的情况，后续修改相当麻烦,切

忌、切忌……！

2.最好选择新的安装目录，避免冲掉原来程序，方便备份

3、第三步服务安装

确认安装目录无误后，点击"安装"按钮进行安装。

如果已经安装过，但是没有卸载干净的，而且安装目录与以前安装相同，可

能会提示一下界面：

选择"自动关闭该应用程序"后（查看进程"HwWatcher"进程，手动关闭进

程），点击"下一步"继续安装。

如果360阻止时，请点击允许运行

Q.；JS.^^gg馈x

这是敲诈病毒，会勒索您的钱财

风险程序:fifaC:\Users\Administrator\Desktop

\DasSetUp2.19.09.26.exe

发起来源：C:\Users\Administrator\is-OGIF9.tmp

\DasSetUp2.19.09.26.tmp

目标:C:\HanWeiVR据访问服务19.09.26\DasManage\lib

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

敲诈分毒会将电脑中文档、图片、数据等资料全部加空隐意,并以此

向您勒索高额钱财.建议立即阻止！

阻止本射作(27)

安装完成后显示如下界面：

选中"运行数据访问服务"然后点击"完成"按钮，完成数据访问服务的安装。

二、部署配置

完成数据访问服务的安装后，运行数据访问服务，会出现数据访问服务的部

署配置界面，按照配置说明，进行配置及部署。

注意：如果要修改配置，可以通过先找到数据访问服务的安装目录，然后运

行"部署配置.exe"启动配置。

1、第一步服务网站配置

首先，如下图提示是否导入配置文件，没有配置文件，则点击"否"即可

这里可以数据访问服务部署到新建网站下，也可以部署到已有网站下，具体

操作说明如下：

(1)创建新网站

按照说明填写新网站信息，包括网站名称、绑定端口、应用程序池等信息八

网站名称：要求网站名称不能与已有网站重名

绑定端口：网站端口，数字类型，不能与已有网站端口重复

应用程序池：可以填写应用程序池名称，新建应用程序池(应用程序池名称

不能和已有应用程序池重复),也可以选择已有应用程序池。点击"选择"按钮，

弹出一下界面：

选择应用程序池

应用程序地：

雕k

版O

托

管

馥

$::V4根

a

运

伊

原

安装程序检测应用程序池的配置信息，抓取符合条件的应用程序，供选择,

选择后，点击"确定"按钮，否则点击"取消"按钮。

(2)部署已有网站下

可以把数据访问服务配置到已有网站下，取消"创建新网站"选框，则进入

已有网站选择操作界面。

选择已有网站名称则会把已有网站的端口及应用程序池提取到页面上如下图：

由于通过程序获取到的服务器IP不准确，所以需要配置检查，如果和预设

不一致，需要手动修改，并确认，如果确认无误后，点击"下一步"按钮，继续

后续配置。

注意：如果IP设置不准确，会影响数据访问服务管理的正常运行。

2、第二步应用程序配置

数据访问服务应用程序配置，数据访问服务应用程序包括五个，分别为认证

服务SSOService、数据访问服务DasService、FasService文件服务、RasService

报表服务和服务管理DasManage,界面如下图：

网站应用程序的名称是固定的，但是对应的引用程序池是可以修改的，用户

可以修改应用程序池名称，新建应用应用程序池，也可以选择已有应用程序池,

界面如下：

安装程序检测应用程序池的配置信息，抓取符合条件的应用程序，供选择,

选择后，点击"确定"按钮，否则点击"取消"按钮。

数据访问服务部署配置1*1

通过以下配置搭建"数据访问服务"网站的应用程

序,如果存在相同名称的则修改原应用程序，否则新建

应用颗,具体操伽下：

注意：应用程序地，不能与其它网站或是应用程序共用，

如果默认应用程序池已被使用，请重新命名程序池!

|上一步||下一步|

应用程序配置信息确认无误后，点击"下一步"按钮，继续后续配置。

3、第三步服务数据库配置

数据访问服务的数据库配置，该数据库存储数据访问服务中配置的接口配置

信息。

注意：

＞目前数据访问服务数据库，只支持MySQL数据库，该数据库账号要有

建表、操作数据等权限。

＞该数据库数据表及数据可以为空，在数据访问服务安装部署完后，运行

数据服务管理，进行数据库初始化操作。

填写完数据库连接配置信息后，点击"测试运行”进程数据库连接测试，确

保数据库连接配置正确。

|数据访问康务部署配置x1

服务数据库配置

数据库类型：您MySQLOOracle

登录用户名：I

登录密码：,****~j

认X1

8.1.187

I酝I

上一步下一步

配置完成后，点击"下一步"按钮，继续后续配置。

4、第四步服务平台认证配置

由于数据访问服务在访问接口时有认证，认证目前使用的是平台的用户认

证体系，所以需要配置平台的数据库连接信息，如下图：

注意：(1)目前数据访问服务使用的用户密码认证方式，后续会建成平台的

Token认证，平台数据库配置会换成Token认证地址配置。

(2)可以设置平台认证库为平台4还是平台5数据库，因为平台4和

平台5的数据库表结构不一致，所以认证语句不一致，需要标识一下。

(3)还可以选择"同一账号只允许一客户端在线"设置，如果选中

一个账号只能一台机器登录，再次登录会吧上次登录人踢下来。

填写完数据库连接配置信息后，点击"测试运行”进程数据库连接测试，确

保数据库连接配置正确。

配置完成后，点击"下一步"按钮，继续后续配置。

5、第五步数据字典库配置

为了满足数据访问服务支持批量生成数据访问服务接口（单表）功能，通过

引用数据字典库，基于数据字典库中表及其字段数据，动态生成数据访问服务的

查询和保存服务。具体数据字典库配置界面，如下：

所访问服务般配置X

数据字典数据库配置

上一步II下一步I

6、第六步服务其他认证配置

数据访问服务除了提供平台认证方式外，还提供第三方认证，例如中石化认

证、ad域认证、汉威考勤认证等，根据实际需求配置响应的认证方式，具体如

下图：

数据访问服务部署配置X

标识：［unity一1添加删除

unity

认证方式

O平台库@汉威认证

□认证通过后，如果无用户信息，是否自动添加到平台中

认证配置：汉，认证密置信息清严格参寰部著手副埴写！

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

上一步|FT|

数据访问服务一个服务提供多套认证，通过标识区分，可以点击“添加"按

钮添加认证方式，在应用使用时，根据标识获取相应的认证配置，做响应的判断，

认证配置格式具体如下：

汉威服务认证：

1）中石化统一认证方式，编写格式

{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"}

由于第三方认证通过后，平台库中没有验证通过用户的信息时，应用有可

能会出错，所以这里可以设置，第三方认证通过后，是否检测平台中有没有该用

户信息，如果没有就添加。

配置完成后，点击"下一步"按钮，继续后续配置。

注意如果这一步出错，请将安装目录下的"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、第七步文件存储部署配置

数据访问服务支持文件上传和文件的下载，需要配置文件存储路径，这里

可以配置多个标识的文件存储地址，在访问时，通过标识判断使用按个路径，如

下图：

数据访问服务默认会有两个标识的路径信息分别为vmd、wdk、resources

和isip5ocx,而且路径也是默认的，需要按照实际情况修改，也可以点击“添

加"按钮进行路径标识的添加，如下图：

如果需要创建虚拟目录的可以选中"是否创建虚拟目录"，方便后续应用中

使用。配置完成后，点击"下一步"按钮，继续后续配置。

8、第八步执行部署配置

执行网站及应用程序的配置及配置文件的修改，在运行提示框中，会提示

执行操作情况，如下图：

配置完成后，提示如下图，点击"完成"按钮，退出部署配置。

注意：在执行配置的过程中，会有些意外情况，导致配置不成功，则不成

功的需要用户进行手动配置，具体怎么操作，在配置运行提示中会有相关提示,

在此不再做详细介绍。

9、第九步服务运行测试

在完成安装配置后，部署程序会打开数据访问服务管理页面，如下图，具

体操作说明详见《数据访问服务管理用户操作手册.doc》。

注意：如果数据访问服务数据库的表和数据没有初始化，则可以进入服务

管理中的“系统设置""数据库设置""数据初始化"进行数据库初始化。

三、配置修改

如果修改数据访问服务的配置信息，可以通过先找到数据访问服务的安装目

录，然后运行"部署配置.exe"启动配置。

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

直接点击"下一步"跳过即可。

附件一相关问题解决方法

一、部署配置相关问题解决

如果第一步遇到如下问题：

会访问服务部等配置x

未知错误(0x8000500。)。

|▼详细信息S)继续(C)退出⑹

可能的原因：iis没装或是iis装的不全

解决方法：安装iis相关功能，特别是兼容性配置一定要选择装,具体看iis安装

指南.docx

二、跨域问题解决

如果数据访问服务访问接口时，出现跨域问题，可以通过设置iis的允许跨

域解决，具体设置步骤为：

(1)打开iis的"http响应标头"设置，如下图：

号DESKTOPT11HRN5痂

S3：_______•丁申en-♦至学二手通知

ASPKT

❺WtbSite曲国•毛桀,&J!

JMEf*SJM£T»»55.N£TWESJMEfSMTP电子frSttSttIWi

HRKd

0皿内目做身

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

具体内容如下：

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位问题解决

如果数据报表服务在部署后，访问遇到以下错误:

错误信息!X

试图加载格式不正确的程序。(ExceptionfromHRESULT:0x80070C0B)

就需要检查报表服务是否以64位运行如果不是以64位运行那就检查。

Netcore安装是否支持64位，如果netcore支持64位，就检查系统环境变量。

修改环境变量Path:将C:\ProgramFiles\dotnet\修改先于C:\Program

Files(x86)\dotnet\，修改完环境变量后,重启服务器。

四、数据访问服务登录出错解决1

可以F12查看请求信息，打开认证的请求url,拷贝url内容到浏览器中打

开，杳看具体错误内容。相关错误提示如下：

HTTP瞰500.19InternalServerLrror

无HM*初页・,网为迳©的❸义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)如果出错就要直看系统补丁是否安装

(2)Dotnet框架是否安装

(3)vjredist.重新装一下

(4)重启服务器

五、数据访问服务登录出错解决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安装部署说明安

装即可。

六、数据访问服务数据乱码问题解决

如果数据访问服务界面数据出现乱码，如下图:

说明数据集编码与导入的数据文件编码格式不一致导致。

(1)要求mysql数据库在安装，必须选用Utf8格式；如果不是以上要求，请修

改，数据库安装编码需要通过配置文件修改，具体操作请查阅百度;

(2)要求数据库创建时，基字符集选用Utf8数据库排序规则选择：

utf8_general_ci.如果数据库不是该编码，则修改数据库或是删除后重新创建即

可。

七、打开IIS7.0网页时收到“