Chapter 3. Migrating from internal Satellite databases to external databases

Procedure

1. On your new database server, install PostgreSQL:

   # dnf install postgresql-server postgresql-contrib

2. Initialize the PostgreSQL database:

   # postgresql-setup --initdb

3. Edit the /var/lib/pgsql/data/postgresql.conf file:

   # vi /var/lib/pgsql/data/postgresql.conf

   Note that the default configuration of external PostgreSQL needs to be adjusted to work with Satellite. The base recommended external database configuration adjustments are as follows:

   • checkpoint_completion_target: 0.9
   • max_connections: 500
   • shared_buffers: 512MB
   • work_mem: 4MB

4. Remove the # and edit to listen to inbound connections:

   listen_addresses = '*'

5. Add the following line to the end of the file to use SCRAM for authentication:

   password_encryption=scram-sha-256

6. Edit the /var/lib/pgsql/data/pg_hba.conf file:

   # vi /var/lib/pgsql/data/pg_hba.conf

7. Add the following line to the file:

     host  all   all   Satellite_ip/32   scram-sha-256

8. Start and enable the PostgreSQL service:

   # systemctl enable --now postgresql

9. Update the firewall configuration. For example, using the firewall-cmd command:

   1. Open the postgresql port:

      # firewall-cmd --add-service=postgresql

   2. Make the changes persistent:

      # firewall-cmd --runtime-to-permanent

10. Switch to the postgres user and start the PostgreSQL client:

    $ su - postgres -c psql

11. Create three databases and dedicated roles: one for Foreman, one for Candlepin, and one for Pulp:

    CREATE USER "foreman" WITH PASSWORD 'Foreman_Password';
    CREATE DATABASE foreman OWNER foreman;
    CREATE USER "candlepin" WITH PASSWORD 'Candlepin_Password';
    CREATE DATABASE candlepin OWNER candlepin;
    CREATE USER "pulp" WITH PASSWORD 'Pulpcore_Password';
    CREATE DATABASE pulpcore OWNER pulp;

12. Exit the postgres user:

    # \q

Procedure

1. On Satellite Server, stop all Satellite services except for PostgreSQL:

   # satellite-maintain service stop --exclude postgresql

2. Create your target directory for the Satellite backup:

   # mkdir /var/My_Migration_Backup_Directory

3. Back up the internal databases:

   # satellite-maintain backup online \
   --preserve-directory \
   --skip-pulp-content \
   /var/My_Migration_Backup_Directory

4. Transfer the data to the new external databases:

   PGPASSWORD='Foreman_Password' pg_restore --host=postgres.example.com --username=foreman --dbname=foreman < /var/My_Migration_Backup_Directory/foreman.dump
   PGPASSWORD='Candlepin_Password' pg_restore --host=postgres.example.com --username=candlepin --dbname=candlepin < /var/My_Migration_Backup_Directory/candlepin.dump
   PGPASSWORD='Pulpcore_Password' pg_restore --host=postgres.example.com --username=pulp --dbname=pulpcore < /var/My_Migration_Backup_Directory/pulpcore.dump

5. Use the satellite-installer command to update Satellite to point to the new databases:

   # satellite-installer \
   --katello-candlepin-manage-db false \
   --katello-candlepin-db-host postgres.example.com \
   --katello-candlepin-db-name candlepin \
   --katello-candlepin-db-user candlepin \
   --katello-candlepin-db-password Candlepin_Password \
   --foreman-proxy-content-pulpcore-manage-postgresql false \
   --foreman-proxy-content-pulpcore-postgresql-host postgres.example.com \
   --foreman-proxy-content-pulpcore-postgresql-db-name pulpcore \
   --foreman-proxy-content-pulpcore-postgresql-user pulp \
   --foreman-proxy-content-pulpcore-postgresql-password Pulpcore_Password \
   --foreman-db-manage false \
   --foreman-db-host postgres.example.com \
   --foreman-db-database foreman \
   --foreman-db-username foreman \
   --foreman-db-password Foreman_Password

6. Remove the PostgreSQL package on Satellite Server:

   # dnf remove postgresql-server

7. Remove the PostgreSQL data directory:

   # rm -fr /var/lib/pgsql/data