Bug 1016799 - rhn-upgrade doc/satellite-and-os-upgrade-postgresql.txt needs update
rhn-upgrade doc/satellite-and-os-upgrade-postgresql.txt needs update
Status: CLOSED ERRATA
Product: Red Hat Satellite 5
Classification: Red Hat
Component: Upgrades (Show other bugs)
560
Unspecified Unspecified
medium Severity low
: ---
: ---
Assigned To: Milan Zazrivec
Lukas Pramuk
:
Depends On:
Blocks: sat560-triage
  Show dependency treegraph
 
Reported: 2013-10-08 13:24 EDT by DzungDo
Modified: 2013-12-17 02:05 EST (History)
4 users (show)

See Also:
Fixed In Version: rhn-upgrade-5.6.0.40-1
Doc Type: Bug Fix
Doc Text:
Cause: Consequence: Fix: This is a simple upgrade documentation fix explaining our customers in more details how to install rhn-upgrade package on their Satellite 5.6 machine. Result:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2013-12-12 05:45:31 EST
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description DzungDo 2013-10-08 13:24:31 EDT
Description of problem:

Step 3 (right before step 4) tells reader to either install rhn-upgrade or download the rhn-upgrade package for the newly installed Satellite 5.6 server. Should we install rhn-upgrade on the Satellite 5.6???

The rhn-upgrade is *NOT* part of the redhat-rhn-satellite-5.6-server-x86_64-6 channel, thus, we cannot install rhn-upgrade on this Satellite 5.6 server if we wanted to. 

If this rhn-upgrade would be a part of this channel (at this time it is not), we need to include instruction for reader to activate this Satellite 5.6 server before it can get the packages in the redhat-rhn-satellite-5.6-server-x86_64-6 channel.


Version-Release number of selected component (if applicable):
rhn-upgrade-5.6.0.38-1.el6sat.noarch.rpm

How reproducible:
always

Steps to Reproduce:
1. install rhn-upgrade-5.6.0.38-1.el6sat.noarch.rpm
2. look into the doc/ directory
3.

Actual results:
Instruction not clear

Expected results:


Additional info:
Comment 1 Milan Zazrivec 2013-10-08 15:08:16 EDT
Point 3 of satellite-upgrade-postgresql.txt (currently mentioned in
the bug report summary) contains instructions to convert Satellite filer
(/var/satellite).

Point 4 of the same document contains instructions to rebuild search
indexes.

Nowhere in this document have I found a single occurence of the "rhn-upgrade"
string.

Which document are we really talking about here?
Comment 2 DzungDo 2013-10-08 16:52:38 EDT
Package = rhn-upgrade.noarch 0:5.6.0.38-1.el6sat
File = /etc/sysconfig/rhn/satellite-upgrade/doc/satellite-and-os-upgrade-postgresql.txt

...
...
100 You will see a message advising you to create the satellite administrator
101 account. Ignore this message.
102
103 At the end of Red Hat Satellite installation, stop your Satellite by:
104
105     /usr/sbin/rhn-satellite stop
106
107 and if you installed embedded PostgreSQL variant, start the database with:
108
109     service postgresql start
110
111 Install the rhn-upgrade package on new server, either:
112
113     yum install rhn-upgrade
114
115 or by downloading the rpm manually and running:
116
117     rpm -ivh rhn-upgrade-*.rpm
118
119
120 4. Import database schema.
...
...
Comment 3 Milan Zazrivec 2013-10-09 04:47:21 EDT
All right, thank you.

True, you cannot yum install rhn-upgrade on a 5.6 Satellite. The package
is not available in 5.6 channels + disconnected Satellites do not have
that option.

The instructions here should be clearer, we could perhaps instruct our
customers to download & install the rhn-upgrade package manually.
Comment 6 Lukas Pramuk 2013-12-02 09:14:50 EST
VERIFIED. rhn-upgrade-5.6.0.41-1.el6sat.noarch

REPRO:
# less /etc/sysconfig/rhn/satellite-upgrade/doc/satellite-and-os-upgrade-{oracle,postgresql}.txt
...
Install the rhn-upgrade package on new server, either:

    yum install rhn-upgrade

or by downloading the rpm manually and running:

    rpm -ivh rhn-upgrade-*.rpm


4. {Import database schema.|Restore and upgrade database schema.}
...


FIX:
# less /etc/sysconfig/rhn/satellite-upgrade/doc/satellite-and-os-upgrade-{oracle,postgresql}.txt
...

Install the rhn-upgrade package on new server. Download the latest version
of rhn-upgrade from Red Hat Customer Portal and install the package by running:

    rpm -ivh rhn-upgrade-*.rpm


4. {Import database schema.|Restore and upgrade database schema.}
...
Comment 8 errata-xmlrpc 2013-12-12 05:45:31 EST
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2013-1828.html

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