Upgrade Core Version

Upgrade a warehouse to an available newer core version immediately or during its next maintenance window. Use Upgrades to compare available versions, manage schedules, and review previous upgrades.

Before you begin

• You need permission to manage the warehouse in the VeloDB Cloud console. SQL privileges alone do not grant this access.
• The warehouse must be Running to schedule or reschedule an upgrade. Available actions also depend on the update's status and any other warehouse operations in progress.
• To use Next maintenance window, configure a maintenance window. You can also configure it from the scheduling dialog.

Warning:

An upgrade interrupts service. Schedule it during off-peak hours and make sure that applications reconnect automatically.

An upgrade applies to the warehouse and its clusters. VeloDB Cloud resumes a Paused cluster for the upgrade and returns it to Paused after the upgrade. Use the Estimated Time shown for the target version when planning the upgrade.

Find available versions

1. Log in to the VeloDB Cloud console and select the warehouse in the upper-left corner.
2. In the left navigation pane, under MORE, click Warehouse Settings.
3. In Version Upgrade, click Upgrade.

The Available Versions tab lists each Target Version, its Type (major or minor version), Status, Scheduled Start, and Estimated Time. Check the UTC offset displayed with the scheduled start time.

If no newer version is available, the tab displays You're on the latest version.

Schedule an upgrade

1. On Available Versions, find the target version and click Schedule.

2. Under When to apply, choose an option:

   Option	Behavior
   Next maintenance window	Schedules the upgrade for the next configured window. Review the displayed date, time range, and UTC offset. If no window is configured, click Set up to configure one.
   Apply immediately	Starts the upgrade when you click Apply Now.

3. Select I understand the expected impact and approve this schedule.

4. Click Save Changes for the next maintenance window, or Apply Now to start immediately.

After saving, review the target version's status and scheduled start in Available Versions. A scheduled upgrade shows Scheduled. An upgrade that has started shows In progress and can no longer be rescheduled or canceled.

Change or cancel a scheduled upgrade

Before an upgrade starts, click Reschedule for its target version and choose an available option:

• Next maintenance window: Use the next configured window. If you changed the warehouse's maintenance window, review the new time here before saving.
• Apply immediately: Start the upgrade now instead of waiting for its scheduled time.
• Not scheduled: Cancel the existing schedule. The upgrade will not run until you schedule it again.

For a new execution time, select the impact acknowledgment, then click Save Changes or Apply Now. To cancel the schedule, select Not scheduled and click Save Changes.

Changing the warehouse's maintenance window alone does not move an existing upgrade. Verify Scheduled Start after rescheduling.

If rescheduling fails, reopen Available Versions and check the upgrade's status. The previous schedule may already have been canceled. If the upgrade is no longer scheduled, schedule it again.

Review upgrade history

In Upgrades, select History to review the source and target versions, upgrade type, status, start and end times, and duration.

History statuses include Completed, Failed, and Revoked. If a failed or revoked upgrade has a message, hover over the warning icon next to its status to read the details. After a completed upgrade, verify the current version in Warehouse Settings.

Troubleshooting

When an action is unavailable, hover over a disabled action or scheduling option to see why it is unavailable.

Reason	What to do
The warehouse is not running or is busy.	Wait for the warehouse to return to Running and for conflicting operations to finish.
Another upgrade is already scheduled.	Review the existing schedule before scheduling another upgrade.
The update has already started.	Wait for completion and check History for the result.
The update is no longer applicable.	Reopen Available Versions and review the available targets.
No maintenance window is configured.	Configure a maintenance window before choosing Next maintenance window.
You do not have permission to manage the warehouse.	Ask your organization administrator for the required warehouse access.

See also

• Warehouse Settings: configure the maintenance window.
• OS Updates: manage operating system security updates separately from core version upgrades.