Guide d'administration d'Oracle® VM Server for SPARC 3.3

Quitter la vue de l'impression

Mis à jour : Octobre 2015
 
 

Ressources et propriétés de Logical Domains Manager

Cette section fournit des exemples des ressources Logical Domains Manager et des propriétés qui peuvent être définies pour chacune de ces ressources. Les ressources et les propriétés sont présentées en gras dans les exemples XML. Ces exemples présentent des ressources, non une sortie de liaison. La sortie de contrainte peut être utilisée pour créer une entrée pour les actions de Logical Domains Manager, à l'exception de la sortie de migration de domaine. Reportez-vous à la section Migration de domaine. Chaque ressource est définie dans une section OVF <Section> et est définie par une balise <rasd:OtherResourceType>.

Ressource d'informations sur le domaine (ldom_info)

L'exemple suivant illustre les propriétés facultatives de la ressource ldom_info :

Exemple 23-6  Exemple de sortie XML ldom_info

L'exemple suivant montre les valeurs spécifiées pour les différentes propriétés ldom_info telles que uuid, hostid et Address.

<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="primary">
    <Section xsi:type="ovf:ResourceAllocationSection_type">
      <Item>
        <rasd:OtherResourceType>ldom_info</rasd:OtherResourceType>
        <uuid>c2c3d93b-a3f9-60f6-a45e-f35d55c05fb6</uuid>
        <rasd:Address>00:03:ba:d8:ba:f6</rasd:Address>
        <gprop:GenericProperty key="hostid">83d8baf6</gprop:GenericProperty>
        <gprop:GenericProperty key="master">plum</gprop:GenericProperty>
        <gprop:GenericProperty key="failure-policy">reset</gprop:GenericProperty>
        <gprop:GenericProperty key="extended-mapin-space">on</gprop:GenericProperty>
        <gprop:GenericProperty key="progress">45%</gprop:GenericProperty>
        <gprop:GenericProperty key="status">ongoing</gprop:GenericProperty>
        <gprop:GenericProperty key="source">system1</gprop:GenericProperty>
        <gprop:GenericProperty key="rc-add-policy"></gprop:GenericProperty>
        <gprop:GenericProperty key="perf-counters">global</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

    La ressource ldom_info est toujours contenue dans une section <Content>. Les propriétés suivantes de la ressource ldom_info sont des propriétés facultatives :

  • Balise <uuid>, qui spécifie l'UUID du domaine.

  • Balise <rasd:Address>, qui définit l'adresse MAC à assigner au domaine.

  • Balise <gprop:GenericProperty key="extended-mapin-space">, qui définit si la fonctionnalité Extended Mapin Space est activée (on) ou désactivée (off) pour le domaine. La valeur par défaut est off.

  • Balise <gprop:GenericProperty key="failure-policy">, qui définit comment les domaines esclaves doivent se comporter si le domaine maître est en panne. La valeur par défaut est ignore. Les valeurs valides de la propriété sont indiquées ci-après :

    • ignore ignore les erreurs du domaine maître (les domaines esclaves ne sont pas affectés).

    • panic panique tous les domaines esclaves lorsque le domaine maître est en panne.

    • reset réinitialise tous les domaines esclaves lorsque le domaine maître est en panne.

    • stop arrête tous les domaines esclaves lorsque le domaine maître est en panne.

  • Balise <gprop:GenericProperty key="hostid">, qui définit l'ID hôte à assigner au domaine.

  • Balise <gprop:GenericProperty key="master">, qui définit jusqu'à quatre noms de domaines maîtres séparés par des virgules.

  • Balise <gprop:GenericProperty key="progress">, qui définit le pourcentage de progression effectué par la commande.

  • Balise <gprop:GenericProperty key="source">, qui définit le compte-rendu de la machine sur la progression de la commande.

  • Balise <gprop:GenericProperty key="status">, qui définit l'état de la commande (done, failed ou ongoing).

  • Balise <gprop:GenericProperty key="rc-add-policy">, qui indique s'il est nécessaire d'activer ou de désactiver les opérations de virtualisation d'E/S directes et d'E/S SR-IOV sur les complexes root susceptibles d'être ajoutés au domaine indiqué. Les valeurs valides sont iov et aucune valeur (rc-add-policy=).

  • Balise <gprop:GenericProperty key="perf-counters">, qui définit les ensembles de registres de performances auxquels accéder (global, htstrand, strand).

    Si la plate-forme ne permet pas l'accès aux performances, la valeur de la propriété perf-counters est ignorée.

