Amazon Linux2 プレアップグレードアシスタントをやってみた



こんにちは オペレーション部 園部です。

今日は、アプリケーションの移植を前提に、実行環境のOSを Amazon Linux(以降、AL1) から Amazon Linux 2(以降、AL2) へ移行する際の影響を確認するプレアップグレードアシスタント(パッケージ、ライブラリ、サービス、コマンドラインオプション、設定ファイルの非互換性をチェック)を使ってみました。

Amazon Linux 2 プレアップグレードアシスタントの発表


また現在、AL1 から AL2 へ移行するには、インプレースアップグレードなどはサポートされておりません。 (良い方法を知っている方は、教えてください!)

Q: 既存バージョンの Amazon Linux AMI から Amazon Linux 2 へのインプレースアップグレードを実行できますか? いいえ。既存バージョンの Amazon Linux から Amazon Linux 2 へのインプレースアップグレードはサポートされていません。アプリケーションの移行前に、新しくインストールした Amazon Linux 2 でテストすることをお勧めします。

Q: Amazon Linux AMI を実行しているインスタンスから Amazon Linux 2 へのローリングアップグレードを実行できますか? いいえ。Amazon Linux を実行しているインスタンスがローリングアップデートメカニズムで Amazon Linux 2 にアップグレードされることはありません。そのため、既存のアプリケーションの中断も発生しません。詳細については、Amazon Linux のドキュメントと移行ツールを参照してください。






  • インスタンスタイプ:t2.micro
  • AMI ID:amzn-ami-hvm-2018.03.0.20181129-x86_64-gp2 (ami-00a5245b4816c38e6)
  • サブネット:パブリックサブネット(外部と直接通信が可能な設定のサブネット)


以下のコマンドで、プレアップグレードアシスタントモジュール をインストールします。

$ sudo yum install -y preupgrade-assistant preupgrade-assistant-al1toal2


以下のコマンドで、プレアップグレードアシスタントを実行します。 (AMIから作成して、何も変更していないインスタンスで)数分で完了しました。

$ sudo preupg
The Preupgrade Assistant is a diagnostics tool
and does not perform the actual upgrade.
Do you want to continue? [Y/n]
Gathering logs used by the Preupgrade Assistant:
All installed packages : 01/10 ...finished (time 00:00s)
All changed files : 02/10 ...finished (time 00:21s)
Changed config files : 03/10 ...finished (time 00:00s)
All users : 04/10 ...finished (time 00:00s)
All groups : 05/10 ...finished (time 00:00s)
Service statuses : 06/10 ...finished (time 00:00s)
All installed files : 07/10 ...finished (time 00:00s)
All local files : 08/10 ...finished (time 00:00s)
All executable files : 09/10 ...finished (time 00:00s)
Red Hat signed packages : 10/10 ...finished (time 00:00s)
Assessment of the system, running checks / SCE scripts:
001/006 ...done (Grub 2) (time: 00:00s)
002/006 ...done (mysql to mariadb) (time: 00:00s)
003/006 ...done (Extras provide packages) (time: 00:00s)
004/006 ...done (Python Native Packages) (time: 00:03s)
005/006 ...done (Release Lock) (time: 00:00s)
006/006 ...done (SoName drift) (time: 00:00s)
The assessment finished (time 00:04s)
Result table with checks and their results for 'main contents':
|Grub 2 |notapplicable |
|mysql to mariadb |notapplicable |
|Extras provide packages |informational |
|Release Lock |informational |
|SoName drift |informational |
|Python Native Packages |needs_inspection |
The tarball with results is stored in '/root/preupgrade-results/preupg_results-190313025245.tar.gz' .
The latest assessment is stored in the '/root/preupgrade' directory.
Summary information:
We have found some potential risks.
Read the full report file '/root/preupgrade/result.html' for more details.
Please ensure you have backed up your system and/or data
before doing a system upgrade to prevent loss of data in
case the upgrade fails and full re-install of the system
from installation media is needed.
Upload results to UI by the command:
e.g. preupg -u -r /root/preupgrade-results/preupg_results-190313025245.tar.gz .


コマンドの実行結果に、以下のように出力されます。 6項目について結果が表示されており、Python に関して対応が必要だという結果が出ています。

result table with checks and their results for 'main contents':
|Grub 2 |notapplicable |
|mysql to mariadb |notapplicable |
|Extras provide packages |informational |
|Release Lock |informational |
|SoName drift |informational |
|Python Native Packages |needs_inspection |



