Edits

Author: v-tappelgate

support/windows-server/system-management-components/troubleshoot-openssh-connection-issues-maxstartups-maxsessions.md

@@ -17,13 +17,13 @@ appliesto:
 # How to use "MaxStartups" and "MaxSessions" to troubleshoot OpenSSH connection issues
 
 This guide explains how to use the `MaxStartups` and `MaxSessions` parameters to limit client connections to the OpenSSH Server service.
-These settings help you troubleshoot connection issues and to manage unauthenticated and authenticated SSH sessions, especially in high-load environments.
+These settings help you troubleshoot connection issues and manage unauthenticated and authenticated SSH sessions, especially in high-load environments.
 
 ## Symptoms
 
 You can use `MaxStartups` and `MaxSessions` to address the following types of symptoms.
 
-- Symptom 1: Clients can't connect to the OpenSSH Server service and establish sessions. Additionally, you might see errors such as the following messages:
+- Symptom 1: Clients can't connect to the OpenSSH Server service and establish sessions. Additionally, you might receive the following error messages:
 
   - Connection reset by peer
   - Exceeded MaxStartups
@@ -33,28 +33,28 @@ You can use `MaxStartups` and `MaxSessions` to address the following types of sy
 
 ## Cause
 
-Symptom 1 indicates that too many client applications are connecting to the OpenSSH Server service at once.
+Symptom 1 indicates that too many client applications are connecting to the OpenSSH Server service at the same time.
 
-Symptom 2 is limited to multiplexing environments, and indicates that the OpenSSH Server service can't support the number of sessions per connection that the clients are using. This symptom can occur after you configure`MaxStartups`.
+Symptom 2 is limited to multiplexing environments. It indicates that the OpenSSH Server service can't support the number of sessions per connection that the clients are using. This symptom can occur after you configure`MaxStartups`.
 
 ## How to use the parameters
 
-`MaxStartups`and `MaxSessions` are parameters in the sshd_config file, and function as follows.
+`MaxStartups`and `MaxSessions` are parameters in the sshd_config file. The following sections explain how they function.
 
 ### MaxStartups
 
-The `MaxStartups` parameter defines how many concurrent unauthenticated connections the OpenSSH Server service can manage. This setting is especially useful on servers that support multiple parallel SSH connections, such as jump hosts or provisioning servers (such as servers that use Ansible). It's also useful in high-load environments or during brute-force attacks.
+The `MaxStartups` parameter defines how many concurrent unauthenticated connections the OpenSSH Server service can manage. This setting is especially useful on servers that support multiple parallel SSH connections, including jump hosts and provisioning servers (such as servers that use Ansible). It's also useful in high-load environments or during brute-force attacks.
 
-The value is a set of three integers separated by colons, in the format `start:rate:full`. The integers represent the following values:
+The value is a set of three integers that are separated by colons, in the format `Start:Rate:Full`. The integers represent the following values:
 
-- **start**: The number of unauthenticated connections that the OpenSSH Server service supports before it starts dropping connections.
-- **rate**: Probability that the OpenSSH Server service drops a connection. As long as the number of concurrent sessions is below the `start` value, the service ignores `rate`. However, when the number of concurrent connections surpasses `start`, each additional connection has a `rate`% probability of being dropped.
-- **full**: When the number of concurrent connections surpasses `full`, the service drops all additional connections.
+- **Start**: The number of unauthenticated connections that the OpenSSH Server service supports before it starts dropping connections.
+- **Rate**: Probability that the OpenSSH Server service drops a connection. As long as the number of concurrent sessions is below the `Start` value, the service ignores `Rate`. However, when the number of concurrent connections surpasses `Start`, each additional connection has a `Rate` percent probability of being dropped.
+- **Full**: When the number of concurrent connections surpasses `Full`, the service drops all additional connections.
 
-For example, consider a system that's using the configuration `MaxStartups 20:40:60`. The OpenSSH Server service manages connections as follows:
+For example, consider a system that's using the configuration, `MaxStartups 20:40:60`. The OpenSSH Server service manages connections as follows:
 
 - The service maintains the first 20 concurrent unauthenticated connections. 
-- Starting with the 21st connection attempt, there's a 40% probability that the server drops the new connection attempt.
+- Starting at the 21st connection attempt, there's a 40 percent probability that the server drops the new connection attempt.
 - After the service reaches 60 concurrent unauthenticated connections, the server rejects all further connection attempts.
 
 ### MaxSessions
@@ -63,9 +63,9 @@ The `MaxSessions` parameter defines how many open shell, login, or subsystem (fo
 
 ### How to set the connection parameters
 
-To modify these parameters for the Windows OpenSSH Server service, modify the sshd_config file and restart the OpenSSH Server service. To do this, follow these steps:
+To modify the parameters for the Windows OpenSSH Server service, modify the sshd_config file, and then restart the OpenSSH Server service. To do this, follow these steps:
 
-1. Using an Administrator-level account, open a text editor, and then open **%ProgramData%\ssh\sshd_config**. The default text these settings should resemble the following excerpt:
+1. Using an Administrator-level account, open a text editor, and then open **%ProgramData%\ssh\sshd_config**. The default text for these settings should resemble the following excerpt:
 
    ```output
    #MaxStartups 10
@@ -78,7 +78,7 @@ To modify these parameters for the Windows OpenSSH Server service, modify the ss
    > [!NOTE]  
    > `MaxSessions` typically appears within the `# Authentication` section of the file. `MaxStartups` typically appears in a list of general options later in the file.
 
-1. To enable `MaxStartup` or `MaxSessions` and set values, edit the text to resemble the following excerpt:
+1. To enable `MaxStartup` or `MaxSessions` and to set values, edit the text to resemble the following excerpt:
 
    ```output
 
@@ -90,7 +90,7 @@ To modify these parameters for the Windows OpenSSH Server service, modify the ss
    ```
 
    > [!NOTE]  
-   > In this command, `20:40:60` and `15` are example values. Use values that're appropriate for your environment.
+   > In this command, `20:40:60` and `15` are example values. Use values that are appropriate for your environment.
 
 1. Save and close the sshd_config file.
 
@@ -110,7 +110,7 @@ After the service restarts, it uses the new parameter values.
 
 ## More information
 
-- [Windows configurations in sshd_config](/windows-server/administration/OpenSSH/openssh-server-configuration#windows-configurations-in-sshd_config) in "OpenSSH Server configuration for Windows Server and Windows"
+- [Windows configurations in sshd_config](../windows-server/administration/OpenSSH/openssh-server-configuration#windows-configurations-in-sshd_config) in "OpenSSH Server configuration for Windows Server and Windows"
 - [sshd_config(5) - Linux manual page](https://man7.org/linux/man-pages/man5/sshd_config.5.html)
 - [sshd_config - OpenSSH daemon configuration file](https://man.openbsd.org/sshd_config)