You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- 10-year security maintenance: Ubuntu Pro 18.04 LTS provides security maintenance until April 2028
49
+
- Developer friendly: Ubuntu offers developers the latest libraries and tools to innovate with the latest technologies
50
+
- Nonstop security: Canonical publishes images ensuring security is present from the moment an instance launches
51
+
- Portability: Ubuntu is available in all regions with content mirrors to reduce the need to go across regions or out to the Internet for updates
52
+
- Consistent experience across platforms: from edge to multicloud, Ubuntu provides the same experience regardless of the platform. It ensures consistency of your CI/CD pipelines and management mechanisms.
61
53
62
54
> [!NOTE]
63
-
> This document presents the direction to upgrade from an Ubuntu Server (16.04 or higher) image to
64
-
> Ubuntu Pro with zero downtime for upgrade by executing the following steps in your VMs:
65
-
>
66
-
> 1. Converting to Ubuntu Pro license
67
-
> 2. Validating the license
68
-
>
69
-
> Converting to UBUNTU_PRO is an irreversible process. You can't even downgrade a VM by running
70
-
> detach. Open a support ticket for any exceptions.
55
+
> This document provides instructions to upgrade Ubuntu Server (16.04 or higher) to
56
+
> Ubuntu Pro. Converting to Ubuntu Pro is an irreversible process.
71
57
72
58
## Convert to Ubuntu Pro using the Azure CLI
73
59
74
-
```azurecli-interactive
75
-
# The following will enable Ubuntu Pro on a virtual machine
60
+
The following command enables Ubuntu Pro on a virtual machine in Azure:
61
+
62
+
```Azure CLI
76
63
az vm update -g myResourceGroup -n myVmName --license-type UBUNTU_PRO
77
64
```
78
65
79
-
```In-VM commands
80
-
# The next step is to execute two in-VM commands
66
+
Execute these commands inside the VM:
67
+
68
+
```bash
81
69
sudo apt install ubuntu-advantage-tools
82
70
sudo pro auto-attach
83
71
```
84
72
85
-
(Note that "sudo apt install ubuntu-advantage-tools" is only necessary if "pro --version" is lower than 28)
73
+
If the `pro --version` is lower than 28, execute this command:
74
+
75
+
```bash
76
+
sudo apt install ubuntu-advantage-tools
77
+
```
86
78
87
79
## Validate the license
88
80
81
+
use the `pro status --all` command to validate the license:
82
+
89
83
Expected output:
90
84
91
-

