update ssh unit

Author: JnHs

learn-pr/azure/manage-linux-with-arc/includes/2-describe-managing-linux-concepts.md

@@ -1,5 +1,7 @@
 Azure Arc lets you manage physical and virtual Linux machines hosted outside of Azure, whether on your corporate network or on another cloud provider. Organizations like Contoso can manage their Linux resources with Azure, just as they do their Arc-enabled Windows machines. Linux machines onboarded to Azure Arc enjoy the same capabilities as native Azure machines, including standard Azure constructs such as Azure policy and applying tags.
 
+To onboard a Linux machine to Azure Arc, you deploy the Azure Arc Connected machine agent to the machine. Azure Arc provides multiple options for deploying the agent individually or at scale across multiple machines. Once the agent is installed and functioning properly, the machine appears as an Arc resource in the Azure portal, and you can manage it like any other Azure resource.
+
 Once your Linux machines are onboarded to Azure Arc, you can:
 
 - Proactively monitor the OS and workloads running on the machine.

learn-pr/azure/manage-linux-with-arc/includes/3-describe-using-ssh.md

@@ -1,57 +1,37 @@
 Contoso uses SSH for their Windows machines to provide secure management, remote access to resources, and updates. They want to apply that same level of security to their Linux systems. Through SSH, Azure Arc provides Contoso with a secure, encrypted connection for managing both their Windows and Linux machines.
 
-SSH for Azure Arc provides SSH-based connections to Linux machines on Azure Arc without requiring a public IP address or other open ports. This functionality can be used interactively, automated, or with existing SSH-based tooling, allowing existing management tools to have a greater impact. SSH access allows you to reach your Linux machines through a simple Azure CLI command or through Microsoft PowerShell. You can use your existing local SSH keys to connect to your Linux machines.
+SSH for Azure Arc provides SSH-based connections to Linux machines on Azure Arc without requiring a public IP address or other open ports. This functionality can be used interactively, automated, or with existing SSH-based tooling, allowing existing management tools to have a greater impact. With SSH you can access any of your machines, in any network, with one Azure CLI or Microsoft PowerShell command. You can use your existing local SSH keys to connect to your machines. With Linux machines, you can also use SSH with Microsoft Entra credentials. 
 
-Additionally, you can use SSH with Microsoft Entra credentials. With SSH you can access any of your machines, in any network, with one command. All without exposing a public IP address or opening more inbound firewall ports.
-
-> [!NOTE]
-> Microsoft Entra authorization is limited to Linux machines.
-
-## Supported Linux environments
-
-For SSH access to Azure Arc-enabled servers, the supported Linux environments include:
-
-- RedHat Enterprise Linux (RHEL) 7, 8, and 9
-- SUSE Linux Enterprise Server (SLES) 12 SP3-SP5 and 15
-- Ubuntu 18.04, 20.04, and 22.04 LTS12
-- Azure Linux (CBL-Mariner) 2.0
-- AlmaLinux 9
-- Amazon Linux 2 and 2023
-- Debian 11 and 12
-- Oracle Linux 7, 8, and 9
-- Rocky Linux 8 and 9
-
-## Enabling SSH functionality
-
-In order to connect to a Linux resource using SSH through Azure Arc, the resource needs to be fully Arc-enabled. That means that it already has the Azure Arc Connected machine agent installed and functioning properly, so that the resource appears as an Arc resource in the Azure portal.
+## Enable SSH functionality
 
 To use SSH with a Linux machine connected via Azure Arc, the following high-level steps are required:
 
 1. Verify that you satisfy all the prerequisites. You need:
 
-    - Azure CLI installed on your remote work station
+    - Azure CLI or Azure PowerShell installed on your remote workstation. The examples below use Azure CLI.
     - To be logged in to your Azure environment
+    - `openssh-server` installed on the machine via a package manager
 
 1. Enable connections on the Connected Machine agent installed on the Linux machine.
 
-    Run the following command to view your current connections:
+    View your current connections:
 
     `azcmagent config list`
 
-    If you have existing ports, you need to include them in the following command:
+    Ensure connection is enabled to a specific port:
 
-    `azcmagent config set incomingconnections.ports 22<,other open ports,...>`
+    `azcmagent config set incomingconnections.ports 22`
 
-    If you're using a nondefault port for your SSH connection, replace port 22 with your desired port in the previous command.
+    Replace port 22 in this command if you use a different port, or add additional ports if needed.
 
 1. Install the SSH extension on your remote workstation:
 
     `az extension add --name ssh`
 
-1. Run the following command to make the connection between the workstation to the linux machine through Azure Arc:
+1. Make the connection between the workstation to the Linux machine through Azure Arc:
 
-    `az ssh arc --resource-group \<resource-group\> \<host-name\> --local-user \<local-user-name\>`
+    `az ssh arc --resource-group YOUR_RESOURCE_GROUP YOUR_HOSTNAME --local-user YOUR_LOCAL_USER_NAME`
 
-    To connect using Microsoft Entra ID instead of connecting as a local user, remove the `--local-user` parameter from the preceding command. You need to already be logged in through Microsoft Entra ID for this method to work.
+    To connect using Microsoft Entra ID instead of connecting as a local user, remove the `--local-user` parameter from the preceding command. You need to already be logged in through Microsoft Entra ID for this method to work, and additional packages must be installed on the Linux machine.
 
 Once you establish your SSH connection, you can manage the Linux resource securely.