結果を集約するWEB-UI(preupgrade-assistant-ui)へのアップロードすることでも 結果を表示できますが、今回はファイルをローカルに転送して、ブラウザ(chrome)で開きます。

  • 結果の一覧が表示されます

  • 各チェック内容の詳細や理由が記載されています



preupg コマンドのオプションを確認したところ、以下のようになっています。

$ sudo preupg --help
Usage: preupg [options]

  --version             show program's version number and exit
  -h, --help            Show help message and exit.
  -S, --skip-common     Skip generating files containing information about the
                        system. For assessing the system these files are
                        needed (by modules) but in the case the system remains
                        the same (the same installed packages, configuration
                        files not touched, etc.) they can be reused from the
                        previous runs of Preupgrade Assistant.
  -d, --debug           Turn on debugging mode.
  -u, --upload          Upload a system assessment result to Preupgrade
                        Assistant WEB-UI.
  -r TARBALL, --results=TARBALL
                        Provide path to a system assessment result tarball
                        which is to be uploaded to WEB-UI. By default, the
                        result tarballs can be found in /root/preupgrade.
  -l, --list-contents-set
                        List all the available sets of modules. They are
                        searched for in /usr/share/preupgrade.
                        Provide name of the set of modules which are to be
                        used for assessing the system. By default, if there is
                        just one set in /usr/share/preupgrade, Preupgrade
                        Assistant uses that one. Use --list-contents-set
                        option to get a list of possible values.
                        Provide path to all-xccdf.xml of the set of modules
                        which is to be used for assesing the system. By
                        default, if there is just one set in
                        /usr/share/preupgrade, Preupgrade Assistant uses that
                        one. Option --scan works similarly.
  --riskcheck           Return the highest reported level of risk or result
                        related to system upgrade. Run Preupgrade Assistant
                        first - assessment of the system needs to be performed
                        before using this option. When this option is used in
                        concert with --verbose option, summary of the risks
                        are printed to STDOUT. If the --verbose option is used
                        once, just HIGH and EXTREME risks are printed. If it
                        is used twice, all the risks are printed.
                        Return codes:
                        0 ... SLIGHT or MEDIUM risk or needs_inspection,
                        fixed, informational, not_applicable, not_selected,
                        not_checked or pass result.
                        1 ... HIGH risk or needs_action result.
                        2 ... EXTREME risk or error or fail result.
  --force               Suppress user interaction.
  --text                Generate plain text assessment report alongside XML
                        and HTML reports. The text report is converted from
                        HTML using elinks, lynx or w3m tool.
  -v, --verbose         Show more information during the assessment.
  --cleanup             Remove all the files created by previous runs of
                        Preupgrade Assistant.
  -m MODE, --mode=MODE  Select what you plan to do with the system after
                        performing its assessment by Preupgrate Assistant -
                        migration or upgrade. Both modes are selected by
                        default. This option may only affect behaviour of the
                        modules - they can provide different results when only
                        one mode is selected. Use one of these values:
                        migrate, upgrade. It may be that modules behave the
                        same no matter what mode is selected.
  --select-rules=RULES  Execute just a subset of modules out of a module set.
                        Multiple modules are to be separated by a comma.
  --list-rules          List all the modules available within a module set.
  --dst-arch=ARCH       Specify an architecture of the system to be migrate
                        to. Available option are: x86_64, ppc64. Use of the
                        option is expected on 32-bit systems as by the release
                        of RHEL 7, 32-bit hardware support has been dropped.
  --old-report-style    Generate report with simpler style than the default.



$ sudo preupg --list-rules


モジュール等と同じディレクトにREADMEがあります。 動作について、一部記載があります。

$ sudo cat /root/preupgrade/README
Preupgrade Assistant Purpose
The Preupgrade Assistant is a framework designed to run the Preupgrade Assistant modules, which analyze the system for possible in-place upgrade limitations. It is based on a modular system, with each module performing a separate test, checking for package removals, incompatible obsolete packages, changes in libraries, users, groups, services, or incompatibilities of command-line options or configuration files. It is able to execute post-upgrade scripts to finalize complex tasks after the system upgrade. Apart from performing the in-place upgrades, the Preupgrade Assistant is also capable of migrating the system. It then produces a report, which assists you in performing the upgrade itself by outlining potential problem areas and by offering suggestions about mitigating any possible incompatibilities. The Preupgrade Assistant utility is a Red Hat Upgrade Tool prerequisite for completing a successful in-place upgrade to the next major version of Red Hat Enterprise Linux.

Preupgrade Assistant Usage
At the moment, only a CLI interface and limited functionality is available.

