【操作指南】Coremail企業郵箱搬家

Coremail企業郵箱搬家：

1.1.1? 功能介紹

郵箱搬家功能用于將用戶舊郵箱中的郵件搬到新郵箱，從而保證企業員工在企業郵箱成功遷移后可正常讀取歷史郵件。郵箱搬家是以POP/IMAP取信的方式將舊郵箱系統的郵件遷移到云享版企業郵箱，類似通過客戶端收取舊郵箱服務器的郵件。

1.1.2? 適用范圍

使用郵箱搬家進行系統遷移，需要滿足以下條件：

1、舊郵箱系統必須開通POP或IMAP功能，且舊郵箱帳號IMAP或POP協議登錄正常；

2、企業僅需遷移用戶、密碼和郵件數據，無其他特殊數據遷移需求。（如還需遷移個人通訊錄、網絡硬盤數據，推薦使用migration遷移工具，如有其它特殊需求則需進行定制化方案評估。）；

3、郵箱搬家適用的新、舊郵箱系統類型情況說明如下：

舊郵箱系統類型

新郵箱系統類型

是否適用

備注

企業郵箱（公有云）

企業郵箱（公有云）

是

優先推薦使用郵箱搬家

企業郵箱（公有云）

自建系統

是

優先推薦使用郵箱搬家

自建系統

企業郵箱（公有云）

是

優先推薦使用郵箱搬家

1.1.3? 操作說明

使用郵箱搬家進行系統遷移主要有五個階段，每個階段包含的關鍵步驟及說明如下：

圖1 郵箱搬家五個關鍵階段

1、確認舊郵箱信息及相關參數

（1）確認舊郵箱是否已開通POP或IMAP

未開通POP或IMAP無法進行郵箱搬家

郵箱搬家只能采用POP或IMAP其中一種方式，使用POP方式只能搬取舊郵箱【收件箱】中的郵件；使用IMAP方式可搬取舊郵箱【收件箱】、【發件箱】、【已刪除】、【草稿箱】、【垃圾郵件】及用戶自定義文件夾中的歷史郵件。因此，若企業舊郵箱支持IMAP，則在搬家時盡量選用IMAP方式。

（2）明確舊郵箱服務器地址及端口號

此為開通郵箱搬家的必填參數

需要企業郵箱管理員與舊郵箱運營商進行確認，例如騰訊企業郵的IMAP服務器地址為exmail.qq.com，端口號為143；服務器地址也可為具體的IP地址。

（3）提供可供測試的舊郵箱賬號和密碼

需企業郵箱管理員提供可在舊郵箱中正常使用POP或IMAP的郵箱賬號及密碼，用于開通郵箱搬家前進行舊服務器連接測試。

2、在云享版企業郵箱中創建組織及用戶

（1）根據企業實際組織架構需求，在Coremail webadmin創建組織及部門；

（2）在對應的組織及部門下創建郵箱用戶

在開通郵箱搬家前，必須在云享版企業郵箱系統中創建好組織和用戶

創建的用戶賬號必須與舊郵箱用戶賬號一致，例如舊郵箱中用戶A賬號為a@123.com，在Coremail中用戶A的賬號也必須為a@123.com。

管理員可逐個創建用戶，也可以批量導入郵箱用戶。需按照批量導入郵箱用戶的文件格式要求上傳文件并導入用戶。

無論是逐個創建還是批量導入用戶，用戶初始密碼必須勾選“支持用舊郵箱密碼登錄webmail”，才能為用戶開啟郵箱搬家。

圖2 管理員逐個創建用戶

圖3 管理員批量導入郵箱用戶

3、開啟郵箱搬家

（1）確認上述1、2階段準備工作到位后，進入Coremail webadmin＞組織與用戶＞郵箱搬家＞郵箱搬家向導，設置搬家組織。

圖4 搬家組織設置界面

設置說明：

設置項

作用描述

參數設置說明

搬家組織

確定云享版企業郵箱系統中需要進行舊郵箱搬家的用戶范圍，所選范圍內的用戶才會進行郵箱搬家。

1、可選擇整個組織；

2、也可以選擇部分用戶，支持跨組織、跨部門選擇用戶范圍；

搬家域名

該功能在XT5標準產品中無實際作用，可忽略（待后續產品優化流程）

——

搬遷郵件收發時間

確定舊郵箱歷史郵件的搬遷范圍，讓企業可以根據實際需求選擇搬遷指定時間內的舊郵件，縮短郵箱搬家的時間

可選擇全部、近三個月內、近半年內、近一年內的歷史郵件，也支持搬遷從自定義時間起的歷史郵件

