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
Copy file name to clipboardexpand all lines: compute/instances/reference-content/identify-devices.mdx
+8-8
Original file line number
Diff line number
Diff line change
@@ -17,9 +17,9 @@ An Instance is composed of a multitude of devices. Some of them can be configure
17
17
18
18
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.
19
19
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.
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.
25
25
@@ -96,7 +96,7 @@ Note that this rule relies on `ID_VENDOR` and `ID_SERIAL_SHORT` being in the env
96
96
97
97
For more details on writing `udev` rules, please see `man 7 udev`.
98
98
99
-
# Identifying Block Storage volumes (SBS)
99
+
##Identifying Block Storage volumes (SBS)
100
100
101
101
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.
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`.
119
119
120
-
# Identifying VPC Private Network interfaces
120
+
##Identifying VPC Private Network interfaces
121
121
122
122
VPC Private Networks to which the Instance is connected will appear as virtio PCI network devices, handled by the `virtio-net` driver.
123
123
@@ -151,7 +151,7 @@ root@test-instance:~# ip link show
151
151
altname enp0s6
152
152
```
153
153
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.
155
155
156
156
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`.
157
157
@@ -195,7 +195,7 @@ For example, querying `/instances/v1/<zone>/servers/<uuid>/private_nics`, where
195
195
}
196
196
```
197
197
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.
199
199
200
200
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`:
201
201
@@ -209,5 +209,5 @@ If a more complex scheme is desired, such as including part of the name of the c
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