

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Scarica e configura Edge Manager
<a name="edge-getting-started-step4"></a>

L'agente Edge Manager è un motore di inferenza per i dispositivi edge. Usa l'agente per fare previsioni con modelli caricati sui tuoi dispositivi edge. L'agente raccoglie anche i parametri dei modelli e acquisisce i dati a intervalli specifici.



In questa sezione configurerai il tuo dispositivo con l'agente. Per fare ciò, prima copia, localmente sul tuo computer, un artefatto di rilascio e il certificato root di firma dal bucket di rilascio. Dopo aver decompresso l'artefatto di rilascio, caricalo su Amazon S3. Quindi, definisci e salva un file di configurazione per l'agente. Viene fornito un modello da copiare e incollare. Infine, copia sul tuo dispositivo gli artefatti della versione, il file di configurazione e le credenziali.

1. **Scarica l'agente SageMaker Edge Manager.**

   L'agente viene rilasciato in formato binario per i sistemi operativi supportati. Questo esempio esegue l'inferenza su un Jetson Nano che utilizza un sistema operativo Linux e ha un'architettura. ARM64 Per ulteriori informazioni sul sistema operativo e sull'architettura utilizzati dai dispositivi supportati, vedere [Dispositivi, architetture di chip e sistemi supportati](neo-supported-devices-edge-devices.md).

   Recupera l'ultima versione dei file binari dal bucket di rilascio di SageMaker Edge Manager dalla regione us-west-2.

   ```
   !aws s3 ls s3://sagemaker-edge-release-store-us-west-2-linux-armv8/Releases/ | sort -r
   ```

   Ciò restituisce gli artefatti della versione ordinati in base alla loro versione.

   ```
                              PRE 1.20210512.96da6cc/
                              PRE 1.20210305.a4bc999/
                              PRE 1.20201218.81f481f/
                              PRE 1.20201207.02d0e97/
   ```

   La versione ha il formato seguente: `<MAJOR_VERSION>.<YYYY-MM-DD>.<SHA-7>`. Consiste di tre componenti:
   + `<MAJOR_VERSION>`: la versione del rilascio La versione del rilascio è attualmente impostata su `1`.
   + `<YYYY-MM-DD>`: Il timestamp del rilascio dell'artefatto.
   + <SHA-7>: L'ID commit del repository da cui viene creato il rilascio.

   Copia localmente o direttamente sul tuo dispositivo il file TAR compresso. L'esempio seguente mostra come copiare l'artefatto del rilascio più recente al momento del rilascio del documento.

   ```
   !aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-x64/Releases/1.20201218.81f481f/1.20201218.81f481f.tgz ./
   ```

   Una volta ottenuto l'artefatto, decomprimi il file TAR compresso. Quanto segue decomprime il file TAR e lo memorizza in una directory chiamata: `agent_demo`

   ```
   !mkdir agent_demo
   !tar -xvzf 1.20201218.81f481f.tgz -C ./agent_demo
   ```

   Carica gli artefatti di rilascio dell'agente sul tuo bucket Amazon S3. Il seguente esempio di codice copia il contenuto all'interno di `agent_demo` e lo carica in una directory all'interno del bucket Amazon S3 chiamata: `agent_demo`

   ```
   !aws s3 cp --recursive ./agent_demo s3://{bucket}/agent_demo
   ```

   Sono inoltre necessari i certificati root per la firma dal bucket di rilascio:

   ```
   !aws s3 cp s3://sagemaker-edge-release-store-us-west-2-linux-x64/Certificates/us-west-2/us-west-2.pem ./
   ```

   Carica il certificato root di firma sul tuo bucket Amazon S3:

   ```
   !aws s3 cp us-west-2.pem s3://{bucket}/authorization-files/
   ```

