Red Hat Bugzilla – Bug 478966
Update documentation in rhn-upgrade
Last modified: 2009-08-27 13:37:52 EDT
Description of problem:
Upgrade documentation contained in rhn-upgrade package needs to be
updated in at least following:
* Say 5.3 instead of 5.2 (where applicable)
* schema upgrade is now being done by spacewalk-schema-upgrade scripts
Version-Release number of selected component (if applicable):
Not to forget mentioning update of /var/satellite between versions 5.2 and 5.3.
Perhaps replacing strings /etc/init.d/rhn-satellite with
Indexes for search could be an issue in the future. I don't recall changes to package search in 5.3, so this is probably not going to impact 5.2 -> 5.3, but as a general rule of thumb it'd be a good idea to regenerate the lucene indexes after each upgrade.
To regenerate the indexes run:
That will stop rhn-search and wipe indexes, then upon next startup rhn-search will create new indexes.
As of Spacewalk 0.4, spacewalk-setup needs
semanage fcontext -a -t spacewalk_data_t ...
if /var/satellite is in different directory. We might make spacewalk-setup more clever in 0.5 but as of now, this ought to be documented.
tagged & built rhn-upgrade-184.108.40.206-1
The part about rebuilding search indexes was added in
86d424bd15c7c8391cb3992b8b2a3e6cc766b95c (satellite.git, SATELLITE-5.3).
tagged & built rhn-upgrade-220.127.116.11-1
5.2 references look sane:
/etc/sysconfig/rhn/satellite-upgrade/README:Satellite 5.2 introduced support for Oracle 10g. If you are using embedded
/etc/sysconfig/rhn/satellite-upgrade/README: - Satellite 5.2 and before: service rhn-satellite restart
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1a.txt: ** if you are upgrading from Satellite v5.2, run as root:
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1a.txt: NOTE 1: this step is necessary if you are upgrading from Satellite 5.2.x
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1a.txt: If you are upgrading from Satellite 5.2.0 or earlier, it is necessary to
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1b.txt: 4AS + Satellite 5.2
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1b.txt: 5 Server + Satellite 5.2
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1b.txt: NOTE 1: this step is necessary if you are upgrading from Satellite 5.2.x
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1b.txt: If you are upgrading from Satellite 5.2.0 or earlier, it is necessary to
'spacewalk-schema-upgrade' is referenced:
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1a.txt: Upgrade your database schema using spacewalk-schema-upgrade command
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1a.txt: (see manual page for spacewalk-schema-upgrade for more information):
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1b.txt: Upgrade your database schema using spacewalk-schema-upgrade command
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1b.txt: (see manual page for spacewalk-schema-upgrade for more information):
Multiple references to "Convert /var/satellite directory"
Appropriate reference changes from "service rhn-satellite" to "/usr/sbin/rhn-satellite"
Now includes "cleanindex":
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1a.txt: service rhn-search cleanindex
/etc/sysconfig/rhn/satellite-upgrade/rhn-satellite-5-upgrade-scenario-1b.txt: service rhn-search cleanindex
There is no reference to " semanage fcontext -a -t spacewalk_data_t ..."
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.