MapABC电子地图服务器产品安装与维护记录.docx

产品安装和维护说明

内部资料 请勿外传

2010年11月

文 档 说 明

本文档是北京图盟科技有限公司为购买并安装使用产品的用户提供的，主要在提供产品安装说明的前提下，使用户了解产品服务架构，为运营维护服务提供技术参考和服务记录，建立北京图盟科技有限公司与用户在产品服务层面的基础。
本文档由项目经理和产品安装工程师共同编写、确认，内容必须真实、详尽、准确。使用者仅限项目经理、产品安装工程师和用户运维管理人员，并在产品安装部署后，由项目经理提交给用户运维管理人员。每次在产品结构调整、数据更新、功能和服务新增或升级时，必须由实施人员进行记录，当有重大变动而导致有必要重新编写本文档时，可以重新订制编写，但原记录保留。
北京图盟科技有限公司针对不同用户产品使用状况，主要在功能应用、软硬件环境、网络安全设置或用户特殊需求，而在产品安装部署时，进行了相应的调整和设置，在资源充分利用和效益最大化的原则下，合理化安装和设置产品。因此每个用户的文档各有不同，不能重复使用，以免导致产品使用和维护问题。
由于本文档涉及北京图盟科技有限公司产品机密，以及用户的运营安全，因此本文档内容属于机密，双方人员未经授权，不得翻阅、复印、传播本文档，由此引起的一切后果，由泄密方负责。

北京图盟科技有限公司
文 档 信 息

用 户 名 称

销售负责人
王阳
编 写 人
杨开宇、王征
时 间
2010年6月
文档修订记录
修 订 时 间
2010/11/05
修 订 人
朱佩凡
修 订 时 间

修 订 人

修 订 时 间

修 订 人

修 订 时 间

修 订 人

修 订 时 间

修 订 人

目 录

一、 产品安装说明
MapABC地图服务产品的安装和部署，必须在北京图盟科技有限公司同意并批准的条件
下实施。产品安装的相关授权，依据北京图盟科技有限公司与用户签署的协议提供，主要涉及产品安装授权和使用授权。因此用户在进行产品安装前，需要与北京图盟科技有限公司联系，并已经协议获取授权。
北京图盟科技有限公司为用户提供产品安装和服务技术支持，但不包括以下情况：
Ø 非合作协议范围内的产品安装
Ø 非合作协议范围内的产品和服务
Ø 其它第三方相关单位

二、 产品安装环境
(一) 服务器环境说明
内 容
环境说明
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: 无
域名：无
安装信息
MAC地址：
MapABC地图应用服务器
硬件规格和设置
64位机，CPU：四核Xeon5530*4,内存：32G DDR3，硬盘：SAS 300g*4。RAID5(300g*4)
操作系统
Linux RedHat5.5
网络配置
内网IP：10.135.4.129
外网IP: 无
域名：无
安装信息
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设置方法为：使用服务器配备系统工具光盘启动后，安照提示进行配置。
注意:请保存服务器原配Server Guide盘，用于系统RAID操作安装。
(二) 操作系统安装
服务器采用的是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
四、 产品安装准备
产品安装前，为了保证产品安装顺利，并确保安装后的产品提供稳定、可靠的服务，需要对产品安装相关的环境和设置进行了解，以便及时弥补不足，使安装工作准备全面。
(一) 安装环境检查
服务器
内容
检测方法
补充安装方法
MapABC地图数据服务器
内核版本2.6.18
uname -a
正确
GCC版本4.1.2
gcc -v
正确
INODS节点数209M
df -hi
正确
MapABC地图应用服务器
内核版本2.6.18
uname -a
正确
GCC版本4.1.2
gcc -v
正确
说明：如果各项检查通过，则在“补充安装方法”中填写“正确”或更高级别的版本号。

(二) 数据库和第三方软件说明
服务器
内容
功能应用和版权说明
MapABC地图数据服务器
Jdk1.6
Java运行环境
Tomcat6
取图服务所需的第三方基础服务
MapABC地图应用服务器
Jdk1.6
Java运行环境
Apache2.2
POI地图搜索服务所需的第三方基础服务
Tomcat6
Apiserver及地图引擎服务所需的第三方基础服务

(三) 服务器外部端口设置
服务器
可以使用的端口
MapABC地图数据服务器
80
MapABC地图应用服务器
80
8081

(四) 服务器用户权限设置
服务器
用户
密码
说明
MapAbc地图数据服务器
root
xmjk2010
系统管理员用户
MapAbc地图应用服务器
root
xmjk2010
系统管理员用户

