我国移动邮件代理网关ForExchange安装与维护

邮件代理网关ForExchange安装与维护2008年01月培训说明培训原因－实施工程师对CEFForExchange方案不够熟悉，无法排除常见的系统故障培训对象－实施工程师培训目的了解CEFforExchange方案的适用条件熟悉CEFforExchange方案的参数配置熟悉CEFforExchange方案的常见故障排除方法目录系统

安装

维护邮件代理网关ForExchange应用于Exchange服务器的软件包支持MAPI、MAPI+、WebDAV三种连接方式MAPI方案原理使用MAPI协议访问邮件服务器在邮件服务器上配置CEFAdmin帐号来自....中国最大的资料库下载Exchange管理员（仅查看）具有对信箱存储的完全控制权限具有代理发送（SendAs）和代理接收（ReceiveAs）权限以CEFAdmin帐号登录，邮件客户端可以打开其他用户的信箱并以其他用户的身份发送邮件MAPI方案原理（续）验证CEFAdmin帐号权限使用浏览器，打开“.exchange_ip/exchange/手机邮箱用户的用户名”，用CEFAdmin帐号登录，看能否打开用户信箱以CEFAdmin帐号身份登录MicrosoftOutlook，在菜单中选择开始->打开->其他用户的文件夹，看能否打开手机终端身份验证使用业务密码MAPI方案适用条件CEF服务器与邮件服务器逻辑上属于同一内网，能够：加入邮件服务器所在的域使用MAPI协议访问邮件服务器企业管理员有控制AD和Exchange服务器的权限，能够配合设置CEFAdmin帐号手机邮箱用户是普通域用户，没有权限较高的域用户，否则，CEFAdmin可能会没有权限访问用户信箱MAPI+方案原理使用MAPI协议访问邮件服务器模拟MicrosoftOutlook的工作方式以本地管理员身份启动程序模拟手机邮箱用户身份运行登录邮件服务器收发邮件等操作恢复本地管理员身份手机终端身份验证使用域用户的用户名和密码MAPI+方案适用条件CEF服务器与邮件服务器逻辑上属于同一内网，能够：加入邮件服务器所在的域使用MAPI协议访问邮件服务器无其他要求WebDAV方案原理通过HTTP协议连接Exchange服务器通过WebDAV协议访问Exchange存储WebDAV（“Web-basedDistributedAuthoringandVersioning”的缩写）是标准HTTP协议的扩展支持表单和非表单方式的基本身份验证表单验证：用浏览器打开.exchange_ip/exchange时显示一个页面要求输入用户名和密码非表单验证：用浏览器打开http://exchange_ip/exchange时弹出对话框要求输入用户名和密码支持HTTPS协议即URL是https://exchange_ip/exchange手机终端身份验证使用域用户的用户名和密码WebDAV方案适用条条件邮件服务器器已开启WebDav协议CEF服务器能够够使用WebDav协议连接邮邮件服务器器能够用浏览览器打开.exchange_ip/exchange或https://exchange_ip/exchange无其他要求求收取邮件的的过程cef_polld服务连接到到服务器cef_polld服务取得邮邮件并保存存在邮件缓缓存中，同同时在数据据库中记录录在邮件缓存存文件夹（（{cef安装目录}\data\{用户手机号号码}\inbox）中保存加加密邮件文文件，文件件名为邮件件的UID在数据库的的trx_history表和user_mail表中插入记记录cef_cronpushd服务发送EMN到终端终端连接到到cef_cmpopd服务cef_cmpopd服务从邮件件缓存中取取得邮件并并发送到终终端如果收取的的邮件已经经从CEF上删除，则则cef_cmpopd服务通过插插件连接到到邮件服务务器，取得得目标邮件件并发送到到终端发送邮件的的过程终端连接到到cef_cmsmtpd服务cef_cmsmtpd服务接收邮邮件并保存存到邮件缓缓存中在邮件缓存存文件夹（（{cef安装目录}\data\{用户手机号号码}\outbox）中保存加加密邮件文文件，文件件名为邮件件的UID在数据库的的trx_history表中插入记记录cef_relayd服务通过插插件连接到到服务器cef_relayd服务从邮件件缓存中取取得待发送送的邮件并并发送到邮邮件服务器器如果发送失失败，程序序将重试三三次，间隔隔十分钟三次重试仍仍未成功，，程序将放放弃发送并并向终端发发送通知适用的邮件件服务器MAPIMAPI+WebDAVExchangeServer2000/2003支持支持支持ExchangeServer2007暂不支持支持暂不支持操作系统准准备推荐的系统统环境WindowsServer2003(sp1)简体中文版版MicrosoftInternetExplorer6.0MicrosoftOffice2003(sp2)简体中文版版其他系统环环境理论上，可可以运行于于Windows2000Server和WindowsXP，但未经正正式测试目录系统安装维护护安装装过过程程详见见《操作作手手册册》可以以安安装装防防病病毒毒软软件件只有有MAPI方案案需需要要创创建建CEFAdmin帐号号安装装程程序序首首先先对对设设置置系系统统环环境境，，重重启启计计算算机机后后继继续续完完成成安安装装安装装开开始始时时，，CAU检测测系系统统环环境境，，会会严严重重影影响响系系统统正正常常运运行行的的项项目目有有：：检测端口占用用是否已安装MicrosoftOffice2003检测域控可连连接性检查GEGW可连接性检查MAPI(+)功能安装过程（续续）安装结束前，，CAU对系统初始化化，各个项目目都要成功执执行，否则会会严重影响系系统正常运行行设置GEGW连接参数，包包括企业ID、短信代码、、验证码、GEGWIP和证书注意：如果CEF通过代理连接接GEGW，则CAU不能完成“设置GEGW连接参数”配置，需要手手工导入c:\cef\sql\gegw.sql，然后通过WebAdmin进行配置分配系统权限限设置服务启动动帐号，服务务启动帐号要要求是本地的的Administrator特殊服务的启启动帐号是本本地管理员安装完成后，，按《软件验证说明明》验证安装正确确补丁包安装补丁包安装运行安装包程程序，按向导导步骤进行补丁包介绍cef-exchange-2.50-sp1：CEF2.50的SP1补丁和MAS1.2升级软件包。。第一次运行行时安装SP1；如果已经安安装了SP1，运行时升级级到MAS1.2。cefexchange-2.50-kb00003-patch：2007年9月15日发布的补丁丁包，解决了了cef-exchange-2.50-sp1之后的问题预计每月发布布一个补丁包包，解决新近近发现的问题题系统配置（1）服务器连接方方式使用WebAdmin配置通过<邮件服务器设设置>进行管理添加服务器时时选择连接方方式可以同时支持持MAPI、MAPI+、WebDAV三种连接方式式系统配置（2）配置文件统一一放在c:\cef\conf目录下配置文件包括括：CEF配置文件cef.confWatch配置文件cef_watch.confMonitor配置文件smconfig（目录）Router配置文件client.ovpnSTunnel配置文件stunnel.conf证书文件也在在此目录下：：Router的证书，ca.crt、企业ID.crt、企业ID.keySTunnel的证书，cef-cert.pem和cef-key.pem系统配置（3）CEF配置文件修改日志级别别默认日志级别别是精简日志志，loglevel=3；排查系统问题题时，可以设设置为打印复复杂日志，loglevel=8。（也可以使使用WebAdmin修改）修改轮询间隔隔轮询全部用户户所消耗的时时间如果小于于设置的间隔隔，则在轮询询完成后，等等待一定时间间，从而控制制用户少和邮邮件少时的轮轮询频度，减减小对邮件服服务器的压力力。参数PollInterval，单位是秒。。轮询方式PollMethod为轮询方式，，默认为单进进程轮询，PollMethod=MP为多进程轮询询，如果设置置为多进程轮轮询，系统会会根据注册用用户数启动多多个轮询进程程轮询（默认认是50个用户启动一一个进程）系统配置（4）WATCH配置文件日志保存时间间CLEAN部分的LogReserveDay项，单位是天天，默认值是是8；用户邮件保存存时间CLEAN部分的CacheReserveDay项，单位是天天，默认值是是8；数据库备份保保存时间DBBACKUP部分的DBReserveDay项，单位是天天，默认值是是8；详见《操作手册》日志文件说明明在c:\cef\log目录下常用日志：cef_polld日志：cef_polld-xxxxxxxx.log记录轮询邮件件的过程，如如果CEF不能收取到邮邮件服务器上上的邮件，可可以查看此日日志检查轮询询是否正常cef_relayd日志：cef_relayd-xxxxxxxx.log记录发送邮件件到邮件服务务器的过程cef-cmpopd日志：cef-cmpopd-xxxxxxxx.log记录手机从CEF收取邮件的过过程cef-cmsmtpd日志：cef-cmsmtpd-xxxxxxxx.log记录手机向CEF发送邮件的过过程cef_watchd日志：cef_watchd-xxxxxxxx.log记录watchd监控进程的活活动，根据此此日志，可以以判断其他服服务进程何时时发生故障WebAdmin的日志c:\cef\log\admin用于排查与WebAdmin页面有关的问问题CAU的日志在c:\cef\cau\cau_logs记录CAU执行检查过程程中的原始信信息，可以用用于判断检测测故障的原因因目录系统安装维护问题排查原则则不要盲目修改改系统配置，，以免引入新新的问题，使使情况更加复复杂通过检查服务务运行状态、、查看日志等等分析定位问问题，然后通通过检查工具具进一步定位位问题分析原原因，，解决决问题题基本检检查服务是是否正正常运运行尝试手手动启启动服服务错误1069：由于于登录录失败败而无无法启启动。。解决决方法法：需需要重重新设设置服服务启启动帐帐号，，保证证用户户名密密码正正确无无误查看服服务属属性，，检查查可执执行文文件路路径是是否正正确在命令令行下下运行行c:\cef\bin\[服务程程序]–d，有可可能会会弹出出对话话框，，提示示错误误信息息，比比如：：找不不到动动态链链接库库。其其中，，服务务程序序是服服务对对应的的可执执行程程序，，比如如cef_cmpopd.exe按《软件验验证说说明》验证系系统正正常使用MapiTestTool.exe检查MAPI(+)功能使用cau_preinstall.bat启动程程序才才能生生成日日志日志分分析（（1）分析cef-cmpopd日志，，排除除CEF故障对于手手机不不能收收取邮邮件、、不能能同步步密码码等问问题，，要先先分析析cef-cmpopd日志。。如果果日志志中没没有用用户连连接和和登录录的记记录，，则可可排除除CEF故障的的可能能。分析cef-cmsmtpd日志，，排除除CEF故障对于手手机不不能发发送邮邮件的的问题题，要要先分分析cef-cmsmtpd日志。。如果果日志志中没没有用用户连连接和和登录录的记记录，，则可可排除除CEF故障的的可能能。日志分分析（（2）同步密密码失失败问问题分析cef-cmpopd日志用户名名或密密码错错误的的例子子20:31:49err[652-2164]:NTlogonerror:[1326]登录失失败:未知的的用户户名或或错误误密码码。|tokensmgr.cpp(169)……20:31:49err[652-2164]:do_pop_passfail:(4)mapicefconnector.cpp(131)[0x3f3,183]:TestingNTloginfailed.[0_tom@abc.vm],[tom@abc.vm],[fdsfsda](2)cefuser.cpp(278)[0x11,183]:CefUserauthenticateexception(1)CefProtoCmpop.cpp(341)[0x10,183]:authenticateuserfail|CefProtoCmpop.cpp(589)20:31:49inf[652-2164]:=>:-ERR405Failedtoauthenticateuser.|CefProtocalIO.cpp(46)日志志分分析析（（3）轮询询日日志志通过过cef_polld日志志，，判判断断是是否否轮轮询询某某一一用用户户Cef_poller日志志详详细细记记录录了了收收取取邮邮件件的的过过程程连接接服服务务器器成成功功：：00:00:00dbg[3928-2908]:Testconnectionok:have6Messages.|mapicefconnector.cpp(507)取得得一一封封邮邮件件：：测试试6]!|cefpollex.cpp(143)日志志分分析析（（4）通过过分分析析轮轮询询日日志志定定位位问问题题创建建Profile超时时，，进进程程被被Watch停止止，，不不能能轮轮询询。。注注意意时时间间，，程程序序中中止止运运行行20分钟钟后后，，被被Watch停止止。。00:52:50dbg[3032]:usingCDOconnectto2:jun.li@:02|mapicefconnector.cpp(390)00:52:50dbg[3032]:CreatingProfilefor2:jun.li@:02->30321188319970jun.li@|mapicefconnector.cpp(410)01:12:44inf[2344]:stopservice[cef_polld]|cefwinservice.h(32)日志志分分析析（（5）stunnel服务务日日志志stunnel服务务实实现现了了手手机机与与CEF间的的数数据据加加密密解解密密功功能能，，此此服服务务的的故故障障可可能能导导致致手手机机不不能能连连接接到到CEF接收收或或发发送送邮邮件件修改改C:\cef\conf\stunnel.conf文件，添添加一个个配置项项“output=C:/cef/log/stunnel.log“，打开日日志功能能，排查查相关问问题未能生成成日志时时打开DOS窗口，执执行命令令：c:\cef\bin\cef_stunnel-d，查看看屏幕打打印一个证书书问题的的例子2007.09.1416:39:02LOG7[2780:2060]:RAND_statusclaimssufficiententropyforthePRNG2007.09.1416:39:02LOG6[2780:2060]:PRNGseededsuccessfully2007.09.1416:39:02LOG3[2780:2060]:Errorreadingcertificatefile:c:\cef/conf/cef-cert.pem2007.09.1416:39:02LOG3[2780:2060]:errorstack:140DC009

