MapGIS K9基础系列(一)--安装指南

2024年1月12日发(作者：)

MapGIS K9基础系列（一）--安装指南

很多朋友可能在安装或者使用MapGIS的过程中不同程度的遇到过一些问题，本文将深度剖析常用的MapGIS模块，旨在完全解决MapGIS安装以及因为安装异常导致的各种问题。（主要以MapGIS K9 SP2为例加以说明，MapGIS K9 SP3因为统一了安装风格和入口，用户操作更趋向于傻瓜化，本文会在不同的地方加以提醒。）

MapGIS K9 SP2软件根据软件的使用特性进行了区分，采用“证书+基础平台+增量包”的方式进行按需组合。其中：（1）证书服务安装程序用于控制软件使用权限（目前分两种，一种是学习版证书服务安装程序，另一种是正式版证书服务安装程序，根据证书的性质不同，软件相应的分为两大类：学习版和正式版）；（2）基础平台包含主要的功能模块，就是常说的MapGIS(根据功能模块的不同，软件可以分为专业版、工程版、企业版等)；（3）增量包主要针对二次开发用户（针对政务办公系统开发的搭建平台、针对WebGIS开发的IGServer，针对互联网真三维数字地球的Virtual Earth等），它是封装的一些插件、动态库，需要搭载在基础平台上才能正常使用。注：MapGIS K9 SP3统一了基础平台和增量包的安装入口，也就是说软件采用的是“证书+软件”的组合，所有MapGIS K9 SP2中基础平台和增量包里包含的功能模块都集成到了软件里，在安装时根据用户的选择进行安装，类似于MicroSoft Office 2010的安装程序，软件也不再根据基础平台的功能模块进行版本的区分（即不再分专业版、工程版、企业版）。

简要介绍了软件的基本情况，接下来将详细说明安装，这里以功能模块最全的MapGIS

K9 SP2企业版为例加以说明，主要分两步：

1.安装准备：

(1)如果只需要使用基础平台，非二次开发用户，只用安装“证书+MapGIS K9 SP2企业版”，不需要做其他额外准备；

(2)如果是BS二次开发用户，需要安装“证书+MapGIS K9 SP2企业版+MapGIS

IGServer增量包”。因为涉及BS，故在安装之前需要根据BS架构的特性确保机器上正常安装了IIS，.NET Framework（2.0及以上版本），否则会出现不同类型的错误（如果未安装IIS，则在安装IGS到最后阶段会进行回滚，并抛出一个代号为1603的致命错，.NET

Framework异常会导致访问开发的站点时，抛出“访问元数据失败”等等）。

一般可以在安装MapGIS之前用一个比较简单的方式检测下IIS的配置情况，打开浏览器，在地址栏输入localhost 或者127.0.0.1 （xp系统输入后面这个地址时可能会需要用户名和密码，建议用前面那个地址；win7系统由于IPV4/IPV6的关系，127.0.0.1和localhost指向的域实际是有差异的，根据个人情况，如果一个地址出不来，可以试试另一个），然后回车，如果出来IIS的默认页面即可（当然由于配置选项的差异，有时即使能出来默认页，但配置项不对，最后还是会导致IGS的异常）。

附：Win7系统的IIS配置截图和win7的IIS默认页分别如下图所示：

2.安装步骤：

安装前，有几点需要特别留意的：

1.

2.

安装应避免使用中文路径，避免个别系统由于中文路径导致的软件不能正常使用；

安装前请确认机器上没有正在运行的MapGIS K9，否则可能由于写注册表冲突，导致软件异常；

3. win7系统请以“右键-以管理员身份运行”,并且安装路径应避开系统盘，否则可能导致软件不能正常运行；

4. 安装MapGIS K9 SP3的用户请留意，如果之前在机器上安装过MapGIS K9 SP3,卸载后重新安装时路径变了，需要先清理注册表，否则由于之前的注册表值指定的服务程序路径没清除，而又与现在的不一致，导致软件个别服务不能工作。

2.1 安装证书服务程序

2.1.1正式版证书服务程序安装

正式版证书服务程序需要与中地公司发行的硬件狗配套使用，一起还有硬件狗的安装密码，安装前请确认是否被包含到产品包，确认无误后进行。过程如下：