1. **Definire un file di configurazione dell'agente SageMaker Edge Manager.**

   Innanzitutto, definire il file di configurazione dell'agente come segue:

   ```
   sagemaker_edge_config = {
       "sagemaker_edge_core_device_name": {{"device_name"}},
       "sagemaker_edge_core_device_fleet_name": {{"device_fleet_name"}},
       "sagemaker_edge_core_capture_data_buffer_size": 30,
       "sagemaker_edge_core_capture_data_push_period_seconds": 4,
       "sagemaker_edge_core_folder_prefix": "demo_capture",
       "sagemaker_edge_core_region": "us-west-2",
       "sagemaker_edge_core_root_certs_path": "/agent_demo/certificates",
       "sagemaker_edge_provider_aws_ca_cert_file": "/agent_demo/iot-credentials/AmazonRootCA1.pem",
       "sagemaker_edge_provider_aws_cert_file": "/agent_demo/iot-credentials/device.pem.crt",
       "sagemaker_edge_provider_aws_cert_pk_file": "/agent_demo/iot-credentials/private.pem.key",
       "sagemaker_edge_provider_aws_iot_cred_endpoint": {{"endpoint"}},
       "sagemaker_edge_provider_provider": "Aws",
       "sagemaker_edge_provider_s3_bucket_name": bucket,
       "sagemaker_edge_core_capture_data_destination": "Cloud"
   }
   ```

   Sostituisci quanto segue:
   + `"device_name"` con il nome del tuo dispositivo (questa stringa è stata memorizzata in una fase precedente in una variabile denominata `device_name`).
   + `"device_fleet_name`" con il nome del tuo dispositivo (questa stringa è stata memorizzata in una fase precedente in una variabile denominata `device_fleet_name`).
   + `"endpoint"`con l'endpoint AWS specifico dell'account per il provider di credenziali (questa stringa è stata archiviata in un passaggio precedente in una variabile denominata). `endpoint`

   Quindi, salvalo come file JSON:

   ```
   edge_config_file = open("sagemaker_edge_config.json", "w")
   json.dump(sagemaker_edge_config, edge_config_file, indent = 6)
   edge_config_file.close()
   ```

   Carica il file di configurazione nel tuo bucket Amazon S3.

   ```
   !aws s3 cp sagemaker_edge_config.json s3://{bucket}/
   ```

1. **Copia sul tuo dispositivo gli artefatti della versione, il file di configurazione e le credenziali.**

   Le seguenti istruzioni vengono eseguite sul dispositivo edge stesso.
**Nota**  
Devi prima installare Python AWS SDK per Python (Boto3), the e the AWS CLI sul tuo dispositivo edge. 

   Apri un terminale sul dispositivo. Crea una cartella per memorizzare gli artefatti di rilascio, le tue credenziali e il file di configurazione.

   ```
   mkdir agent_demo
   cd agent_demo
   ```

   Copia il contenuto degli artefatti di rilascio archiviati nel bucket Amazon S3 sul dispositivo:

   ```
   # Copy release artifacts 
   aws s3 cp s3://{{<bucket-name>}}/{{agent_demo}}/ ./ --recursive
   ```

   (Il contenuto dell'artefatto di rilascio è stato archiviato in una fase precedente in una directory chiamata `agent_demo`). Sostituisci `<bucket-name>` e `agent_demo` rispettivamente con il nome del bucket Amazon S3 e il percorso del file degli artefatti di rilascio.

   Vai alla directory `/bin` e rendi eseguibili i file binari:

   ```
   cd bin
   
   chmod +x sagemaker_edge_agent_binary
   chmod +x sagemaker_edge_agent_client_example
   
   cd agent_demo
   ```

   Crea una directory per archiviare AWS IoT le tue credenziali e copia le credenziali dal tuo bucket Amazon S3 al tuo dispositivo edge (usa la stessa su che definisci nella variabile: `bucket`

   ```
   mkdir iot-credentials
   cd iot-credentials
   
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/AmazonRootCA1.pem ./
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/device.pem.crt ./
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/private.pem.key ./
   
   cd ../
   ```

   Crea una directory per archiviare i certificati root di firma del modello:

   ```
   mkdir certificates
   
   cd certificates
   
   aws s3 cp s3://{{<bucket-name>}}/authorization-files/us-west-2.pem ./
   
   cd agent_demo
   ```

   Copia il file di configurazione sul tuo dispositivo:

   ```
   #Download config file from S3
   aws s3 cp s3://{{<bucket-name>}}/sagemaker_edge_config.json ./
   
   cd agent_demo
   ```

   La directory `agent_demo` sul dispositivo edge dovrebbe essere simile alla seguente:

   ```
   ├──agent_demo
   |    ├── bin
   |        ├── sagemaker_edge_agent_binary
   |        └── sagemaker_edge_agent_client_example
   |    ├── sagemaker_edge_config.json
   |    ├── certificates
   |        └──us-west-2.pem
   |    ├── iot-credentials
   |        ├── AmazonRootCA1.pem
   |        ├── device.pem.crt
   |        └── private.pem.key
   |    ├── docs
   |        ├── api
   |        └── examples
   |    ├── ATTRIBUTIONS.txt
   |    ├── LICENSE.txt  
   |    └── RELEASE_NOTES.md
   ```