五、 产品安装设计
(一) 产品安装内容
功能服务名称
安装包名称
服务版本
Apic Flash版地图引擎
fmp-v2.3.3.tar.gz
2.3.3
Api地图服务接口（APIServer）
ROOT.tar.gz
1.01
Lse4 POI搜索服务
lse4.0.tgz
4.0
MapABC 驾车导航服务
XLong4.0.tgz
4.0
MapABC 逆地理编码服务
rgeo.tgz
4.0
MapABC 坐标处理服务
XLongSrv.tgz
3.5
MapTile栅格瓦片取图服务
mapabc.tar.gz
1.01
(二) 服务安装分配和设置

产品服务安装分配示意
服务安装设置
服务器
服务名称
端口设置
MapABC地图数据服务器
MapABC栅格瓦片取图服务
80
MapABC地图应用服务器
Mapabc Flash版地图引擎
80
Mapabc地图服务接口（APIServer）
8081
MapABC POI搜索服务
8888、14002
MapABC 驾车导航服务
7140
MapABC 逆地理编码服务
8888、13336
MapABC 坐标处理服务
7130
说明：如果服务端口使用其他服务进行了代理，请在“端口设置”中进行说明。
(三) 用户服务授权
项 目
内 容
授权信息
服务器安装授权
E4:1F:13:62:5E:F4
mapabc_lbs.license
域名/IP使用授权
localhost

10.135.4．133
fd6ea3c108c746057bf04d2d6feb12fad1e9afb087adcbcc788b0df5b58423fd232680b462e91624
10.135.4.129

说明：对于产品授权使用的方法，域名/IP和KEY的对应关系，以及KEY的使用方法，请依照北京图盟科技有限公司提供的用户文档，并可向北京图盟科技有限公司的技术工程师进行咨询。
六、 产品安装
产品安装涉及到的内容主要包括：功能服务和相应的数据、服务接口和授权文件。通常
采用的安装方式为先安装各项功能服务，在完成该服务调试后，再逐个进行其他的服务安装。在完成全部服务和数据安装后，开始安装和调试服务接口，最后确认产品安装没有问题后，安装产品授权文件。
　　依据之前的产品安装设计及安装权限要求，就可以进行产品权限的安装了。
(一) 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 　 cp –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 install 开始安装
(make 编译二进制生成可执行文件。make install 安装可以执行文件。make install clean 清空执行安装文件是所产生的垃圾文件和缓存...）

Cronolog软件安装完毕。
2．软件包安装及配置
1) 服务环境的安装和配置
Ø Apache服务的安装
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 && make install与make install是两个命令，在你./configuration生成了Makefile之后执行编译安装；与&&一起的还有||，不过意思不一样，make && make install的意思就是执行make如果没有发生错误就执行make install
Apahce服务安装完毕。
Ø Apache服务配置
进行Apache服务的配置：
#cd /disk/mapapi/apache2.2.14/conf　
#vi httpd.conf
修改红色部分如下：
　#Listen 12.34.56.78:80
　Listen 8888

ErrorLog
"|/usr/local/sbin/cronolog /disk/mapapi/apache2.2.14/logs/%Y/%m/%d/error_log"

CustomLog
"|/usr/local/sbin/cronolog /disk/mapapi/apache2.2.14/logs/%Y/%m/%d/access_log" common
保存后退出。
Apache服务配置完毕。

Ø Tomcat软件的安装
　　Tomcat软件是mapabc地图服务接口、地图API引擎服务所必须的第三方基础服务，这里采用的tomcat版本为tomcat6.0。
开始安装Tomcat软件：
　#cd /disk/soft/tomcat
　#tar –zvxf apache-tomcat-6.0.20.tar.gz
　#cp –r apache-tomcat-6.0.20 /disk/mapapi/tomcat-6.0-api 黄颜色注意
　#cp –r apache-tomcat-6.0.20 /disk/mapapi/tomcat-6.0-apic
Tomcat软件安装完毕。

Ø Tomcat软件的配置
开始进行Tomcat软件的配置：
　#cd /disk/mapapi/tomcat-6.0-api/bin 黄颜色注意
　#mv catalina.sh catalina.sh.bak mv是移动目录
　#cd ../conf
　#mv server.xml server.xml.bak
　#cd /disk/mapapi/tomcat-6.0-apic/bin
　#mv catalina.sh catalina.sh.bak
　#cd ../conf
　#mv server.xml server.xml.bak
　#cd /disk/soft/
　#cp config/api/catalina.sh /disk/mapapi/tomcat-6.0-api/bin 黄颜色注意
　#cp config/api/server.xml /disk/mapapi/tomcat-6.0-api/conf
　#cp config/apic/catalina.sh /disk/mapapi/tomcat-6.0-apic/bin
　#cp config/apic/server.xml /disk/mapapi/tomcat-6.0-apic/conf
Tomcat软件配置完毕。

