13.8. Migrating the Database
If you have installed Red Hat Satellite 5 but later need to transition your database, use the following sections to guide your migration process.
13.8.1. Migrating from an Embedded Database to a Managed Database Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
The requirements to migrate from Embedded to Managed Database are:
- The Red Hat Satellite installation ISO
- A complete installation of Red Hat Satellite server with an Embedded Database (
satellite.example.com
) - A new system to host the Managed Database with Red Hat Enterprise Linux 6 installed (
manageddb.example.com
)
Procedure 13.2. Migrating to a Managed Database
- Shut down the Red Hat Satellite instance:
rhn-satellite stop
[root@satellite ~]# rhn-satellite stop
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Remove the
rhn-upgrade
if it exists on your server:yum remove rhn-upgrade
[root@satellite ~]# yum remove rhn-upgrade
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Use
db-control
to create a database backupmkdir ~/dbbackup db-control backup ~/dbbackup
[root@satellite ~]# mkdir ~/dbbackup [root@satellite ~]# db-control backup ~/dbbackup
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Copy the database backup from the Satellite server to the Managed Database server.
scp -r ~/dbbackup root@manageddb.example.com:~/.
[root@satellite ~]# scp -r ~/dbbackup root@manageddb.example.com:~/.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Install the Managed Database using the Red Hat Satellite installation ISO. For full instructions, see Section 4.2.6, “Installing the Managed Database”.
- After you have installed the Managed External Database, shut it down and back up the database configuration and access control files.
db-control stop cp /opt/rh/postgresql92/root/var/lib/pgsql/data/postgresql.conf ~/dbbackup cp /opt/rh/postgresql92/root/var/lib/pgsql/data/pg_hba.conf ~/dbbackup
[root@manageddb ~]# db-control stop [root@manageddb ~]# cp /opt/rh/postgresql92/root/var/lib/pgsql/data/postgresql.conf ~/dbbackup [root@manageddb ~]# cp /opt/rh/postgresql92/root/var/lib/pgsql/data/pg_hba.conf ~/dbbackup
Copy to Clipboard Copied! Toggle word wrap Toggle overflow You need to backup these files because the migration process will erase them. - Use
db-control
to restore the database backup to the Managed Database server.db-control restore ~/dbbackup
[root@manageddb ~]# db-control restore ~/dbbackup
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Restore the database configuration and access control files from backup to the Managed Database.
cp ~/dbbackup/postgresql.conf /opt/rh/postgresql92/root/var/lib/pgsql/data/postgresql.conf cp ~/dbbackup/pg_hba.conf /opt/rh/postgresql92/root/var/lib/pgsql/data/pg_hba.conf
[root@manageddb ~]# cp ~/dbbackup/postgresql.conf /opt/rh/postgresql92/root/var/lib/pgsql/data/postgresql.conf [root@manageddb ~]# cp ~/dbbackup/pg_hba.conf /opt/rh/postgresql92/root/var/lib/pgsql/data/pg_hba.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - On the Satellite server, edit the
/etc/rhn/rhn.conf
file and changedb_host
to the domain name of the Managed Database and set thedb_port
to 5432. For example:db_host = manageddb.example.com db_port = 5432
db_host = manageddb.example.com db_port = 5432
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Remove
postgresql92-postgresql
from the/etc/rhn/service-list
file on the Satellite server.sed -i 's/postgresql92-postgresql //g' /etc/rhn/service-list
[root@satellite ~]# sed -i 's/postgresql92-postgresql //g' /etc/rhn/service-list
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - On the Managed Database, edit the
/etc/rhn/rhn.conf
file and changedb_name
,db_user
,db_password
to reflect the same values in/etc/rhn/rhn.conf
on the Satellite server. For example:db_name = mydb db_user = mydbuser db_password = mydbpassword
db_name = mydb db_user = mydbuser db_password = mydbpassword
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Start the Managed Database instance using
db-control
.db-control start
[root@manageddb ~]# db-control start
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Remove the
postgresql92-server
andspacewalk-dobby
packages from the Satellite server.yum remove postgresql92-server spacewalk-dobby
[root@satellite ~]# yum remove postgresql92-server spacewalk-dobby
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Restart Red Hat Satellite.
rhn-satellite start
[root@satellite ~]# rhn-satellite start
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
The database is now migrated from an Embedded Database to a Managed Database.