The run.sh script will test your data from pulp < 2.8 to ensure that the upgrade process will succeed. It requires you to creata a database dump. It does not modify data in your running pulp server, nor does it modify the contents of the database dump you provide. The script starts a docker container running mongodb. It then starts a second container that loads your database dump into the mongodb container, and then runs the upgrade test script. At the end, both containers are stopped and removed. Requirements ------------ Docker Dump of pulp database from mongodb Usage ----- 1. Create an empty directory, and use it as the working directory for all further steps. 2. Download the run.sh script found near this README. 3. Use mongodump to create a dump of your pulp database. This will create a subdirectory called "dump". On EL6 and EL7, mongodump is found in package "mongodb". On Fedora, it is in package "mongo-tools". For usage, see the documentation link below. In the simplest use case: mongodump --db pulp_database 4. If selinux is enforcing, run this command so the docker container will have access to the dumped files: sudo chcon -Rt svirt_sandbox_file_t dump 5. sudo ./run.sh Progress information will appear on your screen, and that same data will be written to disk in a file whose name starts with "upgrade_validation-". If there are any errors, please share that log file with the pulp team. You can file an issue here: https://pulp.plan.io/ References ---------- https://docs.mongodb.org/v2.6/reference/program/mongodump/