Merge pull request #116 from NetAppDocs/mikrefresh_nikhilcomments_set1

Mikrefresh nikhilcomments set1

concept-clone-cloud-native-oracle-concepts.adoc

@@ -14,7 +14,7 @@ summary:  Understand the clone concepts before cloning the database.
 
 [.lead]
 
-You can clone an Oracle database using the backup of the database either to the source database host or to an alternate host. You can clone the backup from primary storage systems.
+You can clone an Oracle database residing on Amazon FSx for NetApp ONTAP or Cloud Volumes ONTAP using the backup of the database either to the source database host or to an alternate host. You can clone the backup from primary storage systems.
 
 Before cloning the database, you should understand the clone concepts and ensure that all the requirements are met.
 
@@ -43,6 +43,7 @@ If you are cloning to an alternate host, then make sure that an iSCSI session is
 
 == Limitations
 
+* Cloning of databases residing on Azure NetApp Files is not supported.
 * Cloning of databases residing on Qtree is not supported.
 * Backing up a cloned database is not supported.
 

concept-protect-cloud-app-data-to-cloud.adoc

@@ -50,7 +50,7 @@ IMPORTANT: The BlueXP SaaS infrastructure is resilient to availability zone fail
 
 * Add host and deploy plug-in
 +
-You can deploy the plug-in manually, using script, or automatically.
+You can deploy plugin using UI, script, or manually.
 * Auto-discovery of Oracle databases
 * Backing up Oracle databases residing on Amazon FSx for NetApp ONTAP, Cloud Volumes ONTAP, and Azure NetApp Files
 ** Full (data + control + archive log files) backup

reference-configure-azure-netapp-files.adoc

@@ -22,17 +22,10 @@ You should create Azure NetApp Files working environments where your databases a
 == Create a connector
 A BlueXP account admin should deploy a Connector in Azure that enables BlueXP to manage resources and processes within your public cloud environment.
 
-NOTE: You cannot update the new connector_id from the UI.
-
 For information, refer to link:https://docs.netapp.com/us-en/cloud-manager-setup-admin/task-creating-connectors-azure.html[Create a Connector in Azure from BlueXP].
 
-* You should use the same connector to manage both Azure NetApp Files working environment and databases.
+* Ensure that there is connectivity from the connector to the database hosts.
 * If you have the Azure NetApp Files working environment and databases in the same Virtual Network (VNet), you can deploy the connector in the same VNet.
 * If you have the Azure NetApp Files working environment and databases in different VNets and have NAS (NFS) workloads configured on Azure NetApp Files, then you can create the connector on either of the VNets.
 
-After creating the connector, perform the following:
-
-* Add the working environment by clicking *Storage* > *Canvas* > *My Working Environments* > *Add Working Environment*.
-+
-Ensure that there is connectivity from the connector to the database hosts and Azure NetApp Files working environment. The connector should connect to the Azure NetApp Files working environment.
-* Copy the Connector ID by clicking *Connector > Manage Connectors* and selecting the Connector name.
+After creating the connector, add the working environment by clicking *Storage* > *Canvas* > *My Working Environments* > *Add Working Environment*.

task-add-host-discover-oracle-databases.adoc

@@ -25,17 +25,17 @@ You should install the SnapCenter Plug-in for Oracle on each of the Oracle datab
 Before adding the host, you should ensure that the prerequisites are met.
 
 * You should have created the working environment and the Connector.
-* Ensure that the Connector has connectivity to the working environment and Oracle database hosts.
+* Ensure that the Connector has connectivity to the Oracle database hosts.
 +
 For information on how to resolve the connectivity issue, refer to link:https://kb.netapp.com/Advice_and_Troubleshooting/Data_Protection_and_Security/SnapCenter/Cloud_Backup_Application_Failed_to_validate_connectivity_from_BlueXP_connector_host_to_application_database_host[Failed to validate connectivity from BlueXP connector host to application database host].
 +
 When the connector is lost or if you have created a new connector, you should associate the connector with the existing application resources. For instructions to update the Connector, see link:task-manage-cloud-native-app-data.html#update-the-connector-details[Update the Connector Details].
 * Ensure that the BlueXP user has the “Account Admin” role.
