Merge pull request #272436 from Phil-Jensen/patch-1

Updates for AzAcSnap 9a release

Author: prmerger-automator[bot]

articles/azure-netapp-files/azacsnap-release-notes.md

@@ -5,7 +5,7 @@ services: azure-netapp-files
 author: Phil-Jensen
 ms.service: azure-netapp-files
 ms.topic: conceptual
-ms.date: 08/21/2023
+ms.date: 04/17/2024
 ms.author: phjensen
 ---
 
@@ -17,6 +17,18 @@ Download the [latest release](https://aka.ms/azacsnapinstaller) of the installer
 
 For specific information on Preview features, refer to the [AzAcSnap Preview](azacsnap-preview.md) page.
 
+## Apr-2024
+
+### AzAcSnap 9a (Build: 1B3B458)
+
+AzAcSnap 9a is being released with the following fixes and improvements:
+
+- Fixes and Improvements:
+  - Allow AzAcSnap to have Azure Management Endpoints manually configured to allow it to work in Azure Sovereign Clouds.
+    - Added a global override variable `AZURE_MANAGEMENT_ENDPOINT` to be used in either the `.azacsnaprc` file or as an environment variable set to the appropriate Azure management endpoint. For details on configuration refer to the [global override settings to control AzAcSnap behavior](azacsnap-tips.md#global-override-settings-to-control-azacsnap-behavior).
+
+Download the [AzAcSnap 9a](https://aka.ms/azacsnap-9a) installer.
+
 ## Aug-2023
 
 ### AzAcSnap 9 (Build: 1AE5640)
@@ -32,7 +44,7 @@ AzAcSnap 9 is being released with the following fixes and improvements:
 - Features added to [Preview](azacsnap-preview.md):
   - None.
 - Features removed:
-  - Azure Key Vault support has been removed from Preview, it isn't needed now AzAcSnap supports a System Managed Identity directly.
+  - Azure Key Vault support removed from Preview. It isn't needed now AzAcSnap supports a System Managed Identity directly.
 
 Download the [AzAcSnap 9](https://aka.ms/azacsnap-9) installer.
 
@@ -44,12 +56,12 @@ AzAcSnap 8b is being released with the following fixes and improvements:
 
 - Fixes and Improvements:
   - General improvement to `azacsnap` command exit codes.
-    - `azacsnap` should return an exit code of 0 (zero) when it has run as expected, otherwise it should return an exit code of non-zero.  For example, running `azacsnap` returns non-zero as it hasn't done anything and shows usage information whereas `azacsnap -h` returns exit-code of zero as it's performing as expected by returning usage information.
+    - `azacsnap` should return an exit code of 0 (zero) when run as expected, otherwise it should return an exit code of non-zero. For example, running `azacsnap` returns non-zero as there's nothing to do and shows usage information whereas `azacsnap -h` returns exit-code of zero as it's performing as expected by returning usage information.
     - Any failure in `--runbefore` exits before any backup activity and returns the `--runbefore` exit code.
     - Any failure in `--runafter` returns the `--runafter` exit code.
   - Backup (`-c backup`) changes:
     - Change in the Db2 workflow to move the protected-paths query outside the WRITE SUSPEND, Storage Snapshot, WRITE RESUME workflow to improve resilience. (Preview)
-    - Fix for missing snapshot name (`azSnapshotName`)  in `--runafter` command environment.
+    - Fix for missing snapshot name (`azSnapshotName`) in `--runafter` command environment.
 
 Download the [AzAcSnap 8b](https://aka.ms/azacsnap-8b) installer.
 
@@ -76,7 +88,7 @@ AzAcSnap 8 is being released with the following fixes and improvements:
   - Backup (`-c backup`) changes:
     - Fix for incorrect error output when using `-c backup` and the database has ‘backint’ configured.
     - Remove lower-case conversion for anfBackup rename-only option using `-c backup` so the snapshot name maintains case of Volume name.
-    - Fix for when a snapshot is created even though SAP HANA wasn't put into backup-mode.  Now if SAP HANA can't be put into backup-mode, AzAcSnap immediately exits with an error.
+    - Fix for when a snapshot is created even though SAP HANA wasn't put into backup-mode. Now if SAP HANA can't be put into backup-mode, AzAcSnap immediately exits with an error.
   - Details (`-c details`) changes:
     - Fix for listing snapshot details with `-c details` when using Azure Large Instance storage.
   - Logging enhancements:
@@ -93,7 +105,7 @@ Download the [AzAcSnap 8](https://aka.ms/azacsnap-8) installer.
 AzAcSnap 7a is being released with the following fixes:
 
 - Fixes for `-c restore` commands:
-  - Enable mounting volumes on HLI (BareMetal) where the volumes have been reverted to a prior state when using `-c restore --restore revertvolume`.
+  - Enable mounting volumes on HLI (BareMetal) when the volumes are reverted to a prior state when using `-c restore --restore revertvolume`.
   - Correctly set ThroughputMiBps on volume clones for Azure NetApp Files volumes in an Auto QoS Capacity Pool when using `-c restore --restore snaptovol`.
 
 Download the [AzAcSnap 7a](https://aka.ms/azacsnap-7a) installer.
@@ -106,16 +118,16 @@ AzAcSnap 7 is being released with the following fixes and improvements:
 
 - Fixes and Improvements:
   - Backup (`-c backup`) changes:
-    - Shorten suffix added to the snapshot name.  The previous 26 character suffix of "YYYY-MM-DDThhhhss-nnnnnnnZ" was too long.  The suffix is now an 11 character hex-decimal based on the ten-thousandths of a second since the Unix epoch to avoid naming collisions for example, F2D212540D5.
+    - Shorten suffix added to the snapshot name. The previous 26 character suffix of "YYYY-MM-DDThhhhss-nnnnnnnZ" was too long. The suffix is now an 11 character hex-decimal based on the ten-thousandths of a second since the Unix epoch to avoid naming collisions, for example, F2D212540D5.
     - Increased validation when creating snapshots to avoid failures on snapshot creation retry.
     - Time out when executing AzAcSnap mechanism to disable/enable backint (`autoDisableEnableBackint=true`) now aligns with other SAP HANA related operation timeout values.
-    - Azure Backup now allows third party snapshot-based backups without impact to streaming backups (also known as 'backint'). Therefore, AzAcSnap 'backint' detection logic has been reordered to allow for future deprecation of this feature.  By default this setting is disabled (`autoDisableEnableBackint=false`). For customers who have relied on this feature to take snapshots with AzAcSnap and use Azure Backup, keeping this value as true means AzAcSnap 7 continues to disable/enable backint.  As this setting is no longer necessary for Azure Backup, we recommend testing AzAcSnap backups with the value of `autoDisableEnableBackint=false`, and then if successful make the same change in your production deployment.
+    - Azure Backup now allows third party snapshot-based backups without impact to streaming backups (also known as "backint"). Therefore, AzAcSnap "backint" detection logic is reordered to allow for future deprecation of this feature. By default this setting is disabled (`autoDisableEnableBackint=false`). For customers who relied on this feature to take snapshots with AzAcSnap and use Azure Backup, keeping this value as true means AzAcSnap 7 continues to disable/enable backint. As this setting is no longer necessary for Azure Backup, we recommend testing AzAcSnap backups with the value of `autoDisableEnableBackint=false`, and then if successful make the same change in your production deployment.
   - Restore (`-c restore`) changes:
     - Ability to create a custom suffix for Volume clones created when using `-c restore --restore snaptovol` either:
       - via the command-line with `--clonesuffix <custom suffix>`.
       - interactively when running the command without the `--force` option.
-    - When doing a `--restore snaptovol` on ANF, then Volume Clone inherits the new 'NetworkFeatures' setting from the Source Volume.
-    - Can now do a restore if there are no Data Volumes configured.  It will only restore the Other Volumes using the Other Volumes latest snapshot (the `--snapshotfilter` option only applies to Data Volumes).
+    - When doing a `--restore snaptovol` on ANF, then Volume Clone inherits the new "NetworkFeatures" setting from the Source Volume.
+    - Can now do a restore if there are no Data Volumes configured. It only restores the Other Volumes using the Other Volumes latest snapshot (the `--snapshotfilter` option only applies to Data Volumes).
     - Extra logging for `-c restore` command to help with user debugging.
   - Test (`-c test`) changes:
     - Now tests managing snapshots for all otherVolume(s) and all dataVolume(s).
@@ -132,9 +144,9 @@ Download the [AzAcSnap 7](https://aka.ms/azacsnap-7) installer.
 ### AzAcSnap 6 (Build: 1A5F0B8)
 
 > [!IMPORTANT]
-> AzAcSnap 6 brings a new release model for AzAcSnap and includes fully supported GA features and Preview features in a single release.  
+> AzAcSnap 6 brings a new release model for AzAcSnap and includes fully supported GA features and Preview features in a single release.
 
-Since AzAcSnap v5.0 was released as GA in April 2021, there have been eight releases of AzAcSnap across two branches. Our goal with the new release model is to align with how Azure components are released.  This change allows moving features from Preview to GA (without having to move an entire branch), and introduce new Preview features (without having to create a new branch). From AzAcSnap 6, we have a single branch with fully supported GA features and Preview features (which are subject to Microsoft's Preview Ts&Cs). It’s important to note customers can't accidentally use Preview features, and must enable them with the `--preview` command line option.  Therefore the next release will be AzAcSnap 7, which could include; patches (if necessary) for GA features, current Preview features moving to GA, or new Preview features.
+Since AzAcSnap v5.0 was released as GA in April 2021, there has been eight releases of AzAcSnap across two branches. Our goal with the new release model is to align with how Azure components are released. This change allows moving features from Preview to GA (without having to move an entire branch), and introduce new Preview features (without having to create a new branch). From AzAcSnap 6, we have a single branch with fully supported GA features and Preview features (which are subject to Microsoft's Preview Ts&Cs). It’s important to note customers can't accidentally use Preview features, and must enable them with the `--preview` command line option. Therefore the next release will be AzAcSnap 7, which could include; patches (if necessary) for GA features, current Preview features moving to GA, or new Preview features.
 
 AzAcSnap 6 is being released with the following fixes and improvements:
 
@@ -156,17 +168,17 @@ Download the [AzAcSnap 6](https://aka.ms/azacsnap-6) installer.
 
 AzAcSnap v5.0.3 (Build: 20220524.14204) is provided as a patch update to the v5.0 branch with the following fix:
 
-- Fix for handling delimited identifiers when querying SAP HANA.  This issue only impacted SAP HANA in HSR-HA node when there's a Secondary node configured with 'logreplay_readaccss' and has been resolved.
+- Fix for handling delimited identifiers when querying SAP HANA. This issue only impacted SAP HANA in HSR-HA node when there's a Secondary node configured with "logreplay_readaccss" and is resolved.
 
 ### AzAcSnap v5.1 Preview (Build: 20220524.15550)
 
-AzAcSnap v5.1 Preview (Build: 20220524.15550) is an updated build to extend the preview expiry date for 90 days.  This update contains the fix for handling delimited identifiers when querying SAP HANA as provided in v5.0.3.
+AzAcSnap v5.1 Preview (Build: 20220524.15550) is an updated build to extend the preview expiry date for 90 days. This update contains the fix for handling delimited identifiers when querying SAP HANA as provided in v5.0.3.
 
 ## Mar-2022
 
 ### AzAcSnap v5.1 Preview (Build: 20220302.81795)
 
-AzAcSnap v5.1 Preview (Build: 20220302.81795) has been released with the following new features:
+AzAcSnap v5.1 Preview (Build: 20220302.81795) is released with the following new features:
 
 - Azure Key Vault support for securely storing the Service Principal.
 - A new option for `-c backup --volume`, which has the `all` parameter value.
@@ -175,21 +187,21 @@ AzAcSnap v5.1 Preview (Build: 20220302.81795) has been released with the followi
 
 ### AzAcSnap v5.1 Preview (Build: 20220220.55340)
 
-AzAcSnap v5.1 Preview (Build: 20220220.55340) has been released with the following fixes and improvements:
+AzAcSnap v5.1 Preview (Build: 20220220.55340) is released with the following fixes and improvements:
 
 - Resolved failure in matching `--dbsid` command line option with `sid` entry in the JSON configuration file for Oracle databases when using the `-c restore` command.
 
 ### AzAcSnap v5.1 Preview (Build: 20220203.77807)
 
-AzAcSnap v5.1 Preview (Build: 20220203.77807) has been released with the following fixes and improvements:
+AzAcSnap v5.1 Preview (Build: 20220203.77807) is released with the following fixes and improvements:
 
-- Minor update to resolve STDOUT buffer limitations.  Now the list of Oracle table files put into archive-mode is sent to an external file rather than output in the main AzAcSnap log file.  The external file is in the same location and basename as the log file, but with a ".protected-tables" extension (output filename detailed in the AzAcSnap log file).  It's overwritten each time `azacsnap` runs.
+- Minor update to resolve STDOUT buffer limitations. Now the list of Oracle table files put into archive-mode is sent to an external file rather than output in the main AzAcSnap log file. The external file is in the same location and basename as the log file, but with a ".protected-tables" extension (output filename detailed in the AzAcSnap log file). It's overwritten each time `azacsnap` runs.
 
 ## Jan-2022
 
 ### AzAcSnap v5.1 Preview (Build: 20220125.85030)
 
-AzAcSnap v5.1 Preview (Build: 20220125.85030) has been released with the following new features:
+AzAcSnap v5.1 Preview (Build: 20220125.85030) is released with the following new features:
 
 - Oracle Database support
 - Backint Co-existence
@@ -202,8 +214,8 @@ AzAcSnap v5.1 Preview (Build: 20220125.85030) has been released with the followi
 
 AzAcSnap v5.0.2 (Build: 20210827.19086) is provided as a patch update to the v5.0 branch with the following fixes and improvements:
 
-- Ignore `ssh` 255 exit codes.  In some cases the `ssh` command, which is used to communicate with storage on Azure Large Instance, would emit an exit code of 255 when there were no errors or execution failures  (refer `man ssh` "EXIT STATUS") - then AzAcSnap would trap this exit code as a failure and abort.  With this update extra verification is done to validate correct execution, this validation includes parsing `ssh` STDOUT and STDERR for errors in addition to traditional exit code checks.
-- Fix the installer's check for the location of the hdbuserstore.  The installer would search the filesystem for an incorrect source directory for the hdbuserstore location for the user running the install - the installer now searches for `~/.hdb`.  This fix is applicable to systems (for example, Azure Large Instance) where the hdbuserstore was preconfigured for the `root` user before installing `azacsnap`.
+- Ignore `ssh` 255 exit codes. In some cases the `ssh` command, which is used to communicate with storage on Azure Large Instance, would emit an exit code of 255 when there were no errors or execution failures (refer `man ssh` "EXIT STATUS") - then AzAcSnap would trap this exit code as a failure and abort. With this update extra verification is done to validate correct execution, this validation includes parsing `ssh` STDOUT and STDERR for errors in addition to traditional exit code checks.
+- Fix the installer's check for the location of the hdbuserstore. The installer would search the filesystem for an incorrect source directory for the hdbuserstore location for the user running the install - the installer now searches for `~/.hdb`. This fix is applicable to systems (for example, Azure Large Instance) where the hdbuserstore was preconfigured for the `root` user before installing `azacsnap`.
 - Installer now shows the version it will install/extract (if the installer is run without any arguments).
 
 ## May-2021
@@ -212,28 +224,28 @@ AzAcSnap v5.0.2 (Build: 20210827.19086) is provided as a patch update to the v5.
 
 AzAcSnap v5.0.1 (Build: 20210524.14837) is provided as a patch update to the v5.0 branch with the following fixes and improvements:
 
-- Improved exit code handling.  In some cases AzAcSnap would emit an exit code of 0 (zero), even after an execution failure when the exit code should have been non-zero.  Exit codes should now only be zero on successfully running `azacsnap` to completion and non-zero if there's any failure.  
-- AzAcSnap's internal error handling has been extended to capture and emit the exit code of the external commands run by AzAcSnap.
+- Improved exit code handling. In some cases AzAcSnap would emit an exit code of 0 (zero), even after an execution failure when the exit code should be non-zero. Exit codes should now only be zero on successfully running `azacsnap` to completion and non-zero if there's any failure.
+- AzAcSnap's internal error handling is extended to capture and emit the exit code of the external commands run by AzAcSnap.
 
 ## April-2021
 
 ### AzAcSnap v5.0 (Build: 20210421.6349) - GA Released (21-April-2021)
 
-AzAcSnap v5.0 (Build: 20210421.6349) has been made Generally Available and for this build had the following fixes and improvements:
+AzAcSnap v5.0 (Build: 20210421.6349) is now Generally Available and for this build had the following fixes and improvements:
 
-- The hdbsql retry timeout (to wait for a response from SAP HANA) is automatically set to half of the "savePointAbortWaitSeconds" to avoid race conditions.  The setting for "savePointAbortWaitSeconds" can be modified directly in the JSON configuration file and must be a minimum of 600 seconds.
+- The hdbsql retry timeout (to wait for a response from SAP HANA) is automatically set to half of the "savePointAbortWaitSeconds" to avoid race conditions. The setting for "savePointAbortWaitSeconds" can be modified directly in the JSON configuration file and must be a minimum of 600 seconds.
 
 ## March-2021
 
 ### AzAcSnap v5.0 Preview (Build: 20210318.30771)
 
-AzAcSnap v5.0 Preview (Build: 20210318.30771) has been released with the following fixes and improvements:
+AzAcSnap v5.0 Preview (Build: 20210318.30771) is released with the following fixes and improvements:
 
 - Removed the need to add the AZACSNAP user into the SAP HANA Tenant DBs, see the [Enable communication with database](azacsnap-installation.md#enable-communication-with-the-database) section.
 - Fix to allow a [restore](azacsnap-cmd-ref-restore.md) with volumes configured with Manual QOS.
 - Added mutex control to throttle SSH connections for Azure Large Instance.
 - Fix installer for handling path names with spaces and other related issues.
-- In preparation for supporting other database servers, changed the optional parameter '--hanasid' to '--dbsid'.
+- In preparation for supporting other database servers, changed the optional parameter "--hanasid" to "--dbsid".
 
 ## Next steps