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