Fixed some formatting issues.

Author: kcantrel

Management-Utilities/auto_create_sm_relationships/README.md

@@ -15,61 +15,55 @@ This script is used to ensure that all your volumes, in all your FSxN file syste
 ## Set Up
 There are a few things you need to do in order to get this script to run properly:
 
-- Set up a secret for each of the FSxN file systems in the AWS Secrets Manager. Each secret should have two "keys" (they can be named anything, since you set the name of the key the scretsTable defined below.):
+- Set up a secret for each of the FSxN file systems in the AWS Secrets Manager. Each secret should have two "keys" (they can be named anything, since you set the name of the key the scretsTable defined below):
     - username - set to the username you want the script to use when issuing API to the ONTAP system.
     - password - set to the password of the username specified with the username key.
 - Edit the top of the script and fill in a few variables:
-- partnerTable - This table provides the association with a source FSxN file system to its partner cluster (i.e. where its volumes should be SnapMirror'ed to.) There should be five fields for each entry:
-    - fsxId - Set to the AWS ID of the FSx file system.
-    - svmName - Set to the SVM name on the FSxN file system.
-    - partnerFsxnIP - Set to the IP address of the management port of the partner FSxN file system.
-    - partnerSvmName - The name of the SVM where you want the SnapMirror destination volume to reside.
-    - partnerSvmSourceName - Is the "peered name" of the source SVM. Usually, it is the same as the source SVM, but can be different if that same name already exists on the partner file system. When you peer the SVM it will require you to create an alias for the source SVM so all the SVM names are unique.
+    - partnerTable - This table provides the association with a source FSxN file system to its partner cluster (i.e. where its volumes should be SnapMirror'ed to.) There should be five fields for each entry:
+        - fsxId - Set to the AWS ID of the FSx file system.
+        - svmName - Set to the SVM name on the FSxN file system.
+        - partnerFsxnIP - Set to the IP address of the management port of the partner FSxN file system.
+        - partnerSvmName - The name of the SVM where you want the SnapMirror destination volume to reside.
+        - partnerSvmSourceName - Is the "peered name" of the source SVM. Usually, it is the same as the source SVM, but can be different if that same name already exists on the partner file system. When you peer the SVM it will require you to create an alias for the source SVM so all the SVM names are unique.
+    - dynamodbPartnersTableName and dynamodbRegion - Instead of filling out the partnerTable in the source code, you can populate a DynamoDB table with the information and define these two variables to point to that table. Note that if both partnerTable and these two variables are defined, the partnerTable will be used. Also note that the required fields in the DynamoDB are a little different than the partnerTable. Here are the fields that should be defined in the DynamoDB table:
+        - soureceId - Which is the concatenation of the source file system ID followed by a ":" followed by the SVM name. It is done this way because the id has to be unique in the table. It is split up into its two components in the script when it is read in.
+        - partnerFsxnIp - Set to the IP address of the management port of the partner FSxN file system.
+        - partnerSvmName - The name of the SVM where you want the SnapMirror destination volume to reside.
+        - partnerSvmSourceName - Is the "peered name" of the source SVM. Usually, it is the same as the source SVM, but can be different if that same name already exists on the partner file system. When you peer the SVM it will require you to create an alias for the source SVM so all the SVM names are unique.
+    - secretsTable - This table provides the secret name, and username and password keys to use for each of the file systems. It should have 4 fields:
+        - fsxId - Set to the AWS File System ID.
+        - secretName - Set to the name of the secret created in step one.
+        - usernameKey - Set to the name of the key that holds the username.
+        - passwordKey - Set to the name of the key that holds the password.
+    - dynamodbSecretsTableName and dynamodbRegion - Instead of defining the secretsTable in the source code, you can populate a DynamoDB table with the information and define these variables to point to that table. The table should have the same fields as the secretsTable defined above
+    - secretsManagerRegion - Set to the region where the Secrets Manager has been set up.
+    - destinationVolumeSuffix - Set to the string you want appended to the source volume name to create the destination volume name.
+    - snapMirrorPolicy - Set to the Data ONTAP SnapMirror policy you want the assigned to the SnapMirror relationship.
+    - maxSnapMirrorRelationships - Set to the maximum number of SnapMirror relationship initializations you want this script to create in a single run.
+    - dryRun - If set to 'True' (case sensitive) the script will just show what it would have done, instead of actually creating the SnapMirror relationships.
+    - protectAll - If set to 'True' (case sensitive) the script will protect all volumes that don't have a "protect_volume" tag set to "skip". If set to 'False' it will only protect volumes that have a "protect_volume" tag set to "protect".
 
-    **NOTE:** Instead of defining the partnersTable in the script, you can define dynamodbPartnersTableName and dynamodbRegion and the script will read in the partner information from the specified DynamoDB table. The partners table should have the following fields:
+- If you want to run this script as a Lambda program, then you'll need to:
+    - Create a role that has the following permissions:
+        - secretsmanager:GetSecretValue
+        - ec2:DescribeRegions
+        - fsx:DescribeFileSystems
+        - fsx:DescribeVolumes
+        - fsx:ListTagsForResources
+        - dynamodb:GetItem - Optional, only needed if you are using a DynamoDB table to access the secretsTable or partnerTable.
 
-    - soureceId - Which is the concatentation of the source file system ID followed by a ":" followed by the SVM name. It is done this way because the id has to be unique in the table. It is split up into its two components in the script when it is read in.
-    - partnerFsxnIp - Set to the IP address of the management port of the partner FSxN file system.
-    - partnerSvmName - The name of the SVM where you want the SnapMirror destination volume to reside.
-    - partnerSvmSourceName - Is the "peered name" of the source SVM. Usually, it is the same as the source SVM, but can be different if that same name already exists on the partner file system. When you peer the SVM it will require you to create an alias for the source SVM so all the SVM names are unique.
-
-- secretsTable - This table provides the secret name, and username and password keys to use for each of the file systems. It should have 4 fields:
-    - fsxId - Set to the AWS File System ID.
-    - secretName - Set to the name of the secret created in step one.
-    - usernameKey - Set to the name of the key that holds the username.
-    - passwordKey - Set to the name of the key that holds the password.
-
-    **NOTE:** Instead of defining the secretsTable in the script, you can define dynamodbSecretsTableName and dynamodbRegion and the script will read in the secretsTable information from the specified DynamoDB table. The table should have the same fields as the secretsTable defined above.
-
-- secretsManagerRegion - Set to the region where the Secrets Manager has been set up.
-- destinationVolumeSuffix - Set to the string you want appended to the source volume name to create the destination volume name.
-- snapMirrorPolicy - Set to the Data ONTAP SnapMirror policy you want the assigned to the SnapMirror relationship.
-- maxSnapMirrorRelationships - Set to the maximum number of SnapMirror relationship initializations you want this script to create in a single run.
-- dryRun - If set to 'True' (case sensitive) the script will just show what it would have done, instead of actually creating the SnapMirror relationships.
-- protectAll - If set to 'True' (case sensitive) the script will protect all volumes that don't have a "protect_volume" tag set to "skip". If set to 'False' it will only protect volumes that have a "protect_volume" tag set to "protect".
-
-If you want to run this script as a Lambda program, then you'll need to
-- Create a role that has the following permissions:
-    - secretsmanager:GetSecretValue
-    - ec2:DescribeRegions
-    - fsx:DescribeFileSystems
-    - fsx:DescribeVolumes
-    - fsx:ListTagsForResources
-    - dynamodb:GetItem - Optional, only needed if you are using a DynamoDB table to access the secretsTable or partnersTable.
-
-Create AWS endpoints for any services that it uses. Currently that is:
-- ec2
-- fsx
-- SecretsManager
-- dynamodb - Optional, only needed if you are using a DynamoDB table to access the secretsTable or partnersTable.
+    - Create AWS endpoints for any services that it uses. Currently that is:
+        - ec2
+        - fsx
+        - SecretsManager
+        - dynamodb - Optional, only needed if you are using a DynamoDB table to access the secretsTable or partnersTable.
 
 # Running The Script
 To run the script on a Linux host, you just need to change the UNIX permissions on the file to be executable, then run it as a command:
-
+```
 chmod +x auto_creaate_sm_relationships
- 
-./auto_create_sm_relationships
-
+ ./auto_create_sm_relationships
+```
 To run it as a Lambda function you will need to:
 - Create the Lambda function with a Python runtime, from scratch, and paste the program into code box and save it.
 - Associate the role created above with the Lambda function.