Documentation Oracle Cloud Infrastructure

Mise à niveau du logiciel d'appareil Roving Edge lors de la déconnexion

Découvrez comment mettre à niveau le logiciel d'appareil Roving Edge alors que l'appareil n'est pas connecté à votre location Oracle Cloud Infrastructure (OCI).

Remarque

La possibilité de mettre à niveau le logiciel de l'appareil alors qu'il est déconnecté a été introduite dans la version 2.6 du logiciel Roving Edge. Si votre périphérique exécute une version antérieure (2.5 ou antérieure), vous devez mettre à jour le logiciel du périphérique lors de la connexion. Pour trouver la version logicielle de votre périphérique, reportez-vous à la section Identifying the Device Software Version.

Le processus de mise à niveau déconnectée comprend plusieurs tâches :

  1. Obtenez la version logicielle en cours de l'appareil.
  2. Dans OCI, demandez un package de mise à niveau de système.
  3. Transférez le package de mise à niveau vers un bucket sur l'appareil Roving Edge.
  4. Sur le périphérique, importez le lot de mise à niveau.
  5. Mettez le périphérique à niveau.

Les étapes de chaque tâche sont décrites dans cette section.

Vous devez disposer des droits d'accès requis pour effectuer une mise à niveau logicielle sur un appareil Roving Edge Infrastructure déconnecté. Reportez-vous à la section Enabling Disconnected Upgrade Bundle Delivery (Optional).

Remarque

Les lots de mise à niveau du système peuvent être très volumineux. Le téléchargement et le téléchargement peuvent prendre beaucoup de temps. Planifiez en conséquence.

