CentOS 7遷移到Anolis OS 8

歡迎來到藍隊云技術小課堂，每天分享一個技術小知識。

1 遷移原理與注意事項

CentOS7.x到Anolis OS 8，無論是內核，基礎軟件包，工具鏈都發生了較大的變化。遷移工具需要考慮這些變化帶來的兼容性問題。OpenAnolis社區提供的遷移工具leapp包含了遷移評估，遷移實施，配置還原等步驟，用于實現CentOS7.x到Anolis OS 8的就地遷移。

1.1 遷移評估

leapp掃描待遷移系統，搜集內核，軟件包，系統配置基礎信息，同時與目標系統（Anolis OS）進行對比分析，對于不兼容項給出影響分析和解決方案。如內核角度給出Anolis OS 中不再支持的內核特性，硬件驅動；軟件角度給出系統命令的變更項，提示用戶適配業務程序。leapp的遷移評估報告會給出當前系統中所有可能影響到遷移的影響項目，當這些影響項目都被解決后，用戶才能夠繼續做遷移實施。同時業務程序可根據評估報告中的兼容性提示來適配遷移業務程序。

1.2 遷移實施

leapp首先搜集當前的系統信息，記錄需要在重啟后恢復的配置（如selinux狀態）。遷移實施過程中，工具首先按照當前系統安裝的軟件包列表，并根據CentOS7.x到Anolis OS 8的軟件包映射關系，從Anolis OS repo上提前下載遷移所需要的軟件包，并基于Anolis OS的軟件包制作upgrade-initramfs，在下一次重啟后，系統自動進入upgrade-initramfs，并觸發所有軟件包的就地升級。在所有的軟件包就地升級完成后，自動重啟進入系統配置還原階段，待所有的信息都完成配置后，系統重啟進入新的OS，完成OS的就地遷移。

2 部署遷移工具

選項一 從本地 yum 源安裝遷移工具

1. 如果待遷移系統無法訪問龍蜥 mirror，首先建議在內網搭建一套本地yum源。(如何做本地yum源 用戶名： rsync_user ， 密碼： Rsync@2020) ，然后通過本地源安裝遷移工具。假設本地源地址為 http:///local.repo.com/anolis ， 則下載遷移工具軟件源：

wget http:///local.repo.com/anolis/migration/anolis-migration.repo -O /etc/yum.repos.d/anolis-migration.repo

2. 然后執行下述命令將 /etc/yum.repos.d/anolis-migration.repo 里面的baseurl地址替換為本地源地址。

sed -i "s#baseurl=https:///mirrors.openanolis.cn/#baseurl=http:///local.repo.com/#" /etc/yum.repos.d/anolis-migration.repo
sed -i "s#gpgkey=https:///mirrors.openanolis.cn/#gpgkey=http:///local.repo.com/#" /etc/yum.repos.d/anolis-migration.repo

3. 安裝遷移工具：

yum install -y python-pip
yum remove -y python-requests python-urllib3; /usr/bin/pip2 uninstall requests urllib3 -y 2>/dev/null || echo "not installed"
yum -y install leapp

備注：重新安裝 python-requests 和 python-urllib3 是為了解決遷移過程中可能發生的軟件包升級沖突。

4. 執行下述命令將 /etc/leapp/files/leapp_upgrade_repositories.repo 里面的baseurl地址替換為本地源地址。

leapp customrepo --seturl http:///local.repo.com/<version_number>

選項二 從社區 yum 源（mirrors.openanolis.cn) 安裝遷移工具

1. 如果待遷移系統可以聯網，則下載遷移工具軟件源：

wget https:///mirrors.openanolis.cn/anolis/migration/anolis-migration.repo -O /etc/yum.repos.d/anolis-migration.repo

2. 安裝遷移工具：

yum install -y python-pip
yum remove -y python-requests python-urllib3; /usr/bin/pip2 uninstall requests urllib3 -y 2>/dev/null || echo "not installed"
yum -y install leapp

3 遷移前評估

成功部署工具后，運行工具的評估命令來對系統環境進行掃描評估：

leapp preupgrade --no-rhsm

上述命令是默認評估遷移到帶 ANCK 內核的龍蜥OS，如果你想評估遷移到帶 RHCK 內核的龍蜥OS請執行下面的命令

leapp preupgrade --no-rhsm --disablerepo=anolis_plus

3.1 查看評估報告

評估命令執行完成后，會生成評估報告，在/var/log/leapp/leapp-report.txt中,報告中詳細列舉出當前OS與目標OS系統間的升級分析報告，每一個報告點都包含影響等級，影響范圍以及解決方案。

當評估工具認為報告點影響到了OS的就地升級，這些報告點問題就必須解決，否則無法實施就地遷移。

報告樣式如下，包含影響等級，影響概述，影響詳細信息，推薦解決方案。

上述報告提示用戶在Anolis OS中默認沒有python命令，系統中默認提供的是不向前兼容的python3，并且python2只是有限支持，用戶需要盡快將業務程序盡快遷移到使用python3。同時報告也給出了解決方案來使系統默認提供python命令。

