Red Hat Satellite Upgrade Helper

Updated -

This app is designed to help you upgrade your Red Hat Satellite 6 to a newer version. All you need to provide is information about your upgrade path. We will not only present you the steps to upgrade Red Hat Satellite 6, but we'll also give you some extra steps that will prevent known issues specific to your upgrade scenario.

Currently Red Hat supported Red Hat Satellite versions:

  • 6.10 ( EOL by 31 May 2023 )
  • 6.11
  • 6.12
  • 6.13

For more details, check Red Hat Satellite Lifecycle page.

It provides instructions for these upgrade paths:

  • 6.7 to 6.8
  • 6.8 to 6.9
  • 6.9 to 6.10
  • 6.10 to 6.11
  • 6.11 to 6.12
  • 6.12 to 6.13

Was this helpful?

We appreciate your feedback. Leave a comment if you would like to provide more detail.
It looks like we have some work to do. Leave a comment to let us know how we could improve.

Get notified when this content is updated



Subscriber exclusive content

An active Red Hat subscription is required to participate.

Log In

Is there an ETA when this helper will be updated to support going from Satellite 6.3 to 6.4?

Hi Tomas, Thank you for reaching out us. The app is updated for Satellite 6.4 today. You can use it for Satellite 6.4 now.

Need help upgrading from Satellite 5.6 to 6.4.

Hi Paul,

Advise: setup a new server running RH Satellite 6.4, once it is up and running migrate your clients.

RH Satellite 5.x and 6.y are completely different products.


Jan Gerrit Kootstra

> This article worked for me.

The total upgrade from 6.4 to 6.5 only added 10GB to /var/lib/pulp. 


Hi Mike, What does you mean? Are you reporting a bug? Thanks.

All bugs are submitted to: - My post was a comment that the process worked from 6.4 to 6.5 with additional note that the upgrade process added 10gb to my /var/lib/pulp filesystem.

Thanks for your explanation, Mike.

