RTX服务器插件部署手册免费V.docx

珠海信达星辰科技有限公司版本所有： 保密级别：普通 保密 机密文件编号：信达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. 技术支持81. 概述在进行部署之前，请确认已经向信达公司申请开通过手机RTX服务并获取了账号和密码。请严格按照本文件部署及配置RTX服务器插件，否则可能导致图片、文件、语音功能不可用。RTX服务器插件又叫信达通讯录管理器，是信达公司为了实现手机RTX开发的一个代理插件，其一端连通RTX服务器，另一端连通信达通讯录服务器，从而实现手机端和PC端的通讯。请通过我们公司网址关注新版本产品的发布，以及产品安装包下载。2. 环境要求 只有2011及以上版本的RTX服务端程序才支持手机RTX，部署前请先确认版本，低版本的建议先升级到最新版本，最新版本下载地址参考腾讯官网：/rtx/download/index.shtml。 RTX服务器插件必须与RTX服务器安装在同一台物理服务器上。 要使用免费版手机RTX，需保证RTX服务器能访问信达服务器的5002端口，确保 telnet 5002 能通。 思科腾讯通需要做些特殊处理，请联系我们的技术服务人员获取支持。3. RTX服务器插件部署说明3.1 安装RTX服务器插件必须与RTX服务器安装在同一台物理服务器上。安装之前，建议先关闭杀毒软件。安装文件：类似Agent.X.X.exe这样的文件，其中X表示版本号，可从信达官网下载中心中的RTX服务器插件链接地址下载。点击安装文件，跟随安装指引即可完成安装。3.2 配置3.2.1 配置账号安装完成之后，启动RTX服务器插件（信达通讯录管理器）的管理界面，需要首先完成账号的配置；此处配置的账号是RTX服务器插件与信达通讯录服务器程序之间进行连接的身份认证；账号和密码由信达公司生成，在手机RTX服务开通申请的回复邮件中一同发送，账号一般与RTX总机号相同。注意：此处的密码是信达公司提供的密码，不是腾讯公司提供的那个RTX密码。在RTX服务器插件（信达通讯录管理器）的管理界面点击【配置账号】即可完成配置，见下图：图1：RTX服务器插件管理界面图2：账号配置界面每个免费版信达通讯录的客户都有一个自己的管理后台，地址如下：/userportal/login.jsp。通过上述账号和密码可以登录这个后台维护企业信息、查看企业成员登录手机端的情况、修改服务密码等；如果通过本后台修改了服务密码，则需在RTX服务器插件管理界面的配置账号中重新输入这个密码，并重启RTX服务器插件服务（停止服务，再启动服务）。 3.2.2 启动服务配置好账号信息之后，即可启动服务；启动服务之后就会在日志框中输出插件运行日志，如果日志中有“登录成功”字样的，则服务启动成功，此时手机客户端可完成登录。如果启动了服务，但手机端不能完成登录，则可能是服务启动失败，具体要查看日志内容来判断问题说在，详见后续的【常见问题】。3.2.3 停止服务停止服务一般是在应用出现异常，或者变更了账号、密码之后需重启服务时使用。停止服务之后，手机端将不能再登录系统，直至重启服务。3.2.4 同步组织架构同步组织架构是指将RTX管理器里的组织架构同步到信达通讯录（手机RTX）的服务器上，供手机端下载到使用。 自动同步RTX服务器插件每5分钟会自动同步一次组织架构增量（发生变化部分）到信达通讯录服务器上，手机端第一次登录之后，每次也是以增量的方式同步组织架构。 手工同步如果系统自动同步组织架构出现异常（比如手机端显示不完整等），也可以点击【同步组织架构】进行手工同步；每次手工同步都是将组织架构完整的同步到信达服务器，不是同步增量。3.2.5 查看日志日志已经显示在窗口中，此处可以打开日志文本查看。4. RTX服务升级针对RTXServer2011、2012版本必须做此部分设置，否则不能支持文件收发和语音留言功能。1. 进入RTX管理器，选择【服务运行状态】项，停止APPSERVER服务（右键停止服务）。2. 将RTX服务器插件（信达通讯录管理器）安装路径下RTXagent/bin目录内的APPServer.exe文件覆盖掉腾讯通RTX管理器安装路径下BIN目录里的APPServer.exe文件（原文件请先做好备份）。3. 进入RTX管理器，选择【服务运行状态】项，重启APPServer.exe服务。4. 进入RTX管理器，选择【服务运行状态】项，重启FileServer服务。5. RTX-SERVER-SDK升级针对RTXServer2011、2012版本必须做此部分设置，否则不能支持文件收发和语音留言功能。Rtx-server-sdk下载地址：/foxmail/rtx/rtx2013formalsdk_allinstall.zip下载之后，直接在RTX服务器上安装完成即可，只需安装SERVER-SDK。6. 支持电脑端和手机端同时在线的配置1. 进入RTX管理器，选择【服务运行状态】项，停止CONNSERVER服务（右键停止服务）2. 将RTX服务器插件（信达通讯录管理器）安装路径下bin目录内的CONNServer.exe文件覆盖掉腾讯通RTX管理器安装路径下BIN目录里的CONNServer.exe文件（原文件请先做好备份）。3. 进入RTX管理器，选择【服务运行状态】项，重启CONNServer.exe服务7. 客户端安装iPhone客户端：在AppStore里搜索“信达通讯录”然后下载安装。iPad客户端：在AppStore里选择“仅iPhone”，然后搜索“信达通讯录”下载安装安卓客户端：在腾讯应用宝、360手机助手、百度手机助手、小米应用商店等应用商店搜索“信达通讯录”然后下载安装。上述客户端也可以直接通过信达官网的下载中心下载或扫描二维码安装。信达官网：8. 常见问题处理8.1 信达通讯录管理器启动不了【启动服务】和【停止服务】按钮为灰色不可用，启动窗口没有日志输出。这个情况一般是服务器上装了杀毒软件，特别是360，拦截了windows服务agent_svrmain；看看windows服务列表中，agent_svrmain服务是否正常启动（或者是否可以启动），如果否则按下图指引处理。8.2 RTX服务器升级会对原来的接口开发有影响吗没有影响，腾讯通RTX新版的SDK对老版本是向下兼容的，升级到新版本对老版本已经实现的接口开发没有影响。8.3 服务启动时日志显示登录失败或密码错误一般是在账号配置中的账号或者密码错误，账号和密码是信达公司提供的，不是腾讯提供的。如果不记得密码，可以查回申请开通手机RTX服务时信达的回复邮件，也可以联系信达客服重置密码。可以通过客户后台更改手机RTX服务密码，后台地址：/userportal/login.jsp。如果通过后台修改了服务密码，则需在RTX服务器插件管理界面的配置账号中重新输入这个密码，并重启RTX服务器插件服务（停止服务，再启动服务）8.4 服务启动后日志显示连接到手机后台服务器失败免费版手机RTX的服务程序是部署在信达的云端服务器上的，并通过其5002端口向所有免费版手机RTX客户的RTX服务器开放连接；出现此问题一般是客户的RTX服务器插件连不上信达云服务器所致，可以通过如下办法检查：在RTX服务器上打开CMD窗口，执行 telnet 5002 ，看是否能通，如果不通则需要进行相关的网络设置，确保RTX服务器能够访问信达服务器 的5002端口。8.5 服务启动后手机端登录不成功首先确定输入的总机号、账号、密码是否正确。然后免费版用户登录时无需配置服务器地址，确定在手机登录界面的设置里没有设置任何服务器信息。最后查看一下RTX服务器插件运行状态是否正常，日志中是否有报错，如果有错误可尝试重启服务或根据错误提示做相应处理。8.6 手机端登录后组织架构下载不下来近期信达通讯录的组织架构同步逻辑做了优化，需要手机客户端和RTX服务器插件同时升级到最新版才能支持，如果手机客户端升级到了最新版而RTX服务器插件没有升级，这可能导致手机拉不到组织架构。解决办法是到信达官网上下载最新的RTX服务器插件安装一下。组织架构同步逻辑优化后的手机端版本号是2.0.9，RTX服务器插件版本号号是4.0。8.7 手机端登录后组织架构显示不完整到RTX服务器上，打开RTX服务器插件（信达通讯录管理器），点【同步组织架构】按钮；等同步完成之后（看查看日志同步结果），手机端注销登录一下。如果还不行，尝试一下卸载手机端重新安装再登录。8.8 手机端不能发送图片、文件和语音首先，图片收发、文件收发和语音留言功能没有对免费版用户开放，可以发邮件到supportcind