Bug 1037737 - Install guide 5.1.2: Incorrect upgrade instructions
Summary: Install guide 5.1.2: Incorrect upgrade instructions
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 3.3.0
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ---
: ---
Assignee: Zac Dover
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-12-03 17:15 UTC by Aaron Weitekamp
Modified: 2014-05-27 01:28 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed:
oVirt Team: ---
Target Upstream Version:


Attachments (Terms of Use)

Description Aaron Weitekamp 2013-12-03 17:15:15 UTC
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.


Note You need to log in before you can comment on or make changes to this bug.