收取時保留郵件備份

在使用POP方式進行郵箱搬家時，可選擇收取時是否保留舊郵箱中郵件備份；勾選則在進行POP收取時保留舊郵箱郵件備份，不勾選則在完成POP搬遷后，用戶舊郵箱中的相應郵件不復存在。

1、使用IMAP方式搬家，無論此處是否勾選，收取時都將保留舊郵箱中的郵件備份

2、使用POP方式搬家，建議管理員勾選“收取時保留郵件備份”

支持SSL

若舊郵箱支持SSL，搬家時可選擇支持SSL，以增強傳輸安全。

——

（2）對舊郵箱進行運營商設置

完成第（1）步后，點擊下一步進入“運營商設置”：

圖5 運營商設置界面

設置說明：

設置項

作用描述

參數設置說明

服務商選擇

該功能在XT5標準產品中無實際作用，默認勾選“其他郵箱”，且不可更改（待后續產品優化流程）

——

搬家方式

選擇POP或IMAP方式進行搬家

1、使用POP方式只能搬取舊郵箱【收件箱】中的郵件；

2、使用IMAP方式可搬取舊郵箱【收件箱】、【發件箱】、【已刪除】、【草稿箱】、【垃圾郵件】及用戶自定義文件夾中的歷史郵件。因此，若企業舊郵箱支持IMAP，則在搬家時盡量選用IMAP方式。

郵件搬遷至新郵箱中的文件夾設置

從舊郵箱搬遷到云享版企業郵箱的郵件，可設置將郵件放置在哪些文件夾中。

1、使用POP方式搬家，只能選擇將郵件放在收件箱，或另外新建文件夾集中放置；

2、使用IMAP方式搬家，可選擇“按照舊系統文件夾顯示”，即將舊郵箱中的文件夾目錄遷移到用戶的云享版郵箱，且舊郵件的位置與舊郵箱保持一致；也可以另外新建文件夾集中放置。

服務器地址

用于連接舊郵箱服務器

1、需要企業郵箱管理員確認，必要時可咨詢舊郵箱服務提供商

2、支持SSL與不支持SSL的服務器地址和端口可能不同，需提前確認清楚

服務器端口

（3）舊郵箱服務器連接測試

完成第（2）步后，填寫在舊郵箱可正常使用的賬號和密碼，需確認該賬號相應的POP或IMAP協議登錄正常。正確填寫測試賬號后，點擊“測試”：

圖6 舊郵箱服務器連接測試

測試成功界面將進行提示：

圖7 測試成功提示

若界面提示“連接服務器失敗”（如圖8），請檢查:

舊郵箱服務器地址及端口號是否正確；

測試賬號密碼是否正確，可使用該賬號登錄舊郵箱驗證；

測試賬號除了賬號密碼外，是否開啟了其他驗證方式。例如在遷移騰訊企業郵箱時，因測試賬號開啟強制啟用安全登錄且綁定了微信驗證，在進行舊郵箱服務器連接測試時，無法直接驗證通過，解除微信登錄驗證后，再次測試可成功連接到騰訊企業郵箱服務器；

圖8 測試成功提示

（4）測試成功后開通搬家

第（3）步中提示“連接服務器成功”后，點擊“開通搬家”，此時已成功開通郵箱搬家。

圖9 成功開通郵箱搬家頁面

4、執行郵箱搬家

第3步成功開通郵箱搬家并不等于系統已經開始進行郵件搬家，還需要郵箱用戶本人或者管理員觸發搬家，系統才會正式開始執行對舊郵箱賬號的郵件搬運工作。

觸發郵箱搬家正式執行的方式有兩種可選，說明如下：

執行搬家的方式

必要條件

特點

用戶自主搬家

郵箱用戶

1、用戶使用舊郵箱賬號密碼登錄Coremail webmail

2、輸入舊郵箱密碼開啟搬家。

1、用戶只有在登錄webmail且主動開啟搬家才能觸發搬家，因此搬家的時間和進度不可控；

2、管理員在開通搬家后，需要通過其他方式通知到搬家用戶，以提醒和引導用戶自主完成搬家

管理員統一搬家

郵箱管理員

管理員需要知道所有搬家用戶的舊郵箱賬號和密碼

1、無需用戶主動觸發，用戶無感知；管理員后臺統一控制，時間和搬家進度可控；

2、需要管理員將搬家用戶的舊郵箱賬號和密碼整理成csv文件導入并啟動搬家

兩種觸發方式具體操作步驟如下：

（1）用戶自主搬家

