MapABC电子地图服务器产品安装和维护.doc

产品安装和维护说明产品安装和维护说明产品安装和维护说明 内部资料内部资料 请勿外传请勿外传 20102010 年年 1111 月月 文文 档档 说说 明明 本文档是北京图盟科技有限公司为购买并安装使用产品的用户提供的 主要在提供产品安装说 明的前提下 使用户了解产品服务架构 为运营维护服务提供技术参考和服务记录 建立北京图盟 科技有限公司与用户在产品服务层面的基础 本文档由项目经理和产品安装工程师共同编写 确认 内容必须真实 详尽 准确 使用者仅 限项目经理 产品安装工程师和用户运维管理人员 并在产品安装部署后 由项目经理提交给用户 运维管理人员 每次在产品结构调整 数据更新 功能和服务新增或升级时 必须由实施人员进行 记录 当有重大变动而导致有必要重新编写本文档时 可以重新订制编写 但原记录保留 北京图盟科技有限公司针对不同用户产品使用状况 主要在功能应用 软硬件环境 网络安全 设置或用户特殊需求 而在产品安装部署时 进行了相应的调整和设置 在资源充分利用和效益最 大化的原则下 合理化安装和设置产品 因此每个用户的文档各有不同 不能重复使用 以免导致 产品使用和维护问题 由于本文档涉及北京图盟科技有限公司产品机密 以及用户的运营安全 因此本文档内容属于 机密 双方人员未经授权 不得翻阅 复印 传播本文档 由此引起的一切后果 由泄密方负责 北京图盟科技有限公司北京图盟科技有限公司 文文 档档 信信 息息 用用 户户 名名 称称销售负责人销售负责人王阳王阳 编编 写写 人人杨开宇 王征杨开宇 王征时时 间间20102010 年年 6 6 月月 文档修订记录文档修订记录 修修 订订 时时 间间 2010 11 052010 11 05 修修 订订 人人朱佩凡朱佩凡 修修 订订 时时 间间修修 订订 人人 修修 订订 时时 间间修修 订订 人人 修修 订订 时时 间间修修 订订 人人 修修 订订 时时 间间修修 订订 人人 目目 录录 一 一 产品安装说明产品安装说明 5 二 二 产品安装环境产品安装环境 5 一 服务器环境说明 5 二 网络管理环境说明 6 三 三 产品安装准备产品安装准备 6 一 安装环境检查 6 二 数据库和第三方软件说明 7 三 服务器外部端口设置 7 四 服务器用户权限设置 7 四 四 产品安装设计产品安装设计 8 一 产品安装内容 8 二 服务安装分配和设置 9 三 用户服务授权 9 五 五 产品安装产品安装 10 一 MAPABC 地图功能服务器 11 1 安装环境设置 11 2 软件包安装及配置 14 3 Mapabc地图服务的启动及停止 31 4 Mapabc地图服务的测试及使用 37 二 MAPABC 地图数据服务器 39 1 安装环境设置 39 2 软件包安装及配置 41 3 栅格地图数据包安装及配置 44 4 MapAbc地图数据服务器服务的启动及停止 44 5 MapAbc地图数据服务器服务的测试 45 六 六 产品维护说明产品维护说明 46 七 七 服务脚本说明服务脚本说明 49 八 八 产品使用说明产品使用说明 50 九 九 产品安装和维护记录产品安装和维护记录 52 一 一 产品安装说明产品安装说明 MapABC 地图服务产品的安装和部署 必须在北京图盟科技有限公司同意并批准的条件 下实施 产品安装的相关授权 依据北京图盟科技有限公司与用户签署的协议提供 主要涉及产品安装授权和使 用授权 因此用户在进行产品安装前 需要与北京图盟科技有限公司联系 并已经协议获取授权 北京图盟科技有限公司为用户提供产品安装和服务技术支持 但不包括以下情况 非合作协议范围内的产品安装 非合作协议范围内的产品和服务 其它第三方相关单位 二 二 产品安装环境产品安装环境 一一 服务器环境说明服务器环境说明 内内 容容环境说明环境说明 硬件规格 和设置 64 位机 CPU 四核 Xeon5530 4 内存 32G DDR3 硬盘 SAS 300g 6 RAID5 300g 6 RAID1 300g 2 其中 2 块 硬盘从应用服务器分配过来 操作系统 Linux RedHat5 5 网络配置内网 IP 10 135 4 130 外网 IP 无 域名 无 MapABCMapABC 地图地图 数据服务器数据服务器 安装信息MAC 地址 硬件规格 和设置 64 位机 CPU 四核 Xeon5530 4 内存 32G DDR3 硬盘 SAS 300g 4 RAID5 300g 4 操作系统 Linux RedHat5 5 网络配置内网 IP 10 135 4 129 外网 IP 无 域名 无 MapABCMapABC 地图地图 应用服务器应用服务器 安装信息MAC 地址 E4 1F 13 62 5E F4 二二 网络管理环境说明网络管理环境说明 网络管理监控软件无 网络安全设置无 网络端口管理和使用对外开放端口包括 80 8081 22 三 三 服务器安装及相关设置服务器安装及相关设置 一一 服务器服务器 RAID 设置设置 服务器型号为 IBM system X3650 M2 配备 6 块 300G SAS 硬盘 为了保证服务器性能及数据的安全性 需要 对服务器硬盘进行 RAID 设置 数据服务器 RAID 配置方案为 6 块硬盘做 RAID5 2 块硬盘做 RAID1 服务器 RAID 设置方法为 使用服务器配备系统工具光盘启动后 安照提示进行配置 注意注意 请保存服务器原配请保存服务器原配 ServerServer GuideGuide 盘 用于系统盘 用于系统 RAIDRAID 操作安装 操作安装 二二 操作系统安装操作系统安装 服务器采用的是 RedHat Linux5 5 企业版系统 详细安装步骤见 Linux5 5 操作系统安装 三三 网络设置和检测网络设置和检测 操作系统安装完毕后 需对服务器进行网络配置 分别给服务器分配 IP 地址为 10 135 4 129 和 10 135 4 130 子网掩码为 255 255 255 224 网关为 10 135 4 158 注意 服务器网线连接的网卡不一定是设备 eth0 目前服务器连接网卡为设备 eth2 但是申请 license 文件必须使 用 eth0 的 MAC 地址 所有需重新调整网卡的编号 使第一块所有需重新调整网卡的编号 使第一块 RJ45 网口的编号为网口的编号为 eth0 检测网卡环境命令 ifconfig 激活网卡设备命令 X 为设备编号 0 4 ifconfig ethX up 重新启动网络服务命令 service network restart 检测网络连通性命令 ping 对方对方 ip 地址地址 示例 查看 eth0 网卡设备的 MAC 地址 需给高德公司注册 不能是光纤的 ifconfig eth0 up ifconfig 四 四 产品安装准备产品安装准备 产品安装前 为了保证产品安装顺利 并确保安装后的产品提供稳定 可靠的服务 需要对产品安装相关的 环境和设置进行了解 以便及时弥补不足 使安装工作准备全面 一一 安装环境检查安装环境检查 服务器服务器内容内容检测方法检测方法补充安装方法补充安装方法 内核版本 2 6 18uname a正确 GCC 版本 4 1 2gcc v正确 MapABCMapABC 地图数据服务器地图数据服务器 INODS 节点数 209Mdf hi正确 MapABCMapABC 地图应用服务器地图应用服务器内核版本 2 6 18uname a正确 GCC 版本 4 1 2gcc v正确 说明 如果各项检查通过 则在说明 如果各项检查通过 则在 补充安装方法补充安装方法 中填写中填写 正确正确 或更高级别的版本号 或更高级别的版本号 二二 数据库和第三方软件说明数据库和第三方软件说明 服务器服务器内容内容功能应用和版权说明功能应用和版权说明 Jdk1 6Java 运行环境MapABCMapABC 地图数据服务器地图数据服务器 Tomcat6取图服务所需的第三方基础服务 Jdk1 6Java 运行环境 Apache2 2POI 地图搜索服务所需的第三方基础服务 MapABCMapABC 地图应用服务器地图应用服务器 Tomcat6Apiserver 及地图引擎服务所需的第三方基础服务 三三 服务器外部端口设置服务器外部端口设置 服务器服务器可以使用的端口可以使用的端口 MapABCMapABC 地图数据服务器地图数据服务器80 80MapABCMapABC 地图应用服务器地图应用服务器 8081 四四 服务器用户权限设置服务器用户权限设置 服务器服务器用户用户密码密码说明说明 MapAbcMapAbc 地图数据服务器地图数据服务器rootxmjk2010系统管理员用户 MapAbcMapAbc 地图应用服务器地图应用服务器rootxmjk2010系统管理员用户 五 五 产品安装设计产品安装设计 一一 产品安装内容产品安装内容 功能服务名称功能服务名称安装包名称安装包名称服务版本服务版本 Apic Flash 版地图引擎fmp v2 3 3 tar gz2 3 3 Api 地图服务接口 APIServer ROOT tar gz1 01 Lse4 POI 搜索服务lse4 0 tgz4 0 MapABC 驾车导航服务XLong4 0 tgz4 0 MapABC 逆地理编码服务rgeo tgz4 0 MapABC 坐标处理服务XLongSrv tgz3 5 MapTile 栅格瓦片取图服务mapabc tar gz1 01 二二 服务安装分配和设置服务安装分配和设置 产品服务安装分配示意产品服务安装分配示意 服务安装设置服务安装设置 服务器服务器服务名称服务名称端口设置端口设置 MapABCMapABC 地图数据服务器地图数据服务器MapABC 栅格瓦片取图服务 80 Mapabc Flash 版地图引擎 80 Mapabc 地图服务接口 APIServer 8081 MapABC POI 搜索服务8888 14002 MapABC 驾车导航服务 7140 MapABC 逆地理编码服务8888 13336 MapABCMapABC 地图应用服务器地图应用服务器 MapABC 坐标处理服务 7130 说明 如果服务端口使用其他服务进行了代理 请在说明 如果服务端口使用其他服务进行了代理 请在 端口设置端口设置 中进行说明 中进行说明 三三 用户服务授权用户服务授权 项项 目目内内 容容授权信息授权信息 服务器安 装授权 E4 1F 13 62 5E F4 mapabc lbs license localhost 10 135 4 133fd6ea3c108c746057bf04d2d6feb12fad1e9afb087adcbcc788b0 df5b58423fd232680b462e91624 域名 IP 使用授权 10 135 4 129 说明 对于产品授权使用的方法 域名说明 对于产品授权使用的方法 域名 IP IP 和和 KEYKEY 的对应关系 以及的对应关系 以及 KEYKEY 的使用方法 请依照北京图盟科技有限公司提供的用户文档 的使用方法 请依照北京图盟科技有限公司提供的用户文档 并可向北京图盟科技有限公司的技术工程师进行咨询 并可向北京图盟科技有限公司的技术工程师进行咨询 六 六 产品安装产品安装 产品安装涉及到的内容主要包括 功能服务和相应的数据 服务接口和授权文件 通常 采用的安装方式为先安装各项功能服务 在完成该服务调试后 再逐个进行其他的服务安装 在完成全部服务和 数据安装后 开始安装和调试服务接口 最后确认产品安装没有问题后 安装产品授权文件 依据之前的产品安装设计及安装权限要求 就可以进行产品权限的安装了 一一 MapABC 地图应用服务器地图应用服务器 1 安装环境设置安装环境设置 1 通过图形见面先在文件系统下创建一个通过图形见面先在文件系统下创建一个 disk 文件目录 文件目录 2 所有软件包 data 和 soft 均存放在 disk 目录下 3 安装安装 JAVA 环境环境 在 disk 下创建 mapapi 目录 cd disk 进入进入 disk 目录里目录里 mkdir mapapi 创建创建 mapapi 文件夹文件夹 mkdir p disk mapapi 可选一次性省略创建可选一次性省略创建 进入 soft 目录里将 java 目录拷贝到 disk mapapi 下 cd soft 进入进入 soft 目录里目录里 cp r java disk mapapi cpcp r r 将复制该目录下所有的子目录和文件 将复制该目录下所有的子目录和文件 进入 mapapi java 目录 执行 jdk1 6 的安装 cd disk mapapi java chmod 777 jdk 6u20 linux i586 bin 先给与这个文件可读可写和执行权限先给与这个文件可读可写和执行权限 才能执行安装 才能执行安装 jdk 6u20 linux i586 bin 表示在当前目录下执行某个文件表示在当前目录下执行某个文件 安装完成后 编辑系统配置文件 修改 java 环境变量及字体环境变量 vi etc profile 在文件最下方加入如下几行 注意 把前面的冒号去掉 JAVA HOME disk mapapi java jdk1 6 0 20 JRE HOME JAVA HOME jre CLASSPATH JAVA HOME lib JRE HOME lib PATH sbin JAVA HOME bin JAVA HOME jre bin PATH export JAVA HOME JRE HOME CLASSPATH PATH LANG zh CN GB18030 LANGUAGE zh CN GB18030 zh CN GB2312 zh CN export LANG LANGUAGE 保存后退出 执行环境变量更新 使环境变量生效 source etc profile 检测当前 jdk 版本 javac version 显示 javac 1 6 0 20 实际安装时 显示的有点不同 但不影响 java version 显示 Java TM SE Runtime Environment build 1 6 0 20 b02 Java HotSpot TM Server VM build 16 3 b01 mixed mode 环境配置完毕 4 Cronolog 日志切割软件的安装 日志切割软件的安装 执行 cronolog 软件的安装 cd disk soft cronolog tar zvxf cronolog 1 6 2 tar gz cd cronolog 1 6 2 configure 表示在当前目录下执行配置表示在当前目录下执行配置 点表示当前目录下 斜杠表示执行 点表示当前目录下 斜杠表示执行 make make 二进制编译 make make installinstall 开始安装开始安装 make 编译二进制生成可执行文件 make install 安装可以执行文件 make install clean 清空执行安装文件 是所产生的垃圾文件和缓存 Cronolog 软件安装完毕 2 软件包安装及配置 软件包安装及配置 1 1 服务环境的安装和配置服务环境的安装和配置 ApacheApache 服务的安装服务的安装 Apache 服务是 MapABC POI 搜索服务所需的第三方基础服务 这里采用的是 Apache2 2 14 版本 开始安装 Apache 软件 cd disk soft apache tar zvxf httpd 2 2 14 tar gz cd httpd 2 2 14 configure prefix disk mapapi apache2 2 14 enable so enable mods shared all 指定编译到某某目录指定编译到某某目录 激活模块功能激活模块功能 动态加载所有的模块动态加载所有的模块 make make install make sis service 应用服务器应用服务器ip this UBASServerAddr http 10 135 4 129 8081 api authen jhtml ubas server address 应用服务器应用服务器ip this GPSAddress 保存后退出 Mapabc 地图引擎服务配置完毕 4 LICENSE 文件及授权文件的安装文件及授权文件的安装 这个文件是 这个文件是 Gis 应用服务器的应用服务器的 IP 和和 MCA 给高德公司注册后发来的文给高德公司注册后发来的文 件 件 开始 LICENSE 文件及授权文件的安装 mkdir p disk mapapi license cp mapabc lbs license disk mapapi license cp ubas lsp serverpermissions xml disk mapapi license Mapabc LICENSE 文件及授权文件安装完毕 3 Mapabc 地图服务的启动及停止地图服务的启动及停止 1 1 ApacheApache 服务的启动及停止服务的启动及停止 Apache 服务为 mapabc POI 检索服务及逆地理编码服务提供基础服务 因此在启动其他服务前 必须先启动 Apache 服务 Apache 服务的启动 cd disk mapapi apache2 2 14 bin apachectl start 启动 Apache 服务器 测试 Apache 服务是否启动 netstat an grep 8888 查看端口号查看端口号 8888 是否可用是否可用 显示 tcp 0 0 0 0 0 0 8888 0 0 0 0 LISTEN 监听监听8888端口端口 则服务正常启动 检测日志输出 tail f disk mapapi apache2 2 14 logs 年年 月月 日日 error log Apache 服务的停止 cd disk mapapi apache2 2 14 bin apachectl stop 停止 Apache 服务器 Apache 服务已停止 2 2 MapabcMapabc POIPOI 检索服务的启动及停止检索服务的启动及停止 Mapabc POI 检索服务的启动前必须保证 Apache 服务已经正常启动 Mapabc POI 检索服务的启动 cd disk mapapi LSE4 bin nohup nohup lse4 lse4 20msie 208 0 20windows 20nt 206 1 20trident 4 0 20sl cc2 20clr 202 0 50727 20clr 203 5 30729 20clr 203 0 30729 20media 20center 20pc 2 06 0 39 98882653 116 344845 39 8882653make install Cronolog 软件安装完毕 2 软件包安装及配置软件包安装及配置 1 1 TomcatTomcat 软件的安装软件的安装 Tomcat 软件是 MapABC 栅格取图服务所需的第三方基础服务 这里采用的 Tomcat 版本为 tomcat6 0 开始进行 Tomcat 软件的安装 cd disk soft tomcat tar zvxf apache tomcat 6 0 20 tar gz C disk mapapi cd disk mapapi mv apache tomcat 6 0 20 tomcat 6 0 map Tomcat 软件安装完毕 2 2 TomcatTomcat 软件的配置软件的配置 开始进行 Tomcat 软件的配置 cd disk mapapi tomcat 6 0 map bin mv catalina sh catalina sh bak cd disk mapapi tomcat 6 0 map conf mv server xml server xml bak cd disk soft config cd config tomcat map cp catalina sh disk mapapi tomcat 6 0 map bin cp server xml disk mapapi tomcat 6 0 map conf Tomcat 软件配置完毕 3 3 MapabcMapabc 栅格取图服务安装栅格取图服务安装 开始进行 Mapabc 栅格取图服务的安装 cd disk soft map tile tar zvxf mapabc tar gz C disk mapapi tomcat 6 0 map webapps Mapabc 栅格取图服务安装完毕 4 4 MapabcMapabc 栅格取图服务配置栅格取图服务配置 开始进行 Mapabc 栅格取图服务配置 cd disk mapapi tomcat 6 0 map webapps mapabc mkdir data cd data ln s disk pic data gif cd WEB INF vi web xml 修改为下面红色的部分 tileBaseDir disk mapapi tomcat 6 0 map webapps mapabc data gif emptyBlockFileName disk mapapi tomcat 6 0 map webapps mapabc data gif 0 xEBE6DC gif emptyBlockFileName2 disk mapapi tomcat 6 0 map webapps mapabc data gif 0 xE8E3D8 gif format gif 保存后退出 Mapabc 栅格取图服务配置完毕 3 栅格地图数据包安装及配置栅格地图数据包安装及配置 栅格地图数据包保存在 disk pic data src data 20100412 下 分为 city 和 buding 目录 栅格数据包为 tar gz 格 式 分为城市包及补丁包 通常先安装城市包 city 后安装补丁包 buding 栅格地图数据包安装 cd disk pic data src data 编写解压缩脚本 vi jieya sh 修改红色的部分如下 source Home disk pic data src data 20100412 pic Home disk pic data 保存后退出 将安装脚本权限修改为可执行 chmod 777 jieya sh 执行解压脚本 并且将其放到后台执行 nohup jieya sh 可随时查看解压缩状态 tail f nohup out 直至地图数据解压完成 通常时间较长 可先进行其他部署 资料上写是 7 个小时左右 但我们解压时 用了 大概 30 小时 它会从小到大将逐级的地图解压 最后是 18 级 在查看解压状态时 可以看到每个解压文件路径 的最左边有个序号 那个就是级的对应号 解压完成后 将在 disk pic data 下生成栅格数据目录 拷贝空图片到 disk pic data 下 cp disk pic data src data 20100412 gif disk pic data Mapabc 栅格地图数据安装完毕 4 MapAbc 地图数据服务器服务的启动及停止地图数据服务器服务的启动及停止 MapAbc 栅格取图服务是由 Tomcat 软件提供基础服务的 因此 启动 Tomcat 软件服务也将同时启动栅格取图 服务及静态地图服务 Mapabc 栅格取图服务的启动 cd disk mapapi tomcat 6 0 map bin startup sh 测试栅格取图服务是否正常启动 netstat an grep 80 显示 tcp 0 0 0 0 0 0 80 0 0 0 0 LISTEN 则服务正常启动 使用 tail f disk mapapi tomcat 6 0 map logs 年年 月月 日日 catalina out 检测日志输出 Mapabc 栅格取图服务的停止 cd disk mapapi tomcat 6 0 map bin shutdown sh Mapabc 栅格取图服务及静态地图服务已停止 5 MapAbc 地图数据服务器服务的测试地图数据服务器服务的测试 MapAbcMapAbc 栅格取图服务测试栅格取图服务测试 http 10 135 4 130 mapabc maptile v w2 61 x 6676 y 3556 z 13 完成了 http 10 89 0 2 fmp v2 3 3 testPage html 地图测试页面 七 七 产品维护说明产品维护说明 产品的维护主要涉及各产品服务应用的数据 以下是产品数据维护和升级说明 1 1 MapabcMapabc 地图功能服务器地图功能服务器 Mapabc POI 检索数据升级 POI 检索数据的升级采用全量方式进行数据升级 i 停止 Mapabc POI 搜索服务 ps aux grep lse4 kill 进程号进程号 ii 备份旧数据 cd disk mapapi LSE4 bin mv index index old iii 解压缩新 POI 检索数据包 tar zvxf index tar gz C disk mapapi LSE4 bin iv 启动 Mapabc POI 检索服务 检测数据是否正常 cd disk mapapi LSE4 bin nohup lse4 tail f nohup out 如果正常 删除旧数据 rm rf index bak Mapabc POI 检索服务数据升级完毕 MapabcMapabc 驾车导航服务数据升级驾车导航服务数据升级 驾车导航服务数据的升级采用全量方式进行数据升级 i 停止 Mapabc 驾车导航服务 ps aux grep XLongSrv4 0 kill 进程号进程号 ii 备份旧数据 cd disk mapapi route mv map map bak iii 解压缩新的导航数据包 tar zvxf map tar gz C disk mapapi route iv 启动 Mapabc 驾车导航服务 检测数据是否正常 cd disk mapapi route nohup XLongSrv4 0 tail f nohup out 如果正常 删除旧数据 rm rf map bak Mapabc 驾车导航服务数据升级完毕 2 2 MapabcMapabc 地图数据服务器地图数据服务器 MapabcMapabc 栅格数据升级栅格数据升级 Mapabc 栅格数据将以补丁包的形式提供 通常收到补丁包后 将所有补丁包拷贝到一个目录中 并将目录名 称以日期形式保存 例如 20100501 将这个目录拷贝到 disk pic data src data 20100412 buding 下 编辑 Mapabc 栅格数据解压缩脚本 vi jieya sh 修改如下 source Home disk pic data src data 20100412 pic Home disk pic data cd source Home buding 新数据的目录名新数据的目录名 tar zxvf 数据包数据包1名称名称 C pic Home tar zxvf 数据包数据包2名称名称 C pic Home tar zxvf 数据包数据包3名称名称 C pic Home 4 5 保存后退出 执行该脚本 nohup jieya sh 查看解压状态 tail f nohup out Mapabc 栅格地图数据升级完毕 八 八 服务脚本说明服务脚本说明 1 1 MapabcMapabc 地图应用服务器地图应用服务器 Mapabc 地图应用服务器服务启动脚本 地图应用服务器服务启动脚本 start service sh 保存路径 disk mapapi start service sh 实现功能 启动所有地图服务 使用方法 将该脚本写入 etc rc local 中 将实现开机或者重启时 所有服务自动启动 2 2 MapabcMapabc 地图数据服务器地图数据服务器 Mapabc 地图应用服务器服务启动脚本 地图应用服务器服务启动脚本 start service sh 保存路径 disk