Gestire la larghezza di banda di rete di un agente di Spostamento archiviazione
Questo articolo mostra come impostare le pianificazioni della gestione della larghezza di banda per gli agenti di Spostamento archiviazione.
Quando si esegue la migrazione di file e cartelle in Azure, è necessario valutare attentamente la larghezza di banda di caricamento che si vuole rendere disponibile a ogni agente di Spostamento archiviazione. Anche altri carichi di lavoro possono dipendere dalla disponibilità di una larghezza di banda sufficiente. Per rendere gli agenti di Spostamento archiviazione un “buon vicino” per gli altri carichi di lavoro nella rete, è possibile pianificare i limiti per ogni agente.
Prerequisiti
Prima di impostare una pianificazione della larghezza di banda, è necessario innanzitutto distribuire una risorsa di Spostamento archiviazione in uno dei gruppi di risorse e quindi registrare un agente. Le pianificazioni dei limiti di larghezza di banda vengono impostate e archiviate per ogni agente registrato.
Informazioni sul concetto di base di gestione della larghezza di banda
Una pianificazione è un attributo di un agente registrato. Nel portale è possibile impostare e modificare questa pianificazione nella pagina degli agenti registrati, disponibile nella risorsa di Spostamento archiviazione.
Una pianificazione della gestione della larghezza di banda descrive gli intervalli temporali nell’arco di una settimana, durante i quali è possibile impostare un limite per la quantità di larghezza di banda di caricamento che un agente di Spostamento archiviazione può usare.
Benché la pianificazione sia molto simile a un calendario in Outlook ci sono alcune differenze importanti:
- La pianificazione si ripete. La pianificazione interessa sette giorni feriali e si ripete alla fine della settimana.
- Una voce nella pianificazione rappresenta un limite designato che l'agente non deve superare. L’intervallo non pianificato si estende in un giorno in cui non è stata definita alcuna limitazione, consentendo all'agente di usare la larghezza di banda necessaria.
- Non è possibile pianificare un limite per una data specifica, ma solo per giorni feriali consecutivi. Ad esempio, è possibile specificare: "Limitare la larghezza di banda dell'agente a non più di x durante la finestra di backup del cloud la domenica".
- Nella pianificazione non viene archiviato un fuso orario. Quando si imposta un limite che inizia ad esempio alle 9:00, si intende l'ora locale dell'agente. È possibile visualizzare il fuso orario configurato per l'agente. Prestare particolare attenzione in quanto il fuso orario dell'agente può essere diverso dal fuso orario del sito in cui viene distribuito l'agente.
Suggerimento
È possibile impostare il fuso orario di un agente di Spostamento archiviazione su quello dell’area geografica dove viene distribuito.
1. Connettersi alla console dell'agente ed eseguire l’accesso
2. Selezionare l'opzione di menu: 1) System configuration
3. Selezionare l'opzione di menu 3) Change timezone
e seguire le istruzioni per effettuare la selezione.
Abilitare o modificare una pianificazione della gestione della larghezza di banda
È possibile usare il portale di Azure per abilitare una pianificazione della larghezza di banda in una risorsa agente registrata.
- Quando il portale visualizza la risorsa di Spostamento archiviazione, selezionare "Agenti registrati" nel menu a sinistra.
- A questo punto vengono visualizzate due opzioni che consentono di impostare o visualizzare una pianificazione. È possibile individuare la colonna "Gestione della larghezza di banda" e fare clic sul collegamento dell'agente selezionato. In alternativa, è possibile selezionare la casella di controllo davanti all'agente. Viene abilitato un pulsante di comando sopra l'elenco degli agenti denominato "Gestisci limite di larghezza di banda".
- Viene visualizzata la finestra di gestione della larghezza di banda e la pianificazione attualmente attiva per l'agente. Se viene visualizzata una pianificazione vuota, significa che non ci sono limitazioni della larghezza di banda definite per l’agente.
Impostare un limite di larghezza di banda
Aprire la finestra di pianificazione della larghezza di banda (vedere la sezione precedente).
Qui è possibile creare una pianificazione personalizzata per l’agente selezionato oppure riutilizzare una pianificazione creata in precedenza per un altro agente.
- Per creare una pianificazione personalizzata, selezionare il comando "Aggiungi limite". Viene visualizzata una finestra di dialogo che consente di definire un intervallo di tempo in cui impostare la larghezza di banda massima del collegamento WAN utilizzabile dall’agente.
La finestra di dialogo richiede di impostare un’ora di inizio e di fine durante le quali applicare un limite di uplink per l'agente. È quindi possibile scegliere in quali giorni della settimana applicare il nuovo limite. Selezionare tutti i giorni feriali in cui applicare lo stesso limite. È quindi necessario specificare il limite in Mbps (megabit al secondo). Non sono consentiti intervalli di tempo sovrapposti. Qualsiasi limite impostato si applica all'ora visualizzata nel fuso orario dell'agente. È possibile trovare il fuso orario dell'agente visualizzato nella parte superiore della finestra di gestione della larghezza di banda. Può essere necessario sfalsare la pianificazione o modificare il fuso orario dell'agente. - Per "riutilizzare una pianificazione di un altro agente", seguire il collegamento a una sezione futura.
- Per applicare le modifiche apportate all’agente, selezionare il pulsante "Salva" nella parte inferiore della finestra "Gestione della larghezza di banda".
Nota
La pianificazione controlla solo il flusso di dati di migrazione stabilito da un agente per l'archivio di destinazione in Azure. Oltre a questo flusso di dati, è presente anche il traffico del piano di controllo dall'agente ad Azure. I messaggi di controllo, i dati di telemetria dello stato e i log di copia richiedono in genere solo una piccola quantità di larghezza di banda. Il piano di controllo dell'agente non è regolato dalla pianificazione impostata per garantire una corretta funzionalità dell’agente durante la migrazione. In casi estremi l'agente può leggermente superare i limiti definiti.
Suggerimento
È possibile impostare il fuso orario di un agente di Spostamento archiviazione su quello dell’area geografica dove viene distribuito.
1. Connettersi alla console dell'agente ed eseguire l’accesso
2. Selezionare l'opzione di menu: 1) System configuration
3. Selezionare l'opzione di menu 3) Change timezone
e seguire le istruzioni per effettuare la selezione.
Modificare o eliminare un limite di larghezza di banda
Aprire la pianificazione della gestione della larghezza di banda per l'agente selezionato (vedere la sezione precedente).
Per modificare o eliminare un limite specifico, selezionare il limite. Verrà visualizzata la finestra di dialogo "Modifica limite". È possibile modificare la fascia oraria o eliminare il limite. Poiché le opzioni di modifica in blocco non sono disponibili, è necessario modificare ogni limite per ogni giorno feriale singolarmente.
Se l'obiettivo è disabilitare completamente la gestione della larghezza di banda per l'agente, selezionare il comando "Cancella tutti i limiti".
Non dimenticarsi di applicare le modifiche apportate all’agente. Selezionare il pulsante "Salva" nella parte inferiore della finestra "Gestione della larghezza di banda".
Riutilizzare una pianificazione di un altro agente
È possibile riutilizzare la pianificazione del limite di larghezza di banda di un altro agente.
- Aprire la pianificazione della gestione della larghezza di banda per l'agente selezionato Vedere il paragrafo precedente.
- Selezionare il comando "Importa limiti da altri agenti" e quindi selezionare l'agente da cui copiare la pianificazione. Se nell'elenco non sono presenti agenti, non ci sono altri agenti con limiti di larghezza di banda abilitati.
Avviso
L'uso di questa opzione sovrascriverà la pianificazione attualmente configurata per l'agente. Non è possibile ripristinare le modifiche non salvate apportate prima dell’importazione di una pianificazione.
- Facoltativamente, è ora possibile modificare la pianificazione copiata.
- Per applicare le modifiche apportate all’agente, selezionare il pulsante "Salva" nella parte inferiore della finestra "Gestione della larghezza di banda".
Importante
Le pianificazioni vengono archiviate senza il fuso orario. Ciò consente di riutilizzarle per altri agenti. Un limite pianificato sarà effettivo durante il periodo specificato in qualsiasi fuso orario dell'agente. È necessario assicurarsi di compensare la pianificazione della gestione della larghezza di banda se il fuso orario dell'agente è diverso da quello usato nell’area geografica in cui è stato distribuito l'agente. Ad esempio, se il fuso orario dell'agente è UTC, ma l'agente viene effettivamente distribuito nel fuso orario del Pacifico (PST), è necessario compensare la pianificazione di -7 ore. In alternativa, è possibile modificare il fuso orario dell'agente in base a quello corretto per l’area geografica. In questo modo non è più necessario compensare la pianificazione e si consente anche alla pianificazione di impostare automaticamente l'ora legale se il fuso orario lo prevede.
Suggerimento
È possibile impostare il fuso orario di un agente di Spostamento archiviazione su quello dell’area geografica dove viene distribuito.
1. Connettersi alla console dell'agente ed eseguire l’accesso
2. Selezionare l'opzione di menu: 1) System configuration
3. Selezionare l'opzione di menu 3) Change timezone
e seguire le istruzioni per effettuare la selezione.
Usare PowerShell per configurare una pianificazione del limite di larghezza di banda
La gestione di questa funzionalità è possibile quando si usa la versione più recente del modulo di Azure PowerShell.
Preparare l'ambiente Azure PowerShell
- Se si sceglie di usare Azure PowerShell in locale:
- Installare la versione più recente del modulo Az di PowerShell.
- Connettersi all'account Azure con il cmdlet Connect-AzAccount.
- Se si sceglie di usare Azure Cloud Shell:
- Vedere Panoramica di Azure Cloud Shell per altre informazioni.
È necessario il modulo Az.StorageMover
:
## Ensure you are running the latest version of PowerShell 7
$PSVersionTable.PSVersion
## Your local execution policy must be set to at least remote signed or less restrictive
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
## If you don't have the general Az PowerShell module, install it first
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force
## Lastly, the Az.StorageMover module is not installed by default and must be manually requested.
Install-Module -Name Az.StorageMover -Scope CurrentUser -Repository PSGallery -Force
Gestire una pianificazione del limite di larghezza di banda
## Set variables
$subscriptionID = "Your subscription ID"
$resourceGroupName = "Your resource group name"
$storageMoverName = "Your storage mover resource name"
$registeredAgentName = "Name of the agent, registered to your storage mover resource"
## Log into Azure with your Azure credentials
Connect-AzAccount -SubscriptionId $subscriptionID # -DeviceLogin #Leverage DeviceLogin if you need to authenticate your PowerShell session from another machine. # -TenantID #In some environments you may you need to specify the EntraID tenant to authenticate against.
#------------
# GET the schedule configured on an agent:
$schedule = @(Get-AzStorageMoverAgent -ResourceGroupName $resourceGroupName -StorageMoverName $storageMoverName -AgentName $registeredAgentName).UploadLimitScheduleWeeklyRecurrence
# $schedule then contains a JSON structure with elements for each configured time windows and the upload limit in Mbps that applies during this window.
# Output the entire schedule
$schedule
# Schedule elements can be addressed like an array.
$schedule[0]
Aggiungere una nuova limitazione della larghezza di banda
$newLimit = New-AzStorageMoverUploadLimitWeeklyRecurrenceObject `
-Day "Monday", "Tuesday" ` # Mandatory. An array, limited to the English names of all 7 days, Monday through Sunday in any order.
-LimitInMbps 900 ` # Mandatory. Limit in "Mega bits per second"
-StartTimeHour 5 ` # Mandatory. 24-hour clock: 5 = 5am
-EndTimeHour 17 ` # Mandatory. 24-hour clock: 17 = 5pm
-EndTimeMinute 30 # Optional. Time blocks are precise to 30 Minutes. -EndTimeMinute 0 is equivalent to omitting the parameter. The only other acceptable value is the half hour mark: 30.
$schedule += $newLimit # Appends the new limit to the exiting schedule. The JSON structure does not need to be ordered by days or time.
# Updates the bandwidth limit schedule for the selected agent by adding the defined "time block" to the schedule.
# Ensure that the new limit does not overlap with an already configured limit in the schedule, otherwise the operation will fail.
Update-AzStorageMoverAgent `
-ResourceGroupName $resourceGroupName `
-StorageMoverName $storageMoverName `
-AgentName $registeredAgentName `
-UploadLimitScheduleWeeklyRecurrence $schedule
# This command sets and overwrites a bandwidth limit schedule for the selected agent. Be sure to preserve an existing schedule if you want to only add a new limit. If you are building an entirely new schedule, you can form all your limit objects and then supply a comma-separated list of your new limits here.
# Ensure the new limit's time span is not overlapping any existing limits. Otherwise, the operation will fail.
Disabilitare la limitazione della larghezza di banda per un agente
Update-AzStorageMoverAgent `
-ResourceGroupName $resourceGroupName `
-StorageMoverName $storageMoverName `
-AgentName $registeredAgentName `
-UploadLimitScheduleWeeklyRecurrence @() # Supply an empty array to remove all previously configured limits. This operation cannot be undone. You have to build and supply a new schedule if you want to enable bandwidth limitations for this agent again.
Modificare una limitazione della larghezza di banda esistente
È possibile combinare le azioni di gestione descritte in precedenza per aggiornare in modo selettivo una limitazione della larghezza di banda esistente a un nuovo limite o a un intervallo di tempo aggiornato.
# Step 1: define the new limit object you want to use to replace an existing limit:
$limit = New-AzStorageMoverUploadLimitWeeklyRecurrenceObject `
-Day "Monday", "Tuesday" ` # Mandatory. An array, limited to the English names of all 7 days, Monday through Sunday in any order.
-LimitInMbps 900 ` # Mandatory. limit in "Mega bits per second"
-StartTimeHour 5 ` # Mandatory. 24-hour clock: 5 = 5am
-EndTimeHour 17 ` # Mandatory. 24-hour clock: 17 = 5pm
-EndTimeMinute 30 # Optional. Time blocks are precise to 30 Minutes. -EndTimeMinute 0 is equivalent to omitting the parameter. The only other acceptable value is the half hour mark: 30.
# Step 2: Find the bandwidth limitation window you want to change:
$schedule = @(Get-AzStorageMoverAgent -ResourceGroupName $resourceGroupName -StorageMoverName $storageMoverName -AgentName $registeredAgentName).UploadLimitScheduleWeeklyRecurrence
$schedule[<n>] = $limit # Replace the limit (start count at zero) with your newly defined limit.
#Step 3: Update the bandwidth limit schedule for the selected agent:
Update-AzStorageMoverAgent `
-ResourceGroupName $resourceGroupName `
-StorageMoverName $storageMoverName `
-AgentName $registeredAgentName `
-UploadLimitScheduleWeeklyRecurrence $schedule # Apply your entire, updated schedule. Performing this step on an agent with other limits already configured will override them with this new schedule. Ensure there are no overlapping time spans, otherwise the operation will fail.
Informazioni sullo schema JSON di una pianificazione del limite di larghezza di banda
La pianificazione del limite di larghezza di banda viene archiviata come costrutto JSON nella proprietà UploadLimitScheduleWeeklyRecurrence
di un agente registrato.
La sezione precedente di PowerShell mostra un esempio di come creare e aggiornare questa proprietà dell'agente con Azure PowerShell. È tuttavia possibile formare manualmente il codice JSON e specificarlo direttamente come argomento per la proprietà . La sezione seguente fornisce una descrizione degli elementi della pianificazione della larghezza di banda del costrutto JSON.
Importante
La pianificazione è costituita da uno o più intervalli di tempo durante i quali viene applicato un limite di larghezza di banda che l'agente non deve superare. Questi intervalli di tempo non devono sovrapporsi. In qualsiasi momento, è possibile applicare un solo limite. Un codice JSON che specifica una pianificazione con intervalli di tempo sovrapposti viene considerato come avente un formato non valido e non può essere applicato all'agente.
Le due rappresentazioni seguenti di una pianificazione del limite di larghezza di banda sono equivalenti:
{
{
"startTime":
{
"hour": 7,
"minute": 0
},
"endTime":
{
"hour": 9,
"minute": 0
}
"days": ["Monday"],
"limitInMbps": 500
},
{
"startTime":
{
"hour": 9,
"minute": 0
},
"endTime":
{
"hour": 12,
"minute": 0
}
"days": ["Monday", "Tuesday", "Wednesday"],
"limitInMbps": 200
}
}
Nota
Negli intervalli di tempo non associati a una voce nella pianificazione l'agente può utilizzare la larghezza di banda disponibile. In questi intervalli di tempo, è probabile che un agente non usi tutta la larghezza di banda disponibile. Per altre informazioni, vedere la sezione: "Perché le prestazioni della migrazione variano" nell’articolo sulle prestazioni.
Passaggi successivi
Passare a uno degli articoli successivi per informazioni su come distribuire un agente di Spostamento archiviazione o creare un progetto di migrazione.