1、 将硬件狗插入计算机的USB接口中，为了确保计算机能识别硬件狗请重新启动电脑（具体如何判断计算机是否已经识别硬件狗，请参见第6章附录节），以管理员身份登录系统，要确保服务器上10001端口打开。

2、关闭服务器上所有打开的应用程序。

重要：如果服务器上有正在运行的MapGIS 6.x 、MapGIS 7.x、MapGIS K9应用程序 和（或）其他需要连接MapGIS K9 证书服务的应用程序和服务，MapGIS证书服务安装完毕后有可能不能自动启动，强烈建议您在安装之前关闭所有正在运行的MapGIS应用程序和服务，然后再安装MapGIS K9 证书服务。

3、找到安装光盘中的证书服务安装程序后，双击“”文件进行安装（win7系统请以“右键-以管理员身份运行“安装，否则可能不能正常使用），进入正在准备安装界面（如下图所示）：

4.准备安装完成后，进入欢迎界面，点击“下一步”按钮，出现最终用户许可协议，选择“我接受许可协议中的条款”，点击“下一步”：

5.选择目的位置界面，在此界面点击“浏览”按钮选择安装路径，选择完路径后直接点击“下一步”：

6.准备开始安装，如图所示：

7.安装完成界面，直接点击“完成”，自动运行证书管理工具，弹出“证书服务管理器”，如图所示：

8.证书服务管理器。

证书服务管理器是集加密狗服务安装、检测、证书服务检测、证书注册等功能与一体的管理工具，能够检测出加密狗及证书服务的状态，如是否有插入USB加密狗、证书服务是否安装、证书服务是否已启动、证书服务是否已注册永久证书码、临时证书是否已过期等。

为了更好的说明“证书服务管理器”的主要功能及使用方法，下面分7类情况进行详细说明。

（1） 未能检测到USB加密狗：

一般启动了“证书服务管理器”，首先看看是否能在机器上检测到USB加密狗，若未能检查到USB加密狗，“证书服务管理器”会显示如下图所示的内容：

若未插入USB加密狗，则将其插入后再次检测其状态；

若已插入USB加密狗，但识别不出来可能是由于USB接口问题，可尝试换一个USB接口后再次检测；

若用的是较早版本白色USB加密狗，安装的win7操作系统则会识别不到，需联系我公司商务部对USB加密狗进行升级；

注：输入密码的时候，一定要分清楚密码中数字“0”和字母“o”等容易引起混淆的文字，以避免出入有误造成的不便。

（2） 已检测到USB加密狗，未检测到注册证书：

当USB加密狗状态检测正常，但未检测到注册证书时，“证书服务管理器”会显示出USB加密狗的类型、序列号、功能号及节点数，同时作出如下提示：

此时点击“单击此处申请许可证书”链接跳转到申请证书码并认证的界面，如下图所示：

输入USB加密狗的安装密码（一般记录在随USB加密狗一并邮寄给用户的纸条上）、用户姓名、单位、联系电话、邮箱等资料，点击“认证”按钮，系统便会自动计算出该USB加密狗的注册码及证书码。注意，此步骤在操作时必须保持Internet网络联通，否则会导致注册失败，弹出如下提示框：

此时用户可检查网络状态，保持网络通畅后，点击上图的“是”按钮切换到手动申请证书码界面，如下图所示：

手动申请证书码并认证的步骤可直接参照上图操作步骤完成，此处不再赘述。

（3） 已注册临时证书（未过期），未安装证书服务：

若暂时不能联网，系统提供了临时证书，有效期自注册起30日。当系统检测到当前使用的为临时证书时，会做出如下图提示：

此时可点击“单击此处申请永久许可证书”链接跳转到申请证书吗并认证界面进行认证（具体操作步骤参见前面描述），也可以继续使用临时证书来安装证书服务，点击上图中的“请单击此处”链接跳转到证书服务管理界面：

点击“安装许可证服务”按钮安装服务，安装成功后需手动点击“启功许可证服务”按钮将该服务启动。

说明：“卸载许可证服务“按钮点亮时，说明许可证服务已安装，可点击此按钮将其卸载；”停止许可证服务“按钮点亮时，说明许可证服务处于启动状态，可点击此按钮停止此服务。

（4） 已注册临时证书（未过期），证书服务已启动：

临时证书的有效期只有30日，因此当用户使用临时证书安装了许可证服务则需尽快联网获取永久证书码，可按照下图所示提示及前面描述操作，此处不再赘述：

