eSpace ECS2.3移动客户端登录失败定位方法

发布时间:  2016-03-30 浏览次数:  466 下载次数:  0
问题描述
UC2.3 eSpace Mobile终端比较常见的几种登录失败场景排查方法。如:界面提示账号或密码错误,终端界面很快提示“连接服务器失败,请检查网络设置”,终端界面提示“操作失败/登录失败/连接超时”等。
处理过程

定位方法汇总
1.2.1 终端界面提示账号或密码错误
   1. 查看安装目录\Logs\eServer\imserver.log,搜索关键字” message.LoginAck”,查看返回码result =。
      (1) 返回码2,表示密码错误。请确认输入的密码正确。
      (2) 返回码3,表示用户不存在。请确认:
          1用户确实存在
          2已开启UC业务
          3鉴权方式正确
      (3) 其他返回码请联系华为400售后技术支持工程师,并反馈日志。

   2. 检查espace应用->服务器设置中,MAA外网地址和端口是否填写正确(此处提示确实比较奇怪,但测试过确实存在MAA地址填错报用户名密码错误的问题)。

1.2.2 终端界面很快提示“连接服务器失败,请检查网络设置”
   1. 确认手机网络正常连接(手机可以正常上网)。
   2. 检查MAA服务是否正常
      windows环境:执行netstat -ano | findstr "7801",查看7801端口是否开启;
      Linux环境:执行netstat -ano | grep 7801,查看7801端口是否开启
   3. 检查AppAgent服务是否正常启动。
      在浏览器中输入http://IP/appServer(IP为AppAgent的服务器IP),如果出现”Welcome to appServer”欢迎页面,则表示AppAgent服务启动正常。
   4. 如果以上步骤都正常,请参照1.2.3继续定位。


1.2.3 终端界面提示“操作失败/登录失败/连接超时”
    1. 查看手机客户端日志eSpacelog.txt(iphone查看mip.log),找到checkVersion,再搜索后面是否有checkVersionAck。
       (1) 能搜索到checkVersionAck,查看返回码retval =
           i. 返回码0,说明checkVersion响应成功,进入步骤2。
           ii. 返回码-1,表示通用错误,未知异常。打开安装目录\Logs\MAA\MBServer.debug
           a) 搜索到”login app server error”,检查MAA安装目录下MBServer/WEB-INF/server_config.xml中配置的guid和pwd是否与数据库表t_server中配置的AppAgent的guid和pwd相同。 如果不相同,则说明没有配置正确,请按照产品文档中的“调测eSpace移动客户端的基本语音通话”章节的“配置BMU(可选) ”节配置即可。
           b) 搜索到”AppServer wait for response timeout”
            检查AppAgent服务是否正常启动;
            检查MAA安装目录下MBServer/WEB-INF/server_config.xml文件中appServer的ip地址端口(<appserver>标签下的<ip>标签和<socket_port>标签)是否配置正确。若不正确,请修改(修改配置文件需重启MAA生效)。
       (2) 搜索不到checkVersionAck
说明手机客户端跟MAA之间消息不通,请检查防火墙是否已经做了端口开放、端口映射。

   2. 在eSpacelog.txt中搜索KeyExchangeAck,查看返回码retval =
      (1) 返回码0,说明KeyExchange响应成功,进入步骤3。
      (2) 返回码-4,客户端请求参数不合法。打开MBServer.debug
          i. 搜索到”key is null”,则说明移动客户端没有带秘钥上来,需要分析移动端为什么没有带秘钥给MAA。
          ii. 搜索不到”key is null”, 请联系华为400售后技术支持工程师,并反馈日志。。
      (3) 返回码-1,表示通用错误,未知异常。请联系华为400售后技术支持工程师,并反馈日志。。

   3. 打开MBServer.debug,搜索关键字” ActionType=Login”,查看返回码<return></return>。
      (1) 返回码为-5,表示eServer服务器无响应
         i. 搜索”send msg to server failed for udp msg send faild”,若搜索到,说明MAA与eServer的UDP连接建立失败。
         a) 搜索message.Hello,检查消息发往的eServer端口地址是否正确;若不正确,打开server_config.xml,找到<IMServerIP>、<IMServerPort>标签,修改成正确的(修改配置文件需重启MAA)。
         b) 搜索message.Login,检查消息发往的eServer端口地址是否正确。若不正确,登录BMU:
          检查区域中是否已经把MAA的服务器IP加入到内网区域;
          检查eSpace维护中的消息服务,为内网接入区域配置eServer服务器的内网地址,默认区域配置防火墙的外网地址。
            详细配置参照产品文档配置专题->配置终端外网接入->配置BMU。
         c) 若上述eServer端口地址都正确,则检查eServer服务是否正常,确保eServer启动正常。
         d) 检查MAA与eServer之间网络是否OK。可通过在MAA及eServer侧抓包确定,若eServer收不到MAA的网络包,说明可能是防火墙设置原因。检查防火墙的端口开放及NAT映射配置是否正确。
     (2) 返回码为-10,表示未开通手机客户端权限。
请进入BMU角色管理,为账号对应的角色开通客户端权限。
     (3) 返回码为-4,表示客户端请求的参数错误。包含解析XML解析错误,必填字段为空,参数不合法。请联系华为400售后技术支持工程师,并反馈日志。。
     (4) 返回码为-3,搜索” handle Login eServer retcode=”
          i.  若搜索到,查看eServer的返回码,根据返回码定位错误原因。
            若retcode=1,表示未知错误。
              搜索imserver.log如果有”permit licence error”字眼,表示license过期。可登录BMU,进入系统管理->license维护,确认license是否过期。
            若retcode=2,表示密码错误。
            若retcode=3,表示用户不存在。
              登录BMU依次确认:用户确实存在,用户已开启UC业务,鉴权方式正确。
            若retcode=4,表示用户已存在。
            若retcode=5,表示用户不可重试登录。
            若retcode=6,表示版本过低,需要强制用户更新。
            若retcode=7,表示用户未激活。
              其它问题请联系华为400售后技术支持工程师,并反馈日志。。
          ii. 若搜索不到,请联系华为400售后技术支持工程师,并反馈日志。。
    (5) 返回码为-1,表示通用错误,未知的异常。搜索Login上下文的异常日志
         i. 若有”appid”、”tag”、”serverconfig”等关键字,说明MAA发给AppServer的应用鉴权请求不过:检查server_config.xml中配置的guid和pwd是否与数据库表t_server中配置的AppAgent的guid和pwd相同。
         ii. 其他问题请联系华为400售后技术支持工程师。

1.3 日志反馈
    若根据上述步骤还不能解决问题请联系华为400售后技术支持工程师,并反馈以下四个组件的日志:
   1.手机客户端日志 2.MAA日志 3. eServer日志4. AppAgent日志
     日志相对路径:安装目录\Logs。

END