号百能力开放平台

号百能力开放平台

Besttone Open API 

维护手册

Maintenance Manual

 

作者:                    季峰

贡献者:                 

创建时间:            2011年8月31日星期三

稳定程度:           

修改历史

版本	日期	修订人	说明
1.0	2011-8-31	季峰

 

目录

1     引言... 1

1.1         编写目的... 1

1.2         背景... 1

2     系统涉及的配置文件说明... 1

2.1         Spring的配置文件applicationContext.xml 1

2.2         applicationContext_back.xml 1

2.3         ehcache.xml 1

2.4         globalMessages.properties. 2

2.5         logback.xml 2

2.6         openapi.properties. 2

2.7         struts.xml 2

2.8         task.xml 2

1. 引言
   1. 编写目的

为了维护工作能顺利开展，保证平台的平稳运行，特编写该手册，说明一些日常维护注意的事情和升级平台注意的事项。

1. 1. 背景
2. 支持日常运维，日常维护的注意事项；
3. 支持版本升级工作。

1. 系统涉及的配置文件说明
   1. Spring的配置文件applicationContext.xml

文件位于src/config目录下。

该文件中包括数据库的配置信息，在开发阶段使用开发数据库，在联调环境中使用联调数据库。

开发数据库：

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">

        <property name="driverClassName" value="oracle.jdbc.driver.OracleDriver" />

       <property name="url" value="jdbc:oracle:thin:@192.168.27.233:1521:orcl" />

       <property name="username" value="openapi"/>

       <property name="password" value="openapi"/>

</bean>

联调数据库：

<bean id="dataSource"

    class="org.springframework.jdbc.datasource.DriverManagerDataSource">

           <property name="driverClassName" value="oracle.jdbc.driver.OracleDriver" />

           <property name="url" value="jdbc:oracle:thin:@192.168.153.138:1521:orcl" />

           <property name="username" value="openapi"/>

           <property name="password" value="openapi"/>

</bean>

这个文件中除了数据库信息以外的配置都是开发人员编写的，维护的过程中不需要改动。

1. 1. applicationContext_back.xml

文件位于src/config目录下。

该文件是后台维护系统用到的Bean的配置，以及hibernate的配置，后台维护系统主要功能有系统用户的维护，用户访问接口权限维护，用户IP的维护，日志察看等，该文件在系统维护的过程中不需要改动。

1. 1. ehcache.xml

文件位于src/config目录下。

配置系统中的缓存，该功能在手机粗定位的功能中应用，当用户在一个小时内使用同一手机号调用粗定位接口，系统会把第一次调用的结果存入缓存，以后的调用会从缓存中取，而不要去调用集团的接口，效率会高一些。

1. 1. globalMessages.properties

文件位于src/config目录下。

用户统一维护后台系统的字符串。

1. 1. logback.xml

文件位于src/config目录下。

用于配置日志的纪录方式，目前是如果com.besttone.openapi包中的java文件报ERROR级别以上的错误，则记录到open_api.log文件和console。

1. 1. openapi.properties

文件位于src/config目录下。

包含系统使用接口的信息和代理服务器的信息，接口有：根据经纬度取地区代码接口，集团手机粗定位接口，全能搜股票接口，bdc新闻接口，bdc天气接口，短信接口。

lbsWebServiceUrl：开发时配置成192.168.19.239，联调时配置成192.168.19.239，

needHttpProxy：在开发时配置成true，联调时配置成false，

bdcWeatherWebServiceUrl：

测试地址: http://116.228.55.13:8085/bdc_queryInfo/bdp_WeatherForecastWs

测试用户:ceshi

测试密码:123456

联调地址: http://10.6.54.29:8088/WeatherQuery/bdp_WeatherForecastWs

测试用户: ggnlpt

测试密码: 7c2c4g2k

其他配置参数在发布时不需要改动。

1. 1. struts.xml

文件位于src/config目录下。

关于struts2的配置，发布时不需要改动，后台系统使用。

1. 1. task.xml

文件位于src/config目录下。

该配置文件配置检查接口是否正常的执行频率，各个节点的含义在该文件中都有具体描述。

<?xml version="1.0" encoding="UTF-8"?>

<openApiTaskContext>

    <!-- 一天=86400秒,一小时=3600秒 -->

    <task>

        <!-- 心跳服务：每天早上8点发送一条短信。 -->

        <!-- 服务器启动时安装 -->

        <install>false</install>

        <!-- 任务的类名，是实现Runnable接口 -->

        <className>com.besttone.openapi.task.HeartbeatTask</className>

        <!-- 任务的开始时间：年，月，日，时，分，秒，如果小于0或者无值，就取当前时间值 -->

        <startTime>-1,-1,-1,8,0,0</startTime>

        <!-- 任务的周期执行时间，单位是秒，如果为0或者没有值，表示任务最多执行一次 -->

        <period>86400</period>

    </task>

    <task>

        <!-- 监控服务：每5分钟扫描一次，出错就短信通知  -->

        <!-- 服务器启动时安装 -->

        <install>false</install>

        <!-- 任务的类名，是实现Runnable接口 -->

        <className>com.besttone.openapi.task.monitor.MobileMonitorTask</className>

        <!-- 任务的周期执行时间，单位是秒，如果为0或者没有值，表示任务最多执行一次 -->

        <period>300</period>

    </task>

    <task>

        <!-- 监控服务：每5分钟扫描一次，出错就短信通知  -->

        <!-- 服务器启动时安装 -->

        <install>false</install>

        <!-- 任务的类名，是实现Runnable接口 -->

        <className>com.besttone.openapi.task.monitor.NewsMonitorTask</className>

        <!-- 任务的周期执行时间，单位是秒，如果为0或者没有值，表示任务最多执行一次 -->

        <period>300</period>

    </task>

    <task>

        <!-- 监控服务：每5分钟扫描一次，出错就短信通知  -->

        <!-- 服务器启动时安装 -->

        <install>false</install>

        <!-- 任务的类名，是实现Runnable接口 -->

        <className>com.besttone.openapi.task.monitor.StockMonitorTask</className>

        <!-- 任务的周期执行时间，单位是秒，如果为0或者没有值，表示任务最多执行一次 -->

        <period>300</period>

    </task>

    <task>

        <!-- 监控服务：每5分钟扫描一次，出错就短信通知  -->

        <!-- 服务器启动时安装 -->

        <install>false</install>

        <!-- 任务的类名，是实现Runnable接口 -->

        <className>com.besttone.openapi.task.monitor.WeatherMonitorTask</className>

        <!-- 任务的周期执行时间，单位是秒，如果为0或者没有值，表示任务最多执行一次 -->

        <period>300</period>

    </task>

</openApiTaskContext>