（5） 已注册临时证书（未过期），证书服务已停止：

当证书服务已停止时，“证书服务管理器“会做出如下提示，可点击”请单击此处启动MapGIS许可证书服务“链接跳转到证书服务管理界面启动服务，也可点击”单击此处申请永久许可证书“链接跳转到申请证书码并认证界面进行认证。（具体操作步骤参见前面描述）

（6） 已注册临时证书（已过期）：

当临时证书已经过期时，就必须申请永久许可证书，否则MapGIS K9 的所有程序都会不可使用，具体注册步骤参见前面描述。

（7） 已注册永久证书：

当用户已完成永久证书的注册，则可参见证书服务管理对应的操作内容安装许可服务。

9.一旦您安装完毕，安装程序会在服务器上自动运行MapGIS K9许可证服务。若未自动启动，打开管理工具中的服务，在服务列表中找到并启动MapGIS Licence Service。必要时重启电脑后启动该服务。

上述几个步骤是对有USB加密狗的用户安装证书服务程序时使用的。

10.安装完成后，在开始菜单会生成MapGIS K9许可证书服务菜单，MapGIS K9证书服务管理器提供证书管理工具，对证书进行管理，如下图所示：

2.1.2 学习版证书服务程序安装

学习版证书服务安装可参考正式版的安装过程，它与正式版证书服务安装过程唯一的不同之处在于学习版不要硬件加密狗，不要求输入安装密码。

2.2 安装基础平台

按上面的步骤安装完证书服务程序后，就可以安装MapGIS K9基础平台，即MapGIS

K9 SP2企业版。

注：

如果使用本机上的证书服务程序，安装前要确保USB加密狗已插在电脑上，且许可证服务处于启动状态，然后放入安装光盘到计算机光驱中，运行安装光盘中MapGIS K9 SP2企业版安装包的,启动安装向导；

如果用网络狗安装：安装前要确保本机已经连到服务器（插有USB加密狗的服务器），且网络狗所在服务器上的证书服务处于启动状态，然后把安装光盘放入计算机光驱中（或者拷贝安装包到电脑硬盘上安装），运行MapGIS K9 SP2企业版安装包即可；

如果是使用学习版证书服务的用户，请确保机器上的MapGIS Licence已启动，然后运行MapGIS K9 SP2企业版安装包即可。

1. 运行，启动安装向导。首先会提示准备安装，然后进入向导的欢迎界

面，单击“下一步“继续：

2. 许可协议。许可协议页面，请认真阅读协议条款，只有在接受协议的前提下才能继续安装。如果认可协议，请勾选“我接受许可证协议中的条款”，单击“下一步”继续；否则，点击“取消”，退出安装：

单击“下一步”出现“系统组件”页面，若必须组件已经安装才能继续下一步的操作。如果系统中还没有安装该组件，则会以红色的小叉标记，直接点击确认即可，MapGIS K9 SP2会自动安装这些组件；正确安装这些组件后，如下所示：

3. 客户信息。客户信息界面，请输入用户的姓名和公司名称，并选择安装该软件的用户类型，单击“下一步”按钮进入下一个安装界面：

4. 选择许可证服务器。在选择许可证服务器对话框中选择使用的许可证书服务的类型，有网络许可证和本机许可证两种。默认选择使用本机许可证，如果使用的是网络狗，请选择网络许可证服务器，并输入网络狗所在服务器的IP，然后单击“下一步”继续：

5. 自定义安装。这一步，您可以为MapGIS基础平台选择安装目录，默认的是系统盘下的路径，建议改到非系统盘，因为有些操作系统的系统盘安全性非常高，装在默认目录下可能会对软件使用造成影响。

点击“下一步”进入自定义安装界面，如下图所示：

上图可选择需要安装的功能，包括基础平台核心组件（必选）、SDE、解决方案、数据中心开发平台、示例数据和帮助文档。根据开发需求选择安装，点击“下一步”继续。

6. 安装过程。出现安装状态的对话框，将依次进行安装操作：复制文件，注册等，可能要花上几分钟，请您耐心等候：

在安装过程中，您可以打开电脑的任务管理器，查看性能下面的CPU使用情况，若在一定范围内上下跳动，进程正在占用CPU，则表示安装正常。拖遇到注册失败情况，则右击“我的电脑”，选择属性-高级-性能-数据执行保护，勾选“只为关键windows程序和服务启用数据执行保护”，单击“确定”即可。