Ressource de CPU (cpu)

Notez que la propriété des unités d'allocation, <rasd:AllocationUnits>, pour la ressource cpu, spécifie toujours le nombre de CPU virtuelles et non le nombre de serveurs de base.

Une ressource cpu est toujours contenue dans une section <Content>.

Exemple 23-7  Sortie de la section XML cpu à partir de la commande ldm list-bindings

L'exemple suivant illustre la sortie XML pour la section <cpu> à l'aide de la commande ldm list-bindings.

<?xml version="1.0"?>
<LDM_interface 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ovf="./schemas/envelope"
xmlns:rasd="./schemas/CIM_ResourceAllocationSettingData"
xmlns:vssd="./schemas/CIM_VirtualSystemSettingData"
xmlns:gprop="./schemas/GenericProperty"
xmlns:bind="./schemas/Binding"
version="1.3"
xsi:noNamespaceSchemaLocation="./schemas/combined-v3.xsd">
  <cmd>
    <action>list-bindings</action>
    <data version="3.0">
      <Envelope>
        <References/>
        <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="primary">
          <Section xsi:type="ovf:ResourceAllocationSection_Type">
            <Item>
              <rasd:OtherResourceType>ldom_info</rasd:OtherResourceType>
              <uuid>1e04cdbd-472a-e8b9-ba4c-d3eee86e7725</uuid>
              <rasd:Address>00:21:28:f5:11:6a</rasd:Address>
              <gprop:GenericProperty key="hostid">0x8486632a</gprop:GenericProperty>
              <failure-policy>fff</failure-policy>
              <wcore>0</wcore>
              <extended-mapin-space>0</extended-mapin-space>
              <cpu-arch>native</cpu-arch>
              <rc-add-policy/>
              <gprop:GenericProperty key="state">active</gprop:GenericProperty>
            </Item>
          </Section>
          <Section xsi:type="ovf:VirtualHardwareSection_Type">
            <Item>
              <rasd:OtherResourceType>cpu</rasd:OtherResourceType>
              <rasd:AllocationUnits>8</rasd:AllocationUnits>
              <bind:Binding>
                <Item>
                  <rasd:OtherResourceType>cpu</rasd:OtherResourceType>
                  <gprop:GenericProperty key="vid">0</gprop:GenericProperty>
                  <gprop:GenericProperty key="pid">0</gprop:GenericProperty>
                  <gprop:GenericProperty key="cid">0</gprop:GenericProperty>
                  <gprop:GenericProperty key="strand_percent">100</gprop:GenericProperty>
                  <gprop:GenericProperty key="util_percent">1.1%</gprop:GenericProperty>
                  <gprop:GenericProperty key="normalized_utilization">0.1%</gprop:GenericProperty>
                </Item>
          </Section>
        </Content>
      </Envelope>
    </data>
  </cmd>
</LDM_interface>
Exemple 23-8  Sortie de la section XML cpu à partir de la commande ldm list-domain

L'exemple suivant illustre la sortie XML pour la section <cpu> à l'aide de la commande ldm list-domain.