+* Ensure that non root (sudo) account is present on the application host for data protection operations.
 * Ensure that either Java 11 (64-bit) Oracle Java or OpenJDK is installed on each of the Oracle database hosts and the JAVA_HOME variable is set appropriately.
 * Ensure that the Connector has the communication enabled to the SSH port (default: 22) if SSH based installation is performed.
 * Ensure that the Connector has the communication enabled to plug-in port (default: 8145) for the data protection operations to work.
 * Ensure that the you have the latest version of plug-in is installed. To upgrade the plug-in, refer to <<Upgrade SnapCenter Plug-in for Oracle Database>>.
-* Create a non root (sudo) account on the application host.
 
 == Add host from UI using SSH option
 
@@ -45,15 +45,15 @@ If you have already added a host and want to add another host, click *Applicatio
 . Click *Discover Applications*.
 . Select *Cloud Native* and click *Next*.
 +
-A service account with _SnapCenter System_ role is created to perform scheduled data protection operations for all the users in this account.
-+
-* Click *Account* > *Manage Account* > *Members* to view the service account.
-+
-NOTE: The service account (_SnapCenter-account-<accountid>_) is used to run the scheduled backup operations. You should never delete the service account.
+A service account (_SnapCenter-account-<accountid>_) with _SnapCenter System_ role is created to perform scheduled data protection operations for all the users in this account. 
+The service account (_SnapCenter-account-<accountid>_) is used to run the scheduled backup operations. You should never delete the service account.
+You can view the service account by clicking *Account* > *Manage Account* > *Members*. 
 . Select Oracle as the application type.
 . In the Host details page, perform the following:
 .. Select *Using SSH*.
 .. Specify the  FQDN or IP address of the host where you want to install the plug-in.
++
+Ensure that the Connector can communicate with the database host using the FQDN or IP address.
 .. Specify the non-root(sudo) user using which the plug-in package will be copied to the host.
 +
 Root user is not supported.
@@ -72,9 +72,9 @@ NOTE: The SSH private key is not stored anywhere in the application and is not u
 .. Select the checkbox and click *Next*.
 . Review the details and click *Discover Applications*.
 +
-* After the plug-in is installed, the discovery operation starts. You can monitor the Installation job from the *Job Monitoring* page.
+* After the plug-in is installed, the discovery operation starts.
 +
-* Displays all the databases on the host. If OS authentication is disabled for the database, click *Configure* to enable database authentication. For more information, refer to <<Configure Oracle database credentials>>.
+* After completing the discovery operation, all the databases on the host are displayed. If OS authentication is disabled for the database, click *Configure* to enable database authentication. For more information, refer to <<Configure Oracle database credentials>>.
 +
 * Click *Settings* and select *Hosts* to view all the hosts.
 +
@@ -96,18 +96,15 @@ Ensure that the SSH connection to the Connector is enabled.
 . Click *Discover Applications*.
 . Select *Cloud Native* and click *Next*.
 +
-A service account with _SnapCenter System_ role is created to perform scheduled data protection operations for all the users in this account.
-+
-* Click *Account* > *Manage Account* > *Members* to view the service account.
-+
-NOTE: The service account (_SnapCenter-account-<accountid>_) is used to run the scheduled backup operations. You should never delete the service account.
-
+A service account (_SnapCenter-account-<accountid>_) with _SnapCenter System_ role is created to perform scheduled data protection operations for all the users in this account. 
+The service account (_SnapCenter-account-<accountid>_) is used to run the scheduled backup operations. You should never delete the service account.
+You can view the service account by clicking *Account* > *Manage Account* > *Members*.
 . Select Oracle as the application type.
 . In the Host details page, perform the following:
 .. Select *Manual*.
 .. Specify the  FQDN or IP address of the host where the plug-in is installed.
 +
-Ensure that using the FQDN or IP address, the Connector can communicate with the database host.
+Ensure that the Connector can communicate with the database host using the FQDN or IP address.
 .. Specify the plug-in port.
 +
 Default port is 8145.
@@ -122,17 +119,57 @@ Default port is 8145.
 . Install the plug-in using the script provided in the Connector.
 `sudo bash  /var/lib/docker/volumes/service-manager-2_cloudmanager_scs_cloud_volume/_data/scripts/linux_plugin_copy_and_install.sh --host <plugin_host> --username <host_user_name> --sshkey <host_ssh_key> --pluginport <plugin_port> --sshport <host_ssh_port>`
 
