The GitLab support team is here to help. As a part of our Priority Support we offer Live Upgrade Assistance. That is, we'll host a live screen share session to help you through the process and ensure there aren't any surprises.
Live Upgrade Assistance is part of the Priority Support package that lets you invite a GitLab Support Engineer to participate in a screenshare session as you upgrade your GitLab installation between releases.
"Upgrade" in this sense does not include:
In short, Live Upgrade Assistance is simply for moving from one GitLab point release to a newer GitLab point release on the same server.
For support to properly assist you, the earlier you can notify us, the better. Our minimum requirements for notification are:
If you cannot meet our minimum advanced notice period for your planned upgrade, we may not be able to go ahead with a Live Upgrade Assistance call. In this case:
First, confirm that nothing about your instance would make the request out of scope for support.
Then, please provide all the relevant information you can so that we will be best positioned to assist you. At a minimum, we require:
You can do so, however we cannot review the scripts themselves to determine if they are viable. Generally speaking, our upgrade documentation is the single source of truth for how to best carry out an upgrade.
If issues do occur during the upgrade window and you are running a custom script, it is likely the advice from support will be to utilize your rollback plan. It is important to know that should issues arise while using custom scripts, Support will recommend following the exact steps from our documentation on future attempts.
Organizations with Priority Support or higher may use the Support for Self Managed instances form and under "Problem Type" select "Live Upgrade Assistance Request" to begin the process. For efficiency, please include the required information when opening the ticket. Once Support has received the ticket an engineer will review the upgrade plan and make any notes/suggestions as well as provide a single use Calendly link to schedule the date and time of the upgrade. Note that until the engineer has all of the available information they may not be able to begin the scheduling process, please be as comprehensive as possible when opening the ticket to avoid delays.
If your organization meets the requirements for GitLab's US Federal Support you may use the US Federal Live Upgrade Assistance Request form to begin the process. For efficiency, please include the required information when opening the ticket. Once Support has received the ticket an engineer will review the upgrade plan and make any notes/suggestions as well as provide a single-use Calendly link to schedule the date and time of the upgrade.
After confirming that all relevant information has been provided a GitLab Support Engineer will send an invitation to schedule a call. At the day and time of the call a GitLab Engineer will join you for the first 30 minutes of your upgrade, to help kick things off and ensure that you're set up for success by:
At that point, the engineer will drop off the call and watch the ticket for any updates for the duration of the upgrade. If required, they'll rejoin the ongoing call to troubleshoot any issues.
Once the upgrade is complete, and has passed your post-upgrade success criteria, please be sure to send an update to the ticket that was opened so the Engineer knows they can go offline.
If there haven't been any updates for some time, the Engineer assisting may rejoin the call or send an update to the ticket requesting an update.
If the upgrade is taking longer than expected and the shift of the assigned engineer is about to end, they will notify you through the support ticket that they are no longer available. If you need assistance after that point, please page the on-call engineer to help troubleshoot.
As noted in our Statement of Support, we support the current major version and two previous major versions. If you're upgrading from a version of GitLab that is no longer supported, Live Upgrade Assistance may not be an option. If you're in this situation, please discuss options with your Technical Account Manager or your Account Manager for Professional Services options.
As a part of Priority Support, you're also entitled to 24x7 uptime Support. If you encounter any issues that are leading to downtime during your upgrade, you can page the on-call engineer to help troubleshoot.
Please provide as much context as you can, including an upgrade plan when you open your emergency ticket.
Do note, that in some cases the best option available may be to invoke your roll-back plan and reschedule the upgrade.