<?xml version="1.0"?>
<LDM_interface
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ovf="./schemas/envelope"
xmlns:rasd="./schemas/CIM_ResourceAllocationSettingData"
xmlns:vssd="./schemas/CIM_VirtualSystemSettingData"
xmlns:gprop="./schemas/GenericProperty"
xmlns:bind="./schemas/Binding"
version="1.3"
xsi:noNamespaceSchemaLocation="./schemas/combined-v3.xsd">
  <cmd>
    <action>list-domain</action>
    <data version="3.0">
      <Envelope>
        <References/>
        <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="primary">
          <Section xsi:type="ovf:ResourceAllocationSection_Type">
            <Item>
              <rasd:OtherResourceType>ldom_info</rasd:OtherResourceType>
              <gprop:GenericProperty key="state">active</gprop:GenericProperty>
              <gprop:GenericProperty key="flags">-n-cv-</gprop:GenericProperty>
              <gprop:GenericProperty key="utilization">0.7%</gprop:GenericProperty>
              <gprop:GenericProperty key="uptime">3h</gprop:GenericProperty>
              <gprop:GenericProperty key="normalized_utilization">0.1%</gprop:GenericProperty>
            </Item>
          </Section>
        </Content>
      </Envelope>
    </data>
  </cmd>
</LDM_interface>

Ressource MAU (mau)

Une ressource mau est toujours contenue dans une section <Content>. La seule propriété est la balise <rasd:AllocationUnits>, qui signifie le nombre de MAU ou d'autres unités cryptographiques.


Remarque - La ressource mau est une unité cryptographique prise en charge sur un serveur pris en charge. Actuellement, les deux unités cryptographiques prises en charge sont l'unité arithmétique modulaire (MAU) et la file d'attente de mot de contrôle (CWQ).
Exemple 23-9  Exemple de XML mau
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>mau</rasd:OtherResourceType>
        <rasd:AllocationUnits>1</rasd:AllocationUnits>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de mémoire (memory)

Une ressource memory est toujours contenue dans une section <Content>. La seule propriété est la balise <rasd:AllocationUnits>, qui signifie la quantité de mémoire.

Exemple 23-10  Exemple de XML memory
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>memory</rasd:OtherResourceType>
        <rasd:AllocationUnits>4G</rasd:AllocationUnits>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de serveur de disque virtuel (vds)

Une ressource de serveur de disque virtuel (vds) peut se trouver dans une section <Content> comme faisant partie de la description du domaine, ou elle peut apparaître seule dans une section <Envelope>. La seule propriété est la balise <gprop:GenericProperty> avec une clé de service_name, qui contient le nom de la ressource vds décrite.

Exemple 23-11  Exemple de XML vds
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>vds</rasd:OtherResourceType>
        <gprop:GenericProperty
          key="service_name">vdstmp</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource du volume de disque virtuel (vds_volume)

    Une ressource vds_volume peut se trouver dans une section <Content> comme faisant partie de la description du domaine, ou elle peut apparaître seule dans une section <Envelope>. Elle doit comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • vol_name – Nom du volume

  • service_name – Nom du serveur de disque virtuel auquel ce volume doit être lié

  • block_dev – Nom du fichier ou du périphérique à associer à ce volume

    Une ressource vds_volume peut également avoir les propriétés suivantes :

  • vol_opts – Une ou plusieurs des chaînes suivantes séparées par des virgules : {ro,slice,excl}

  • mpgroup – Nom du groupe multivoie (basculement)

Exemple 23-12  Exemple de XML vds_volume
<Envelope>
  <References/>
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>vds_volume</rasd:OtherResourceType>
        <gprop:GenericProperty key="vol_name">vdsdev0</gprop:GenericProperty>
        <gprop:GenericProperty key="service_name">primary-vds0</gprop:GenericProperty>
        <gprop:GenericProperty key="block_dev">
          opt/SUNWldm/domain_disks/testdisk1</gprop:GenericProperty>
        <gprop:GenericProperty key="vol_opts">ro</gprop:GenericProperty>
        <gprop:GenericProperty key="mpgroup">mpgroup-name</gprop:GenericProperty>
      </Item>
    </Section>
</Envelope>