2) 产品服务安装
Ø Mapabc POI搜索服务的安装
开始安装POI搜索服务：
　#cd /disk/soft/lse4
　#tar –zvxf LSE4.0.tgz –C /disk/mapapi 注意是大写字母
　#cd /disk/mapapi/LSE4/bin
　#cp sisserver4 /disk/mapapi/apache2.2.14/cgi-bin/sisserver
在POI搜索索引数据（/data/poi_data）下执行install.sh进行批处理。（数据服务器需使用完整的data包，大小为100多G；而应用服务器只需使用data中的poi_data、rgeo_data和route_data几个，大小为几G以内）。
#cd /disk/data/poi_data
# ./install.sh
Mapabc POI搜索服务安装完毕。

Ø Mapabc逆地理编码服务的安装
开始安装逆地理编码服务：
　#cd /disk/soft/rgeo
　#tar –zvxf geometry.tgz –C /disk/mapapi 注意大写字母
　#cd /disk/mapapi/geometry
　#cp rgeocode.cgi /disk/mapapi/apache2.2.14/cgi-bin
在逆地理编码数据（/data/rgeo_data）下执行install.sh进行批处理。
#cd /disk/data/rgeo_data
# ./install.sh
Mapabc逆地理编码服务安装完毕。

Ø Mapabc驾车导航服务的安装
开始安装驾车导航服务：
　#cd /disk/soft/route
　#tar –zvxf route.tar.gz –C /disk/mapapi 注意大写字母
在驾车导航数据（/data/route_data）下执行install.sh进行批处理。
#cd /disk/ data/route_data
# ./install.sh
Mapabc驾车导航服务安装完毕。

Ø Mapabc坐标处理服务的安装
开始安装坐标处理服务：
　#cd /disk/soft/rgc
　#tar –zvxf rgc.tgz –C /disk/mapapi
Mapabc坐标处理服务安装完毕。

Ø Mapabc地图服务接口的安装
开始安装Mapabc地图服务接口：
　#rm –rf /disk/mapapi/tomcat-6.0-api/webapps/* 注意后面有个*
#cd /disk/soft/api
　#tar –zvxf ROOT.tar.gz –C /disk/mapapi/tomcat-6.0-api/webapps
Mapabc地图服务接口安装完毕。

Ø Mapabc地图引擎（客户端）的安装
开始安装Mapabc地图引擎：
#cd /disk/soft/apic
#tar –zvxf fmp-v2.3.3.tar.gz –C /disk/mapapi/tomcat-6.0-apic/webapps
Mapabc地图引擎服务安装完毕。

3) 产品服务配置
Ø 　Mapabc驾车导航服务配置
开始进行Mapabc驾车导航服务的配置：
　#cd /disk/mapapi/route
　#vi XLongSrv.cfg
修改红色的部分如下：
　Def_Port=7140
　Def_Path=/disk/mapapi/route/map/
　Local_IP=127.0.0.1
　Log_File=0
　=7199
保存后退出。
Mapabc驾车导航服务配置完毕。

