ANF-Doc-Updates.md

ANF documentation activities for October 2021:

• Documentation enhancement - Table of Content restructure
  • Articles under Concepts are now grouped into subcategories.
  • The single FAQ article is now split into individual articles according to the subject.
  • Regional capacity quota is now a standalone article.
• [new feature] Standard network features
  • [new] Configure network features for a volume - Describes network feature registration and configuration steps.
  • Guidelines for Azure NetApp Files network planning - New and updated subsections:
    - [new] Configurable network features 
    - Constraints
    - Supported network topologies
    - UDRs and NSGs
  • What's new - Feature announcement.
  • Create an NFS volume, Create an SMB volume, Create a dual-protocol volume – Added a mention about the Network Features UI and point to the new article for steps.
  • Troubleshoot volume errors - Error messages related to volume allocation
  • Networking FAQs for Azure NetApp Files - Removed entry "Does Azure NetApp Files support Network Security Groups?", which indicated NSG isn't supported.
• The Azure NetApp Files service no longer requires waitlist registration:
  • Register for NetApp Resource Provider - Removed Waitlist section; retitled article.
  • Quickstart: Set up Azure NetApp Files and NFS volume - Removed Waitlist requirement
  • Create a NetApp account - Removed Waitlist requirement
  • What is Azure NetApp Files - Removed Waitlist requirement
  • Troubleshoot Resource Provider errors - Removed Waitlist requirement
• Understand cross-region replication:
  • Is now generally available (GA):
    • Removed waitlist/registration requirement from all relevant articles, incl.:
      • Understand cross-region replication
      • Requirements and considerations for cross-region replication
      • Create volume replication
    • What’s New – Announcing GA of cross-region replication.
    • Azure NetApp Files for Azure Government - Update Cross-region replication status to GA for public cloud.
  • Added more supported pairs:
    • Added to Azure regional pairs:
      • Asia-Pacific : East Asia <> Southeast Asia
      • Switzerland: Switzerland North <> Switzerland West
      • US Government: US Gov Arizona <> US Gov Texas
    • Added to Azure regional non-standard pairs:
      • US Government: US Gov Arizona <> US Gov Virginia
• NFS FAQ - Updated Can I use the same file path (volume creation token) for multiple volumes__.
• Enable Continuous Availability on existing SMB volumes - Added reminder: Continuous Availability should be enabled only for SQL Server and FSLogix user profile containers.
• Configure export policy for NFS or dual protocol - Clarified that the Root Access option is not available for NFSv4.1 Kerberos volumes.
• Requirements and considerations for Azure NetApp Files backup – Added consideration: ANF backup is not supported on a cross-region replication destination volume.
• Solution architectures using Azure NetApp Files -
  • Subsection File sharing and Global File Caching
    • [new] Disaster Recovery for Enterprise File Shares with Azure NetApp Files and DFS Namespaces
  • Subsection Machine Learning
    • [new] Distributed training in Azure: Click-Through Rate Prediction – Solution design
  • Subsection Azure Kubernetes Services and Kubernetes
    • [updated] Integrate Azure NetApp Files with Azure Kubernetes Service - Updated with details about how to create ANF volumes to be used by pods in an Azure Kubernetes Service (AKS) cluster by using Astra Trident. (Contribution from NetApp AKS team)

ANF documentation activities for Septempter 2021:

• [new feature] Azure NetApp Files backup
  • [new] Understand Azure NetApp Files backup
  • [new] Requirements and considerations for Azure NetApp Files backup
  • [new] Configure policy-based backups
  • [new] Configure manual backups
  • [new] Manage backup policies
  • [new] Search backups
  • [new] Restore a backup to a new volume
  • [new] Disable backup functionality
  • [new] Delete backups
  • What's new - Feature announcement.
  • How Azure NetApp Files snapshots work -
    • [New subsections] How snapshots can be vaulted for long-term retention and cost savings, Restoring volume backups from vaulted snapshots, and Deleting vaulted snapshots.
    • Updates throughout the article.
  • Azure NetApp Files backup FAQs - Added backup FAQs.
  • Resource limits - Added backup resource limits to table.
  • Volume backup metrics - Added backup metrics
• [new] Azure NetApp Files for Azure Government - Describes Azure NetApp Files feature availability in Azure Government and how to access the Azure NetApp Files service within Azure Government.
• [new option] Administrators for Active Directory connections
  • Create and manage Active Directory connections – Under Step 3 (Protocol), added Administrators bullet for the new UI.
  • What's new – Added introduction about Administrators
• Resource limits for Azure NetApp Files - Default limit for the number of cross-region replication data protection volumes (destination volumes) has been updated to 10.
• Create and manage Active Directory connections -- Subsection Azure Active Directory Domain Services added POSIX attribute consideration about using AADDS with a dual-protocol volume.
• Configure an NFS client for Azure NetApp Files - Subsection RHEL 8 configuration if you are using dual protocol has updated details about ldap_id_mapping and other configurations under Step 3.
• Configure ADDS LDAP with extended groups for NFS –
  • Updated guidelines about `objectClass` values for POSIX attributes.
  • Clarified that the feature enables access to files and directories in the volume.
