Skip to content

Commit 23d8365

Browse files
tcpdumpfbacketcpdumpfbacke
authored
EN proof
1 parent 6dca617 commit 23d8365

File tree

1 file changed

+24
-24
lines changed
  • pages/bare_metal_cloud/dedicated_servers/end-of-life-for-personal-installation-templates

1 file changed

+24
-24
lines changed

‎pages/bare_metal_cloud/dedicated_servers/end-of-life-for-personal-installation-templates/guide.en-gb.md

+24-24
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,41 @@
11
---
22
title: End of life for personal installation templates
3-
excerpt: Information about removal of your personal installation templates & workaround
3+
excerpt: Information about the removal of your personal installation templates & workaround
44
updated: 2025-04-29
55
---
66

77
**This is an important documentation, please read it carefully as you might be impacted in the future if you request an OS installation on a new dedicated server or an OS reinstallation on a dedicated server you already have.**
88

9-
Although this page outlines the decommissioning of personal templates for dedicated server OS installation and its impacts, customers can rest assured that **there will be no loss of features**.
9+
Although this page outlines the decommissioning of personal templates for dedicated server OS installation and its impacts, customers can rest assured that **there will be no loss of features**.
1010
In fact, after this decommissioning, customers will still be able to install operating systems with **the same level of customization as before**. Moreover, customers who use the API directly will benefit from **1 simplified API call**.
1111

1212
## Objective
1313

14-
This page provides key information about the decommissioning plan for personal templates used in dedicated server OS installations. Additionally, it offers helpful tips for customers using the OVHcloud, SoYouStart, or Kimsufi control panels. Furthermore, it highlights the benefits of the new API call compared to the deprecated API call.
14+
This page provides key information about the decommissioning plan for personal templates used in dedicated server OS installations. Additionally, it offers helpful tips for customers using the OVHcloud, SoYouStart, or Kimsufi Control Panels. Furthermore, it highlights the benefits of the new API call compared to the deprecated API call.
1515

1616
## Context<a name="context"></a>
1717

1818
OVHcloud is constantly evolving and must adapt its offers to the increasingly resilient and regulated cloud market. In order to meet those new challenges, **personal templates for dedicated servers OS installation** will be fully decommissioned on the **7th of October 2025**.
1919

2020
This feature allowed requesting an OS installation on a dedicated server by using a personal template containing the following elements:
2121

22-
- Operating System to be installed
23-
- partitioning layout
24-
- hardware RAID configuration
25-
- hostname
22+
- Operating system to be installed
23+
- Partitioning layout
24+
- Hardware RAID configuration
25+
- Hostname
2626
- SSH public key
27-
- post-installation script
27+
- Post-installation script
2828

2929
In order to simplify the OS installation on dedicated servers as well as the migration communication, a new API call was created: `POST /dedicated/server/{serviceName}/reinstall`{.action}. This API call is the successor of the old route: `POST /dedicated/server/{serviceName}/install/start`{.action}. The old route had the ability to target an OS installation from an OVHcloud template **or a personal template**.
3030

31-
The old route and the notion of personal templates will be decommissioned in future. The new route only supports starting an OS installation from an OVHcloud template. Also, please note that the confusing "OVHcloud template" terminology will gradually disappear in favor of "operating system".
31+
The old route and the notion of personal templates will be decommissioned. The new route only supports starting an OS installation from an OVHcloud template. Also, please note that the term "OVHcloud template" will gradually disappear in favour of the more precise "operating system".
3232

3333
Personal templates decommissioning will be done in 2 steps:
3434

3535
### Step 1: 17th of June 2025<a name="step-1"></a>
3636

3737
- Customers will no longer be able to **edit** or **add** new personal templates.
38-
- Customers having personal template(s) and active subscriptions to dedicated servers will receive custom technical information by email to help them migrate their personal template(s) to the [new /reinstall API call](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall).
38+
- Customers having personal templates and active subscriptions to dedicated servers will receive custom technical information by email to help them migrate their personal templates to the [new "/reinstall" API call](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall).
3939

4040
### Step 2: 7th of October 2025<a name="step-2"></a>
4141

@@ -46,17 +46,17 @@ Please note that customers will still have the email from the 17th of June 2025
4646

4747
## Instructions <a name="instructions"></a>
4848

