说句题外话，前段时期生了大病，险些就与世长辞，修养了3个多月终于基本恢复。这里希望各位程序猿工作之余还是要保存身体，活着才能继续革命不是。
言归正传，近来有几个项目是要做专题图相关的项目。为提高效率，公司考虑使用 OneMap 作为基础框架进行快速开发。OneMap 是捷泰天域（Esri 在天朝的战略合作伙伴）的产品之一，是基于服务器 GIS 的软件产品，面向各行业提供多源异构空间信息服务资源整合、管理、安全监控与运维保障一体化的专业解决方案。OneMap产品包含平台 管理系统、资源服务中心、地图应用模板等不同的产品组件，还包括可选的公交换乘扩展模块（产品官网上照搬的，其实我表示一脸懵逼，哈哈哈）。
经过几次安装部署发现其中还遇到了不少坑，捷泰天域的官方安装部署手册中很多都写的太笼统。里面的原因有我对 GIS 开发其实也是不熟悉（以前更多就是用了高德百度地图 API）,还有就是 GIS 这块的东西在国内资源还是比较难查，鉴于此情，写下学习过程中遇到的问题，以备以后查看。
1. 安装环境准备
这里我使用了2个虚拟机来分别存放数据和部署一下应用，是为了通过虚拟机的快照功能，快速恢复某一个的状态，避免玩崩了重装软件等麻烦事。
我的系统环境和安装的必要程序如下：
- 数据服务器（虚拟机，网络使用桥接方式）
系统：Windows Server 2012 R2 64位；
其它：Oralce11gR2 数据库。 - 应用服务器（虚拟机，网络使用桥接方式）
系统：Windows Server 2012 R2 64位；
其它：ArcGIS Server 10.5，Oralce11g 客户端 64位，准备工作完成后 OneMap 将安装到该主机。 - 本机
系统：Windows 10 专业版 64位；
其它：ArcGIS Desktop 10.5，Oracle11g 客户端 32位。
注意事项：
- 本文所用的截图为我这几次在不同环境下安装 OneMap 时为截图，图片内的部分版本号和日期并不一定对应，但并不影响安装的步骤和流程；
- 所有安装 ArcGIS 相关产品的主机都要预先安装 .NET Framework 3.5；
- 所有主机的机器名最好都为字母和数字组合，如果不是则最好在安装前更改机器名，不要带 "-” 和 "_" ，以免在安装部署 ActiveMQ（OneMap 需用到，MQ 在机器名为上述符号时有时启动会报异常）和 ArcGIS（不能使用 "_"） 时发生异常；
- 由于 ArcGIS Server 是 64位的程序，所以 Oracle 客户端也必须安装 64位的并配置好环境变量，而 Desktop 是 32位的程序，所以 Oracle 客户端需要安装 32位。如果 Server 和 Desktop 安装在一个主机环境下，则 32位和64位的 Oracle 客户端都需要安装（详细 Arcgis 安装可以查阅 Esri 官方网站的安装说明手册）。
- Oracle 数据库的字符集要设置为 ZHS16GBK，为避免意外，最好实例名使用默认的 orcl；
-
需要修改 Oralce 的监听器中的地址为机器名，否则 ArcGIS 和数据库进行连接建立地理信息基础数据库时会出错，如下图所示：
1.png
解决方案：
- 打开 Oracle 的 Net Manager 程序
图像 3.png
- 如下图所示，将监听中的主机名改为当前主机的机器名（默认是 localhost）
图像 4.png
- 查看 ORACLE_HOME/NETWORK/ADMIN/listener.ora 里的监听名称是否已改为当前主机机器名
图像 5.png
- 修改 tnsnames.ora 里的主机地址为当前主机的机器名，并将修改好的 tnsnames.ora 文件复制到所有客户端下的相同位置（如客户端目录下 NETWORK/ADMIN 文件夹不存在则创建），然后重启 Oracle 服务。
图像 6.png
2. 注册 SDE 服务
2.1 在 Oracle 数据库中创建 sde 账户
此账户主要用于 ArcGIS 连接访问 Oracle 数据库。
- 打开 ArcGIS Desktop 中的 ArcMap 程序，在右侧 Catalog 工具栏窗口中按照 Toolboxes\System Toolboxes\Data Management Tools.tbx\Geodatabase Administration\ 的目录找到并打开 Create Enterprise Geodatabase，如下图所示：
图像 7-1.png
在 Create Enterprise Geodatabase 窗口中填写数据库实例、用户密码等信息，点击 OK，如下图所示：
图像 8.png
创建 sde 用户成功后，会显示如下信息：
图像 10.png
登录 Oracle11g 控制台可以看到通过 ArcCatalog 工具创建的 sde 表空间和用户
图像 11.png
图像 12.png
2.2 在 ArcGIS Server 中注册 Oracle 数据库
在注册之前，如果 ArcGIS Server 尚为建立站点的话，需先行建立一个站点。建立站点本文不做描述，具体步骤可以查阅 Esri 的官方说明文档。
注册数据库可以通过两种方式，一种通过 ArcMap 来注册，一种是通过访问 ArcGIS Server 的管理后台（ http://主机名:6080/arcgis/manager ）来注册，这里我的是通过 ArcMap 的方式来完成此步骤。具体流程为：
- 在 Catalog 工具栏窗口中 Database Connections 项中找到并打开 Add Database Connection，使用刚才建立的 sde 用户来建立与数据库的连接，成功后会生成一个 .sde 文件，如下图所示：
Paste_Image.png
图像 17.png
Paste_Image.png
- 右键生成的 .sde 文件，点击 properties，可以找到 sde 文件的物理位置，以备之后使用
图像 21.png
图像 22.png
- 在 Catalog 工具栏窗口中 GIS Servers 项中找到并打开 Add ArcGIS Server，建立与 Server 的连接，如下图所示：
图像 13.png
- 选择建立一个管理端的 GIS 服务连接
图像 16.png
- 填写 Server 的地址和站点管理员和密码
图像 27.png
- 连接成功后可以在 GIS Servers 项下看到连接的项，如图所示：
图像 15.png
- 在建立的 Server 连接上右键点击 Server Properties... 项，选择注册托管数据库，具体操作如图所示：
图像 23-1.png
图像 24.png
- 填写注册数据库的名称，点击 Import 按钮导入之前生成好的 .sde 文件
图像 25.png
- 注册成功后，如下图所示：
图像 26.png
注意事项
- 如果未安装 .NET Framework 3.5 此步骤可能会报如下图异常（此图为我之前用访问 Server 管理平台注册数据库时遇到此问题时的截图）
2 - 副本.png
- 由于 OneMap 还未安装，故文件夹等之后再注册。
3. 发布要素服务
此服务主要是用于 OneMap 的扩展权限功能。
- 在之前 Database Connection 项下建立的 sde 连接上右键 New > Feature Class 打开要素服务窗口，并按照官方说明手册要求填写名称、坐标系等信息，具体参数设置请参照官方手册，本文就不再进行说明。大体流程如图所示：
图像 29.png
图像 30.png
图像 31.png
图像 32.png
- 完成后在左侧窗口中就可以看到添加好的数据，根据手册做相应配置后保存
图像 33.png
图像 34.png
而后选择左侧窗口中的数据，点击菜单栏 File > Share As > Service... 开始发布服务
图像 36.png
图像 37.png
- 选择 Server 服务和填写图层服务名称
图像 38.png
图像 39.png
图像 40.png
- 参数设置完成后，点击右上角的 Publish 进行服务发布
图像 42.png
图像 43.png
- 发布成功后，可以登录 ArcGIS Server 的管理平台，可以看到刚刚发布的服务
图像 44.png
图像 45.png
- 至此 OneMap 安装前的准备工作就全部完成。
4. 安装和配置 OneMap
详细的安装流程请参照 OneMap 官方安装部署手册进行，本文只着重说明下其中的关键步骤。
4.1. 向数据库中导入 OneMap 的用户、库表结构和数据
- 运行安装程序，点击创建。而后填写数据库的连接信息，开始导入数据
图像 10.png
图像 13.png
图像 15.png
4.2. 安装 OneMap 主程序
- 运行安装程序，点击安装开始进行安装，尽量不要改动其安装路径，避免将来遇到未知的错误
图像 16.png
- 安装完成后，会弹出参数配置窗口，如下图所示：
图像 17.png
- 这里需要注意的是，上图中蓝框的部分为数据库的配置，主机地址需要填写 Oracle 数据库所在主机的机器名或 IP。绿框的部分为 ArcGIS Server 的配置，主机地址需要填写 Server 所在主机的机器名或 IP。金黄色框的部分为 OneMap 的配置，主机地址需要填写 OneMap 所在主机的机器名或 IP。
- 之后在安装程序主界面点击授权，导入授权文件即可激活 OneMap。
- 安装 OneMap 主程序完成后，还需要在 ArcGIS Server 中注册 OneMap 的共享文件夹。首先先要设置 OneMap 所在主机的 C:\OneMap\temp\upload 文件夹为共享文件夹，并且 ArcGIS 的账户，默认为 arcgis 拥有权限，这里为了方便，直接向所有用户开放了权限。如图所示：
图像 18.png
图像 19.png
图像 22.png
图像 23.png
4.2 根据 OneMap 的部署要求配置 ArcGIS Server
- 将 C:\OneMap\extension\ArcGIS 文件夹下的 11个 jar 包服务到 ArcGIS Server 安装目录下的
framework\lib\server 文件夹下。
Paste_Image.png
- 编辑 C:\OneMap\extension\ArcGIS 目录下的 proxool.xml 修改数据库主机地址为当前数据库所在主机的地址。并将修改好的 proxool.xml 文件复制到 ArcGIS Server 的工作文件夹中（默认为 C:\arcgisserver），本文是将文件复制到 C:\arcgisserver\oracle 文件夹下，并设置 oracle 文件夹为共享，以确保 proxool.xml 为共享文件，然后重启 Server 的服务 。
图像 25.png
图像 26.png
图像 27.png
图像 28.png
- 登录 ArcGIS Server 后台管理系统（主机名:6080/arcgis/admin），登录后，按照 security > config > Update Identity Store 的路径打开更新身份存储窗口。
图像 1.png
图像 3.png
- 将下图中的配置数据，填写到 User Store Configuration 和 Role Store Configuration 项中，红框的路径要设置为之前设置的共享文件位置。
图像 5.png
- 填写完毕后，点击更新，成功则显示如下信息：
图像 4.png
- 按照 security > users > getUsers 的路径打开窗口。然后和数据库中的对应表中的用户名是否一致。
图像 11.png
图像 10.png
4.3 为 Server 配置 OneMap 本地发布的 js 库
- 在 Server 根路径下找到 framework\runtime\tomcat\webapps\arcgis#rest\WEB-INF\classes\resources\rest-config.properties 配置文件并打开。将其中的 js 资源路径替换为 OneMap 发布的资源路径。
图像 16.png
- 注：如果 classes 文件夹下是空的，可以用压缩工具打开 arcgis#rest\WEB-INF\lib\rest-10.4.1.5686.jar 包。提取 jar 里的 rest-config.properties 文件，修改保存后放置到文档要求的位置。 （不过这里有个疑问，官方手册匹配 ArcGIS 版本是10.1/10.2/10.3，我发现 10.4.1 版本的 rest-10.4.1.5686.jar 中的配置文件是放在根路径下，而并非是在 resources 包下，发布后应该也是在 classes 而不是 处理 classes/resources 下，具体等有时间了再进行测试）。
Paste_Image.png
- 登录 ArcGIS Server 管理后台（Server 主机名:6080/arcgis/admin），按照 system > handlers > rest > servicesdirectory 的路径打开窗口。修改 js 相关地址为 OneMap 发布的资源地址并保存。
图像 15.png
- 登录 ArcGIS Server Manager，在安全性功能下编辑令牌信息，默认：geoshare
Paste_Image.png
4.4 启动 OneMap 服务
- 使用 OneMap 启动服务快捷方式启动所有服务。
Paste_Image.png
- 如果出现 “拒绝访问” 的错误，可以使用管理员权限来执行此脚本程序。
Paste_Image.png
Paste_Image.png
Paste_Image.png
- 打开服务管理器，确认 OneMap 的 4 个服务是否已全部开启。
Paste_Image.png
5. 访问和初步配置 OneMap
5.1. 各系统访问地址
主要包含 4 个系统：
- OneMap 资源服务中心（门户系统），URL：http://主机名:8080/Portal；
- OneMap 捷泰天域平台管理系统（运维系统），URL：http://主机名:8080/GeoShareManager；
- OneMap 服务目录（服务系统），URL：http://主机名:8080/OneMapServer/rest/services；
- OneMap 用户信息安全加密服务系统（Token系统），URL：http://主机名:8080/RemoteTokenServer；
5.2. 配置服务引擎
- 登录运维系统，按照“系统配置” > “服务引擎配置” 进入引擎配置页面。按照自己的安装部署环境和需要配置 Server 引擎、OneMap 服务引擎、代理和令牌引擎。
Paste_Image.png
Paste_Image.png
Paste_Image.png
Paste_Image.png
5.3. 平台监控配置
- 打开“系统配置” > “平台监控配置”，有集群（选组织）、单机（选服务器）两种方式进行配置，这里用服务器的方式进行配置。
Paste_Image.png
Paste_Image.png
5.4. 日志系统配置
- 打开“系统配置” > “日志收割”，修改服务器的 IP 为部署 OneMap 的主机 IP，并保存。
Paste_Image.png
- 点击远端配置按钮（下图红圈处），修改“访问账号”的绑定 IP 为部署 OneMap 的主机 IP。
Paste_Image.png
Paste_Image.png
6. 服务测试
至此 OneMap 全部安装和部署工作已全部完成。现在就就发布一组测试数据看看是否可以成功。
登录运维系统，打开“服务管理” > “本地服务发布”。这里我发布了 OneMap 在安装包中提供的示例中国行政区划图的 .sd 文件。
Paste_Image.png
Paste_Image.png
- 发布成功后，在“服务平台管理”中可以看到刚才发布的图层。
Paste_Image.png
- 下图为把图层加载到 ArcGIS Online map viewer 中显示的效果。
Paste_Image.png
- 注：OneMap 安装时会把系统的环境变量中 JDK 等路径设置为他自带的 JDK 1.6 的路径。从而影响系统里其他需要 1.7 和以上版本 JDK 的程序。有需要的或者有强迫症的，可以把 “C:\OneMap\Tomcat\bin\setclasspath.bat”、“C:\OneMap\services\activemq5.4.1\bin\activemq.bat”、“C:\OneMap\services\activemq5.4.1\bin\activemq-admin.bat” 中加上指定 JDK 的语句，然后把环境变量里的设置改回原来的即可。