在管理員完成第3步開通郵箱搬家后，建議通過郵件、IM等方式通知到搬家用戶，提醒與引導郵箱用戶啟動搬家。

用戶自主搬家的操作流程及界面示意圖如下：

圖9 用戶自主搬家操作流程

（2）管理員統一搬家

管理員需首先將搬家用戶的舊郵箱賬號及密碼整理成csv文件，可在Coremail webadmin＞組織與用戶＞郵箱搬家＞郵箱搬家狀態查詢中，點擊頂部功能欄中的“導入郵箱賬號密碼進行搬家”，下載csv文件模板，按文件格式要求整理需要搬家的用戶賬號和密碼。

圖10 通過文件上傳導入搬家用戶

管理員統一搬家的操作流程及界面示意圖如下：

圖11 管理員統一搬家界面操作流程

5、完成郵箱搬家

管理員可進入“郵箱搬家狀態查詢”頁面，查看本次搬家用戶的搬家狀態。若全部搬家用戶搬家狀態均變為“搬家已結束”，則表示本次郵箱搬家已完成。

圖12 郵箱搬家狀態查詢界面

搬家狀態每次只能選擇一個組織或一個部門范圍進行查看，也可以直接搜索用戶賬號查詢。

搬家狀態共有5種，分別為：

搬家狀態

描述

未執行搬家

用戶自主搬家模式下，搬家用戶未在webmail輸入正確的舊郵箱密碼確認搬家

搬家中

1、用戶自主搬家模式下，用戶輸入正確的密碼并連接服務器成功后，進入“搬家中”狀態；

2、管理員導入賬號密碼搬家模式下，管理員導入csv文件解析并確認開始執行后，所導入的搬家賬號進入“搬家中”狀態；

3、以上兩種模式開始執行后，以下狀態也顯示為“搬家中”：

·?? 賬號連接成功，處于隊列中等待；

·?? 賬號中的郵件開始遷移到新系統；

·?? 能連接到對方的服務器但是超過了等待時間，系統進行重試；

·?? 在與服務器連接過程中出現的通訊延遲或者中斷，系統進行重試；

·?? 網絡不通找不到對方服務器ip，系統進行重試

搬家已結束

搬家賬號的郵件搬遷進度達到100%

搬家失敗

以下情況會顯示為“搬家失敗”狀態：

1、搬家過程中用戶修改舊郵箱密碼會導致搬家失敗；

2、管理員導入的賬號密碼中，用戶在舊郵箱中不存在，會顯示為“搬家失敗”狀態；

3、在與服務器連接過程中出現的通訊延遲或者中斷，重試次數達到閾值

4、網絡不通找不到對方服務器ip，重試次數達到閾值

5、除了以上原因之外的所有原因，主要為搬家程序問題，需內部協助排查

其中，1、2會提示“服務器上沒有用戶或密碼不對”；3會提示“服務器通訊超時”；4會提示“不能連接到服務器”。

搬家已取消

對還處于未執行搬家狀態的賬號執行取消搬家操作

1.1.4? 常見問題及解決方案

1、開通郵箱搬家時測試通過，但用戶登錄webmail使用舊郵箱賬號密碼無法觸發搬家，webadmin中此用戶搬家狀態顯示為“失敗，服務器上沒有此用戶或密碼不對”。

【問題描述】

企業客戶原系統為exchange，通過郵箱搬家將郵件遷移到云享版企業郵箱。

測試郵箱搬家：新建與exchange相對應的測試賬號，并開啟“支持用舊郵箱密碼登錄webmail ”，對此用戶開啟郵箱搬家，使用POP3方式，填寫該用戶賬號密碼進行服務器測試并成功，開通郵箱搬家。

開通后在webmail登錄此用戶，提示用戶名密碼錯誤。webadmin中此用戶搬家狀態顯示為“失敗，服務器上沒有此用戶或密碼不對”。

【產生原因】

某些系統默認不允許帶域名進行 POP、IMAP認證，如Exchange。

【解決方法】

修改配置文件：/home/coremail/conf/webmail.cf

[POPAgent]

AuthDiscardDomains="test.com"

重啟Rmiserver

注：test.com為原系統域名。添加此配置后認證將去除域名

2、郵箱搬家結束但未收取到新郵件

【問題描述】

某用戶在某日9：00完成郵箱搬家，但此后舊郵箱系統仍在收取新郵件，新郵箱系統無法接收。

【產生原因】

搬家后DNS的mx記錄未修改到新系統，且郵箱搬家功能默認只是收取截止到搬家開始時的歷史郵件，搬家狀態為“搬家已結束“后，不會繼續收取搬家用戶的新郵件。