Ø Mapabc地图服务接口的配置
开始进行Mapabc地图服务接口的配置：
　#cd /disk/mapapi/tomcat-6.0-api/webapps/ROOT/WEB-INF/
　#vi log4j.xml
修改红色部分如下：
<appender name="poiAppend" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="/disk/mapapi/tomcat-6.0-api/applogs/poi.log" />
<param name="Append" value="true" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-21d{yyyy MM dd HH:mm:ss,SSS} - %m%n" />
</layout>
</appender>
<appender name="geocodingAppend" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="/disk/mapapi/tomcat-6.0-api/applogs/geocoding.log" />
<param name="Append" value="true" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-21d{yyyy MM dd HH:mm:ss,SSS} - %m%n" />
</layout>
</appender>
<appender name="rgcAppend" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="/disk/mapapi/tomcat-6.0-api/applogs/rgc.log" />
<param name="Append" value="true" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-21d{yyyy MM dd HH:mm:ss,SSS}-%m%n" />
</layout>
</appender>
<appender name="baseAppend" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="/disk/mapapi/tomcat-6.0-api/applogs/base.log" />
<param name="Append" value="true" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-21d{yyyy MM dd HH:mm:ss,SSS}-%m%n" />
</layout>
</appender>
<appender name="errorAppend" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="/disk/mapapi/tomcat-6.0-api/applogs/error.log" />
<param name="Append" value="true" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-21d{yyyy MM dd HH:mm:ss,SSS}-%m%n" />
</layout>
保存后退出。
　#mkdir –p /disk/mapapi/tomcat-6.0-api/applogs (–p是指如果/disk下面没有任何目录，可以创建目录并且在新创建的目录下再创建目录，如果/disk目录下有mapapi目录，就会在mapapi目录下创建 )
　#cd classes
　#vi log4j.properties
修改红色部分如下：
log4j.appender.mapclient.file=/disk/mapapi/tomcat-6.0-api/applogs/ubas-logs/apiclient_log.txt
保存后退出。
　#mkdir –p /disk/mapapi/tomcat-6.0-api/applogs/ubas-logs
　#vi /disk/mapapi/tomcat-6.0-api/applogs/ubas-logs/apiclient_log.txt
保存后退出。
　#vi engine-config.xml
修改红色的部分如下：
<engine>
<name>cgi-bin</name>
<url>http://127.0.0.1:8888/cgi-bin/sisserver?</url>
</engine>
<engine>
<name>rgcpost</name>
<url>http://127.0.0.1:7130/speed</url>
</engine>
<engine>
<name>rgcget</name>
<url>http://127.0.0.1:7130/route</url>
</engine>
<engine>
<name>rgeocode</name>
<url>http://127.0.0.1:8888/cgi-bin/rgeocode.cgi?</url>
</engine>
<engine>
<name>route</name>
<url>http://127.0.0.1:7140/route</url>
</engine>

保存后退出。
　#vi ubas-lsp-config.xml
修改红色的部分如下：
<pms-config>
<login-file>
/disk/mapapi/tomcat-6.0-api/webapps/ROOT/WEB-INF/classes/ubas-lsp-gdsusers.xml
</login-file>
<system-file>
/disk/mapapi/tomcat-6.0-api/webapps/ROOT/WEB-INF/classes/ubas-lsp-gdssystem.xml
</system-file>
</pms-config>
<license-config>
<!-- license文件地址 -->
<path>
/disk/mapapi/license/mapabc_lbs.license
</path>
</license-config>
<permission-load>
<!-- remote表示远程加载权限数据，local从本地加载权限数据-->
<current-type>local</current-type>
<!-- 本地数据源文件名称 -->
<local-source>
/disk/mapapi/license/ubas-lsp-serverpermissions.xml
</local-source>
</local-load>
保存后退出。
Mapabc地图服务接口配置完毕。

Ø Mapabc地图引擎服务的配置
开始进行Mapabc地图引擎服务的配置：
　#cd /disk/mapapi/tomcat-6.0-apic/webapps/fmp-v2.3.3
　#vi cfg.xml
修改红色的部分如下：
<UBAS_URL>http://10.135.4.129:8081/api-authen.jhtml?</UBAS_URL> (应用服务器ip)
<DEFAULT_MAP_SERVER_URLS>http://10.135.4.130/mapabc/maptile?v=w2.61^^^,http://10.135.4.130/mapabc/maptile?v=w2.61^^^,http://10.135.4.130/mapabc/maptile?v=w2.61^^^,http://10.135.4.130/mapabc/maptile?v=w2.61^^^</DEFAULT_MAP_SERVER_URLS> (数据服务器IP)
<SISSERVER_URLS>http://10.135.4.129:8081/sisserver?</SISSERVER_URLS> (应用服务器ip)
<GEOCODING_SERVER>http://127.0.0.1:7130/sisserver</GEOCODING_SERVER>
保存后退出。
　#vi js/asa.js
修改红色的部分如下：
function MASAChangeServerAddress(){
this.serverAddress = "http://10.135.4.129:8081/sisserver?";//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) Apache服务的启动及停止
　　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) Mapabc POI检索服务的启动及停止
　　Mapabc POI检索服务的启动前必须保证Apache服务已经正常启动。
Mapabc POI检索服务的启动：
　#cd /disk/mapapi/LSE4/bin
　#nohup ./lse4 & 在后台运行./lse4 (要运行后台中的 nohup 命令，添加 & （ 表示"and"的符号）到命令的尾部。 )
测试检索服务是否启动：
　#netstat –an|grep 14002
显示：
tcp 0 0 127.0.0.1:14002 0.0.0.0:* LISTEN
则服务正常启动。
查看./lse4在后台运行情况使用：
　#t