Pulp3 Migration failed Katello::Errors::Pulp3Error: Cursor not found, cursor id: ############

Solution Unverified - Updated

Environment

  • Red Hat Satellite 6.9
  • Red Hat Satellite 6.10

Issue

During the Satellite 6.9 to 6.10 upgrade, the MongoDB cursor goes missing.

Resolution

From the Satellite 6.10 upgrade documentation:

If you have not pre-migrated Pulp content, the PULP_CONTENT_PREMIGRATION_BATCH_SIZE setting defines the number of content units processed at the same time. It affects the amount of RAM used and the I/O load. The lower the value, the longer satellite-maintain content prepare takes to complete. The upgrade downtime is also longer if you have content left to migrate at that point.

The default value is 1000.
If the system has a hard disk drive, or there are concerns about I/O load, the recommended value is 50.
A lower value is not recommended.
Use the following method to set PULP_CONTENT_PREMIGRATION_BATCH_SIZE:

Create a directory and file:

$ mkdir /etc/systemd/system/pulpcore-worker@.service.d/
$ vi  /etc/systemd/system/pulpcore-worker@.service.d/settings.conf

with contents:

[Service]
User=pulp
Environment=PULP_CONTENT_PREMIGRATION_BATCH_SIZE=50

Restart the satellite-maintain services using:

# systemctl daemon-reload
# satellite-maintain service restart

For more KB articles/solutions related to Red Hat Satellite 6.x Pulp 3.0 Issues, please refer to the Consolidated Troubleshooting Article for Red Hat Satellite 6.x Pulp 3.0-related Issues

Root Cause

Slower hardware or larger content in batches create unique scenarios where the batching may take longer than the cursor timeout that is currently set. Lowering the batch size from the default 1000 to 50 will push less content to the cursor to create faster batching to avoid cursor timeout.

SBR
Product(s)
Components
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.