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

Solutions

Was this helpful?

Yes No
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

Follow

Share

Red Hat Customer Portal Twitter Facebook

63 Comments

Subscriber exclusive content

An active Red Hat subscription is required to participate.

Log In
TH Active Contributor 194 points
17 October 2018 2:08 PM

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

YZ Red Hat Newbie 5 points
18 October 2018 3:30 AM

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.

PH Community Member 78 points
29 October 2018 4:12 PM

Need help upgrading from Satellite 5.6 to 6.4.

ir. Jan Gerrit Kootstra's picture Guru 12807 points
29 October 2018 4:18 PM

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.

Regards,

Jan Gerrit Kootstra

Mike Chanslor's picture Active Contributor 237 points
29 June 2019 2:32 PM

> This article worked for me.

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

>

YZ Red Hat Newbie 5 points
1 July 2019 2:37 AM

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

Mike Chanslor's picture Active Contributor 237 points
1 July 2019 12:31 PM

All bugs are submitted to: https://bugzilla.redhat.com - 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.

YZ Red Hat Newbie 5 points
1 July 2019 2:50 PM

Thanks for your explanation, Mike.

CM
3 July 2019 6:44 PM

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.

AH Red Hat Guru 2067 points
4 July 2019 5:14 PM

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!

AL Community Member 34 points
8 October 2019 7:47 PM

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.

YZ Red Hat Newbie 5 points
9 October 2019 5:03 AM

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.

Thanks.

BG Community Member 43 points
14 October 2019 2:34 PM

the ugo to application link is broken

YZ Red Hat Newbie 5 points
14 October 2019 3:11 PM

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.

Yunfeng

BG Community Member 43 points
14 October 2019 3:36 PM

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

JB Community Member 71 points
23 October 2019 8:14 AM

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

YZ Red Hat Newbie 5 points
23 October 2019 8:28 AM

Jiri,

Thanks for reaching out us.

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

Thanks.

DC Community Member 37 points
6 November 2019 7:53 PM

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

DC Red Hat Community Member 96 points
6 November 2019 7:59 PM

Does not work in Chrome. Does work in Firefox.

AH Red Hat Guru 2067 points
7 November 2019 4:40 PM

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

SR Community Member 61 points
15 November 2019 9:19 PM

is there a direct upgrade from 6.3 to 6.6?

YZ Red Hat Newbie 5 points
18 November 2019 2:21 AM

No, you must follow this upgrade path:

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

SK Newbie 2 points
25 February 2020 7:10 PM

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"

TL Newbie 14 points
9 April 2020 2:58 AM

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.

YZ Red Hat Newbie 5 points
9 April 2020 7:40 AM

Hi,

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.

Thanks.

TL Newbie 14 points
19 April 2020 9:36 AM

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]
AH Red Hat Guru 2067 points
20 April 2020 9:42 AM

Hello,

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"
AC Newbie 5 points
22 April 2020 9:29 PM
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:

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.7/html/installing_satellite_server_from_a_connected_network/preparing_your_environment_for_installation#storage_requirements

YZ Red Hat Newbie 5 points
23 April 2020 3:43 AM

Alexis,

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

ok Community Member 45 points
19 May 2020 5:47 PM

oh's

SK
3 June 2020 5:15 AM

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.

AH Red Hat Guru 2067 points
3 June 2020 9:53 AM

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 bootstrap.py script. You need to download bootstrap script on client system and execute it as below:

# curl -O http://satellite.example.com/pub/bootstrap.py
# bootstrap.py --login=admin \
--server satellite6.example.com \
--location="Example Location" \
--organization="Example Organization" \
--hostgroup="Example Host Group" \
--activationkey=activation_key

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

WL Newbie 16 points
10 August 2021 9:38 PM

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.

DZ Red Hat Community Member 41 points
11 August 2021 1:55 AM

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

Thanks, Dong

AM Community Member 39 points
21 August 2021 11:01 AM

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

DZ Red Hat Community Member 41 points
30 August 2021 1:05 AM

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

CF
27 August 2021 2:41 PM

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

DZ Red Hat Community Member 41 points
30 August 2021 1:12 AM

Hi Canisia,

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

Bootstrap.py

The bootstrap.py 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

CS Newbie 18 points
3 September 2021 3:48 PM

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?

AH Red Hat Guru 2067 points
6 September 2021 11:56 AM

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

CF
14 September 2021 3:32 PM

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

Thanks

mm Newbie 2 points
9 October 2021 12:14 PM

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

YZ Red Hat Newbie 5 points
10 October 2021 8:57 AM

Hi Mary,

Thank you for your feedback.

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

Thanks.

mm Newbie 2 points
10 October 2021 10:35 AM

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?

Agustin Gomez Roca's picture
25 October 2021 5:09 PM

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

Agustin Gomez Roca's picture
25 October 2021 5:03 PM

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

https://access.redhat.com/labsinfo/satelliteupgradehelper

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.

Agustin Gomez Roca's picture
25 October 2021 5:07 PM

Hi Everyone,

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

Bests Regards

DZ Red Hat Community Member 41 points
26 October 2021 2:29 AM

Labs has got back to normal. Thank you Agustin.

Eric Milligan's picture Newbie 2 points
18 November 2021 3:52 PM

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

YZ Red Hat Newbie 5 points
19 November 2021 2:43 AM

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?

Thanks.

IL
6 December 2021 5:14 AM

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

YZ Red Hat Newbie 5 points
10 December 2021 1:53 AM

Hi,

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

Thanks.

AN
4 May 2022 4:12 PM

Hello,

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

YZ Red Hat Newbie 5 points
5 May 2022 1:21 AM

Hi Andrew,

Thank you very much for reaching out to us.

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

Thanks.

TB Community Member 67 points
7 July 2022 6:52 PM

ETA for upgrades from 6.10 to 6.11?

AH Red Hat Guru 2067 points
8 July 2022 4:05 AM

Hi Thomas!

The lab app (https://access.redhat.com/labs/satelliteupgradehelper/ ) is updated with Satellite 6.10 to 6.11 steps, update to this landing page is pending. We will get it updated asap.

Christoph Dwertmann's picture Red Hat Newbie 9 points
21 July 2022 2:20 AM

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

CA Newbie 4 points
13 December 2022 7:35 AM

ETA for upgrades from 6.8 to 6.9 ?

PL Active Contributor 160 points
23 January 2023 5:01 AM

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

AH Red Hat Guru 2067 points
1 February 2023 10:49 AM

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 : https://bugzilla.redhat.com/show_bug.cgi?id=2164027 . We are working with the engineering and documentation team to get this addressed.

MB Newbie 10 points
24 January 2023 7:11 AM

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

MS
8 February 2023 11:51 AM

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

AH Red Hat Guru 2067 points
8 February 2023 12:07 PM

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.