preupg man page

preupg — Preupgrade assistant performs assessment of the system from the "upgradeability" point of view

Synopsis

preupg used in case of one installed contents on source system

preupg [-l, --list-contents]

preupg [-d, --debug] [--skip-common] [-s, --scan PATH] [-m, --mode MODE] [--force] [--text] [--kickstart] [--dst-arch]

preupg [-v, --verbose] [--riskcheck]

preupg [-c, --contents PATH]

preupg [--cleanup]

Description

preupg is the main binary of Preupgrade Assistant.

Options

-c, --contents PATH
Generates a content for preupgrade assistant.
-d, --debug
Makes preupgrade assistant log lots of debugging information.
--cleanup
Clean all files created by preupg about previous state of the machine.
--force
Suppress user interaction.
--kickstart
Generate kickstart.
-l, --list
Shows list of installed contents
-m, --mode MODE
Select one (or both) from the possible modes: migrate or upgrade. Both modes are used by default. upgrade is used for in-place upgrades on the same machine by fedup or redhat-upgrade-tool. migrate is used for migration with kickstart with new clean installation, with settings of the new system as close as possible to settings of original system.
-s, --scan PATH
Executes selected assessment taken from list option.
--skip-common
Skips generating common log files used during assessment.
--riskcheck
Returns value which depends on INPLACE RISK results. If verbose mode is mentioned then shows all inplace risks generated during assessment. Return values are 0 for SLIGHT, MEDIUM risk or 1 for HIGH risk or 2 for EXTREME risk.
--text
Convert HTML results to text form by elinks, lynx or w3m.
-v, --verbose
Shows more information during assessment. Verbose can be repeated more times.
--dst-arch
Specify destination architecture for migrations. Allowed options are: i386-x86_64 or ppc-ppc64.

Return States

preupg command returns several return values.

Possible return values are:

0 - preupg works properly and was successful even modules went properly. Modules exits with results PASS.

10 - preupg works properly but modules finishes with 10. Modules exits with results NOT_APPLICABLE, NOT_CHECKED, NOT_SELECTED.

11 - preupg works properly but modules finishes with 11. Modules exits with results INFORMATIONAL.

12 - preupg works properly but modules finishes with 12. Modules exits with results FIXED, NEEDS_INSPECTION or NEEDS_ACTION.

13 - preupg works properly but modules finishes with 13. Modules exits with results FAILED.

14 - preupg works properly but modules finishes with 14. Modules exits with results UNKNOWN.

15 - preupg works properly but modules finishes with 15. Modules exits with results ERROR.

20 - preupg does not find a proper upgrade scenario.

21 - preupg is executed with parameters mode and select-rules. This is not allowed.

22 - preupg is executed with parameters riskcheck, cleanup and kickstart. This options are not allowed together.

23 - preupg has to be executed as root.

24 - preupg has to be executed before kickstart generation.

25 - openscap and openscap-engine-sce are not installed on the system.

26 - you specified a text convertor which does not exist. Allowe convertors are w3m, lynx and elinks.

27 - File /usr/share/preupgrade/common/scripts.txt is missing. Preupgrade-assistant is not installed properly. Reinstall it.

28 - We have detected some trouble with sending report to WEB-UI. Check if it is installed.

Notes

All common log files are stored in /var/cache/preupgrade/common directory. Assessment results are stored in /root/preupgrade directory. Tarballs with all assessments are stored in directory /root/preupgrade-results.

Authors

Petr Hracek, <phracek@redhat.com> (man page)

Info

2015-03-01 Linux User's Manual