| Summary: | Install guide 5.1.2: Incorrect upgrade instructions | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Virtualization Manager | Reporter: | Aaron Weitekamp <aweiteka> |
| Component: | Documentation | Assignee: | Zac Dover <zdover> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | ecs-bugs |
| Severity: | high | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | 3.3.0 | CC: | acathrow, gklein, yeylon, zdover |
| Target Milestone: | --- | ||
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | Type: | Bug | |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
Description of problem: rhevm-upgrade has been obsoleted by engine-setup Install Guide section 5.1.2 should be updated with this change. It would be good to call out the undocumented use of this tool (see `man engine-setup` output below) and that RHEV-M will reboot. Version-Release number of selected component (if applicable): rhevm-setup.noarch 0:3.3.0-0.37.beta1.el6ev How reproducible: Steps to Reproduce: 1. yum update rhevm-setup 2. rhevm-upgrade Actual results: [root@rhs-rhevm1 ~]# rhevm-upgrade rhevm-upgrade is obsoleted by engine-setup. please run engine-setup for upgrading product or update settings. Additional info: ### # man page ### [root@rhs-rhevm1 ~]# man engine-setup engine-setup(8) BSD System Manager\u2019s Manual engine-setup(8) NAME engine-setup - Setup and configuration utility for Open Virtualization Manager. SYNOPSIS engine-setup [options] DESCRIPTION The engine-setup utility performs setup and configuration of Open Virtualization Manager. Configuration values must be provided interactively, as command line options, or using an answer file. Following a successful run of the engine-setup utility Open Virtualization Manager is installed and ready for use. Where a run of the engine-setup utility is unsuccessful, comprehensive logging and error informa- tion is output both to standard output and to the engine-setup log file. OPTIONS --log=file write log to this file. --config=file Load configuration files. --config-append=file Load extra configuration files. --offline Offline mode. --generate-answer=file Generate answer file. --jboss-home=dir Use this jboss. BUGS Report bugs at https://bugzilla.redhat.com/. POSIX-compatible August 25, 2013 POSIX-compatible ### # upgrade output ### [root@rhs-rhevm1 ~]# engine-setup [ INFO ] Stage: Initializing [ INFO ] Stage: Environment setup Configuration files: ['/etc/ovirt-engine-setup.conf.d/10-packaging.conf', '/etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf'] Log file: /var/log/ovirt-engine/setup/ovirt-engine-setup-20131203170120.log Version: otopi-1.1.2 (otopi-1.1.2-1.el6ev) [ INFO ] Stage: Environment packages setup [ INFO ] Stage: Programs detection [ INFO ] Stage: Environment setup [ INFO ] Stage: Environment customization --== PACKAGES ==-- [ INFO ] Checking for product updates... Setup has found updates for some packages, do you wish to update them now? (Yes, No) [Yes]: [ INFO ] Checking for an update for Setup... --== NETWORK CONFIGURATION ==-- --== DATABASE CONFIGURATION ==-- --== OVIRT ENGINE CONFIGURATION ==-- Skipping storing options as database already prepared --== PKI CONFIGURATION ==-- PKI is already configured --== APACHE CONFIGURATION ==-- --== SYSTEM CONFIGURATION ==-- --== END OF CONFIGURATION ==-- [ INFO ] Stage: Setup validation During execution engine service will be stopped (OK, Cancel) [OK]: [WARNING] Less than 16384MB of memory is available [ INFO ] Cleaning stale zombie tasks --== CONFIGURATION PREVIEW ==-- Database name : engine Database secured connection : False Database host : localhost Database user name : engine Database host name validation : False Datbase port : 5432 NFS setup : True NFS mount point : /var/lib/exports/iso Firewall manager : iptables Configure WebSocket Proxy : True Host FQDN : rhs-rhevm1.cloud.lab.eng.bos.redhat.com Set application as default page : True Configure Apache SSL : True Upgrade packages : True Please confirm installation settings (OK, Cancel) [OK]: [ INFO ] Cleaning async tasks and compensations [ INFO ] Checking the DB consistency [ INFO ] Stage: Transaction setup [ INFO ] Stopping engine service [ INFO ] Stopping websocket-proxy service [ INFO ] Stage: Misc configuration [ INFO ] Fixing DB inconsistencies [ INFO ] Stage: Package installation [ INFO ] Yum Status: Downloading Packages [ INFO ] Yum Download/Verify: rhevm-3.3.0-0.37.beta1.el6ev.noarch Broadcast message from root.lab.eng.bos.redhat.com (unknown) at 17:02 ... The system is going down for halt NOW! Connection to rhs-rhevm1.cloud.lab.eng.bos.redhat.com closed by remote host. Connection to rhs-rhevm1.cloud.lab.eng.bos.redhat.com closed.