协同移动平台2.1版本安装设置手册.doc

协同移动平台2.1版本安装设置手册一、 协同移动平台安装协同移动平台是完全独立于ecology系统的标准的基于J2EE框架Java Web应用程序，可以在各种操作系统的各种Web平台上运行，协同移动平台2.1版本本身默认已包含Resin3.1.12的Web应用服务器，因此只需简单的设置后，便可启动运行。1、 协同移动平台文件安装首先请在相关目录中解压缩协同移动平台的升级包，升级包分为2个部分，第1个部分为协同移动平台及Resin应用服务器的所有相关文件；第2个部分为需要在ecology系统中部署的相关接口文件，即ecology系统的补丁包。因此，在升级前，请先停掉ecology系统，以便在ecology系统中升级相关补丁包及修改相关配置。以下分别介绍相关的文件和相关配置。 协同移动平台目录及文件安装其中mobile_2.1目录下webapps为协同移动平台，其余目录均为Resin的相关目录。 ecology系统相关文件安装先停掉ecology系统，根据补丁包，将文件解压缩至ecology目录下。2、 协同移动平台服务器设置如需要修改服务器端口，请修改mobile_2.1confresin.conf文件： 6801为resin服务的端口89为有Mobile访问端口3、 协同移动平台数据库设置由于协同移动平台应用与ecology系统完全独立，但使用同一个数据库，所以需要单独设置数据库连接信息，需要分别设置2.1和1.0版本2.1版本的数据库连接配置文件位于：mobile_2.1webappsROOTWEB-INFclasses perties1.0版本的数据库连接配置文件位于：mobile_2.1webappsm1WEB-INFclasses perties这两个文件不需要手动配置，后台配置时会自动写入。4、 协同移动平台启动设置 直接启动。编辑mobile2.1下的start.bat文件，修改其中的java_home，根据实现情况指定JDK路径。双击start.bat即可启动服务器。 创建服务可在命令窗口执行如下内容（创建服务后可直接在操作系统中服务中启动ResinMobile服务）安装服务（根据实现情况指定JDK路径）：httpd.exe -java_home D:WEAVERJDK -install-as ResinMobile卸载服务：httpd.exe remove-as ResinMobile如为Linux系统，可以执行binhttpd.sh即可。如果需要在Linux系统后台运行，可以执行binhttpd.sh & 即可。注意：JDK必须使用1.6版本；如果ecology和mobile在同一服务器，mobile可直接使用ecology的JDK，如果在不同的服务器上，要把ecology的JDK复制一份放到mobile服务器上。5、 ecology系统接口相关配置需要修改ecology下的web.xml文件，需要添加如下内容： XFireServlet XFire Servletorg.codehaus.xfire.transport.http.XFireConfigurableServlet XFireServlet /services/*MobileXmlRpcServletorg.apache.xmlrpc.webserver.XmlRpcServletenabledForExtensionstrueMobile XML-RPC.MobileXmlRpcServlet/mobile/xmlrpc注意：请添加在第一次出现行的上面。请不要添加在之前，是注释，如果添加在注释里等于没有添加。二、 协同移动平台配置在安装设置完成后，请启动ecology系统和协同移动平台。并在浏览器中输入以下地址：http:/ip:port/manager将会进入协同移动平台的配置向导，进行相关的配置。 设置向导点击继续填入ecology系统的地址，点击继续，系统将会检测地址填写的是否正确。通过后，进入下一步：填入正确的ecology系统syyadmin的管理员口令进行验证，验证通过进入数据库设置验证：如果之前没有设置过协同移动平台的数据库连接信息，可以在这里重新填写，填写完成后，点击继续，将会进行数据库连接测试，测试通过后，进入ecology接口检测界面：点击完成，提示需要重新启动应用服务器：重启Mobile服务后，即完成协同移动平台的配置。重启后，点击确定，进入后台管理的登陆界面：输入系统管理员的帐号和密码，登陆后，可以进行系统信息、模块设置、用户设置。 系统设置点击检测系统按钮，将会对协同移动平台进行设置检查：系统属性可以对Logo图片及分页大小等系统参数进行修改。日志可以对系统日志进行查看。授权信息可以对License信息进行查看，点击在线获取License按钮后，将会自动从协同移动平台官方服务器上自动下载相应的License文件：如果无法正确下载License文件，可以选择手工添加License方式添加相应的License文件。 模块设置可以对协同移动平台的模块进行设置。 用户设置可以对协同移动平台的用户进行设置。三、 常见错误 服务器端口冲突如果协同移动平台服务器的端口已被占用，服务器将会无法启动，表现形式为不断重启，日志中会出现如下信息：2011-10-14 15:43:51.484.BindException: Address already in use: JVM_Bind 2011-10-14 15:43:51.484Cant bind to /:6801. 2011-10-14 15:43:51.484Check for another server listening to that port.2011-10-14 15:43:51.484at com.caucho.vfs.QJniServerSocket.create(QJniServerSocket.java:103)2011-10-14 15:43:51.484at com.caucho.server.port.Port.bind(Port.java:964)2011-10-14 15:43:51.484at com.caucho.server.cluster.Server.bindPorts(Server.java:1379)2011-10-14 15:43:51.484at com.caucho.server.cluster.Server.start(Server.java:1325)2011-10-14 15:43:51.484at com.caucho.server.cluster.Cluster.startServer(Cluster.java:710)2011-10-14 15:43:51.484at com.caucho.server.cluster.ClusterServer.startServer(ClusterServer.java:542)2011-10-14 15:43:51.484at com.caucho.server.resin.Resin.start(Resin.java:703)2011-10-14 15:43:51.484at com.caucho.server.resin.Resin.initMain(Resin.java:1162)2011-10-14 15:43:51.484at com.caucho.server.resin.Resin.main(Resin.java:1365)解决方法：找到冲突的端口，修改相应的端口后（修改mobile_2.1confresin.conf文件），重启应用服务器。 服务器端文件只读如果协同移动平台服务器的文件只读，服务器将会无法启动，表现形式为不断重启，日志中会出现如下信息：2011/10/14 15:49:41.031 resin.conf = /C:/mobile_2.0/conf/resin.conf2011-10-14 15:49:40 Cant create log directory /C:/mobile_2.0/log/resin.logjava.io.FileNotFoundException: C:mobile_2.0logresin.log (逸款) at java.io.FileOutputStream.open(Native Method) at java.io.FileOutputStream.(FileOutputStream.java:179) at java.io.FileOutputStream.(FileOutputStream.java:70) at com.caucho.vfs.FilePath.openAppendImpl(FilePath.java:493) at com.caucho.vfs.Path.openAppend(Path.java:1119) at com.caucho.log.AbstractRolloverLog.openLog(AbstractRolloverLog.java:504) at com.caucho.log.AbstractRolloverLog.write(AbstractRolloverLog.java:369) at com.caucho.log.RotateStream.write(RotateStream.java:244) at com.caucho.vfs.WriteStream.flush(WriteStream.java:357) at com.caucho.log.TimestampFilter.flush(TimestampFilter.java:237) at com.caucho.vfs.WriteStream.flush(WriteStream.java:362) at com.caucho.log.StreamHandler.publish(StreamHandler.java:122) at com.caucho.log.SubHandler.publish(SubHandler.java:60) at com.caucho.log.EnvironmentLogger.log(EnvironmentLogger.java:331) at java.util.logging.Logger.doLog(Logger.java:480) at java.util.logging.Logger.log(Logger.java:503) at java.util.logging.L(Logger.java:1022) at com.caucho.server.cluster.Server.start(Server.java:1296) at com.caucho.server.cluster.Cluster.startServer(Cluster.java:710)解决方法：去除所有文件的只读属性后，重启应用服务器。 JDK配置问题如果服务器上JDK设置不正确，将会导致协同移动平台无法启动，现象为，直接启动时，窗口一闪而过，或者访问页面抱HTTP 500错误。解决方法：重新配置JDK的JAVA_HOME路径，以及path路径后，重启应用服务器。 Ecology接口问题XML-RPC接口：访问ecology系统地址：http:/ecology ip:port/mobile/xmlrpc如果返回说明该接口正确，否则接口不正确。Web Services接口：访问ecology系统地址：http:/ecology ip:port/services如果返回说明该接口正确，否则接口不正确。解决方法：重新检查补丁包是否正确升级到ecology系统中，检查ecology系统的web.xml文件是否正确修改，运行协同移动平台的配置向导重新配置服务器。 数据库配置问题如果协同移动平台服务器的数据库无法连接，服务器将会无法启动，表现形式为日志中会出现如下信息：2011-10-14 16:05:32.531java.sql.SQLException: Network error IOException: Connection timed out: connect2011-10-14 16:05:32.531at net.sourceforge.jtds.jdbc.ConnectionJDBC2.(ConnectionJDBC2.java:385)2011-10-14 16:05:32.531at net.sourceforge.jtds.jdbc.ConnectionJDBC3.(ConnectionJDBC3.java:50)2011-10-14 16:05:32.531at net.sourceforge.jtds.jdbc.Driver.connect(Driver.java:182)2011-10-14 16:05:32.531at java.sql.DriverManager.getConnection(DriverManager.java:582)2011-10-14 16:05:32.531at java.sql.DriverManager.getConnection(DriverManager.java:154)2011-10-14 16:05:32.531at xool.DefaultConnectionBuilder.buildConnection(DefaultConnectionBuilder.java:39)2011-10-14 16:05:32.531at xool.Prototyper.buildConnection(Prototyper.java:159)2011-10-14 16:05:32.531at xool.Prototyper.sweep(Prototyper.java:102)2011-10-14 16:05:32.531at xool.PrototyperThread.run(PrototyperThread.java:44)2011-10-14 16:05:32.531Caused by: .ConnectException: Connection timed out: connect2011-10-14 16:05:32.531at .PlainSocketImpl.socketConnect(Native Method)2011-10-14 16:05:32.531at .PlainSocketImpl.doConnect(PlainSocketImpl.java:333)2011-10-14 16:05:32.531at .PlainSocketImpl.connectToAddress(PlainSocketImpl.java:195)2011-10-14 16:05:32.531at .PlainSocketImpl.connect(PlainSocketImpl.java:182)2011-10-14 16:05:32.531at .SocksSocketImpl.connect(SocksSocketImpl.java:366)2011-10-14 16:05:32.531at .Socket.connect(Socket.java:529)2011-10-14 16:05:32.531at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)2011-10-14 16:05:32.531a