Skip to content

Commit 6cd721e

Browse files
Merge pull request #106309 from dcurwin/install-upgrade-mars-agent
New MARS agent pages
2 parents 668cb3b + 24f4d19 commit 6cd721e

28 files changed

+319
-220
lines changed

.openpublishing.redirection.json

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18628,6 +18628,11 @@
1862818628
"redirect_url": "/azure/backup/backup-azure-backup-faq",
1862918629
"redirect_document_id": false
1863018630
},
18631+
{
18632+
"source_path": "articles/backup/backup-configure-vault.md",
18633+
"redirect_url": "/azure/backup/backup-windows-with-mars-agent",
18634+
"redirect_document_id": false
18635+
},
1863118636
{
1863218637
"source_path": "articles/backup/backup-upgrade-backup-vault.md",
1863318638
"redirect_url": "/azure/backup/backup-azure-backup-faq",
@@ -31120,7 +31125,7 @@
3112031125
},
3112131126
{
3112231127
"source_path": "articles/backup/backup-configure-vault-classic.md",
31123-
"redirect_url": "/azure/backup/backup-configure-vault",
31128+
"redirect_url": "/azure/backup/backup-windows-with-mars-agent",
3112431129
"redirect_document_id": false
3112531130
},
3112631131
{
@@ -31130,7 +31135,7 @@
3113031135
},
3113131136
{
3113231137
"source_path": "articles/backup/backup-try-azure-backup-in-10-mins.md",
31133-
"redirect_url": "/azure/backup/backup-configure-vault",
31138+
"redirect_url": "/azure/backup/backup-windows-with-mars-agent",
3113431139
"redirect_document_id": false
3113531140
},
3113631141
{

articles/backup/backup-azure-about-mars.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -22,40 +22,40 @@ The MARS agent supports the following restore scenarios:
2222

2323
![MARS recovery scenarios](./media/backup-try-azure-backup-in-10-mins/restore-scenarios.png)
2424

25-
- **Same Server**: The server on which the backup was originally created.
26-
- **Files and Folders**: Choose the individual files and folders that you want to restore.
27-
- **Volume Level**: Choose the volume and recovery point that you want to restore and then restore it to the same location or an alternate location on the same machine. Create a copy of existing files, overwrite existing files, or skip recovering existing files.
28-
- **System Level**: Choose the system state and recovery point to restore to the same machine at a specified location.
25+
- **Same Server**: The server on which the backup was originally created.
26+
- **Files and Folders**: Choose the individual files and folders that you want to restore.
27+
- **Volume Level**: Choose the volume and recovery point that you want to restore and then restore it to the same location or an alternate location on the same machine. Create a copy of existing files, overwrite existing files, or skip recovering existing files.
28+
- **System Level**: Choose the system state and recovery point to restore to the same machine at a specified location.
2929

30-
31-
- **Alternate Server**: A server other than the server where the backup was taken.
32-
- **Files and Folders**: Choose the individual files and folders whose recovery point you want to restore to a target machine.
33-
- **Volume Level**: Choose the volume and recovery point that you want to restore to another location. Create a copy of existing files, overwrite existing files, or skip recovering existing files.
34-
- **System Level**: Choose the system state and recovery point to restore as a System State file to an alternate machine.
30+
- **Alternate Server**: A server other than the server where the backup was taken.
31+
- **Files and Folders**: Choose the individual files and folders whose recovery point you want to restore to a target machine.
32+
- **Volume Level**: Choose the volume and recovery point that you want to restore to another location. Create a copy of existing files, overwrite existing files, or skip recovering existing files.
33+
- **System Level**: Choose the system state and recovery point to restore as a System State file to an alternate machine.
3534

3635
## Backup process
3736

38-
1. From the Azure portal, create a [Recovery Services vault](https://docs.microsoft.com/azure/backup/backup-configure-vault#create-a-recovery-services-vault), and choose files, folders, and the system state from the Backup goals.
39-
2. [Download the Recovery Services vault credentials and agent installer](https://docs.microsoft.com/azure/backup/backup-configure-vault#download-the-mars-agent) to an on-premises machine.
37+
1. From the Azure portal, create a [Recovery Services vault](install-mars-agent.md#create-a-recovery-services-vault), and choose files, folders, and the system state from the Backup goals.
38+
2. [Download the Recovery Services vault credentials and agent installer](https://docs.microsoft.com/azure/backup/install-mars-agent#download-the-mars-agent) to an on-premises machine.
4039

4140
To protect the on-premises machine by selecting the Backup option, choose files, folders, and the system state, and then download the MARS agent.
4241

4342
3. Prepare the infrastructure:
4443

45-
a. Run the installer to [install the agent](https://docs.microsoft.com/azure/backup/backup-configure-vault#install-and-register-the-agent).
44+
a. Run the installer to [install the agent](https://docs.microsoft.com/azure/backup/install-mars-agent#install-and-register-the-agent).
4645

4746
b. Use your downloaded vault credentials to register the machine to the Recovery Services vault.
48-
4. From the agent console on the client, [configure the backup](https://docs.microsoft.com/azure/backup/backup-configure-vault#create-a-backup-policy). Specify the retention policy of your backup data to start protecting it.
47+
4. From the agent console on the client, [configure the backup](https://docs.microsoft.com/azure/backup/backup-windows-with-mars-agent#create-a-backup-policy). Specify the retention policy of your backup data to start protecting it.
4948

5049
![Azure Backup agent diagram](./media/backup-try-azure-backup-in-10-mins/backup-process.png)
5150

52-
5351
### Additional scenarios
54-
- **Back up specific files and folders within Azure virtual machines**: The primary method for backing up Azure virtual machines (VMs) is to use an Azure Backup extension on the VM. The extension backs up the entire VM. If you want to back up specific files and folders within a VM, you can install the MARS agent in the Azure VMs. For more information, see [Architecture: Built-in Azure VM Backup](https://docs.microsoft.com/azure/backup/backup-architecture#architecture-built-in-azure-vm-backup).
5552

56-
- **Offline seeding**: Initial full backups of data to Azure typically transfer large amounts of data and require more network bandwidth. Subsequent backups transfer only the delta, or incremental, amount of data. Azure Backup compresses the initial backups. Through the process of *offline seeding*, Azure Backup can use disks to upload the compressed initial backup data offline to Azure. For more information, see [Azure Backup offline-backup using Azure Data Box](offline-backup-azure-data-box.md).
53+
- **Back up specific files and folders within Azure virtual machines**: The primary method for backing up Azure virtual machines (VMs) is to use an Azure Backup extension on the VM. The extension backs up the entire VM. If you want to back up specific files and folders within a VM, you can install the MARS agent in the Azure VMs. For more information, see [Architecture: Built-in Azure VM Backup](https://docs.microsoft.com/azure/backup/backup-architecture#architecture-built-in-azure-vm-backup).
54+
55+
- **Offline seeding**: Initial full backups of data to Azure typically transfer large amounts of data and require more network bandwidth. Subsequent backups transfer only the delta, or incremental, amount of data. Azure Backup compresses the initial backups. Through the process of *offline seeding*, Azure Backup can use disks to upload the compressed initial backup data offline to Azure. For more information, see [Azure Backup offline-backup using Azure Data Box](offline-backup-azure-data-box.md).
5756

5857
## Next steps
58+
5959
[MARS agent support matrix](https://docs.microsoft.com/azure/backup/backup-support-matrix-mars-agent)
6060

6161
[MARS agent FAQ](https://docs.microsoft.com/azure/backup/backup-azure-file-folder-backup-faq)

articles/backup/backup-azure-backup-sharepoint-mabs.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -59,12 +59,12 @@ You can find **ConfigureSharePoint.exe** in the [MABS Installation Path]\bin fol
5959

6060
1. On the WFE server, at a command prompt, go to [MABS installation location]\bin\
6161
2. Enter ConfigureSharePoint -EnableSharePointProtection.
62-
3. Enter the farm administrator credentials. This account should be a member of the local Administrator group on the WFE server. If the farm administrator isnt a local admin grant the following permissions on the WFE server:
62+
3. Enter the farm administrator credentials. This account should be a member of the local Administrator group on the WFE server. If the farm administrator isn't a local admin grant the following permissions on the WFE server:
6363
* Grant the WSS_Admin_WPG group full control to the DPM folder (%Program Files%\Microsoft Azure Backup\DPM).
6464
* Grant the WSS_Admin_WPG group read access to the DPM Registry key (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft Data Protection Manager).
6565

6666
> [!NOTE]
67-
> Youll need to rerun ConfigureSharePoint.exe whenever theres a change in the SharePoint farm administrator credentials.
67+
> You'll need to rerun ConfigureSharePoint.exe whenever there's a change in the SharePoint farm administrator credentials.
6868
>
6969
>
7070
@@ -123,7 +123,7 @@ After you have configured MABS and the SharePoint farm as explained previously,
123123
![Online_backup_schedule](./media/backup-azure-backup-sharepoint/specify-online-backup-schedule.png)
124124

125125
> [!NOTE]
126-
> MABS provides a maximum of two daily backups to Azure from the then available latest disk backup point. Azure Backup can also control the amount of WAN bandwidth that can be used for backups in peak and off-peak hours by using [Azure Backup Network Throttling](https://azure.microsoft.com/documentation/articles/backup-configure-vault/#enable-network-throttling).
126+
> MABS provides a maximum of two daily backups to Azure from the then available latest disk backup point. Azure Backup can also control the amount of WAN bandwidth that can be used for backups in peak and off-peak hours by using [Azure Backup network throttling](backup-windows-with-mars-agent.md#enable-network-throttling).
127127
>
128128
>
129129
11. Depending on the backup schedule that you selected, on the **Specify Online Retention Policy** page, select the retention policy for daily, weekly, monthly, and yearly backup points.

articles/backup/backup-azure-backup-sharepoint.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -63,12 +63,12 @@ You can find **ConfigureSharePoint.exe** in the [DPM Installation Path]\bin fold
6363

6464
1. On the WFE server, at a command prompt, go to [DPM installation location]\bin\
6565
2. Enter ConfigureSharePoint -EnableSharePointProtection.
66-
3. Enter the farm administrator credentials. This account should be a member of the local Administrator group on the WFE server. If the farm administrator isnt a local admin grant the following permissions on the WFE server:
66+
3. Enter the farm administrator credentials. This account should be a member of the local Administrator group on the WFE server. If the farm administrator isn't a local admin grant the following permissions on the WFE server:
6767
* Grant the WSS_Admin_WPG group full control to the DPM folder (%Program Files%\Microsoft Data Protection Manager\DPM).
6868
* Grant the WSS_Admin_WPG group read access to the DPM Registry key (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft Data Protection Manager).
6969

7070
> [!NOTE]
71-
> Youll need to rerun ConfigureSharePoint.exe whenever theres a change in the SharePoint farm administrator credentials.
71+
> You'll need to rerun ConfigureSharePoint.exe whenever there's a change in the SharePoint farm administrator credentials.
7272
>
7373
>
7474
@@ -127,7 +127,7 @@ After you have configured DPM and the SharePoint farm as explained previously, S
127127
![Online_backup_schedule](./media/backup-azure-backup-sharepoint/specify-online-backup-schedule.png)
128128

129129
> [!NOTE]
130-
> DPM provides a maximum of two daily backups to Azure at different times. Azure Backup can also control the amount of WAN bandwidth that can be used for backups in peak and off-peak hours by using [Azure Backup Network Throttling](https://azure.microsoft.com/documentation/articles/backup-configure-vault/#enable-network-throttling).
130+
> DPM provides a maximum of two daily backups to Azure at different times. Azure Backup can also control the amount of WAN bandwidth that can be used for backups in peak and off-peak hours by using [Azure Backup Network Throttling](backup-windows-with-mars-agent.md#enable-network-throttling).
131131
>
132132
>
133133
11. Depending on the backup schedule that you selected, on the **Specify Online Retention Policy** page, select the retention policy for daily, weekly, monthly, and yearly backup points.

articles/backup/backup-azure-file-folder-backup-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ The cache folder and the metadata VHD don't have the necessary attributes for th
145145
146146
### Is there a way to adjust the amount of bandwidth used for backup?
147147
148-
Yes, you can use the **Change Properties** option in the MARS agent to adjust the bandwidth and timing. [Learn more](backup-configure-vault.md#enable-network-throttling).
148+
Yes, you can use the **Change Properties** option in the MARS agent to adjust the bandwidth and timing. [Learn more](backup-windows-with-mars-agent.md#enable-network-throttling).
149149
150150
## Restore
151151

articles/backup/backup-azure-mabs-troubleshoot.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ We recommend you perform the below validation, before you start troubleshooting
7171
| Operation | Error details | Workaround |
7272
| --- | --- | --- |
7373
| Pushing agent(s) to protected servers | The credentials that are specified for the server are invalid. | **If the recommended action that's shown in the product doesn't work, take the following steps**: <br> Try to install the protection agent manually on the production server as specified in [this article](https://docs.microsoft.com/system-center/dpm/deploy-dpm-protection-agent?view=sc-dpm-2019).|
74-
| Azure Backup Agent was unable to connect to the Azure Backup service (ID: 100050) | The Azure Backup Agent was unable to connect to the Azure Backup service. | **If the recommended action that's shown in the product doesn't work, take the following steps**: <br>1. Run the following command from an elevated prompt: **psexec -i -s "c:\Program Files\Internet Explorer\iexplore.exe**. This opens the Internet Explorer window. <br/> 2. Go to **Tools** > **Internet Options** > **Connections** > **LAN settings**. <br/> 3. Change the settings to use a proxy server. Then provide the proxy server details.<br/> 4. If your machine has limited internet access, ensure that firewall settings on the machine or proxy allow these [URLs](backup-configure-vault.md#verify-internet-access) and [IP address](backup-configure-vault.md#verify-internet-access).|
74+
| Azure Backup Agent was unable to connect to the Azure Backup service (ID: 100050) | The Azure Backup Agent was unable to connect to the Azure Backup service. | **If the recommended action that's shown in the product doesn't work, take the following steps**: <br>1. Run the following command from an elevated prompt: **psexec -i -s "c:\Program Files\Internet Explorer\iexplore.exe**. This opens the Internet Explorer window. <br/> 2. Go to **Tools** > **Internet Options** > **Connections** > **LAN settings**. <br/> 3. Change the settings to use a proxy server. Then provide the proxy server details.<br/> 4. If your machine has limited internet access, ensure that firewall settings on the machine or proxy allow these [URLs](install-mars-agent.md#verify-internet-access) and [IP address](install-mars-agent.md#verify-internet-access).|
7575
| Azure Backup Agent installation failed | The Microsoft Azure Recovery Services installation failed. All changes that were made to the system by the Microsoft Azure Recovery Services installation were rolled back. (ID: 4024) | Manually install Azure Agent.
7676

7777
## Configuring protection group
@@ -104,7 +104,7 @@ We recommend you perform the below validation, before you start troubleshooting
104104

105105
| Operation | Error details | Workaround |
106106
| --- | --- | --- |
107-
| Setting up email notifications using an Office 365 account |Error ID: 2013| **Cause:**<br> Trying to use Office 365 account <br>**Recommended action:**<ol><li> The first thing to ensure is that “Allow Anonymous Relay on a Receive Connector” for your DPM server is set up on Exchange. For more information about how to configure this, see [Allow Anonymous Relay on a Receive Connector](https://docs.microsoft.com/exchange/mail-flow/connectors/allow-anonymous-relay?view=exchserver-2019).</li> <li> If you can't use an internal SMTP relay and need to set up by using your Office 365 server, you can set up IIS to be a relay. Configure the DPM server to [relay the SMTP to O365 using IIS](https://docs.microsoft.com/exchange/mail-flow/test-smtp-with-telnet?view=exchserver-2019)).<br><br> Be sure to use the user\@domain.com format and *not* domain\user.<br><br><li>Point DPM to use the local server name as SMTP server, port 587. Then point it to the user email that the emails should come from.<li> The username and password on the DPM SMTP setup page should be for a domain account in the domain that DPM is on. </li><br> When you are changing the SMTP server address, make the change to the new settings, close the settings box, and then reopen it to be sure it reflects the new value. Simply changing and testing might not always cause the new settings to take effect, so testing it this way is a best practice.<br><br>At any time during this process, you can clear these settings by closing the DPM console and editing the following registry keys: **HKLM\SOFTWARE\Microsoft\Microsoft Data Protection Manager\Notification\ <br/> Delete SMTPPassword and SMTPUserName keys**. You can add them back to the UI when you launch it again.
107+
| Setting up email notifications using an Office 365 account |Error ID: 2013| **Cause:**<br> Trying to use Office 365 account <br>**Recommended action:**<ol><li> The first thing to ensure is that "Allow Anonymous Relay on a Receive Connector" for your DPM server is set up on Exchange. For more information about how to configure this, see [Allow Anonymous Relay on a Receive Connector](https://docs.microsoft.com/exchange/mail-flow/connectors/allow-anonymous-relay?view=exchserver-2019).</li> <li> If you can't use an internal SMTP relay and need to set up by using your Office 365 server, you can set up IIS to be a relay. Configure the DPM server to [relay the SMTP to O365 using IIS](https://docs.microsoft.com/exchange/mail-flow/test-smtp-with-telnet?view=exchserver-2019)).<br><br> Be sure to use the user\@domain.com format and *not* domain\user.<br><br><li>Point DPM to use the local server name as SMTP server, port 587. Then point it to the user email that the emails should come from.<li> The username and password on the DPM SMTP setup page should be for a domain account in the domain that DPM is on. </li><br> When you are changing the SMTP server address, make the change to the new settings, close the settings box, and then reopen it to be sure it reflects the new value. Simply changing and testing might not always cause the new settings to take effect, so testing it this way is a best practice.<br><br>At any time during this process, you can clear these settings by closing the DPM console and editing the following registry keys: **HKLM\SOFTWARE\Microsoft\Microsoft Data Protection Manager\Notification\ <br/> Delete SMTPPassword and SMTPUserName keys**. You can add them back to the UI when you launch it again.
108108

109109
## Common issues
110110

articles/backup/backup-azure-manage-mars.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,4 +166,4 @@ A passphrase is used to encrypt and decrypt data while backing up or restoring y
166166
## Next steps
167167

168168
- For information about supported scenarios and limitations, refer to the [Support Matrix for the MARS Agent](https://docs.microsoft.com/azure/backup/backup-support-matrix-mars-agent).
169-
- Learn more about [On demand backup policy retention behavior](backup-configure-vault.md#set-up-on-demand-backup-policy-retention-behavior).
169+
- Learn more about [On demand backup policy retention behavior](backup-windows-with-mars-agent.md#set-up-on-demand-backup-policy-retention-behavior).

0 commit comments

Comments
 (0)