49-
The following section contains specific information depending on whether you have an OVHcloud, SoYouStart or Kimsufi account and whether you are currently using the OVHcloud Control panel or the API to install OSes on your dedicated server.
49+
The following section contains specific information for all customers with an account at OVHcloud, SoYouStart or Kimsufi and whether you are currently using the OVHcloud Control Panel or the API to install OSs on your dedicated server.
5050

51-
### Using OVHcloud, SoYouStart or Kimsufi Control Panel<a name="ux"></a>
51+
### Using the OVHcloud, SoYouStart or Kimsufi Control Panels<a name="ux"></a>
5252

5353
The `Install one of your templates`{.action} wizard to install an operating system on a dedicated server has already been removed since mid-April 2025. If you were using that wizard you have 3 long-term possibilities:
5454

55-
- Keep using the Web interface (not recommended if you plan on automating your OS installations): manually apply all customizations in the OS install wizard (former `Install from an OVHcloud template`{.action} wizard) every time you need to perform an installation.
56-
- Write a script that uses the API (best for automation, but requires programming skills): see the section [Using OVHcloud, SoYouStart or Kimsufi API](#api) below.
57-
- Use the API console (good tradeoff): use old API call until the 17th of June 2025 and then use new API call with the provided payloads.
55+
- Keep using the Web interface (not recommended if you plan on automating your OS installations): Apply all customizations in the OS install wizard manually (former `Install from an OVHcloud template`{.action} wizard) every time you need to perform an installation.
56+
- Write a script that uses the API (best for automation, but requires programming skills): See the section [Using OVHcloud, SoYouStart or Kimsufi API](#api) below.
57+
- Use the API console (good tradeoff): Use the old API call until the 17th of June 2025 and then use the new API call with the provided payloads.
5858

59-
Although you could start exploring the examples and schemes of the [new /reinstall API call in the API console](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) and look at its [public documentation](/pages/bare_metal_cloud/dedicated_servers/api-os-installation), here is the temporary workaround you can follow until your receive the payloads for the new API route in the email of the 17th of June 2025.
59+
Although you could start exploring the examples and schemes of the [new "/reinstall" API call in the API console](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) and look at its [public documentation](/pages/bare_metal_cloud/dedicated_servers/api-os-installation), here is the temporary workaround you can follow until you receive the payloads for the new API route via email on the 17th of June 2025.
6060

6161
#### OVHcloud workaround <a name="ux-ovh"></a>
6262

@@ -75,7 +75,7 @@ Then run the API call to trigger an OS installation from your personal template:
7575
- Choose the `/dedicated/server`{.action} section.
7676
- Find the `POST /dedicated/server/{serviceName}/install/start`{.action} API call (you can use the filter).
7777
- In the `serviceName` field, enter the name of the dedicated server you want to install.
78-
- In the `REQUEST BODY` field (aka. API payload), put the following JSON value (in this example we assume that "my-amazing-template" is the name of the personal template you want to install):
78+
- In the `REQUEST BODY` field (aka API payload), put the following JSON value (in this example we assume that "my-amazing-template" is the name of the personal template you want to install):
7979

8080
```json
8181
{
@@ -86,7 +86,7 @@ Then run the API call to trigger an OS installation from your personal template:
8686
If you need to list your personal templates and their details, please go to the `/me`{.action} section and look at all the `GET` API calls under `/me/installationTemplate`{.action}.
8787

8888
> [!alert]
89-
> **Performing a [POST /dedicated/server/{serviceName}/install/start](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/install/start) to a dedicated server will erase all the data in that server. PLEASE BE CAREFUL WHILE USING THIS API CALL.**
89+
> **Executing the call [POST /dedicated/server/{serviceName}/install/start](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/install/start) to a dedicated server will erase all the data on that server. PLEASE BE CAREFUL WHILE USING THIS API CALL.**
9090
>
9191
9292
Then click the `Execute`{.action} button to start the OS installation.
@@ -97,7 +97,7 @@ You can go back to the [OVHcloud Control Panel](/links/manager) on the dedicated
9797

9898
#### SoYouStart or Kimsufi workarounds <a name="ux-sys-ks"></a>
9999

100-
Open the [SoYouStart console API](https://eu.api.soyoustart.com/console/) or the [Kimsufi console API](https://eu.api.kimsufi.com/console/).
100+
Open the [SoYouStart API console](https://eu.api.soyoustart.com/console/) or the [Kimsufi API console](https://eu.api.kimsufi.com/console/).
101101

102102
Click `Login`{.action} on the top right corner and enter your credentials. Then click the `Log in`{.action} button: you are now authenticated with the API console.
103103

@@ -109,7 +109,7 @@ Click `Login`{.action} on the top right corner and enter your credentials. Then
109109
If you need to list your personal templates and their details, please go to the `/me`{.action} section and look at all the `GET` API calls under `/me/installationTemplate`{.action}.
110110

111111
> [!alert]
112-
> **Performing a [POST /dedicated/server/{serviceName}/install/start](https://eu.api.soyoustart.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) (or [here](https://eu.api.kimsufi.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) for Kimsufi) to a dedicated server will erase all the data in that server. PLEASE BE CAREFUL WHILE USING THIS API CALL.**
112+
> **Executing the call [POST /dedicated/server/{serviceName}/install/start](https://eu.api.soyoustart.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) (or [this call](https://eu.api.kimsufi.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) for Kimsufi) to a dedicated server will erase all the data on that server. PLEASE BE CAREFUL WHILE USING THIS API CALL.**
113113
>
114114
115115
Then click the `Execute`{.action} button to start the OS installation.
@@ -118,18 +118,18 @@ You can go back to the [SoYouStart](https://eu.soyoustart.com/manager) or [Kimsu
118118

119119
### Using OVHcloud, SoYouStart or Kimsufi APIs <a name="api"></a>
120120

121-
If you are using the OVHcloud, SoYouStart or Kimsufi APIs to trigger OS installations from a personal template, you can continue using the `POST /dedicated/server/{serviceName}/install/start`{.action} API call until **the 7th of October 2025**.
121+
If you are using the OVHcloud, SoYouStart or Kimsufi APIs to trigger OS installations from a personal template, you can continue using the `POST /dedicated/server/{serviceName}/install/start`{.action} API call until **the 7th of October 2025**.
122122
But please note that starting from **the 17th of June 2025**, you will no longer be able to add or edit personal templates.
123123

124-
Although you will receive an email with all the details to migrate your API payloads to the [new /reinstall API call](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall), feel free to start exploring the examples and schemes of the [new /reinstall API call in the API console](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) (API scheme is the same for OVHcloud, [SoYouStart](https://eu.api.soyoustart.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) and [Kimsufi](https://eu.api.kimsufi.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST)) and look at its [public documentation](/pages/bare_metal_cloud/dedicated_servers/api-os-installation).
124+
Although you will receive an email with all the details to migrate your API payloads to the [new "/reinstall" API call](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall), feel free to start exploring the examples and schemes of the [new /reinstall API call in the API console](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) (API scheme is the same for OVHcloud, [SoYouStart](https://eu.api.soyoustart.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) and [Kimsufi](https://eu.api.kimsufi.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST)) and look at its [public documentation](/pages/bare_metal_cloud/dedicated_servers/api-os-installation).
125125

126-
In your case, the end of the personal templates feature should simplify OS installation on dedicated servers. Indeed, the new API call [POST /dedicated/server/{serviceName}/reinstall](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) brings all the possible customizations that the old API call [POST /dedicated/server/{serviceName}/install/start](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/install/start) was not able to offer without the need to first define a personal template under [/me/installationTemplate](https://eu.api.ovh.com/console/?section=%2Fme&branch=v1#get-/me/installationTemplate).
126+
The end of the personal templates feature will simplify OS installation on dedicated servers. Indeed, the new API call [POST /dedicated/server/{serviceName}/reinstall](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) brings all the possible customizations that the old API call [POST /dedicated/server/{serviceName}/install/start](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/install/start) was not able to offer without the need to first define a personal template under [/me/installationTemplate](https://eu.api.ovh.com/console/?section=%2Fme&branch=v1#get-/me/installationTemplate).
127127

128128
The following comparison gives you an idea of the reduced number of API calls to achieve a complex customization configuration involving hardware RAID and custom partitioning: from `4+n`{.action} calls (where `n`{.action} is the number of partitions you have defined in your partitioning layout) to 1 single API call.
129129

130130
![API calls comparison](images/api-calls-comparison.png){.thumbnail}
131131

132-
As you can see, everything becomes streamlined, eliminating the the need for heavy setup.
132+
As you can see, everything becomes streamlined, eliminating the the need for heavy setups.
133133

134134
## Go further
135135

0 commit comments

Comments
 (0)