diff --git a/edge_manager/edge_mgr_enroll.adoc b/edge_manager/edge_mgr_enroll_devices.adoc similarity index 87% rename from edge_manager/edge_mgr_enroll.adoc rename to edge_manager/edge_mgr_enroll_devices.adoc index 5da07e95d4..2eb6ee2621 100644 --- a/edge_manager/edge_mgr_enroll.adoc +++ b/edge_manager/edge_mgr_enroll_devices.adoc @@ -4,10 +4,9 @@ To manage your devices with the {rhem}, you must enroll the devices to the {rhem} service. The first time the {rhem} agents runs on a device, the agent prepares for the enrollment process by generating a cryptographic key pair. -The cryptographic key pair serves as the unique cryptographic identity of the device. -The key pair consists of a public and a private key. +The cryptographic key pair of the device consists of a public and a private key. The private key never leaves the device, so that the device cannot be duplicated or impersonated. -The cryptographic identity is registered with the {rhem} service during enrollment and gets deleted during device decommissioning. +The key pair is registered with the {rhem} service during enrollment and is deleted during decommissioning of the device. When the device is not yet enrolled, the agent performs service discovery to find its {rhem} service instance. Then, the device establishes a secure, mTLS-protected network connection to the service. @@ -22,6 +21,13 @@ The device is not considered trusted and remains quarantined in a device lobby u For more information, read the following sections: //TODO Link to Enrollment, Requesting an enrollment certificate for early binding when docs are merged +[#enroll-device-prereqs] +== Prerequisites + +* You must install the {rhem} CLI. +//TODO Add link to Installing CLI +* You must log in to the {rhem} service. + [#enroll-cli] == Enrolling devices using the CLI diff --git a/edge_manager/edge_mgr_labels.adoc b/edge_manager/edge_mgr_label_devices.adoc similarity index 100% rename from edge_manager/edge_mgr_labels.adoc rename to edge_manager/edge_mgr_label_devices.adoc diff --git a/edge_manager/edge_mgr_manage.adoc b/edge_manager/edge_mgr_manage_devices.adoc similarity index 62% rename from edge_manager/edge_mgr_manage.adoc rename to edge_manager/edge_mgr_manage_devices.adoc index 37371c52db..7c6c83d23c 100644 --- a/edge_manager/edge_mgr_manage.adoc +++ b/edge_manager/edge_mgr_manage_devices.adoc @@ -2,20 +2,21 @@ = Managing devices After provisioning, you need to enroll your devices to manage them with the {rhem}. -Device management includes organizing, monitoring, and updating the operating system and applications on your devices with the {rhem}. +Device management includes organizing, monitoring, and updating your devices with the {rhem}. You can manage your devices individually or in a fleet. Managing your devices individually is advantageous in the following scenarios: -* If your device configurations vary for each device. -* If you need control over the order and timing of updates. +* If a few devices have different configuration. +* If you use external automation for updating the device. //For managing your devices in a fleet, see xref:../[] For more information, read the following sections: -* xref:../edge_manager/edge_mgmt_manage_enroll#enroll[Enrollment] -* xref:../edge_manager/edge_mgmt_manage_view#view-device[Viewing device inventory and device details] -* xref:../edge_manager/edge_mgmt_manage_organize#labels[Labels and label selectors] +* xref:../edge_manager/edge_mgr_enroll_devices#enroll[Enrolling devices] +* xref:../edge_manager/edge_mgr_view_devices#view-device[Viewing device inventory and device details] +* xref:../edge_manager/edge_mgr_label_devices#labels[Labels and label selectors] +* xref:../edge_manager/edge_mgr_update_labels_on_devices#update-labels-cli[Updating labels using the CLI] //// TODO Add links to remaining sections * xref:../edge_manager/edge_mgmt_manage_update_os#update-os[Updating the operating system] diff --git a/edge_manager/edge_mgr_update_labels.adoc b/edge_manager/edge_mgr_update_labels_on_devices.adoc similarity index 100% rename from edge_manager/edge_mgr_update_labels.adoc rename to edge_manager/edge_mgr_update_labels_on_devices.adoc diff --git a/edge_manager/edge_mgr_view.adoc b/edge_manager/edge_mgr_view_devices.adoc similarity index 98% rename from edge_manager/edge_mgr_view.adoc rename to edge_manager/edge_mgr_view_devices.adoc index 2547b70b70..5cdad698a4 100644 --- a/edge_manager/edge_mgr_view.adoc +++ b/edge_manager/edge_mgr_view_devices.adoc @@ -8,6 +8,7 @@ To obtain more information about the devices in your inventory, you can use the * You must install the {rhem} CLI. //TODO Add link to Installing CLI +* You must log in to the {rhem} service. * You must enroll at least one device. [#view-device-details] diff --git a/edge_manager/main.adoc b/edge_manager/main.adoc index f8e98de947..ccbce0fe78 100644 --- a/edge_manager/main.adoc +++ b/edge_manager/main.adoc @@ -4,8 +4,8 @@ include::modules/common-attributes.adoc[] include::edge_mgr_intro.adoc[leveloffset=+1] include::edge_mgr_enable.adoc[leveloffset=+2] -include::edge_mgr_manage.adoc[leveloffset=+2] -include::edge_mgr_enroll.adoc[leveloffset=+3] -include::edge_mgr_view.adoc[leveloffset=+3] -include::edge_mgr_labels.adoc[leveloffset=+3] -include::edge_mgr_update_labels.adoc[leveloffset=+3] +include::edge_mgr_manage_devices.adoc[leveloffset=+2] +include::edge_mgr_enroll_devices.adoc[leveloffset=+3] +include::edge_mgr_view_devices.adoc[leveloffset=+3] +include::edge_mgr_label_devices.adoc[leveloffset=+3] +include::edge_mgr_update_labels_on_devices.adoc[leveloffset=+3] \ No newline at end of file