3.2 基于評估報告處理遷移前問題

遷移評估報告中一旦遇到影響到就地遷移的因素，會禁止做遷移實施，將這些影響因素都解決后才能夠繼續實施遷移。如果遇到影響遷移實施的因素，遷移評估結果顯示如下：

按照報告的提示，在/var/log/leapp/leapp-report.txt可以獲取到詳細的報告信息，同時UPGRADE INHIBITED給出的影響升級的因素也可以在/var/log/leapp/answerfile文件中查看。

# cat /var/log/leapp/answerfile

[remove_pam_pkcs11_module_check]

# Title:              None

# Reason:             Confirmation

# =================== remove_pam_pkcs11_module_check.confirm ==================

# Label:              Disable pam_pkcs11 module in PAM configuration? If no, the upgrade process will be interrupted.

# Description:        PAM module pam_pkcs11 is no longer available in Anolis 8 since it was replaced by SSSD.

# Type:               bool

# Default:            None

# Available choices: True/False

# Unanswered question. Uncomment the following line with your answer

# confirm =

解決方案，在新的Anolis OS 8中不再支持pam_pkcs11，所以我們直接選擇刪除該不支持的選項：

leapp answer --section remove_pam_pkcs11_module_check.confirm=True

Anolis OS 8中默認的PermitRootLogin行為是prohibit-password，禁止root用戶登陸，如果不顯式設置PermitRootLogin yes則會在遷移后影響root用戶密碼登陸。

解決方案：修改sshd_config 配置文件，允許root用戶登錄

sed -i 's/#PermitRootLogin yes/PermitRootLogin yes/' /etc/ssh/sshd_config

解決了上述影響因素后，可以再次執行leapp preupgrade --no-rhsm或者 leapp preupgrade --no-rhsm --disablerepo=anolis_plus 再次評估是否有影響遷移的因素。若沒有影響遷移的因素，結果如下：

3.2.4 遷移實施

解決了評估報告中所有影響就地遷移的問題后，即可實施遷移。

leapp upgrade --no-rhsm

上述命令是默認遷移到帶 ANCK 內核的龍蜥OS，如果你想遷移到帶 RHCK 內核的龍蜥OS請執行下面的命令

leapp upgrade --no-rhsm --disablerepo=anolis_plus

該步驟涉及到從目標系統（Anolis OS repo）上下載軟件包用于就地升級，確保待遷移環境能夠正常訪問Anolis OS repo。

上述命令執行成功后，還可以通過/var/log/leapp/leapp-report.txt查看遷移報告，該報告除了包含評估報告外，還包含對目標系統repo的可行性評估，如果目標系統軟件包不符合遷移要求，會給出提示。

以下圖為例，Anolis OS 8中不再支持kde，評估報告中給出了這樣的提示：

一切就緒，執行結果如下：

接下來需要執行  reboot  命令，reboot后OS進入一個隔離環境自動進行實質的遷移操作。

待系統遷移完成后，OS 會再次自動重啟進入遷移后的系統。這一步驟涉及到2次OS重啟以及相關的遷移操作故耗時較長。

3.2.5 遷移后驗證

就地遷移完成后，進入新的操作系統，可以通過/var/log/leapp/leapp-report.txt查看遷移報告，報告中會包含就地遷移以及遷移后的系統詳細報告信息，也可以通過/var/log/leapp/leapp-upgrade.txt查看就地遷移的執行日志。

查看報告/var/log/leapp/leapp-report.txt可以獲取升級過程中的一些信息，比如因為某些原因軟件包沒有升級成功，需要手動處理這些軟件包。

/var/log/leapp/leapp-upgrade.txt則記錄了整個遷移過程，

遷移完成后，可通過一系列基礎操作查看OS版本，如/etc/os-release查看OS版本。

遷移完成后，應用程序可以通過自身的指標查看是否能夠正常運行。

4 注意

1）執行“leapp upgrade --no-rhsm”時出現因網絡問題下載軟件包失敗，如何解決？

修改/etc/leapp/files/leapp_upgrade_repositories.repo文件，將mirrors.openanolis.cn替換為mirrors.aliyun.com

2)  待遷移環境需要配置代理訪問外網，leapp運行過程中下載軟件包報錯，如何解決？

leapp執行過程中真正生效的repo是/etc/leapp/files/leapp_upgrade_repositories.repo，修改/etc/leapp/files/leapp_upgrade_repositories.repo 文件，為每個repo配置代理，

3）如何確認遷移前后軟件包變化？

使用leapp進行OS遷移后，可通過遷移日志/var/log/leapp/leapp-upgrade.log查看軟件包更新詳細信息。

4）就地遷移失敗是否可回滾？

遷移工具不支持回滾，遷移失敗無法恢復到遷移初始狀態，遷移前務必做好系統備份。

藍隊云官網上擁有完善的技術支持庫可供參考，大家可自行查閱，更多技術問題，可以直接咨詢。同時，藍隊云整理了運維必備的工具包免費分享給大家使用，需要的朋友可以直接咨詢。

更多技術知識，藍隊云期待與你一起探索。