Summary
Customers looking for help in upgrading their CD system can request help from Support.
This document outlines some details that will be beneficial to collect in advance of making such requests.
Solution
We recommend an Assisted Upgrade be considered for all customers to help guide them through CD system upgrades to make the process easier and safer.
This process allows a CloudBees Development Support Engineer to review your instance and prepare a customized upgrade plan which contains:
-
A summarized list of known potential issues you may encounter during your upgrade, based on your current version, target version, remote agents, and what we have experienced with other clients running through similar upgrades
-
Analysis of known issues your CD instance(s) are encountering, or may encounter after performing the upgrade
-
Best practice recommendations on how to test before starting the upgrade on production
-
Steps to follow when performing the production upgrade
-
Recommendations regarding backups to help with any recovery process, should that prove necessary along the way.
-
A 30 minute consultation call to explain the upgrade notes and give you a chance to ask any questions you may have regarding your upgrade
If you are interested in this process, the next step would be to provide us the Required Data for an Assisted Upgrade (below) on a new support ticket. This should include the timezone where you are located, and estimated time when you will perform the upgrade, so we can have the Engineer in the most appropriate timezone assigned to your request.
Requested data for an Assisted Upgrade
This article describes how to collect the minimum required information for planning an upgrade.
If any requested data files are larger than 50 MB you will not be able to use ZenDesk to upload all the information. In this case, we would encourage you to use our upload service in order to attach all required information.
IMPORTANT : Origin and Destination Product and Packaging must be the same. Otherwise, this effort would be considered a Migration and those details should also be identified.
Reference Links
Required Data checklist
In order to gather all the information required data, please copy and paste the following set of questions into your favorite text editor, fill it out and attach it to a Support Ticket.
-
What is your target date for performing your upgrade?
-
Current CloudBees CD (CloudBees Flow) Version
-
Please list any hotfixes applied to this version, if any?
-
Target CloudBees CD (CloudBees Flow) Version
-
If any of the server components rely on Kubernetes, please list which ones here:
-
Is CloudBees CD running in High Availability (clustered) mode?
-
OS in use for CloudBees CD (CloudBees Flow) Server(s)
-
Are any additional services running on your Server Machines?
-
What is the current amount of free disk space on each CD Server?
-
What DB is used for this system?
-
What is the current DB version?
-
Is this DB running on a separate machine from the CD Server machine(s)?
-
Do you have an assigned DBA for your system?
-
If you have a diagram representation of your existing architecture, passing this diagram forward can be beneficial for future communication
-
Do you have a comparable test environment?
-
Do you intend to test this upgrade in TEST before affecting production?
-
Are you planning on changing any machines in your environment during this upgrade?
-
If so, which ones?
-
What is your regular backup process?
-
How are those backups collected?
-
How often are these backups taken?
-
Please provide the output results from these commands for each CD Server in your architecture:
ectool login admin
ectool getServerStatus --diagnostics 1
-
Please provide the most recent commander.log files (ideally the last 1 hour worth of coverage)
-
Where are your plugins stored today?
-
Does this match with what is stored as shown in the UI under: Administration -→ Server -→ Settings?
-
If this upgrade includes a migration, please list any components and OS changes involved
-
If you are upgrading to version 2024.03 or later, please validate your database following the process outlined in this article.