I ran into issues with DNS not starting with several issues related to proxy (this still isn't solved) so I used the addition of --foreman-proxy-dns false and it seemed to finish without trying to start that. I then had issues with getting the 6.4 repository to show, and after a case thread and phone call, it turns out that we need to add a new content view with the new 6.x repository, publish to an environment and then do a subscription-manager refresh before it will show up.

Hi Christopher,

Thank you for your comment, I found the support case you opened for the upgrade to Sat6.4.

After checking the support case, we need to confirm whether you are using DNS/DHCP feature on the satellite server or not. If we are not using the DNS feature then it is fine to use --foreman-proxy-dns false option to disable it.

Also, regarding the content view related issue, we do not need to create a new content view to add Satellite 6.4 tools repo, we can remove 6.3 tools repo from existing content view and add 6.4 tools repo then publish/promote the CV to the required environment so the repo will be accessible to the clients.

For further clarification, Suraj ( case owner) and I will work with you on the support case.

Thank you!

FYI - The link to the application "Red Hat Satellite Upgrade Helper" gives this response: 502 Bad Gateway The server returned an invalid or incomplete response.

Hi Andrew,

Thank you for reaching out us.

Can you try it again?

I can not reproduce it. Maybe you met a temporary network issue.


the ugo to application link is broken

Hi Ben,

Thank you for reaching out us.

I can not reproduce it.

Can you provide these information?

  • Which geo are you in?
  • Which language did you use to access the app?



Thanks for the quick response, I'm getting the "502 Bad GatewayThe server returned an invalid or incomplete response." error in my Chrome browser when I click "go to Application"

When I pull it up in MS Edge, I'm able to get into the tool. So this seems browser-specific.

I am in the United States, I did not see any selection for language, but I would be using en_us

Dear colleagues, could you please add Satellite 6.6 upgrade paths? Thank you


Thanks for reaching out us.

I'm working on the update for Satellite 6.6 and hope can release it as soon as possible.


Clicking on the "Go to Application" link does not work. I get the error: This page isn’t workingIf the problem continues, contact the site owner. HTTP ERROR 400

Does not work in Chrome. Does work in Firefox.

I get same error in chrome, but when I open it in the Chrome Incognito window, it works properly. It seems some caching issue.

is there a direct upgrade from 6.3 to 6.6?

No, you must follow this upgrade path:

6.3 --> 6.4 --> 6.5 --> 6.6

When I click on GO TO APPLICATION button above it returns error page "This page isn’t working. If the problem continues, contact the site owner. HTTP ERROR 400"

Hello, My Current Satellite version is v6.4.1, I want to upgrade v6.6.Is there direct upgrade from 6.4 to 6.6.Please let me know.


You can not upgrade Red Hat Satellite from 6.4 to 6.6 directly. You must follow this upgrade path: 6.4 -> 6.5 -> 6.6.


Hello, We are doing upgrade satellite version from 6.4.1 to 6.5. While executing upgrade check, the below fail message is receiving. it will ask Delete old task -> Y / N

Could you please advice for below error.

Check for old tasks in paused/stopped state: [FAIL]

Found 113154 paused or stopped task(s) older than 30 days

Continue with step [Delete old tasks]?, [y(yes), n(no), q(quit)] n

Check for pending tasks which are safe to delete: [OK]


As per the pre-upgrade check implemented in satellite-maintain command is that, there should not be any tasks present in Satellite Database which are older than 30 days. For the better performance of Satellite server it is recommended to keep tasks only till 30 days. The check is failing because there are some 30+ days old tasks present on the Satellite server.

If you want to keep very old tasks as it is and do not want to delete/clean them, then you can use below command:

# satellite-maintain upgrade check --target-version 6.5 --whitelist="check-old-foreman-tasks"
I'm upgrading from 6.6 to 6.7 and the prerequisites have a link to a non-existing document regarding new storage requirements (get a 404).

The storage requirements for Satellite have changed from the previous version. Before upgrading, review the storage requirements and ensure that the requirements are met before attempting an upgrade:


Thank you very much for reaching out us. The issue has been fixed.


Satellite Server upgrade problem (6.2 > 6.6):

Facing bug while upgrading from 6.2 to 6.3 and stuck for upgrade to 6.6. Please suggest the options: Can I install the fresh Satellite 6.6 and use the same ID which is being used for 6.2 before final migration of clients from 6.2 to 6.6?

Any other suggestion/best practice would be highly appreciated.

Hello Satish,

We would like to know which bug you are hitting while upgrading Satellite 6.2 -> 6.3, can you please share details?

I would recommend you to open a support case for this issue, the Technical Support team will be able to help you complete the upgrade. It would be easy to troubleshoot the issue.

To answer your question: Can I install the fresh Satellite 6.6 and use the same ID which is being used for 6.2 before final migration of clients from 6.2 to 6.6?

-> Yes, you can do a fresh installation of Satellite 6.6/6.7 and then migrate all registered clients from Satellite 6.2 to 6.6/6.7 using script. You need to download bootstrap script on client system and execute it as below:

# curl -O
# --login=admin \
--server \
--location="Example Location" \
--organization="Example Organization" \
--hostgroup="Example Host Group" \

Note: For the --server option, specify the FQDN name of Satellite Server. For --location, --organization, and --hostgroup options, use quoted names, not labels, as arguments to the options.

Satellite 6.7 is the latest released version of Satellite so we will recommend you to plan to install Satellite 6.7 instead of Satellite 6.6.

Regards, Ashish

I get the following error when I try to follow the "go to application" link

Bad Request Your browser sent a request that this server could not understand. Size of a request header field exceeds server limit.

Hi Will, Can you try again? This should be something with your browser cache. Clearing caching may fix the problem.

Thanks, Dong

Hi redhat team

A small feedback around the satellite upgrade helper application. It is helpful of the port and firewall requirements and even the storage requirements it mentions of , which was previously not the case. I would be nice to include the port and firewall requirements mention of insights requirement for the users who are using insights in conjunction with satellite. We have tripped over our own shoe laces quite a few times with insights post upgrade.

Regards Abhinit

Thank you Abhinit for your feedback. We will update the application according to your suggestion.

Hi Team What would be the best way to migrate clients from Sat6.8 to Sat6.9. It seems the bootstrap script is deprecated in Sat6.9. Thanks

Hi Canisia,

We are aware of this change and add instructions in the application.

The script that was used to register a host to Satellite Server or Capsule Server has been replaced with the curl command created with the global registration template.

I'd suggest you follow the steps listed in the application and let us know if something does not work as expected.

Thanks, Dong

Just curious. Does anyone have any issue to upgrade satellite 6.7 to 6.8, and immediately upgrade to 6.9 in the same window?

Hi Curtis,

There is are no such known issues present in Sat6.7->6.8-> 6.9 upgrade, you can open a proactive support case with the Technical Support team who can assist you with the migration process.

Thanks, Ashish

Has anyone taken the the Red Hat cert exam EX403? What version is tested currently? Is there any exam prep we can find anywhere?


I have follow the steps, and it was successful and no issues.

Hi Mary,

Thank you for your feedback.

I'm very glad to see that this app is helpful to you.


Why I cannot access this helper application since yesterday. I was keep trying to access but no luck, I was guessing there is some maintenance in going and hoping I can access on this weekend because I plan to to satellite upgrade this weekend. anyone can share if you know anything why I cannot access this apps?

Hi MM, As far as I can see the helper depends on the labs which is under a major outage at this moment. BTW it worked fine for me last friday.

Bests Regards

Hi Everyone, I'm trying to use the Satellite upgrade helper:

However when I click on "GO TO APPLICATION" button, I get a 404 Not Found error. Is someone else experiencing the same? Thanks in advance.

Hi Everyone,

Please forget about my previous comment. Following page: depends on labsinfo. As per labs is under a major outage, so, the only thing we can do is just wait until it's fixed.

Bests Regards

Labs has got back to normal. Thank you Agustin.

Says it supports 6.9 -> 6.10, but I don't see that as an available option in the application itself as of yet.

It supports the following upgrade paths:

6.3 to 6.4 6.4 to 6.5 6.5 to 6.6 6.6 to 6.7 6.7 to 6.8 6.8 to 6.9 6.9 to 6.10

Hi Eric,

Thank you for reaching out to us.

We met some issues when we switched the app to a new platform yesterday.

Now the issue has been resolved.

Would you like to check the app again?


Hi Can I upgrade from 6.7 to latest version 6.10?

or I have to do like this ?? 6.7 to 6.8 6.8 to 6.9 6.9 to 6.10


You can not upgrade from 6.7 to 6.10 directly. You must follow this upgrade path step by step:

6.7 -> 6.8 -> 6.9 -> 6.10



When trying to access the Satellite Upgrade Helper, we are getting an error 504. Do you know when this is expected to be remediated?

Hi Andrew,

Thank you very much for reaching out to us.

The error has been fixed. Would you like to try it again?


ETA for upgrades from 6.10 to 6.11?

Hi Thomas!

The lab app ( ) is updated with Satellite 6.10 to 6.11 steps, update to this landing page is pending. We will get it updated asap.

The application is unavailable at the time I'm writing this comment (404 not found).

ETA for upgrades from 6.8 to 6.9 ?

After upgrading from RHEL7 to RHEL8 and in preparation to upgrading from Satellite 6.11 to 6.12 subscription-manager release --unset ((because leapp sets to 8.6 explicitly)) subscription-manger repos --disable=satellite-6.11-for-rhel-8-x86_64-rpms --disable=satellite-maintenance-6.12-for-rhel-8-x86_64-rpms subscription-manager repos --enable=satellite-6.12-for-rhel-8-x86_64-rpms

Hi Paul, Thank you for noticing the issue with Sat 6.11 to 6.12 upgrade due to the release version set to 8.6. We have created documentation bug : . We are working with the engineering and documentation team to get this addressed.

Can you make this document available as a complete export to PDF keeping formatting in place (all sections, prereq, deprecated parts, etc)

Hi, is it possible to upgrade satellite 6.7 to 6.12 directly on Linux 7.9?

Hi Mohammad! It is not possible to upgrade from 6.7 to 6.12 directly, we need to go step by step 6.7->6.8-> 6.9 -> 6.10 -> 6.11 , before upgrading to satellite 6.12 you need to move Satellite 6.11 on RHEL 8 as Satellite 6.12 is available only for RHEL 8.

You can follow the instructions from the Satellite Upgrade helper app and also work with Red Hat technical support team to plan this upgrade activity.