使用受支援的遷移將 ownCloud Classic 遷移到 oCIS

使用 ownCloud 的專用migrate-to-ocis應用程式及其occ命令,將使用者、群組、檔案和受支援的共用從 ownCloud Classic 10 遷移到單獨安裝的 ownCloud Infinite Scale (oCIS) 實例。這是一個分階段遷移,而非就地升級:目標環境必須可訪問,已做好身份驗證和模擬準備,並且不存在衝突資料。請提前規劃密碼重設、角色重新分配以及手動處理外部掛載點。

檢查此遷移是否符合您的設置

ownCloud 目前的 Server 10.16 遷移文件介紹了支援的遷移路徑,該路徑使用 ownCloud 提供的應用程式進行引導式遷移。該應用程式未在 Marketplace 上架;請聯絡 ownCloud 支援團隊取得。來源伺服器和目標伺服器都必須已配置、正在運作且彼此可以存取。您還需要擁有對 Classic 伺服器的 SSH 存取權限,並能夠occ以 Web 伺服器使用者身分執行命令。

已記錄的遷移過程會傳輸已啟用使用者和群組、每個已啟用使用者主目錄中的檔案以及使用者、群組和連結共用。但不會傳輸已停用使用者、已停用使用者擁有的檔案、密碼或外部掛載點。外部掛載點中的共用和檔案也不包含在檔案傳輸範圍內。如果您的使用者依賴已掛載的 SMB/S3 儲存、共用的管理掛載點或現有的外部儲存庫,請在安排切換之前清點這些資源,並建立單獨的複製和重建流程。

例如,對於擁有本機帳戶和個人主目錄中檔案的小型團隊,可以使用內建的本機使用者遷移流程。而對於帳戶位於 LDAP 中的公司,則應先確保 oCIS 可以解析相同的使用者和群組,然後再遵循 LDAP 的特定要求。文件中記錄的流程不支援本機使用者和 LDAP 使用者混合的情況。對於生產環境或更大規模的部署,ownCloud 建議使用真正的 LDAP 或外部身分識別管理系統,而不是功能有限的嵌入式 oCIS IDM。

在運行遷移命令之前準備好兩台伺服器

  1. 清點和備份。記錄已啟用和已停用的帳戶、群組成員資格、儲存掛載點、共享連結、應用程式整合以及完整的資料集。建立並驗證 Classic 資料庫和資料的可還原備份,並備份目標配置。遷移不等於備份。在使用者確認新服務之前,請保持原始 Classic 執行個體可用。
  2. 安裝遷移應用程式。從 ownCloud 支援取得該migrate-to-ocis應用程序,將其安裝到 Classic 目錄apps或apps-external具有正確所有權的目錄中,並啟用它。例如,假設使用預設安裝路徑和 Apachewww-data帳戶:
sudo -u www-data php /var/www/owncloud/occ app:enable migrate_to_ocis

請根據您的安裝情況調整路徑和作業系統帳戶。遷移應用程式自備 rclone 二進位文件,因此,如果沒有 ownCloud 提供的遷移計劃,請勿使用單獨的手動複製步驟來取代已記錄的應用程式工作流程。

  1. 準備 oCIS 身份驗證。啟用auth-app服務和模擬。文件中記錄的環境設定如下OCIS_ADD_RUN_SERVICES: "auth-app":,PROXY_ENABLE_APP_AUTH: true和AUTH_APP_ENABLE_IMPERSONATION: true。透過 auth-app 為 oCIS 管理員建立應用程式令牌。遷移過程將使用管理員使用者名稱和此令牌進行 oCIS 操作。請妥善保管令牌;切勿將其貼上到共享 shell 歷史記錄或文章配置中。
  2. 首先解決使用者身分問題。每個已啟用的經典使用者都需要一個有效的、唯一的電子郵件地址。如果使用 LDAP,請確保 oCIS 在遷移前能夠登入用戶,並配置正確的 LDAP 使用者名稱和架構屬性。經典 LDAP 使用者名稱屬性應使用穩定的登入名,例如 ` uid@ classic`samAccountName或 `@classic`,而不是與 oCIS 身分不符的內部 UUID。使用者和群組名稱在相關係統中必須保持一致。遷移的身份階段之後,請勿新增、刪除或重新命名帳戶或群組。

按順序運行遷移

以下指令以 `<example> /var/www/owncloud`、www-data`<example>` 和名為 `<example>` 的 oCIS 主機ocis.example.com為例。請將其替換為您的實際值。遷移命令會以互動方式請求管理員密碼。

  1. 初始化並驗證來源。初始化過程會記錄目標主機,以便後續步驟使用:
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:init ocis.example.com
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:verify

