AWS mgn documentation change
Summary
Updated verb tenses and phrasing for clarity throughout Linux agent installation documentation
Security assessment
Changes consist of grammatical improvements and tense adjustments (e.g., 'will download' to 'downloads', 'will prompt' to 'prompts'). No security vulnerabilities or new security features are mentioned or addressed in the changes.
Diff
diff --git a/mgn/latest/ug/linux-agent.md b/mgn/latest/ug/linux-agent.md index dba1763c0..3d313b867 100644 --- a/mgn/latest/ug/linux-agent.md +++ b/mgn/latest/ug/linux-agent.md @@ -7 +7 @@ -Complete the following steps to install the AWS Replication Agent on Linux source servers. +Complete these steps to install the AWS Replication Agent on Linux source servers. @@ -11 +11 @@ Complete the following steps to install the AWS Replication Agent on Linux sourc - 2. Download the agent installer with the wget command your Linux source server. This wget command will download the Agent installer file - aws-replication-installer-init onto your server. + 2. Download the agent installer with the wget command your Linux source server. This wget command downloads the Agent installer file - aws-replication-installer-init onto your server. @@ -13 +13 @@ Complete the following steps to install the AWS Replication Agent on Linux sourc -The Agent installer follows the following format: `https://aws-application-migration-service-<region>.s3.<region>.amazonaws.com/latest/linux/aws-replication-installer-init` . Replace `<region>` with the AWS Region into which you are replicating. +The Agent installer follows this format: `https://aws-application-migration-service-<region>.s3.<region>.amazonaws.com/latest/linux/aws-replication-installer-init` . Replace `<region>` with the AWS Region into which you are replicating. @@ -15 +15 @@ The Agent installer follows the following format: `https://aws-application-migra -The following is an example of the full wget command for us-east-1: +This is an example of the full wget command for us-east-1: @@ -19 +19 @@ The following is an example of the full wget command for us-east-1: -The command line will indicate when the installer has been successfully downloaded. +The command line indicates when the installer has been successfully downloaded. @@ -33 +33 @@ https://aws-application-migration-service-hashes-us-east-1.s3.us-east-1.amazonaw - * The Linux installer creates the "`aws-replication`" group and "`aws-replication`" user within that group. The Agent will run within the context of the newly created user. Agent installation will attempt to add the user to "`sudoers`". Installation will fail if the Agent is unable to add the newly created "`aws-replication`" user to "`sudoers`". + * The Linux installer creates the "`aws-replication`" group and "`aws-replication`" user within that group. The Agent runs within the context of the newly created user. Agent installation attempts to add the user to "`sudoers`". Installation fails if the Agent is unable to add the newly created "`aws-replication`" user to "`sudoers`". @@ -39 +39 @@ https://aws-application-migration-service-hashes-us-east-1.s3.us-east-1.amazonaw -The following table contains the installer download link by supported AWS Region: +This table contains the installer download link by supported AWS Region: @@ -78 +78 @@ AWS GovCloud (US-West) | us-gov-west-1 | https://aws-application-migration-servi -When using [temporary credentials](./credentials.html) (created using an IAM role instead of a user), you will need to enter the following parameters into the command prompt: +When using [temporary credentials](./credentials.html) (created using an IAM role instead of a user), you need to enter these parameters to the command prompt: @@ -86 +86 @@ When using [temporary credentials](./credentials.html) (created using an IAM rol -The request to enter an AWS session token will only appear if the system identifies that you are using temporary credentials. AWS access key for temporary credentials begins with the letters ASIA. +The request to enter an AWS session token only appears if the system identifies that you are using temporary credentials. AWS access key for temporary credentials begins with the letters ASIA. @@ -94 +94 @@ You can choose to add the Region and required credential as parameters in the in - * **\--region** – The AWS Region in which the installer will register the source server. + * **\--region** – The AWS Region in which the installer registers the source server. @@ -96 +96 @@ You can choose to add the Region and required credential as parameters in the in - * **\--aws-access-key-id** – The AWS IAM Access Key used for authenticating the installing user. If this parameter is not provided, the installer will prompt for it. + * **\--aws-access-key-id** – The AWS IAM Access Key used for authenticating the installing user. If this parameter is not provided, the installer prompts for it. @@ -98 +98 @@ You can choose to add the Region and required credential as parameters in the in - * **\--aws-secret-access-key** – The AWS IAM Secret Access Key tied to the AWS IAM Access Key used for authenticating the installing user. If this parameter is not provided, the installer will prompt for it. + * **\--aws-secret-access-key** – The AWS IAM Secret Access Key tied to the AWS IAM Access Key used for authenticating the installing user. If this parameter is not provided, the installer prompts for it. @@ -100 +100 @@ You can choose to add the Region and required credential as parameters in the in - * **\--aws-session-token** – The session token is generated when using [temporary credentials](./credentials.html) that are generated using AWS STS. If you use temporary credentials and do not provide this parameter, the installer will prompt for it. + * **\--aws-session-token** – The session token is generated when using [temporary credentials](./credentials.html) that are generated using AWS STS. If you use temporary credentials and do not provide this parameter, the installer prompts for it. @@ -144 +144 @@ To start the replication post installation of replication agent using `--no-repl -The installer will confirm that the installation of the AWS Replication Agent has started. +The installer confirms that the installation of the AWS Replication Agent has started. @@ -148 +148 @@ The installer will confirm that the installation of the AWS Replication Agent ha - 5. The installer will prompt you to enter your **AWS Region Name** , the **AWS Access Key ID** , the **AWS Secret Access Key** , and the **AWS Session Token** that you previously generated. Enter the complete AWS Region name (for example, eu-central-1) and the full credentials. + 5. The installer prompts you to enter your **AWS Region Name** , the **AWS Access Key ID** , the **AWS Secret Access Key** , and the **AWS Session Token** that you previously generated. Enter the complete AWS Region name (for example, eu-central-1) and the full credentials. @@ -154 +154 @@ The installer will confirm that the installation of the AWS Replication Agent ha - * You can also enter these values as part of the installation script command parameters. If you do not enter these parameters as part of the installation script, you will be prompted to enter them one by one as described above. (for example: `sudo chmod +x aws-replication-installer-init; sudo ./aws-replication-installer-init --region regionname --aws-access-key-id AKIAIOSFODNN7EXAMPLE --aws-secret-access-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`). + * You can also enter these values as part of the installation script command parameters. If you do not enter these parameters as part of the installation script, you are prompted to enter them one by one as described above. (for example: `sudo chmod +x aws-replication-installer-init; sudo ./aws-replication-installer-init --region regionname --aws-access-key-id AKIAIOSFODNN7EXAMPLE --aws-secret-access-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`). @@ -156 +156 @@ The installer will confirm that the installation of the AWS Replication Agent ha - * The AWS Access Key ID and AWS Secret Access Key values will be hidden when entered into the installer. + * The AWS Access Key ID and AWS Secret Access Key values are hidden when entered into the installer. @@ -158 +158 @@ The installer will confirm that the installation of the AWS Replication Agent ha - 6. Once you have entered your credentials, the installer will identify volumes for replication. The installer will display the identified disks and prompt you to choose the disks you want to replicate. + 6. Once you have entered your credentials, the installer will identify volumes for replication. The installer displays the identified disks and prompt you to choose the disks you want to replicate. @@ -162 +162 @@ The installer will confirm that the installation of the AWS Replication Agent ha -To replicate some of the disks, type the path of the disks, separated by a comma, as illustrated in the installer (such as: /dev/sda, /dev/sdb, and more). To replicate all of the disks, click **Enter**. The installer will identify the selected disks and print their size. +To replicate some of the disks, type the path of the disks, separated by a comma, as illustrated in the installer (such as: /dev/sda, /dev/sdb, and more). To replicate all of the disks, click **Enter**. The installer identifies the selected disks and print their size. @@ -166 +166 @@ To replicate some of the disks, type the path of the disks, separated by a comma -The installer will confirm that all disks were successfully identified. +The installer confirms that all disks were successfully identified. @@ -184 +184 @@ If disks are disconnected from a server, AWS Application Migration Service can n -Note that the returned disks will need be replicated from the beginning. Any disk size changes will be automatically identified, but this will also cause a resync. Perform a test after installing the Agent to ensure that the correct disks have been added. +Note that the returned disks will need be replicated from the beginning. Any disk size changes are automatically identified, but this also causes a resync. Perform a test after installing the Agent to ensure that the correct disks have been added. @@ -186 +186 @@ Note that the returned disks will need be replicated from the beginning. Any dis - 7. After all of the disks that will be replicated have been successfully identified, the installer will download and install the AWS Replication Agent on the source server. + 7. After all of the disks that to be replicated have been successfully identified, the installer will download and install the AWS Replication Agent on the source server. @@ -190 +190 @@ Note that the returned disks will need be replicated from the beginning. Any dis - 8. Once the AWS Replication Agent is installed, the server will be added to the AWS Application Migration Service Console and will undergo the initial sync process. The installer will provide you with the source server's ID. + 8. Once the AWS Replication Agent is installed, the server is added to the AWS Application Migration Service Console and undergoes the initial sync process. The installer provides you with the source server's ID.