-* plugin_host is the name of the Oracle host and this is a mandatory parameter.
-* host_user_name is the SnapCenter user with SSH privileges on the Oracle host and this is a mandatory parameter.
-* host_ssh_key is the SSH key of the SnapCenter user and used to connect to the Oracle host. This is a mandatory parameter.
-* plugin_port is the port used by the plug-in and this is an optional parameter. Default value is 8145
-* host_ssh_port is the SSH port on the Oracle host and this is an optional parameter. Default value is 22
++
+|===
+|Name | Description | Mandatory | Default 
+
+a|
+plugin_host 
+a|
+Specifies the Oracle host 
+a|
+Yes
+a|
+-
+a|
+host_user_name
+a|
+Specifies the SnapCenter user with SSH privileges on the Oracle host
+a|
+Yes
+a|
+-
+a|
+host_ssh_key
+a|
+Specifies the SSH key of the SnapCenter user and is used to connect to the Oracle host
+a|
+Yes
+a|
+-
+a|
+plugin_port
+a|
+Specifies the port used by the plug-in   
+a|
+No
+a|
+8145
+a|
+host_ssh_port 
+a|
+Specifies the SSH port on the Oracle host 
+a|
+No
+a|
+22
+|===
 +
 For example:
 `sudo bash  /var/lib/docker/volumes/service-manager-2_cloudmanager_scs_cloud_volume/_data/scripts/linux_plugin_copy_and_install.sh --host 10.0.1.1 --username snapcenter --sshkey /keys/netapp-ssh.ppk`
 . Review the details and click *Discover Applications*.
 +
-* Displays all the databases on the host. If OS authentication is disabled for the database, click *Configure* to enable database authentication. For more information, refer to <<Configure Oracle database credentials>>.
+* After completing the discovery operation, all the databases on the host are displayed. If OS authentication is disabled for the database, click *Configure* to enable database authentication. For more information, refer to <<Configure Oracle database credentials>>.
 +
 * Click *Settings* and select *Hosts* to view all the hosts.
 +
@@ -150,12 +187,9 @@ If SSH key based authentication is not enabled on the Oracle database host, you
 . Click *Discover Applications*.
 . Select *Cloud Native* and click *Next*.
 +
-A service account with _SnapCenter System_ role is created to perform scheduled data protection operations for all the users in this account.
-+
-* Click *Account* > *Manage Account* > *Members* to view the service account.
-+
-NOTE: The service account (_SnapCenter-account-<accountid>_) is used to run the scheduled backup operations. You should never delete the service account.
-
+A service account (_SnapCenter-account-<accountid>_) with _SnapCenter System_ role is created to perform scheduled data protection operations for all the users in this account. 
+The service account (_SnapCenter-account-<accountid>_) is used to run the scheduled backup operations. You should never delete the service account.
+You can view the service account by clicking *Account* > *Manage Account* > *Members*.
 . Select Oracle as the application type.
 . In the *Host details* page, perform the following:
 .. Select *Manual*.
@@ -191,7 +225,7 @@ The plug-in binary is available at: _cd /var/lib/docker/volumes/service-manager-
 `docker exec -it cloudmanager_scs_cloud curl -ik \https://<FQDN or IP of the plug-in host>:<plug-in port>/PluginService/Version --cert /config/client/certificate/certificate.pem --key /config/client/certificate/key.pem`
 . Review the details and click *Discover Applications*.
 +
-* Displays all the databases on the host. If OS authentication is disabled for the database, click *Configure* to enable database authentication. For more information, refer to <<Configure Oracle database credentials>>.
+* After completing the discovery operation, all the databases on the host are displayed. If OS authentication is disabled for the database, click *Configure* to enable database authentication. For more information, refer to <<Configure Oracle database credentials>>.
 +
 * Click *Settings* and select *Hosts* to view all the hosts.
 +

task-backup-cloud-native-oracle-data.adoc

@@ -32,7 +32,7 @@ Optionally, you can also specify the arguments.
 +
 You should keep the post-scripts in the path _/var/opt/snapcenter/spl/scripts_.
 +
-The supported environment variables are:
+The post script supports a set of environment variables.
 +
 |===
 | Environmental Variable | Description
@@ -73,7 +73,7 @@ _/{anfaccount}/{subscription_id}/{resource_group}/{capacity_pool}/{volumename}_
 
 You can assign a pre-canned policy or create a policy and then assign it to the database. Once the policy is assigned, the backups are created as per the schedule defined in the policy.
 
-NOTE: For Oracle, when creating ASM diskgroups, ensure that there are no common volumes across diskgroups. Each diskgroup should have dedicated volumes.
+NOTE: When creating ASM diskgroups on Amazon FSx for NetApp ONTAP or Cloud Volumes ONTAP, ensure that there are no common volumes across diskgroups. Each diskgroup should have dedicated volumes.
 
 *Steps*
 
