Skip to content

Commit ca2406f

Browse files
author
AbhishekMallick-MS
committed
Freshness - Install MARS agent
1 parent 668801b commit ca2406f

File tree

1 file changed

+18
-14
lines changed

1 file changed

+18
-14
lines changed

articles/backup/install-mars-agent.md

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Install the Microsoft Azure Recovery Services (MARS) agent
33
description: Learn how to install the Microsoft Azure Recovery Services (MARS) agent to back up Windows machines.
44
ms.topic: how-to
5-
ms.date: 11/07/2023
5+
ms.date: 10/25/2024
66
ms.service: azure-backup
77
author: AbhishekMallick-MS
88
ms.author: v-abhmallick
@@ -11,7 +11,7 @@ ms.author: v-abhmallick
1111

1212
# Install the Azure Backup MARS agent
1313

14-
This article explains how to install the Microsoft Azure Recovery Services (MARS) agent. MARS is also known as the Azure Backup agent.
14+
This article describes how to install the Microsoft Azure Recovery Services (MARS) agent. MARS is also known as the Azure Backup agent.
1515

1616
## About the MARS agent
1717

@@ -26,10 +26,12 @@ The data that's available for backup depends on where the agent is installed.
2626
> [!NOTE]
2727
> Generally, you back up an Azure VM by using an Azure Backup extension on the VM. This method backs up the entire VM. If you want to back up specific files and folders on the VM, install and use the MARS agent alongside the extension. For more information, see [Architecture of a built-in Azure VM backup](backup-architecture.md#architecture-built-in-azure-vm-backup).
2828
29-
![Backup process steps](./media/backup-configure-vault/initial-backup-process.png)
29+
![Screenshot shows the Backup workflow.](./media/backup-configure-vault/initial-backup-process.png)
3030

3131
## Before you start
3232

33+
Before you install the MARS agent, ensure that you have performed the following actions:
34+
3335
* Learn how [Azure Backup uses the MARS agent to back up Windows machines](backup-architecture.md#architecture-direct-backup-of-on-premises-windows-server-machines-or-azure-vm-files-or-folders).
3436
* Learn about the [backup architecture](backup-architecture.md#architecture-back-up-to-dpmmabs) that runs the MARS agent on a secondary MABS or Data Protection Manager server.
3537
* Review [what's supported and what you can back up](backup-support-matrix-mars-agent.md) by the MARS agent.
@@ -48,15 +50,15 @@ By default, vaults use [geo-redundant storage (GRS)](../storage/common/storage-r
4850
* If the vault is your primary backup mechanism, we recommend that you use GRS.
4951
* You can use [locally redundant storage (LRS)](../storage/common/storage-redundancy.md#locally-redundant-storage) to reduce Azure storage costs.
5052

51-
To modify the storage replication type:
53+
To modify the storage replication type, follow these steps:
5254

5355
1. In the new vault, select **Properties** under the **Settings** section.
5456

5557
1. On the **Properties** page, under **Backup Configuration**, select **Update**.
5658

5759
1. Select the storage replication type, and select **Save**.
5860

59-
![Update Backup Configuration](./media/backup-afs/backup-configuration.png)
61+
![Screenshot shows how to update the Backup Configuration.](./media/backup-afs/backup-configuration.png)
6062

6163
> [!NOTE]
6264
> You can't modify the storage replication type after the vault is set up and contains backup items. If you want to do this, you need to re-create the vault.
@@ -80,46 +82,48 @@ If you've already installed the agent on any machines, ensure you're running the
8082

8183
1. In the vault, under **Getting Started**, select **Backup**.
8284

83-
![Open the backup goal](./media/backup-try-azure-backup-in-10-mins/open-backup-settings.png)
85+
![Screenshot shows how to open the backup goal.](./media/backup-try-azure-backup-in-10-mins/open-backup-settings.png)
8486

8587
1. Under **Where is your workload running?**, select **On-premises**. Select this option even if you want to install the MARS agent on an Azure VM.
8688
1. Under **What do you want to back up?**, select **Files and folders**. You can also select **System State**. Many other options are available, but these options are supported only if you're running a secondary backup server. Select **Prepare Infrastructure**.
8789

88-
![Configure files and folders](./media/backup-try-azure-backup-in-10-mins/set-file-folder.png)
90+
![Screenshot shows the configuration of files and folders.](./media/backup-try-azure-backup-in-10-mins/set-file-folder.png)
8991

9092
1. For **Prepare infrastructure**, under **Install Recovery Services agent**, download the MARS agent.
9193

92-
![Prepare the infrastructure](./media/backup-try-azure-backup-in-10-mins/choose-agent-for-server-client.png)
94+
![Screenshot shows how to prepare the infrastructure.](./media/backup-try-azure-backup-in-10-mins/choose-agent-for-server-client.png)
9395

9496
1. In the download menu, select **Save**. By default, the *MARSagentinstaller.exe* file is saved to your Downloads folder.
9597

9698
1. Select **Already download or using the latest Recovery Services Agent**, and then download the vault credentials.
9799

98-
![Download vault credentials](./media/backup-try-azure-backup-in-10-mins/download-vault-credentials.png)
100+
![Screenshot shows how to download the vault credentials.](./media/backup-try-azure-backup-in-10-mins/download-vault-credentials.png)
99101

100102
1. Select **Save**. The file is downloaded to your Downloads folder. You can't open the vault credentials file.
101103

102104
## Install and register the agent
103105

106+
To install and register the MARRS agent, follow these steps:
107+
104108
1. Run the *MARSagentinstaller.exe* file on the machines that you want to back up.
105109
1. In the MARS Agent Setup Wizard, select **Installation Settings**. There, choose where to install the agent, and choose a location for the cache. Then select **Next**.
106110
* Azure Backup uses the cache to store data snapshots before sending them to Azure.
107111
* The cache location should have free space equal to at least 5 percent of the size of the data you'll back up.
108112

109-
![Choose installation settings in the MARS Agent Setup Wizard](./media/backup-configure-vault/mars1.png)
113+
![Screenshot shows how to choose installation settings in the MARS Agent Setup Wizard.](./media/backup-configure-vault/mars1.png)
110114

111115
1. For **Proxy Configuration**, specify how the agent that runs on the Windows machine will connect to the internet. Then select **Next**.
112116

113117
* If you use a custom proxy, specify any necessary proxy settings and credentials.
114118
* Remember that the agent needs access to [specific URLs](#before-you-start).
115119

116-
![Set up internet access in the MARS wizard](./media/backup-configure-vault/mars2.png)
120+
![Screenshot shows how to set up internet access in the MARS wizard.](./media/backup-configure-vault/mars2.png)
117121

118122
1. For **Installation**, review the prerequisites, and select **Install**.
119123
1. After the agent is installed, select **Proceed to Registration**.
120124
1. In **Register Server Wizard** > **Vault Identification**, browse to and select the credentials file that you downloaded. Then select **Next**.
121125

122-
![Add vault credentials by using the Register Server Wizard](./media/backup-configure-vault/register1.png)
126+
![Screenshot shows how to add vault credentials by using the Register Server Wizard.](./media/backup-configure-vault/register1.png)
123127

124128
1. On the **Encryption Setting** page, specify a passphrase that will be used to encrypt and decrypt backups for the machine. [Learn more](backup-azure-file-folder-backup-faq.yml#what-characters-are-allowed-for-the-passphrase-) about the allowed passphrase characters.
125129

@@ -130,7 +134,7 @@ If you've already installed the agent on any machines, ensure you're running the
130134

131135
After granting the required permissions, you can save the passphrase to the Key Vault by copying the *Key Vault URI* from the Azure portal and to the Register Server Wizard.
132136

133-
:::image type="content" source="./media/backup-configure-vault/encryption-settings-passphrase-to-encrypt-decrypt-backups.png" alt-text="Screenshot showing to specify a passphrase to be used to encrypt and decrypt backups for machines.":::
137+
:::image type="content" source="./media/backup-configure-vault/encryption-settings-passphrase-to-encrypt-decrypt-backups.png" alt-text="Screenshot shows how to specify a passphrase to be used to encrypt and decrypt backups for machines.":::
134138

135139
1. Select **Finish**. The agent is now installed, and your machine is registered to the vault. You're ready to configure and schedule your backup.
136140

@@ -139,6 +143,6 @@ If you've already installed the agent on any machines, ensure you're running the
139143
>[!Note]
140144
>We recommend to save your passphrase in an alternate secure location, such as the Azure key vault. Microsoft can't recover the data without the passphrase. [Learn](save-backup-passphrase-securely-in-azure-key-vault.md) how to store a secret in a Key Vault.
141145
142-
## Next steps
146+
## Next step
143147

144148
Learn how to [Back up Windows machines by using the Azure Backup MARS agent](backup-windows-with-mars-agent.md)

0 commit comments

Comments
 (0)