Follow these steps to use the Preupgrade Assistant:
1) Run "preupg -l" command - it lists all available modules for
        preupgrade-assistant (as the system is based on a plug-in, there might be
        modules from different sources in the future). If nothing is shown,
        install the preupgrade-assistant modules package.
2) If you have RHEL6_7 modules available, run "preupg -s RHEL6_7"
3) Wait until the analysis finishes (it can take several minutes)
4) Review the report stored as /root/preupgrade/result.html (and possibly
       the files stored at /root/preupgrade) . Especially check for any in-place
        upgrade risks (as described further in this document).

The /root/preupgrade file&directory structure

This directory contains the data from the last Preupgrade Assistant run.
The files are:
result.html - a file with the final migration assessment report in a human-readable
         form (the functionality is only listed)
result.xml - a file with the final migration assessment report in a machine-readable form
README - this file
results.tar.gz - a tarball with all the files in the /root/preupgrade directory

The directories are:
cleanconf - a directory with all user-modified configuration files, which were
          checked for the compatibility by the Preupgrade Assistant. These files
          can be safely used on Red Hat Enterprise Linux 7 system (some of these files might need
          a postupgrade.d scripts execution).
dirtyconf - a directory with all user-modified configuration files, which were not
          checked for the compatibility by the Preupgrade Assistant. These might
          require an admin review after the Red Hat Enterprise Linux 7 installation/upgrade.
kickstart - a directory with various files needed for generating
          Kickstart used to clone the system. See the README file
          in the kickstart directory for the file descriptions.
postupgrade.d - contains various scripts which are supposed to be executed
          AFTER the upgrade to Red Hat Enterprise Linux 7. These scripts should NEVER be used
          on the Red Hat Enterprise Linux 6 system.
RHEL6_7 - just a "debugging" directory - will be removed later. Ignore, unless you see an "Error" plug-in exit status.

Possible exit codes explanation
Every single plug-in has its own exit code. The administrator needs to check
at least those with a FAIL result before starting the in-place upgrade. The FIXED results
should be checked after the in-place upgrade - to finish the Red Hat Enterprise Linux 7 upgrade

The possible exit codes are:
 * PASS = everything is fine, no incompatibilities/issues detected
 * FAIL = an incompatibility/issue that needs to be reviewed by the admin was detected
          FAIL does not necessarily mean that the in-place upgrade will fail, but might
          result in a not 100% functional system
 * FIXED = an incompatibility was detected, but the Preupgrade Assistant was able
          to find an automated solution. Some of the fixes may require running
          postupgrade.d scripts after the upgrade. The fixed configs are available
          in the /root/preupgrade/cleanconf directory. The Preupgrade Assistant does not
          handle the fixes automatically at the moment.
 * INFORMATIONAL = nice to have information for admins (e.g. removed options
          in some common tools which could cause malfunctions of their scripts)
 * NOT_APPLICABLE = the package which was to be tested by the check is not
          installed on the system
 * ERROR = it is not expected to occur and usually means an error in the Preupgrade Assistant
          framework. All such errors should be reported to the Red Hat
          Preupgrade Assistant team.

In-place upgrade risk explanations
There are several levels of in-place upgrade risks. Any level higher than
"slight" means you will get a not 100% functional upgraded system, although the
in-place upgrade tool "redhat-upgrade-tool" may pass.

The available risk assessment levels are:
 * None - Default. It can be used as an indicator for some checks. It is not
          necessary to enter these values.
 * Slight - We assessed this field and have not found any issues. However,
          there is still a risk that not all variants have been covered.
 * Medium - It is likely that the area will cause a problem in the case of the in-place
          upgrade. It needs to be checked by the administrator after
          the in-place upgrade and after the system was monitored for
          some time.
 * High - The in-place upgrade cannot be used safely without the administrator's
          assistance. This typically involves some known broken scenario,
          existing 3rd party packages. After the administrator manually fixes
          the issue, it should be possible to perform the in-place upgrade, but it
          is not recommended.
 * Extreme - We found an incompatibility which makes the in-place upgrade
          impossible. It is recommended to install a new system with the help
          of the Preupgrade Assistant remediations.


AL1 は、最新バージョン(2018.03) のセキュリティ更新提供が2020年6月30日となっています。

引用:Amazon Linux 2 プレアップグレードアシスタントの発表

さて、どうしたものかを悩んでいる方は、まずは既存インスタンスをコピーして(モジュールをインストールするため可能であればコピーしたインスタンスへの実行をお勧めします。) 今回のプレアップグレードアシスタントを実行し、影響度を確認するのもの良いかもしれません。