You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/backup/install-mars-agent.md
+18-14Lines changed: 18 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Install the Microsoft Azure Recovery Services (MARS) agent
3
3
description: Learn how to install the Microsoft Azure Recovery Services (MARS) agent to back up Windows machines.
4
4
ms.topic: how-to
5
-
ms.date: 11/07/2023
5
+
ms.date: 10/25/2024
6
6
ms.service: azure-backup
7
7
author: AbhishekMallick-MS
8
8
ms.author: v-abhmallick
@@ -11,7 +11,7 @@ ms.author: v-abhmallick
11
11
12
12
# Install the Azure Backup MARS agent
13
13
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.
15
15
16
16
## About the MARS agent
17
17
@@ -26,10 +26,12 @@ The data that's available for backup depends on where the agent is installed.
26
26
> [!NOTE]
27
27
> 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).
28
28
29
-

29
+

30
30
31
31
## Before you start
32
32
33
+
Before you install the MARS agent, ensure that you have performed the following actions:
34
+
33
35
* 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).
34
36
* 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.
35
37
* 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
48
50
* If the vault is your primary backup mechanism, we recommend that you use GRS.
49
51
* You can use [locally redundant storage (LRS)](../storage/common/storage-redundancy.md#locally-redundant-storage) to reduce Azure storage costs.
50
52
51
-
To modify the storage replication type:
53
+
To modify the storage replication type, follow these steps:
52
54
53
55
1. In the new vault, select **Properties** under the **Settings** section.
54
56
55
57
1. On the **Properties** page, under **Backup Configuration**, select **Update**.
56
58
57
59
1. Select the storage replication type, and select **Save**.

60
62
61
63
> [!NOTE]
62
64
> 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
80
82
81
83
1. In the vault, under **Getting Started**, select **Backup**.
82
84
83
-

85
+

84
86
85
87
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.
86
88
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**.
87
89
88
-

90
+

89
91
90
92
1. For **Prepare infrastructure**, under **Install Recovery Services agent**, download the MARS agent.
91
93
92
-

94
+

93
95
94
96
1. In the download menu, select **Save**. By default, the *MARSagentinstaller.exe* file is saved to your Downloads folder.
95
97
96
98
1. Select **Already download or using the latest Recovery Services Agent**, and then download the vault credentials.

99
101
100
102
1. Select **Save**. The file is downloaded to your Downloads folder. You can't open the vault credentials file.
101
103
102
104
## Install and register the agent
103
105
106
+
To install and register the MARRS agent, follow these steps:
107
+
104
108
1. Run the *MARSagentinstaller.exe* file on the machines that you want to back up.
105
109
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**.
106
110
* Azure Backup uses the cache to store data snapshots before sending them to Azure.
107
111
* The cache location should have free space equal to at least 5 percent of the size of the data you'll back up.
108
112
109
-

113
+

110
114
111
115
1. For **Proxy Configuration**, specify how the agent that runs on the Windows machine will connect to the internet. Then select **Next**.
112
116
113
117
* If you use a custom proxy, specify any necessary proxy settings and credentials.
114
118
* Remember that the agent needs access to [specific URLs](#before-you-start).
115
119
116
-

120
+

117
121
118
122
1. For **Installation**, review the prerequisites, and select **Install**.
119
123
1. After the agent is installed, select **Proceed to Registration**.
120
124
1. In **Register Server Wizard** > **Vault Identification**, browse to and select the credentials file that you downloaded. Then select **Next**.
121
125
122
-

126
+

123
127
124
128
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.
125
129
@@ -130,7 +134,7 @@ If you've already installed the agent on any machines, ensure you're running the
130
134
131
135
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.
132
136
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.":::
134
138
135
139
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.
136
140
@@ -139,6 +143,6 @@ If you've already installed the agent on any machines, ensure you're running the
139
143
>[!Note]
140
144
>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.
141
145
142
-
## Next steps
146
+
## Next step
143
147
144
148
Learn how to [Back up Windows machines by using the Azure Backup MARS agent](backup-windows-with-mars-agent.md)
0 commit comments