Ressource de disque (disk)

    Une ressource disk est toujours contenue dans une section <Content>. Elle doit comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • vdisk_name – Nom du disque virtuel

  • service_name – Nom du serveur de disque virtuel auquel ce disque virtuel doit être lié

  • vol_name – Périphérique du service de disque virtuel avec lequel le disque virtuel doit être lié

La ressource disk peut également avoir la propriété timeout, qui est la valeur de temporisation en secondes pour l'établissement d'une connexion entre un client de disque virtuel (vdc) et un serveur de disque virtuel (vds). S'il existe plusieurs chemins de disque virtuel (vdisk), le vdc peut tenter de se connecter à un vds différent. Le délai d'attente garantit qu'une connexion à un vds est établie dans le délai imparti.

Exemple 23-13  Exemple de XML disk
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>disk</rasd:OtherResourceType>
        <gprop:GenericProperty key="vdisk_name">vdisk0</gprop:GenericProperty>
        <gprop:GenericProperty
          key="service_name">primary-vds0</gprop:GenericProperty>
        <gprop:GenericProperty key="vol_name">vdsdev0</gprop:GenericProperty>
        <gprop:GenericProperty key="timeout">60</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de commutateur virtuel (vsw)

Une ressource vsw peut se trouver dans une section <Content> et faire partie d'une description de domaine, ou elle peut apparaître seule dans une section <Envelope>. Elle doit contenir une balise <gprop:GenericProperty> avec la clé service_name, qui est le nom à assigner au commutateur virtuel.

    La ressource vsw peut également avoir les propriétés suivantes :

  • <rasd:Address> – Assigne une adresse MAC au commutateur virtuel

  • default-vlan-id – Spécifie le réseau local virtuel (VLAN) par défaut dont un périphérique réseau virtuel ou un commutateur virtuel doit être membre, en mode balisé. Le premier ID de VLAN (vid1) est réservé à default-vlan-id.

  • dev_path – Chemin du périphérique physique à associer à ce commutateur virtuel

  • id – Spécifie l'ID du nouveau périphérique de commutateur virtuel. Par défaut, les valeurs d'ID sont générées automatiquement. Par conséquent, définissez cette propriété si vous devez faire correspondre un nom de périphérique existant dans le SE.

  • inter_vnet_link – Indique s'il faut assigner les canaux LDC pour la communication inter-vnet. La valeur par défaut est on.

  • linkprop – Indique si le périphérique virtuel doit obtenir les mises à jour d'état du lien physique. Lorsque la valeur est phys-state, le périphérique virtuel obtient les mises à jour de l'état du lien physique. Lorsque la valeur est vide, le périphérique virtuel n'est pas régulièrement notifié de l'état du lien physique (il s'agit de la valeur par défaut).

  • modesc pour la prise en charge de la pulsation du cluster Oracle Solaris.

  • pvid – L'identificateur (ID) du réseau local virtuel (VLAN) du port indique le VLAN dont le réseau virtuel doit être membre, en mode non balisé.

  • mtu – Spécifie l'unité de transmission maximale (MTU) d'un commutateur virtuel, les périphériques réseau virtuel liés au commutateur virtuel, ou les deux. Les valeurs valides sont dans la plage de 1500-16000. La commande ldm renvoie une erreur si une valeur non valide est spécifiée.

  • vid – L'identificateur (ID) du réseau local virtuel (VLAN) indique le VLAN dont le réseau virtuel et le commutateur virtuel doivent être membres, en mode balisé.

Exemple 23-14  Exemple de XML vsw
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg2">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>vsw</rasd:OtherResourceType>
        <rasd:Address>00:14:4f:fb:ec:00</rasd:Address>
        <gprop:GenericProperty key="service_name">test-vsw1</gprop:GenericProperty>
        <gprop:GenericProperty key="inter_vnet_link">on</gprop:GenericProperty>
        <gprop:GenericProperty key="default-vlan-id">1</gprop:GenericProperty>
        <gprop:GenericProperty key="pvid">1</gprop:GenericProperty>
        <gprop:GenericProperty key="mtu">1500</gprop:GenericProperty>
        <gprop:GenericProperty key="dev_path">switch@0</gprop:GenericProperty>
        <gprop:GenericProperty key="id">0</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de réseau (network)

    Une ressource network est toujours contenue dans une section <Content>. Elle doit comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • linkprop – Indique si le périphérique virtuel doit obtenir les mises à jour d'état du lien physique. Lorsque la valeur est phys-state, le périphérique virtuel obtient les mises à jour de l'état du lien physique. Lorsque la valeur est vide, le périphérique virtuel n'est pas régulièrement notifié de l'état du lien physique (il s'agit de la valeur par défaut).

  • vnet_name – Nom du réseau virtuel (vnet)

  • service_name – Nom du commutateur virtuel (vswitch) auquel ce réseau virtuel doit être lié

    La ressource network peut également avoir les propriétés suivantes :

  • <rasd:Address> – Assigne une adresse MAC au commutateur virtuel

  • pvid – L'identificateur (ID) du réseau local virtuel (VLAN) du port indique le VLAN dont le réseau virtuel doit être membre, en mode non balisé.

  • vid – L'identificateur (ID) du réseau local virtuel (VLAN) indique le VLAN dont le réseau virtuel et le commutateur virtuel doivent être membres, en mode balisé.

  • modehybrid pour activer l'E/S hybride pour ce réseau virtuel.


    Remarque - La fonction d'E/S hybride NIU a été abandonnée au profit de SR-IOV. Oracle VM Server for SPARC 3.3 est la dernière version logicielle à inclure cette fonction.
Exemple 23-15  Exemple de XML network
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>network</rasd:OtherResourceType>
        <gprop:GenericProperty key="linkprop">phys-state</gprop:GenericProperty>
        <gprop:GenericProperty key="vnet_name">ldg1-vnet0</gprop:GenericProperty>
        <gprop:GenericProperty
          key="service_name">primary-vsw0</gprop:GenericProperty>
        <rasd:Address>00:14:4f:fc:00:01</rasd:Address>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de concentrateur de console virtuelle (vcc)

    Une ressource vcc peut se trouver dans une section <Content> comme faisant partie de la description du domaine, ou elle peut apparaître seule dans une section <Envelope>. Elle peut comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • service_name – Nom à assigner au service de concentrateur de console virtuelle

  • min_port – Numéro de port minimum à associer à ce vcc

  • min_port – Numéro de port maximal à associer à ce vcc

Exemple 23-16  Exemple de XML vcc
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>vcc</rasd:OtherResourceType>
        <gprop:GenericProperty key="service_name">vcc1</gprop:GenericProperty>
        <gprop:GenericProperty key="min_port">6000</gprop:GenericProperty>
        <gprop:GenericProperty key="max_port">6100</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de variable (var)

    Une ressource var est toujours contenue dans une section <Content>. Elle peut comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • name – Nom de la variable

  • value – Valeur de la variable

Exemple 23-17  Exemple de XML var
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>var</rasd:OtherResourceType>
        <gprop:GenericProperty key="name">test_var</gprop:GenericProperty>
        <gprop:GenericProperty key="value">test1</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de périphérique d'E/S physique (physio_device)

Une ressource physio_device est toujours contenue dans une section <Content>. Cette ressource peut être modifié à l'aide de add-io, set-io, remove-io, create-vf, destroy-vf et des sous-commandes set-domain.

Exemple 23-18  Exemple de XML physio_device

    Les exemples suivants indiquent comment effectuer des actions sur les fonctions physiques et virtuelles ainsi que sur les complexes root.

  • Le fragment d'exemple de XML suivant illustre l'utilisation de la commande ldm add-io pour ajouter la fonction virtuelle /SYS/MB/NET0/IOVNET.PF0.VF0 au domaine ldg1.

    <LDM_interface version="1.3">
      <cmd>
        <action>add-io</action>
        <data version="3.0">
          <Envelope>
            <References/>
            <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="ldg1">
              <Section xsi:type="ovf:VirtualHardwareSection_Type">
                <Item>
                  <rasd:OtherResourceType>physio_device</rasd:OtherResourceType>
                  <gprop:GenericProperty key="name">
                  /SYS/MB/NET0/IOVNET.PF0.VF0</gprop:GenericProperty>
                </Item>
              </Section>
            </Content>
          </Envelope>
        </data>
      </cmd>
    </LDM_interface>
  • Le fragment d'exemple de XML suivant illustre l'utilisation de la commande ldm set-io pour définir la valeur de propriété iov_bus_enable_iov sur on pour le complexe root pci_1.

    <LDM_interface version="1.3">
      <cmd>
        <action>set-io</action>
        <data version="3.0">
          <Envelope>
            <References/>
              <Section xsi:type="ovf:VirtualHardwareSection_Type">
                <Item>
                  <rasd:OtherResourceType>physio_device</rasd:OtherResourceType>
                  <gprop:GenericProperty key="name">pci_1</gprop:GenericProperty>
                  <gprop:GenericProperty key="iov_bus_enable_iov">
                  on</gprop:GenericProperty>
                </Item>
            </Section>
          </Envelope>
        </data>
      </cmd>
    </LDM_interface>
  • Le fragment d'exemple de XML suivant illustre l'utilisation de la commande ldm set-io pour définir la valeur de propriété unicast-slots sur 6 pour la fonction physique /SYS/MB/NET0/IOVNET.PF1.

    <LDM_interface version="1.3">
      <cmd>
        <action>set-io</action>
        <data version="3.0">
          <Envelope>
            <References/>
              <Section xsi:type="ovf:VirtualHardwareSection_Type">
                <Item>
                  <rasd:OtherResourceType>physio_device</rasd:OtherResourceType>
                  <gprop:GenericProperty key="name">
                  /SYS/MB/NET0/IOVNET.PF1</gprop:GenericProperty>
                  <gprop:GenericProperty key="unicast-slots">6</gprop:GenericProperty>
                </Item>
              </Section>
          </Envelope>
        </data>
      </cmd>
    </LDM_interface>
  • Le fragment d'exemple de XML suivant illustre l'utilisation de la commande ldm create-vf pour créer la fonction virtuelle /SYS/MB/NET0/IOVNET.PF1.VF0 avec les valeurs de propriété suivantes.

    • unicast-slots=6

    • pvid=3

    • mtu=1600

    <LDM_interface version="1.3">
      <cmd>
        <action>create-vf</action>
        <data version="3.0">
          <Envelope>
            <References/>
              <Section xsi:type="ovf:VirtualHardwareSection_Type">
                <Item>
                  <rasd:OtherResourceType>vf_device</rasd:OtherResourceType>
                  <gprop:GenericProperty key="iov_pf_name">
                  /SYS/MB/NET0/IOVNET.PF1</gprop:GenericProperty>
                  <gprop:GenericProperty key="unicast-slots">6</gprop:GenericProperty>
                  <gprop:GenericProperty key="pvid">3</gprop:GenericProperty>
                  <gprop:GenericProperty key="mtu">1600</gprop:GenericProperty>
                </Item>
              </Section>
          </Envelope>
        </data>
      </cmd>
    </LDM_interface>
  • Le fragment XML suivant illustre l'utilisation de la commande ldm create-vf permettant de créer le nombre de fonctions virtuelles indiquées par la valeur iov_pf_repeat_count_str (3) avec la fonction physique /SYS/MB/NET0/IOVNET.PF1. Vous ne pouvez pas indiquer d'autres valeurs de propriété lorsque vous créez plusieurs fonctions virtuelles avec la propriété iov_pf_repeat_count_str.

    <LDM_interface version="1.3">
      <cmd>
        <action>create-vf</action>
        <data version="3.0">
          <Envelope>
            <References/>
              <Section xsi:type="ovf:VirtualHardwareSection_Type">
                <Item>
                  <rasd:OtherResourceType>vf_device</rasd:OtherResourceType>
                  <gprop:GenericProperty key="iov_pf_name">
                  /SYS/MB/NET0/IOVNET.PF1</gprop:GenericProperty>
                  <gprop:GenericProperty key="iov_pf_repeat_count_str">
                  3</gprop:GenericProperty>
                </Item>
              </Section>
          </Envelope>
        </data>
      </cmd>
    </LDM_interface>

Ressource de configuration du SP (spconfig)

    Une configuration de processeur de service (SP) (spconfig) apparaît toujours seule dans une section <Envelope>. Elle peut comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • spconfig_name – Nom d'une configuration à stocker sur le SP

  • spconfig_status – Etat actuel d'une configuration de SP spécifique. Cette propriété est utilisée dans la sortie d'une commande ldm list-spconfig.

Exemple 23-19  Exemple de XML spconfig
<Envelope>
    <Section xsi:type="ovf:ResourceAllocationSection_type">
      <Item>
        <rasd:OtherResourceType>spconfig</rasd:OtherResourceType>
        <gprop:GenericProperty
          key="spconfig_name">primary</gprop:GenericProperty>
        <gprop:GenericProperty
          key="spconfig_status">current</gprop:GenericProperty>
      </Item>
    </Section>
</Envelope>

Ressource de configuration de la stratégie DRM (policy)

    Une ressource de stratégie DRM (policy) apparaît à la section <Envelope> et peut posséder des balises <gprop:GenericProperty> avec les clés suivantes :

  • policy_name : nom de la stratégie DRM

  • policy_enable : spécifie si la stratégie DRM est activée ou désactivée

  • policy_priority : priorité de la stratégie DRM

  • policy_vcpu_min : nombre minimal de ressources de CPU virtuelle pour un domaine

  • policy_vcpu_max : nombre maximal de ressources de CPU virtuelle pour un domaine

  • policy_util_lower : niveau d'utilisation inférieur auquel une analyse de stratégie est lancée

  • policy_util_upper : niveau d'utilisation supérieur auquel une analyse de stratégie est lancé

  • policy_tod_begin : heure de début effective de la stratégie DRM

  • policy_tod_end Heure de fin effective de la stratégie DRM

  • policy_sample_rate : fréquence d'échantillonnage, qui correspond au temps du cycle en secondes

  • policy_elastic_margin : quantité de tampon entre les limites d'utilisation inférieure et supérieure de la CPU

  • policy_attack : quantité maximale d'une ressource à ajouter au cours d'un cycle de contrôle de ressource

  • policy_decay : quantité maximale d'une ressource à supprimer au cours d'un cycle de contrôle de ressource

Exemple 23-20  Exemple de XML policy
<Envelope>
   <Section xsi:type="ovf:VirtualHardwareSection_Type">
     <Item>
       <rasd:OtherResourceType>policy</rasd:OtherResourceType>
       <gprop:GenericProperty key="policy_name">test-policy</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_enable">on</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_priority">1</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_vcpu_min">12</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_vcpu_max">13</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_util_lower">8</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_util_upper">9</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_tod_begin">07:08:09</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_tod_end">09:08:07</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_sample_rate">1</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_elastic_margin">8</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_attack">8</gprop:GenericProperty>
       <gprop:GenericProperty key="policy_decay">9</gprop:GenericProperty>
     </Item>
   </Section>
</Envelope>

Ressource de service de canal de plan de données virtuelles (vdpcs)

Cette ressource ne présente un intérêt que dans un environnement DPS Netra. Une ressource vdpcs peut se trouver dans une section <Content> comme faisant partie de la description du domaine, ou elle peut apparaître seule dans une section <Envelope>. La seule propriété est la balise <gprop:GenericProperty> avec la valeur de propriété de cléservice_name, qui est le nom de la ressource du service de plan de données virtuelles (vdpcs) étant décrite.

Exemple 23-21  Exemple de XML vdpcs
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>vdpcs</rasd:OtherResourceType>
        <gprop:GenericProperty key="service_name">dg1-vdpcs</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de client de canal de plan de données virtuelles (vdpcc)

    Cette ressource ne présente un intérêt que dans un environnement DPS Netra. Un ressource de client de canal de plan de données virtuelles est toujours contenue dans une section <Content>. Elle peut comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • vdpcc_name – Nom du client du canal de plan de données virtuelles (vdpcc)

  • service_name – Nom du service du canal de plan de données virtuelles vdpcs auquel vdpcc doit être lié

Exemple 23-22  Exemple de XML vdpcc
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>vdpcc</rasd:OtherResourceType>
        <gprop:GenericProperty key="vdpcc_name">vdpcc</gprop:GenericProperty>
        <gprop:GenericProperty
          key="service_name">ldg1-vdpcs</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Ressource de console (console)

    Une ressource console est toujours contenue dans une section <Content>. Elle peut comporter des balises <gprop:GenericProperty> avec les clés suivantes :

  • port – Port sur lequel passer sur cette console virtuelle (console)

  • service_name – Service de concentrateur de console virtuelle (vcc) auquel associer cette console

  • group – Nom du groupe auquel associer cette console

  • enable-log – Activation ou désactivation de la journalisation de console virtuelle pour cette console

Exemple 23-23  Exemple de XML console
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" id="ldg1">
    <Section xsi:type="ovf:VirtualHardwareSection_Type">
      <Item>
        <rasd:OtherResourceType>console</rasd:OtherResourceType>
        <gprop:GenericProperty key="port">6000</gprop:GenericProperty>
        <gprop:GenericProperty key="service_name">vcc2</gprop:GenericProperty>
        <gprop:GenericProperty key="group">group-name</gprop:GenericProperty>
        <gprop:GenericProperty key="enable-log">on</gprop:GenericProperty>
      </Item>
    </Section>
  </Content>
</Envelope>

Migration de domaine

    Cet exemple montre ce qui est contenu dans la section <data> pour une commande ldm migrate-domain.

  • Le premier noeud <Content> (sans section <ldom_info>) est le domaine source à migrer.

  • Le second noeud <Content> (avec une section <ldom_info>) est le domaine cible vers lequel migrer. Les noms des domaines source et cible peuvent être identiques.

  • La section <ldom_info> du domaine cible décrit la machine que laquelle migrer et les détails nécessaires à la migration sur cette machine :

    • target-host est la machine cible vers laquelle migrer.

    • user-name est le nom d'utilisateur pour la connexion à la machine cible, qui doit être codé en SASL 64 bits.

    • password est le mot de passe à utiliser pour la connexion à la machine cible, qui doit être codé en SASL 64 bits.


Remarque - Logical Domains Manager utilise sasl_decode64() pour décoder le nom et le mot de passe de l'utilisateur cible et utilise sasl_encode64() pour coder ces valeurs. Le codage SASL 64 est équivalent au codage base64.
Exemple 23-24  Exemple de section migrate-domain <data>
<Envelope>
  <References/>
  <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="ldg1"/>
  <Content xsi:type="ovf:VirtualSystem_Type" ovf:id="ldg1"/>
    <Section xsi:type="ovf:ResourceAllocationSection_Type">
      <Item>
        <rasd:OtherResourceType>ldom_info</rasd:OtherResourceType>
        <gprop:GenericProperty key="target">target-host</gprop:GenericProperty>
        <gprop:GenericProperty key="username">user-name</gprop:GenericProperty>
        <gprop:GenericProperty key="password">password</gprop:GenericProperty>
      <Item>
    </Section>
  </Content>
</Envelope>