:error:140DC009:SSLroutines:SSL_CTX_use_certificate_chain_file:PEMlib2007.09.1416:39:02LOG3[2780:2060]:SSL_CTX_use_certificate_chain_file:906D064:error:0906D064:PEMroutines:PEM_read_bio:badbase64decode日志分析析（6）cef_router服务日志志修改配置置文件client.ovpn，增加一一项配置置“logrouter.log”，重启cef_router服务后，，日志文文件夹内内将生成成router.log日志证书错误误或不能能连接GEGW服务器等等错误都都会在日日志中反反应寻求帮助助清晰的描描述遇到到的问题题如管理页页面打不不开，最最好能说说明页面面显示的的内容：：404错误，500错误，……提供日志志精简级别别的日志志也许能能定位一一些问题题，完全全级别的的日志则则能够为为定位问问题提供供更多线线索CAU的日志，，只有通通过CAU主程序执执行各项项检查时时才生成成使用远程协协助通过管理后后台打开此此功能远程协助人人员通过SSH方式登录到到邮件代理理网关，进进行各种操操作登录的用户户名是cef_raWebAdmin打开此功能能时，设置置登录密码码操作完成后后，通过管管理后台关关闭此功能能有用的链接接谢谢浏览9、静夜四四无邻，，荒居旧旧业贫。。。12月-2212月-22Saturday,December31,202210、雨中黄叶叶树，灯下下白头人。。。11:51:2711:51:2711:5112/31/202211:51:27AM11、以以我我独独沈沈久久，，愧愧君君相相见见频频。。。。12月月-2211:51:2711:51Dec-2231-Dec-2212、故人江江海别，，几度隔隔山川。。。11:51:2711:51:2711:51Saturday,December31,202213、乍见翻翻疑梦，，相悲各各问年。。。12月-2212月-2211:51:2711:51:27December31,202214、他乡生白发发，旧国见青青山。。31十二月月202211:51:27上午午11:51:2712月-2215、比不了了得就不不比，得得不到的的就不要要。。。十二月2211:51上上午12月-2211:51December31,202216、行动出出成果，，工作出出财富。。。2022/12/3111:51:2711:51:2731December202217、做前，能够够环视四周；；做时，你只只能或者最好好沿着以脚为为起点的射线线向前。。11:51:27上午午11:51上上午11:51:2712月-229、没没有有失失败败，，只只有有暂暂时时停停止止成成功功！！。。12月月-2212月月-22Saturday,December31,202210、很多事情努努力了未必有有结果，但是是不努力却什什么改变也没没有。。11:51:2711:51:2711:5112/31/202211:51:27AM11、成功就就是日复复一日那那一点点点小小努努力的积积累。。。12月-2211:51:2711:51Dec-2231-Dec-2212、世间成事事，不求其其绝对圆满满，留一份份不足，可可得无限完完美。。11:51:2711:51:2711:51Saturday,December31,202213、不不知知香香积积寺寺，，数数里里入入云云峰峰。。。。12月月-2212月月-2211:51:2711:51:27December31,202214、意志坚强强的人能把把世界放在在手中像泥泥块一样任任意揉捏。。31十二二月202211:51:27上上午11:51:2712月-2215、楚塞三三湘接，，荆门九九派通。。。。十二月2211:51上上午12月-2211:51D