Skip to content

Commit 79a572c

Browse files
bene2k1nerda-codes
andauthored
feat(ins): update doc sbs migration (#4505)
* feat(ins): update doc sbs migration * feat(ins): update * fix(ins): update * Apply suggestions from code review Co-authored-by: Néda <[email protected]> * feat(ins): update content * feat(ins): feature * feat(ins): add link --------- Co-authored-by: Néda <[email protected]>
1 parent e83e35a commit 79a572c

File tree

1 file changed

+36
-3
lines changed

1 file changed

+36
-3
lines changed

pages/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx

Lines changed: 36 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,14 @@ To facilitate the transition to Scaleway's new Block Storage management, two mai
1919

2020
- [Using the Instance API/CLI migration endpoint (Plan and Apply)](#migrating-using-the-instance-apicli-migration-endpoint-plan-and-apply):
2121
- **Advantage:** Migration can occur without service interruption, as the volume remains attached to the running Instance and fully accessible.
22-
- **Drawback:** Only the volume's representation is migrated to the SBS API; the data itself does not move. This means the migrated volume will not benefit from low latency or higher IOPS, as it retains the original `b_ssd` characteristics.
22+
- **Drawback:** Only the volume's representation is migrated to the SBS API; the data itself does not move. This means the migrated volume will not benefit from low latency or higher IOPS, as it **retains the original `b_ssd` characteristics**.
2323

2424
- [Using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features):
2525
- **Advantage:** The migrated volume will fully support low latency, and it is possible to modify the IOPS up to 15k. All existing data of the old volume will be copied to the new Block Storage Low Latency volume.
2626
- **Drawback:** A snapshot must be manually created, exported, and imported. After importing, the snapshot must be converted into a volume, which must then be attached to the Instance. This process may require downtime.
2727

28-
Each method caters to different needs, balancing uninterrupted service against achieving maximum performance benefits. After migration, these resources will be managed under [Storage](/block-storage/quickstart/) instead of Compute.
28+
Each method caters to different needs, balancing uninterrupted service against achieving maximum performance benefits. After migration, these resources will be managed under [Storage](/block-storage/quickstart/) instead of Compute.<br />
29+
Learn more about the [advantages of migrating from the Instance API to the Block Storage API for managing block volumes and snapshots](/block-storage/reference-content/advantages-migrating-to-sbs/).
2930

3031
## Comparison of migration methods
3132

@@ -37,11 +38,33 @@ Each method caters to different needs, balancing uninterrupted service against a
3738
This guide offers step-by-step instructions to migrate your volumes and snapshots using either the [Scaleway Command Line Interface (CLI)](/scaleway-cli/quickstart/) tool (recommended) or the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage).
3839
Alternatively, you can use the [snapshot export/import feature](/instances/api-cli/snapshot-import-export-feature/) to migrate your unified volumes and snapshots to Block Storage Low Latency volumes.
3940

40-
4141
<Message type="important">
4242
Volumes **created and managed through Kubernetes** do not fall within the scope of the migration described on this page. Find specific instructions for migrating Kubernetes volumes behind the Scaleway Block Storage API in the [managing storage for Kubernetes documentation](/kubernetes/api-cli/managing-storage/#upgrading-to-csi-version-03).
4343
</Message>
4444

45+
## Comparison of Block Storage volume types
46+
47+
| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience |
48+
|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------|
49+
| `b_ssd` (Block Storage 5K legacy) | 5,000 | Legacy SSDs | Higher | Up to 10 TB | General-purpose workloads that do not demand high IOPS or low latency | Data is replicated three times across multiple disks for high availability and integrity |
50+
| `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures |
51+
| `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures |
52+
53+
You can attach a maximum of 16 volumes (including the mandatory boot volume) to a single Instance.
54+
55+
<Message type="tip">
56+
Refer to [Understand the difference between Block Storage volumes and Block Storage Low Latency volumes](/block-storage/reference-content/differences-between-5kiops-volumes/) for more information on the differences between Block Storage 5K legacy volumes and Block Storage Low Latency 5K volumes.
57+
</Message>
58+
59+
### Additional details:
60+
61+
- `b_ssd`: These volumes are based on older SSD technology, providing reliable performance but with limitations in terms of speed and latency.
62+
- `sbs_5k`: These volumes use NVMe technology, offering better performance and lower latency. They allow flexibility to adjust storage based on your needs.
63+
- `sbs_15k`: These volumes offer even higher performance, with up to 15,000 IOPS, making them ideal for workloads requiring fast and reliable data access.
64+
<Message type="note">
65+
To maximize compatibility with Block Storage Low Latency 15K, select an Instance with at least [3 GiB/s of Block bandwidth](/instances/reference-content/instances-bandwidth-overview/).
66+
</Message>
67+
4568
<Macro id="requirements" />
4669

4770
- A Scaleway account logged into the [console](https://console.scaleway.com)
@@ -162,6 +185,11 @@ Alternatively, you can use the [snapshot export/import feature](/instances/api-c
162185
</TabsTab>
163186
</Tabs>
164187

188+
<Message type="important">
189+
After the migration, your volume's type will still be `b_ssd` (displayed as **Block SSD 5K legacy** in the Scaleway console).
190+
To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k` displayed as **Block Low Latency 5K** or **Block Low Latency 15K** in the Scaleway console) using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features).
191+
</Message>
192+
165193
### Migrating an existing Block Storage snapshot to Scaleway Block Storage management
166194

167195
<Message type="important">
@@ -255,6 +283,11 @@ Alternatively, you can use the [snapshot export/import feature](/instances/api-c
255283
</TabsTab>
256284
</Tabs>
257285

286+
<Message type="important">
287+
After the migration, your volume's type will still be `b_ssd` (displayed as **Block SSD 5K legacy** in the Scaleway console).
288+
To benefit from the new features and performance of Scaleway Block Storage, you must create a new volume (`sbs_5k` or `sbs_15k` displayed as **Block Low Latency 5K** or **Block Low Latency 15K** in the Scaleway console) using the snapshot export/import feature. For more information, see [Migrating using the snapshot export/import features](#migrating-using-the-snapshot-exportimport-features).
289+
</Message>
290+
258291
## Migrating using the snapshot export/import features
259292

260293
To convert your unified volumes and snapshots, you can use the snapshot export/import features as an alternative solution for transitioning a Block Storage legacy volume into a Block Storage Low Latency volume.

0 commit comments

Comments
 (0)