Après la mise à niveau, le périphérique se réinitialise et vous devez utiliser la console série pour déverrouiller le périphérique. Pour préparer l'utilisation de la console série, reportez-vous à la section Operating the Serial Console.

  • Tâche 1 – Obtention de la version logicielle actuelle du périphérique

    1. Connectez-vous à la console d'appareil de l'appareil Roving Edge que vous prévoyez de mettre à niveau.

    2. Sélectionnez l'icône Statut de système (Icône Statut de système) dans l'angle supérieur droit de la console de périphériques.

      Mises à niveau du système affiche votre version logicielle actuelle.

    3. Enregistrez la version actuelle du logiciel système. Vous l'utiliserez ultérieurement dans le processus de mise à niveau.

    Tâche 2 – Demande d'un package de mise à niveau système

    1. Dans la console Oracle Cloud, ouvrez le menu Hybride, puis sélectionnez Noeuds.

    2. Si nécessaire, modifiez le compartiment pour trouver la ressource de votre choix.

    3. Sélectionnez le noeud de périphérique que vous prévoyez de mettre à niveau.

      La page Détails du noeud s'affiche.

      Le noeud de périphérique doit avoir l'état Reçu par le client ou Déployé par le client pour demander un package de mise à niveau du système.

    4. Sélectionnez l'onglet Mises à niveau du système.

    5. Sélectionnez Demander un package de mise à niveau de système.

      La boîte de dialogue Request Node Upgrade Bundle s'affiche.

    6. Entrer les informations obligatoires:

      • Entrez la version logicielle actuelle du noeud de périphérique dans la zone Version logicielle actuelle et sélectionnez Obtenir la prochaine version de mise à niveau.

        Le numéro de version que vous saisissez est comparé aux lots de mise à niveau disponibles pour voir quelle est la correspondance appropriée. La meilleure correspondance est affichée dans la zone Version de mise à niveau compatible. Parfois, vous devrez peut-être effectuer une mise à niveau temporaire du logiciel système avant de pouvoir effectuer la mise à niveau souhaitée. La zone Version de mise à niveau compatible vous permet de suivre l'ordre de mise à niveau requis.

      • Sélectionnez un bucket dans la liste Bucket de destination. Le bucket que vous sélectionnez reçoit le bundle système que vous demandez. Sélectionnez Modifier le compartiment pour sélectionner un bucket de destination résidant dans un autre compartiment.

    7. Sélectionnez Demander un package de mise à niveau de système.

      La liste Demandes de package de mise à niveau du système affiche la progression du transfert du package vers le bucket de destination spécifié.

      Une fois le transfert terminé, le fichier du package de mise à niveau est stocké dans le bucket Object Storage et y reste jusqu'à ce que vous le supprimiez.

    8. (Facultatif) Dans le menu Actions (Image de l'icône à trois points.), sélectionnez Afficher les détails pour afficher plus d'informations dans la demande de bundle de mise à niveau du système.

      Les demandes de travail de demande de package de mise à niveau restent répertoriées pendant 48 heures.
    Tâche 3 : transférez le lot de mises à niveau vers le périphérique.
    1. (Bien que toujours connecté à la console Oracle Cloud) Une fois le transfert de groupe de mise à niveau terminé, sélectionnez le nom du bucket de destination pour visualiser le fichier dans le bucket Object Storage.

    2. En regard du fichier du bundle de mise à niveau, sélectionnez le menu Actions (menu Actions (Image de l'icône à trois points.)), puis sélectionnez Télécharger.

      La boîte de dialogue Télécharger l'objet s'affiche pendant le téléchargement de l'objet et affiche le statut de téléchargement.

    3. Copiez le groupe téléchargé sur un ordinateur que vous pouvez connecter au même réseau que l'appareil Roving Edge Infrastructure.

    4. Téléchargez le package de mise à niveau vers le bucket rover-system-upgrade-staging dans Roving Edge Object Storage. Reportez-vous à Téléchargement d'un objet vers un bucket Object Storage sur un appareil.

    Tâche 4 : sur le périphérique, importez le lot de mises à niveau

    1. Connectez-vous à la console d'appareil de l'appareil Roving Edge que vous prévoyez de mettre à niveau.

    2. Dans le menu de navigation, sélectionnez Gestion des noeuds, puis Mises à niveau du système hors ligne.

      Les lots de mise à niveau précédents sont répertoriés. S'il s'agit de la première demande de package de mise à niveau, la liste est vide.

    3. Sélectionnez Importer le bundle.

      Le panneau Import Bundle Requests s'affiche.

    4. Sous Nom de l'objet, sélectionnez le groupe de mise à niveau dans le menu déroulant.

    5. Sélectionnez Importer le bundle.

      Le package de mise à niveau est importé vers le périphérique et placé dans un bucket Object Storage nommé rover-system-upgrade-staging. Une fois l'importation terminée, le groupe importé passe à l'état Importé et vous pouvez procéder à la mise à niveau du périphérique.

    Tâche 5 – Mise à niveau du périphérique

    1. (Bien que toujours connecté à la console des périphériques) Assurez-vous que l'importation du bundle de mise à niveau est terminée. Sélectionnez l'icône Statut de système (Icône Statut de système) dans l'angle supérieur droit de la console de périphériques.

      La boîte de dialogue Mises à niveau du système affiche le statut des différentes étapes du processus d'importation. Une fois l'import terminé, la boîte de dialogue affiche la version actuelle du logiciel système du dispositif et la nouvelle version importée.

    2. Dans le menu de navigation, sélectionnez Gestion des noeuds > Noeuds.

    3. Sur la ligne du noeud de périphérique, sélectionnez le menu Actions (Image de l'icône à trois points.) et sélectionnez Mettre à niveau.

    4. Confirmez la demande de mise à niveau.

      La boîte de dialogue Mises à niveau de système indique quand la mise à niveau est terminée.

      Le périphérique est automatiquement réinitialisé à la fin du processus de mise à niveau. Vous devez déverrouiller le périphérique réinitialisé à l'aide de la console série. Reportez-vous à la section Operating the Serial Console.

  • Vous pouvez utiliser l'interface de ligne de commande pour effectuer des tâches de préparation de mise à niveau, mais vous ne pouvez pas utiliser l'interface de ligne de commande pour effectuer la mise à niveau. Utilisez la console des périphériques pour mettre à niveau le périphérique.

    Commandes CLI de préparation de la mise à niveau

    Remarque

    Les commandes suivantes sont exécutées sur votre location OCI. Veillez à utiliser un profil d'interface de ligne de commande configuré pour atteindre la location OCI.

    • Obtenir la version de mise à niveau compatible : exécutez la commande oci rover node rover-bundle-version get et les paramètres requis pour obtenir la version de mise à niveau compatible pour un appareil Roving Edge Infrastructure :

      oci rover node rover-bundle-version get --current-rover-bundle-version current_rover_bundle_version --rover-node-id rover_node_ocid [OPTIONS]

    • Demander un package de mise à niveau système : exécutez la commande oci rover node rover-bundle copy-to-customer et les paramètres requis pour demander un package de mise à niveau système pour un appareil Roving Edge Infrastructure.

      oci rover node rover-bundle copy-to-customer --bundle-version bundle_version \
--destination-bucket-name destination_bucket_name --destination-compartment-id destination_compartment_ocid \
--rover-node-id rover_node_ocid [OPTIONS]

    • Liste des demandes de package de mise à niveau : exécutez la commande oci rover node rover-bundle-request list et les paramètres requis pour répertorier les demandes de package de mise à niveau d'un appareil Roving Edge Infrastructure :

      oci rover node rover-bundle-request list --rover-node-id rover_node_ocid [OPTIONS]

    • Visualiser la progression du transfert pour une demande de mise à niveau : exécutez la commande oci rover node rover-bundle get-status et les paramètres requis pour visualiser la progression du transfert pour une demande de mise à niveau d'un appareil Roving Edge Infrastructure :

      oci rover node rover-bundle get-status --rover-node-id rover_node_ocid --work-request-id work_request_ocid [OPTIONS]
    Remarque

    Les commandes suivantes sont exécutées sur l'appareil Roving Edge. Veillez à utiliser un profil d'interface de ligne de commande configuré pour atteindre le périphérique (et non votre location OCI).

    • Téléchargez le groupe de systèmes vers le périphérique sur un bucket Object Storage nommé rover-system-upgrade-staging : exécutez la commande oci rover device system-upgrade upload-bundle et les paramètres requis. 

      oci rover device system-upgrade upload-bundle --endpoint device_object_storage_endpoint --file bundle_file_path

    • Importez le package de mise à niveau vers un bucket Object Storage sur le périphérique : exécutez la commande oci rover device system-upgrade import-bundle.

      oci rover device system-upgrade import-bundle --object-name object_name

      où object_name est le nom de l'objet de package de mise à niveau. Par exemple : 2.5.3.20230808163434.rover_disconnected_release.tar.

    • Afficher toutes les tâches d'import : exécutez la commande oci rover device system-upgrade get-import-history.

      oci rover device system-upgrade get-import-history --endpoint upgrade_endpoint

    • Afficher une tâche spécifique : exécutez la commande oci rover device system-upgrade get-import-status.

      oci rover device system-upgrade get-import-status --endpoint upgrade_endpoint --task-id task_ocid --wait true|false

    Une fois que le statut d'import indique COMPLETED, vous pouvez poursuivre la mise à niveau normale du logiciel système à l'aide de la console de périphériques.

  • Cette tâche ne peut pas être effectuée à l'aide de l'API.