@@ -93,12 +93,12 @@ After assigning the policy, you can create an on-demand backup of the applicatio
 *Steps*
 
 . In the Applications page, click image:icon-action.png[icon to select the action] corresponding to the application and click *On-Demand Backup*.
-. If multiple policies are assigned to the application, select the policy, retention value, and then click *Create Backup*.
+. If multiple policies are assigned to the application, select the policy, retention tier, and then click *Create Backup*.
 
 == Limitations
 
 * Does not support consistency group Snapshots for Oracle databases residing on Multiple ASM disk groups with overlap of FSx volumes
-* If your Oracle databases are configured on ASM, ensure your SVM names are unique across the FSx systems. If you have same SVM name across FSx systems, back up of Oracle databases residing on those SVMs are not supported.
+* If your Oracle databases are on Amazon FSx for NetApp ONTAP or Cloud Volumes ONTAP and are configured on ASM, ensure your SVM names are unique across the FSx systems. If you have same SVM name across FSx systems, back up of Oracle databases residing on those SVMs are not supported.
 * After restoring a large database (250 GB or more), if you perform a full online backup on the same database the operation might fail with the following error:
  `failed with status code 500, error {\"error\":{\"code\":\"app_internal_error\",\"message\":\"Failed to create snapshot. Reason: Snapshot operation not allowed due to clones backed by snapshots. Try again after sometime.`
 +

task-clone-cloud-native-oracle-data.adoc

@@ -13,7 +13,7 @@ summary:  Clone the database either to the source or alternate host.
 :imagesdir: ./media/
 
 [.lead]
-You can clone an Oracle database using the backup of the database either to the source database host or to an alternate host.
+You can clone an Oracle database residing on Amazon FSx for NetApp ONTAP or Cloud Volumes ONTAP using the backup of the database either to the source database host or to an alternate host.
 
 You might clone databases for the following reasons:
 

task-deploy-snapcenter-plugin-for-sap-hana.adoc

@@ -138,15 +138,8 @@ The plug-in binary is available at: _cd /var/lib/docker/volumes/service-manager-
 . Restart SPL: `systemctl restart spl`
 . Validate that the plug-in is reachable from the Connector by running the below command from the Connector.
 `docker exec -it cloudmanager_scs_cloud curl -ik \https://<FQDN or IP of the plug-in host>:<plug-in port>/PluginService/Version --cert  config/client/certificate/certificate.pem --key /config/client/certificate/key.pem`
-. Review the details and click *Discover Applications*.
-+
-* Displays all the databases on the host.
-+
-* Click *Settings* and select *Hosts* to view all the hosts.
-+
-NOTE: The filter to view a specific host does not work. When you specify a host name in the filter, all the hosts are displayed.
-+
-* Click *Settings* and select *Policies* to view the pre-canned policies. Review the pre-canned policies and you can either edit them to meet your requirement or create a new policy.
+
+After installing the plug-in, you should <<Add SAP HANA database hosts>>.
 
 == Upgrade SnapCenter Plug-in for SAP HANA Database
 
@@ -196,14 +189,11 @@ Go to *Canvas* page to add a new working environment
 
 NOTE: The filter to view a specific host does not work. When you specify a host name in the filter, all the hosts are displayed.
 
-*What's next*
-
 You can modify or remove the SAP HANA systems from the UI and also by using REST API.  
 
 Before removing the SAP HANA system, you should delete all the associated backups and remove the protection.
 
 
-
 === Add Non-Data Volumes
 After adding the multi-tenant database container or single container type SAP HANA system, you can add the Non-Data Volumes of the HANA system.
 

task-restore-cloud-native-oracle-data.adoc

@@ -46,7 +46,7 @@ Select *All Data Files* and *Control Files*.
 +
 You can also select *Force in-place restore* checkbox.
 +
-In SAN layout, if SnapCenter Plug-in for Oracle finds any foreign files other than Oracle data files on the ASM diskgroup, connect and copy restore method is performed. The foreign files could be one or more of the following types:
+In Amazon FSx for NetApp ONTAP or Cloud Volumes ONTAP SAN layout, if SnapCenter Plug-in for Oracle finds any foreign files other than Oracle data files on the ASM diskgroup, connect and copy restore method is performed. The foreign files could be one or more of the following types:
 
 * Parameter
 * Password