Skip to content

Commit 3d6541b

Browse files
authored
docs(ins): fixed titles (#4110)
1 parent 3a1dfb5 commit 3d6541b

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

compute/instances/reference-content/identify-devices.mdx

+8-8
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ An Instance is composed of a multitude of devices. Some of them can be configure
1717

1818
On a Linux host, devices are named by the kernel in the order they are discovered. The order in which devices are discovered is dependent on things such as the topology of the PCI hierarchy which are *not* guaranteed to be stable across power off/power on/reboot actions.
1919

20-
This guide aims to provide tips to help you identify devices in a stable manner on a Linux host.
20+
This guide aims to provide tips to help you stably identify devices on a Linux host.
2121

22-
# Identifying Instance Block Storage volumes (b_ssd)
22+
## Identifying Instance Block Storage volumes (b_ssd)
2323

2424
Instance Block Storage (`b_ssd`) volumes are connected to the Instance as SCSI disks. They will therefore appear as devices handled by the sd driver in the dev file system, i.e. as `/dev/sd{a,b,c...}` devices.
2525

@@ -96,7 +96,7 @@ Note that this rule relies on `ID_VENDOR` and `ID_SERIAL_SHORT` being in the env
9696

9797
For more details on writing `udev` rules, please see `man 7 udev`.
9898

99-
# Identifying Block Storage volumes (SBS)
99+
## Identifying Block Storage volumes (SBS)
100100

101101
Block Storage devices are similar to Instance Block Storage devices. They are also connected to the Instance as SCSI devices and thus all explanations from the above section are also valid.
102102

@@ -117,7 +117,7 @@ sdb 0:0:1:0 disk SCW b_ssd v42 volume-03e206f6-2a3b-4223-bb56-3d7f1495
117117

118118
Here, the first volume has been created through the Block Storage API with class `sbs`. The second volume is an Instance Block Storage (`b_ssd`) volume which has been migrated to Block Storage, and is now a Block Storage volume with class `bssd`.
119119

120-
# Identifying VPC Private Network interfaces
120+
## Identifying VPC Private Network interfaces
121121

122122
VPC Private Networks to which the Instance is connected will appear as virtio PCI network devices, handled by the `virtio-net` driver.
123123

@@ -151,7 +151,7 @@ root@test-instance:~# ip link show
151151
altname enp0s6
152152
```
153153

154-
Here, four interfaces are listed, one of which (`lo`) is the virtual loopback interface and can be disregarded. The three other correspond to the aforementioned public network interface, and VPC Private Network interfaces.
154+
Here, four interfaces are listed, one of which (`lo`) is the virtual loopback interface and can be disregarded. The three others correspond to the aforementioned public network interface and VPC Private Network interfaces.
155155

156156
A simple and effective way to distinguish the public network interface from the VPC Private Network interfaces is the MAC address prefix. VPC Private Network interfaces always have a MAC address starting with `02:00:00`.
157157

@@ -195,7 +195,7 @@ For example, querying `/instances/v1/<zone>/servers/<uuid>/private_nics`, where
195195
}
196196
```
197197

198-
Two entries are listed, which correspond to the interfaces given by the output of `ip link show` above. The output contains the ID of the VPC Private Network, which helps distinguishing between the two.
198+
Two entries are listed, which correspond to the interfaces given by the output of `ip link show` above. The output contains the ID of the VPC Private Network, which helps distinguish between the two.
199199

200200
Through the use of `udev` rules, it is possible to rename the interfaces if desired. For example, the following rule would assign the static name `priv0` to the interface with MAC address `02:00:00:b7:c8:a5`:
201201

@@ -209,5 +209,5 @@ If a more complex scheme is desired, such as including part of the name of the c
209209
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="02:00:00:*", ENV{SYSTEMD_WANTS}="my-vpc-script@$env{ID_NET_NAME}.service"
210210
```
211211

212-
This rule would start the systemd service `my-vpc-service@<ifname>` when a new interface with name `<ifname>` is added and has a MAC address matching the VPC Private Network prefix.
213-
The systemd service can then execute complex operations (retrieving the server's `private_nics` informations, the VPC Private Network information through the VPC API, applying custom logic, etc.).
212+
This rule would start the systemd service `my-vpc-service@<ifname>` when a new interface with the name `<ifname>` is added and has a MAC address matching the VPC Private Network prefix.
213+
The systemd service can then execute complex operations (retrieving the server's `private_nics` information, the VPC Private Network information through the VPC API, applying custom logic, etc.).

0 commit comments

Comments
 (0)