• Create a dual-protocol volume - Updated guidelines about `objectClass` values for POSIX attributes.
• Enable Continuous Availability on existing SMB volumes - Step 4 updated for clarity.
  • Understand cross-region replication - Restructured tables to list geo(s) by pair and Azure regional pairs added the following:
  • North Central US and South Central US
  • US Gov Virginia and US Gov Texas
• Manage disaster recovery - Updated subsection Resync volumes after disaster recovery with additional explanation about the resync operation.
• Metrics for Azure NetApp Files – Removed an unsupported metric.
• Performance articles updated:
  • Performance benchmark test recommendations for Azure NetApp Files – Updated overview.
  • Performance benchmarks for Linux – Updated details about the graphs.
• Solution architectures using Azure NetApp Files:
  • [new subsection] Azure Red Hat Openshift - Added Using Trident to Automate Azure NetApp Files from OpenShift
  • SQL Server - Added  SQL Server on Azure Virtual Machines with Azure NetApp Files - Azure Example Scenarios
  • Oracle - Added  Oracle Database with Azure NetApp Files - Azure Example Scenarios
  • SAP HANA - Added  SAP HANA Disaster Recovery with Azure NetApp Files
• FAQs about Azure NetApp Files - Added new subsection Application resilience FAQs.
• Release Notes for AzAcSnap - AzAcSnap v5.0.2 is available.
• Doc enhancements:
  • Table of content (TOC) restructure: Articles in How-To Guides section are further categorized and grouped under sub-nodes.
  • Split subsections of article Manage snapshots into standalone articles:
    • Create an on-demand snapshot
    • Manage snapshot policies
    • Edit the Hide Snapshot Path
    • Restore a snapshot to a new volume
    • Restore a file from a snapshot using a client
    • Restore a volume using snapshot revert
    • Delete snapshots

ANF documentation activities for August 2021:

• [new feature] Chown mode export policy support and chmod (Unix permissions)
  • [new] Configure Unix permissions and change ownership mode – Describes setting the Unix permissions and the change ownership mode (Chown Mode) options for NFS volumes or dual-protocol volumes with the ‘Unix’ security style.
  • Configure export policy – Added new UI Chown Mode.
  • Create an NFS volume and Create a dual-protocol volume – Step 3 (Protocol tab) describes new UI Unix permissions**.**
  • What's New - Feature announcement.
• [new feature] Dual protocol access for NFSv4.1 and SMB
  • Create a dual-protocol volume –
    • Updated Security Style details.
    • Step 3 (Protocol) added new UI elements Versions and Kerberos; added AFEC registration for using NFSv4.1 and SMB dual protocol.
  • Create an NFS volume, Create an SMB volume, Configure export policy for an NFS volume - Added "NFSv4.1 and SMB" as supported versions for dual-protocol.
  • What's new - Feature announcement.
• [new feature] Support for enabling Continuous Availability on existing SMB volumes:
  • [new] Enable Continuous Availability on existing SMB volumes – Describes editing an SMB volume to enable the Enable Continuous Availability option.
  • What's new – Feature announcement.
  • Removed previously published article “Convert existing SMB volumes to use Continuous Availability” (no longer applicable).
• Snapshot policy is generally available (GA) –
  • Manage snapshots subsection Manage snapshot policies – Removed requirements for snapshot policy feature registration.
  • What's new – GA announcement.
• Understand cross-region replication –
  • Supported Azure regional pairs now include:
    • UAE North and UAE Central
    • Norway East and Norway West
  • Supported Azure regional non-standard pairs now include:
    • Germany West Central and France Central
• Resource limits for Azure NetApp Files -- The following subsections of are updated to reflect the Quota blade in portal:
  • Regional capacity quota
  • Request limit increase
• FAQs about Azure NetApp Files - Added new entry:
  • When I delete an Azure NetApp Files volume, is the data deleted safely?
• Clarification about SMB share permissions :
  • Create an SMB volume - Removed Share Permissions subsection (no longer applicable).
  • Added FAQ entry Can the SMB share permissions be changed?
• Delegate a subnet to Azure NetApp Files - Consideration about the wizard for creating a new subnet is updated with additional details. 
• Create and manage Active Directory connections –
  • Removed the requirement about _usi_ng Enterprise or Premium SKUs with Azure NetApp Files.
  • Added reminder to update password configured in the Active Directory Connections if you change the password of the Active Directory user account that is used in Azure NetApp Files.
• Create volume replication - Added a note that you might see a difference between the used space of the source volume and the used space of the destination volume.
• Linux concurrency best practices - NFSv3 subsections Example 4 and How to calculate concurrency settings by connection count have updated best practices.
• "Windows Virtual Desktop" is now "Azure Virtual Desktop".  The following articles are updated with the name change:
  • Benefits of using Azure NetApp Files with Azure Virtual Desktop
  • Solution architectures using Azure NetApp Files
  • What's new