85
+
```output
86
+
SERVICE ENTITLED STATUS DESCRIPTION
87
+
cc-eal yes disabled Common Criteria EAL2 Provisioning Packages
88
+
cis yes disables Security compliance and audit tools
89
+
esm-apps yes enabled Expanded Security Maintenance and audit tools
90
+
esm-infra yes enabled Expanded Security Maintenance for infrastructure
91
+
fips yes disabled NIST-certified core packages
92
+
fips-updates yes disabled NIST-certified core packages with priority security updates
93
+
livepatch yes enabled Canonical Livepatch service
94
+
```
92
95
93
96
## Create an Ubuntu Pro VM using the Azure CLI
94
97
95
-
You can also create a new VM using the Ubuntu Server images and apply Ubuntu Pro at create time.
96
-
97
-
For example:
98
+
You can create a new VM using the Ubuntu Server images and apply Ubuntu Pro at the time of creation.
99
+
The following command enables Ubuntu Pro on a virtual machine in Azure:
98
100
99
-
```azurecli-interactive
100
-
# The following will enable Ubuntu Pro on a virtual machine
101
+
```Azure CLI
101
102
az vm update -g myResourceGroup -n myVmName --license-type UBUNTU_PRO
102
103
```
103
104
104
-
```In-VM commands
105
-
# The next step is to execute two in-VM commands
105
+
Execute these commands inside the VM:
106
+
107
+
```bash
106
108
sudo apt install ubuntu-advantage-tools
107
109
sudo pro auto-attach
108
110
```
109
111
110
-
>[!NOTE]
111
-
> For systems with advantage tools version 28 or higher installed the system will perform a pro attach during a reboot.
112
+
> [!NOTE]
113
+
> For systems with advantage tools using version 28 or higher, installed the system will perform a
114
+
> `pro attach` during a reboot.
112
115
113
116
## Check licensing model using the Azure CLI
114
117
115
-
You can use the az vm get-instance-view command to check the status. Look for a licenseType field in the response. If the licenseType field exists and the value is UBUNTU_PRO, your virtual machine has Ubuntu Pro enabled.
118
+
> [!TIP]
119
+
> You can query the metadata in _Azure Instance Metadata Service_ to determine the virtual machine's
120
+
> _licenseType_ value. You can use the `az vm get-instance-view` command to check the status. Look
121
+
> for the _licenseType_ field in the response. If the field exists and the value is UBUNTU_PRO, your
122
+
> virtual machine has Ubuntu Pro enabled. [Learn more about attested metadata][02].
116
123
117
124
```Azure CLI
118
125
az vm get-instance-view -g MyResourceGroup -n MyVm
119
126
```
120
127
121
-
## Check the licensing model of an Ubuntu Pro enabled VM using Azure Instance Metadata Service
122
-
123
-
From within the virtual machine itself, you can query the attested metadata in Azure Instance Metadata Service to determine the virtual machine's licenseType value. A licenseType value of UBUNTU_PRO indicates that your virtual machine has Ubuntu Pro enabled. [Learn more about attested metadata](../../instance-metadata-service.md).
124
-
125
128
## Billing
126
129
127
-
You are charged for Ubuntu Pro as part of the Preview. Visit the
128
-
[pricing calculator](https://azure.microsoft.com/pricing/calculator/) for more details on Ubuntu Pro
129
-
pricing. To cancel the Pro subscription during the preview period, open a support ticket through the
130
-
Azure portal.
130
+
Visit the [pricing calculator][03] for more details on Ubuntu Pro pricing. To cancel the Pro
131
+
subscription during the preview period, open a support ticket through the Azure portal.
131
132
132
-
## Frequently Asked Questions
133
-
134
-
### What are the next step after launching an Ubuntu Pro VM?
133
+
## Next steps after launching an Ubuntu Pro VM
135
134
136
135
With the availability of outbound internet access, Ubuntu Pro automatically enables premium features
137
-
such as Extended Security Maintenance for
138
-
[Main and Universe repositories](https://help.ubuntu.com/community/Repositories) and
139
-
[live patch](https://ubuntu.com/security/livepatch/docs). Should any specific hardening be required
140
-
(for example CIS), check the using 'usg' to
141
-
[harden your servers](https://ubuntu.com/tutorials/comply-with-cis-or-disa-stig-on-ubuntu#1-overview)
142
-
tutorial. Should you require FIPS, check enabling FIPS tutorials.
136
+
including [Live Patch][04] and Extended Security Maintenance for
137
+
[Main and Universe repositories][05].
138
+
Should any specific hardening be required, check `usg` to [harden your servers][06] for CIP and FIPS
139
+
tutorials.
140
+
Learn more about networking requirements (such as egress traffic, endpoints and ports) by reading
141
+
[Ubuntu Pro Client network requirements][07].
143
142
144
-
For more information about networking requirements for making sure Pro enablement process works
145
-
(such as egress traffic, endpoints and ports)
146
-
[check this documentation](https://canonical-ubuntu-pro-client.readthedocs-hosted.com/en/latest/references/network_requirements.html).
143
+
## Frequently Asked Questions
147
144
148
-
### Does shutting down the machine stop billing?
145
+
**Does shutting down the machine stop billing?**
149
146
150
-
If you launch Ubuntu Pro from Azure Marketplace you pay as you go, so, if you don’t have any machine running, you won’t pay anything additional.
147
+
Launching Ubuntu Pro from Azure Marketplace is you pay as you go and only charges for running
148
+
machines.
151
149
152
-
### Are there volume discounts?
150
+
**Are there volume discounts?**
153
151
154
152
Yes. Contact your Microsoft sales representative.
155
153
156
-
### Are Reserved Instances available?
154
+
**Are Reserved Instances available?**
155
+
156
+
Yes.
157
157
158
-
Yes
158
+
**If the customer doesn't perform the `auto attach` function, will they still get attached to pro on reboot?**
159
159
160
-
### If the customer doesn't do the auto attach will they still get attached to pro on reboot?
160
+
If the customer doesn't perform the _auto attach_, they still get the Pro attached upon reboot.
161
+
However, this action only applies if they're using version 28 of the Pro client.
161
162
162
-
If the customer doesn't perform the auto attach, they still get the Pro attached upon reboot.
163
-
However, this applies only if they have v28 of the Pro client.
163
+
- For Ubuntu Jammy and Focal, this process works as expected.
164
+
- For Ubuntu Bionic and Xenial, this process doesn't work due to older versions of the Pro client installed.
164
165
165
-
* For Jammy and Focal, this process works as expected.
166
-
* For Bionic and Xenial this process doesn't work due to the older versions of the Pro client installed.
0 commit comments