7. 完成安装。在最后完成安装前，进行组件注册的操作，如下图所示：

最后将出现安装完成向导界面。单击“完成”，完成安装。

2.3安装MapGIS IGServer增量包

安装完证书服务安装程序和MapGIS K9 SP2企业版后，就可以安装MapGIS IGServer增量包了。MapGIS IGServer增量包有32位和64位系统安装文件，请根据自己的系统环境选择相应的安装文件进行安装（win7 64位系统需安装64的包，32位系统或者windows

xp/2003系统请安装32位的包）。启动安装文件，MapGIS IGServer增量包会自动安装到MapoGIS K9 SP2企业版的目录下，其他过程和前面基础平台的安装类似，此处不做赘述。

3.安装验证：

3.1 验证系统开始菜单

安装完毕，可以在“开始—所有程序”中查看软件，同时服务中会生成如下服务列表：

（这是没有安装MapGIS IGServer的截图，如果有安装，还会生成一个MapGIS

IGServer的目录节点）

3.2 验证系统服务列表

说明：如果只安装了“证书+基础平台”，服务列表里应该是2个以MapGIS开头的服务（MAPGIS DataStorage Service和MAPGIS Licence Service）；

如果使用的网络狗，本机只安装了基础平台，服务列表里应该有1个以MapGIS开头的服务（MAPGIS DataStorage Service）；

如果安装了MapGIS IGServer，服务列表里应该是5个以MapGIS开头的服务，除从上诉截图中的4个外还有一个是MapGIS IGServer GIS Center，这里由于本机不做大型应用，不需要服务器的集群管理，将其卸载。

3.3 验证安装文件

找到安装路径，打开MapGIS K9 SP2文件夹，会看到如下列表：

其中，红色标记出来的部分是安装MapGIS IGServer增量包后生成的，其他子文件则是安装MapGIS K9 SP2企业版后生成的，如果没有安装MapGIS IGServer增量包，则显示的应该是除开标记部分后剩下的其他文件。

各子文件的说明如下：

6xLib目录：里面包括Clib和Slib两个子文件夹，保存的是6x(GDB企业管理器中的MapGIS6xLocal数据源)数据源的字库配置目录与系统库目录；

Clib、Slib目录：字库配置目录与系统库目录；

DataCenter目录：工作目录，工作目录是用户选取和存取数据的目录；

Program目录：软件运行的程序文件、组件等；

Sample目录：包含所有提供的示例数据文件

Temp目录：临时文件目录，用于存放生成的缓存文件；

DataBase目录：IGS示例数据中的业务数据库部分，包括点位信息数据库，GPS数据库；

GisCenter目录：用于存放GIS 包，分配IP地址用于性能和压力测试；

Tool目录：工具文件夹，主要是IGS提供的3个便捷工具：公交换乘相关工具、JAVA环境配置工具、瓦片数据浏览工具；

WebSample目录：存放提供的两套示例站点（.NET 、JAVA各一套），用户可以直接配置在机器上进行体验；

WebSDK目录：IGS的二次开发工具包，包括服务端的SDK和客户端的SDK；

WebService目录：IGS服务站点，用于OGC地图显示的MapgisOGCWebService和用于.NET示例站点（MWSFullDemo）的MapgisWebService

3.4 验证软件基本使用

1.启动证书服务（使用网络狗的用户省略该步骤，但要确保连接到网络狗服务器，且网

络狗服务器上的证书服务已经启动）；

2.开始-所有程序-MapGIS K9 SP2企业版-MapGIS K9 基础平台-GDB企业管理器，打开GDB企业管理器，在左侧MapGISCatalog目录树节点下有个MapGISLocal，右键MapGISLocal-启动存储服务（如果启动存储服务为灰色不可选状态，则说明存储服务已经启动）；

继续右键MapGISLocal-附加数据库，选中一个数据库附加到GDB企业管理器中（例如）

3. 开始-所有程序-MapGIS K9 SP2企业版-MapGIS K9 基础平台-地图编辑器，打开地图编辑器，在左侧空白处右键-打开，选择一个要打开的矢量地图文档（例如），在右侧地图视图中右键-复位，如果可以查看到地图，关闭地图编辑器。

如果上述操作一切正常，关闭地图编辑器和GDB企业管理器之后一切正常，说明基础平台安装正常。