在繼續操作之前,請檢查驗證輸出並修復缺少或重複的電子郵件。切勿為了加快速度而跳過驗證;文件中已說明的跳過選項會將--insecure與電子郵件相關的問題歸您所有。除非是在您了解證書問題的受控測試中,否則請避免執行此操作。修復生產環境遷移所需的 TLS 信任。

  1. 配置使用者並指派角色。對於使用文件中已記錄的嵌入式身分識別管理 (IDM) 流程的本機用戶,請執行:
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:users ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:assign-role ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:groups ocis-admin

角色分配步驟是必要的。系統會為遷移的經典使用者指派一個選定的 oCIS 角色;經典角色不會被保留,子管理員權限也沒有對應的角色。請逐一檢查管理員帳戶,並僅在需要時授予提升的 oCIS 權限。如果 LDAP 已配置用戶,請遵循官方 LDAP 配置流程,並按照指示使用支援的跳過選項,而不是重複建立帳戶。

  1. 傳輸文件,然後共享文件。請在使用者和群組身分準備就緒後執行這些命令:
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:files ocis-admin
sudo -u www-data php /var/www/owncloud/occ migrate:to-ocis:migrate:shares ocis-admin

每個使用者 Classic 主目錄中的檔案都會移轉到該使用者的個人空間。外部掛載點和已接收的共用檔案除外。 shares 指令可以處理使用者、群組和連結共享,但在遷移過程中,如果出現缺少使用者或群組的錯誤,系統會進行報告。受密碼保護的連結會收到與 Classic 密碼不同的新密碼;在預設的 oCIS 策略下,無密碼連結可能會失效。請告知用戶替換已發布的鏈接,並透過安全管道分發更新後的密碼。

切換前驗證存取權限

指令執行完畢後,請將抽取的使用者、群組、資料夾樹、檔案數量、權限和金鑰共用樣本與您的清單進行比對。測試時請使用一般使用者帳戶,而不僅僅是管理員帳戶。確認外部儲存已重新創建,並且其資料已透過單獨規劃的流程複製。由於遷移用戶的舊密碼不會被轉移,請準備好密碼重設或新用戶入職流程。

在驗證和溝通變更期間,請保持經典服務的可用性。為了確保最終切換的一致性,請安排寫入凍結,阻止對來源進行任何新的更改,並考慮自遷移運行以來所做的任何更改;文件中記錄的步驟並不保證持續同步。僅在檢查通過後才重定向使用者和客戶端。保留回滾視窗和已知有效的備份,並且在不了解文件中記錄的重置行為的情況下,不要對已填充數據的目標進行重置和重新運行:重置--force會重新啟動遷移狀態,但會保留已遷移的目標數據,因此在重新啟動之前應清理目標。

官方參考資料

留下評論

使用安全的夜間定時任務自動執行 ownCloud 資料庫轉儲

使用安全的夜間定時任務自動執行 ownCloud 資料庫轉儲

為 ownCloud Server 安排受保護的 MariaDB 轉儲,安全地處理維護模式,並在依賴每個備份之前進行驗證。

使用受支援的遷移將 ownCloud Classic 遷移到 oCIS

使用支援的應用程式、有序的命令、身份驗證以及需要單獨處理的資料的明確列表,規劃 ownCloud 10 到 oCIS 的遷移。

帶有主題應用程式和 CSS 的品牌 ownCloud Classic 10

使用主題應用程式取代 ownCloud Classic 10 標誌並調整 Web UI 顏色,同時避免升級和完整性檢查陷阱。

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

按角色為新的 ownCloud Infinite Scale 使用者指派基於位元組的儲存限制,並提供 proxy.yaml 範例和安全性驗證清單。

修正 TLS 來源端的 ownCloud 同步憑證錯誤

修正 TLS 來源端的 ownCloud 同步憑證錯誤

透過檢查伺服器主機名稱、憑證鏈、私有 CA 信任和強制入口網站問題,恢復 ownCloud 桌面同步,而無需停用 TLS 驗證。

升級後清除 ownCloud 完整性警告

使用無效文件報告來識別不匹配的核心文件或應用程式簽名,恢復正確的發布文件,並安全地驗證完整性檢查。

使用 Docker Compose 安裝 ownCloud Infinite Scale

從官方 Compose 範例部署 ownCloud Infinite Scale,配置網域和持久存儲,然後驗證 TLS、容器和首次登入。

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

設定 S3NG 驅動程式、儲存桶權限、持久性元資料儲存和上傳大小,以便 ownCloud Infinite Scale 可以可靠地儲存檔案內容。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

檢查檔案狀態、配額、臨時磁碟空間、PHP 限制和代理逾時,找出 ownCloud 伺服器上傳接近完成時停止的原因。

安全地清除 ownCloud Apache .htaccess 警告

安全地清除 ownCloud Apache .htaccess 警告

僅對 ownCloud 的 Web 根目錄設定 AllowOverride All,驗證活動的 Apache 虛擬主機,然後安全地重新載入以恢復 .htaccess 規則。