3-RTX服务器插件部署手册(免费版)V1.3.docxVIP

版本所有：保密级别：■普通□保密□机密文件编号：信达RTX服务器插件部署手册版本号 1.3珠海信达星辰科技有限公司目录目录21.概述32.环境要求33. RTX服务器插件部署说明33.1安装33.2配置33.2.1配置账号33.2.2启动服务43.2.3停止服务53.2.4同步组织架构53.2.5查看日志54. RTX服务升级55. RTX-SERVER-SDK升级66.支持电脑端和手机端同时在线的配置67.客户端安装68.常见问题处理78.1 RTX服务器升级会对原来的接口开发有影响吗78.2服务启动时日志显示登录失败或密码错误78.3服务启动后日志显示连接到手机后台服务器失败78.4服务启动后手机端登录不成功78.5手机端登录后组织架构下载不下来78.6手机端登录后组织架构显示不完整88.7手机端不能发送图片、文件和语音89.技术支持8概述在进行部署之前，请确认已经向信达公司申请开通过手机RTX服务并获取了账号和密码。请严格按照本文件部署及配置RTX服务器插件，否则可能导致图片、文件、语音功能不可用。RTX服务器插件又叫信达通讯录管理器，是信达公司为了实现手机RTX开发的一个代理插件，其一端连通RTX服务器，另一端连通信达通讯录服务器，从而实现手机端和PC端的通讯。请通过我们公司网址?关注新版本产品的发布，以及产品安装包下载。环境要求只有2011及以上版本的RTX服务端程序才支持手机RTX，部署前请先确认版本，低版本的建议先升级到最新版本，最新版本下载地址参考腾讯官网：/rtx/download/index.shtml。RTX服务器插件必须与RTX服务器安装在同一台物理服务器上。要使用免费版手机RTX，需保证RTX服务器能访问信达服务器的5002端口，确保 telnet 5002 能通。思科腾讯通需要做些特殊处理，请联系我们的技术服务人员获取支持。RTX服务器插件部署说明安装RTX服务器插件必须与RTX服务器安装在同一台物理服务器上。安装之前，建议先关闭杀毒软件。安装文件：类似Agent.X.X.exe这样的文件，其中’X’表示版本号，可从信达官网下载中心中的[RTX服务器插件]链接地址下载。点击安装文件，跟随安装指引即可完成安装。配置配置账号安装完成之后，启动RTX服务器插件（信达通讯录管理器）的管理界面，需要首先完成账号的配置；此处配置的账号是RTX服务器插件与信达通讯录服务器程序之间进行连接的身份认证；账号和密码由信达公司生成，在手机RTX服务开通申请的回复邮件中一同发送，账号一般与RTX总机号相同。注意：此处的密码是信达公司提供的密码，不是腾讯公司提供的那个RTX密码。在RTX服务器插件（信达通讯录管理器）的管理界面点击【配置账号】即可完成配置，见下图：图1：RTX服务器插件管理界面图2：账号配置界面每个免费版信达通讯录的客户都有一个自己的管理后台，地址如下：/userportal/login.jsp。通过上述账号和密码可以登录这个后台维护企业信息、查看企业成员登录手机端的情况、修改服务密码等；如果通过本后台修改了服务密码，则需在RTX服务器插件管理界面的配置账号中重新输入这个密码，并重启RTX服务器插件服务（停止服务，再启动服务）。启动服务配置好账号信息之后，即可启动服务；启动服务之后就会在日志框中输出插件运行日志，如果日志中有“登录成功”字样的，则服务启动成功，此时手机客户端可完成登录。如果启动了服务，但手机端不能完成登录，则可能是服务启动失败，具体要查看日志内容来判断问题说在，详见后续的【常见问题】。停止服务停止服务一般是在应用出现异常，或者变更了账号、密码之后需重启服务时使用。停止服务之后，手机端将不能再登录系统，直至重启服务。同步组织架构同步组织架构是指将RTX管理器里的组织架构同步到信达通讯录（手机RTX）的服务器上，供手机端下载到使用。自动同步RTX服务器插件每5分钟会自动同步一次组织架构增量（发生变化部分）到信达通讯录服务器上，手机端第一次登录之后，每次也是以增量的方式同步组织架构。手工同步如果系统自动同步组织架构出现异常（比如手机端显示不完整等），也可以点击【同步组织架构】进行手工同步；每次手工同步都是将组织架构完整的同步到信达服务器，不是同步增量。查看日志日志已经显示在窗口中，此处可以打开日志文本查看。RTX服务升级针对RTXServer2011、2012版本必须做此部分设置，否则不能支持文件收发和语音留言功能。进入RTX管理器，选择【服务运行状态】项，停止APPSERVER服务（右键停止服务）。将RTX服务器插件（信达通讯录管理器）安装路径下RTXagent/bin目录内的APPServer.exe文件覆盖掉腾讯通RTX管理器安装路径下BIN目录里的APPServer.exe文件（原文件请先