Moving the scripts located under /recipes/perl/rbac_roles to /recipes/perl/access-control for consistency (#77)

Updating README text to reflect the new script locations and content of the folder.

Author: jeffcjames

README.md

@@ -41,15 +41,16 @@ The new RBAC allows more granular permissions, improved flexibility and greater
 
 The system-defined roles shipped with NetBackup also changed from 8.1.2 to the 8.3 release.  In 8.1.2, there were three system-defined roles available for RBAC configuration.  In the 8.3 release, this was simplified to offer a single “Administrator” role which has all privileges for RBAC.
 
-Due to the significant design shift, automatic upgrade conversion of 8.1.2 RBAC roles to the new 8.3 roles is not feasible.  However, tools are available to migrate the Backup administrator role and create a new Security administrator role for the users that had the old RBAC Security administrator role. Other roles must be reconfigured manually. 
+Due to the significant design shift, automatic upgrade conversion of 8.1.2 RBAC roles to the new 8.3 roles is not feasible.  However, tools are available to migrate the Backup administrator role and create a new Security administrator role for the users that had the old RBAC Security administrator role. 
+Other roles must be reconfigured manually. 
 There is also a script in this repository available to generate templated NetBackup roles.
-See **/recipes/perl/rbac-roles/rbac_role_templates.pl**
+See **/recipes/perl/access-control/rbac_role_templates.pl**
 
 
 Any API keys in use prior to upgrade will still be valid, however, the underlying access granted those API keys must
  be reconfigured using the new RBAC configuration, after which any active user sessions must be removed.
 A utility script exists in this repository to help convert active API keys after upgrade to NetBackup 8.3.  
 See **/recipes/perl/access-control/access_control_api_requests.pl**
 
-Most of the API examples in this repository assume a valid JWT (Json Web Token) or API Key issued by NetBackup and do not incorporate role configuration as part of the script. 
-However, there may be some examples which do configure RBAC as part of the script and have not yet been updated to use the RBAC design.
+Most of the API examples in this repository assume a valid JWT (Json Web Token) or API Key issued by NetBackup and do
+ not incorporate role configuration as part of the script. However, there may be some examples which do configure RBAC as part of the script and have not yet been updated to use the RBAC design.

recipes/perl/access-control/README.md

@@ -1,7 +1,8 @@
 # NetBackup API Code Examples for Perl
 
-This directory contains code samples for converting RBAC principals behind registered API keys.
-
+This directory contains scripts and code samples to aid in the migration of NetBackup 8.1.2
+ roles to the new 8.3 design as well as scripts that can be used to generate typical roles using the new RBAC design.
+ 
 ## Disclaimer
 
 These scripts are only meant to be used as reference. They are not intended to be used in production environment.
@@ -13,10 +14,26 @@ These scripts are only meant to be used as reference. They are not intended to b
 
 ## Executing the recipes in Perl
 
-Use the following command to get RBAC principals behind registered API keys, get existing roles for RBAC gen1 roles, and create new access control roles accordingly.
+**Examples of updating access control roles used by API Keys.**  
+Use the following commands to get RBAC principals behind registered API keys, get existing 0roles for RBAC gen1 roles
+, and create new access control roles accordingly.
 
 - `perl list_api_keys.pl -hostname <hostname> -username <username> -password <password> [-domain_name <domain_name>] [-domain_type <domain_type>]` 
-
 - `perl list_gen1_roles.pl -hostname <hostname> -username <username> -password <password> [-domain_name <domain_name>] [-domain_type <domain_type>]` 
-
 - `perl create_access_control_role.pl -hostname <hostname> -username <username> -password <password> -role_name <role_name> [-role_description <role_description>] [-domain_name <domain_name>] [-domain_type <domain_type>]` 
+
+**Examples creating roles based on role templates.**
+
+- `rbac_role_templates.pl --host nbumaster.domain.com --user dennis --pass secret --domain_type unixpwd --list_templates`
+- `rbac_role_templates.pl --host nbumaster.domain.com --user bill --pass secret --domain_type NT --domain_name DOMAIN
+ --create_templates`
+- `rbac_role_templates.pl --host nbumaster.domain.com --token Iojwei38djasdf893n-23ds --template "VMware Administrator"`
+- `rbac_role_templates.pl --host nbumaster.domain.com --token Iojwei38djasdf893n-23ds --template "RHV Administrator
+" --name "EU RHV Administrator"`
+
+**Examples migrating NetBackup 8.1.2 roles to new 8.3 administrator roles.**
+- `rbac_user_migration.pl --host nbumaster.domain.com --user dennis --pass secret --domain_type unixpwd`
+- `rbac_user_migration.pl --host nbumaster.domain.com --user bill --pass secret --domain_type NT --domain_name DOMAIN`
+- `rbac_user_migration.pl --host nbumaster.domain.com --token Iojwei38djasdf893n-23ds`
+
+