【解決方法】

首先建議企業郵箱管理員在搬家完成后及時切換DNS。

另外可通過定期執行手動收取命令：/home/coremail/bin/sautil callapi cmd=popWebSyncUser\&user_at_domain=user@domain；此命令等同于搬家用戶個人在webmail＞設置＞高級功能＞代收郵箱設置中，手動點擊“收取”，如圖：

圖13 代收郵箱設置界面

或者通過命令執行自動收取：/home/coremail/bin/sautil set-popweb user@doamin "autoSync=1"

3、在webmail代收郵箱設置查看郵箱搬家進度，搬家結果顯示跳過n封郵件。

【問題描述】

1.用戶原有郵箱為263企業郵箱

2.進行郵箱搬家收取郵件過程中，出現了跳過部分郵件（98封）的問題，之后用戶點了一次“收取所有”后，收取了41封，還有一部分沒有收取到

【解決方法】

具體原因需要查看rmi_api.log，根據日志中字段skip one message( )中的具體類型進行判斷：

字符串 "O" - 表示信件大小超過限制，需調整服務等級中“可接收郵件大小限制”

字符串 "Q" - 表示容量滿跳過的信件，需調整用戶郵箱容量，但由于RMI緩存原因，短時間內無法生效（若需立即生效，則需重啟Rmiserver)

字符串 "E" - 表示信件收取出錯，需立即檢查Rmiserver運行情況或與ms通訊情況

字符串 "R" - 表示用戶拒收此信件

字符串 "L" - 表示跳過的循環的信件 (如自動轉發出去的信件)

字符串 "D" - 表示郵件在原郵箱系統中已經刪，只有索引沒有對應郵件，不能下載

字符串 <數字> - 表示跳過此時間前的信件

4、已完成郵箱搬家，但搬遷過來的郵件數據不完整

【問題描述】

開通郵箱搬家后，用戶執行郵箱搬家且最終完成搬家，未顯示跳過郵件。而實際上舊郵箱收件箱有1000多封郵件，最終僅成功搬遷了100多封郵件。

【產生原因】

可能的原因一：舊郵箱POP/IMAP未設置“收取全部郵件”。以126、263郵箱為例：

圖14 126郵箱POP3/SMTP/IMAP設置

圖15 263郵箱客戶端收信設置

可能的原因二：舊郵箱服務器為防止遷移，在服務器加了限制，每個連接只能下載指定數量的郵件。

此外其他情況需要具體問題具體分析。

【解決方法】

針對原因一：需將舊郵箱客戶端收信設置為“收取全部郵件”

針對原因二：可嘗試修改配置，將任務分片執行。具體配置如下：

programs.cf

------------

[popagent]

RerunIfTaskNotComplete = "true"?? # 單次執行任務未完成時，重新放回隊列中排隊

MsgNumLimit = "10"???? # 單個文件夾每次只代收10封

ScanInterval = "10m"?? # 代收定時間隔縮短為 10 分鐘一次

若均為解決問題，則需要內部研發協助排查。

5、郵箱搬家過程中，CPU負載過高，rmi日志顯示內存溢出

【問題描述】

郵箱搬家執行過程中，CPU負載過高，rmi日志顯示內存溢出，如圖：

圖16 CPU負載過高

圖17 rmi日志顯示內存溢出

【產生原因】

RMI默認內存為512M，郵箱搬家/代收占用內存超過此值，導致內存泄漏，觸發JAVA虛擬機垃圾回收機制(GC)，以致CPU占有率過高。

【解決方法】

調高Rmiserver的JVM內存：

修改配置文件：/home/coremail/conf/jdaemon.cf

[rmiserver]

JvmOptions="-Xmx512m" 改為其他數值

重啟Rmiserver

6、完成搬家且新郵箱切換上線后，用戶客戶端出現重復收信或丟失郵件的情況。

【問題描述】

1、在新郵箱切換上線后，用戶POP協議客戶端重復收信

2、新郵箱切換上線后，用戶IMAP協議客戶端本地郵件丟失

【產生原因】

問題1是由于新郵箱系統將郵件判定為新郵件，導致客戶端重新收取；

問題2是因為這部分丟失的郵件在客戶端本地有，而新郵箱服務端沒有，IMAP客戶端在與服務端進行同步后，客戶端本地此部分郵件丟失。

【解決方法】

問題1解決方法：設置郵箱搬家時，選擇將郵件遷移到新建的文件夾，可避免POP客戶端重復收件；

問題2解決方法：事先通知用戶做好備份

云市場

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。