NAME

lsve - Lists detail attributes for a virtual environment.


SYNOPSIS

lsve [-t type] [-m manager] [-o object]


DESCRIPTION

The lsve command can be used to list a virtual environment for 'Data Center', 'Cluster', 'Storage Domain', 'Network' and 'Template' objects.

The mandatory parameter -m manager is used to specify the address of the manager of virtual environment. xCAT needs it to access the RHEV manager.

The mandatory parameter -t type is used to specify the type of the target object.

Basically, lsve command supports three types of object: dc, cl, sd, nw and tpl.

The parameter -o object is used to specify which object to list. If no -o is specified, all the objects with the -t type will be displayed.


OPTIONS

-h Display usage message.
-m Specify the manager of the virtual environment.

For RHEV, the FQDN (Fully Qualified Domain Name) of the rhev manager have to be specified.

-o The target object to display.
-t Specify the type of the target object.

Supported types: dc - Data Center (For type of 'dc', all the elements belongs to the data center will be listed.) cl - Cluster sd - Storage Domain (To get the status of Storage Doamin, show it from data center it attached to. nw - Network tpl - Template


RETURN VALUE

0 The command completed successfully.

1 An error has occurred.


EXAMPLES

  1. To list the data center 'Default', enter:
     lsve -t B<dc> -m <FQDN of rhev manager> -o Default

    Output is similar to:

      datacenters: [Default]
      description: The default Data Center
      state: up
      storageformat: v1
      storagetype: nfs
        clusters: [Default]
          cpu: Intel Westmere Family
          description: The default server cluster
          memory_hugepage: true
          memory_overcommit: 100
        storagedomains: [image]
          available: 55834574848
          committed: 13958643712
          ismaster: true
          status: active
          storage_add: <Address of storage domain>
          storage_format: v1
          storage_path: /vfsimg
          storage_type: nfs
          type: data
          used: 9663676416
        networks: [rhevm2]
          description:
          state: operational
          stp: false
        networks: [rhevm]
          description: Management Network
          state: operational
          stp: false
        templates: [Blank]
          bootorder: hd
          cpucore: 1
          cpusocket: 1
          creation_time: 2008-04-01T00:00:00.000-04:00
          display: spice
          memory: 536870912
          state: ok
          stateless: false
          type: desktop
  2. To list the cluster 'Default', enter:
     lsve -t B<cl> -m <FQDN of rhev manager> -o Default

    Output is similar to:

      cpu: Intel Westmere Family
      description: The default server cluster
      memory_hugepage: true
      memory_overcommit: 10
  3. To list the Storage Domain 'image', enter:
     lsve -t B<sd> -m <FQDN of rhev manager> -o image

    Output is similar to: storagedomains: [image] available: 55834574848 committed: 13958643712 ismaster: true status: storage_add: <Address of storage domain> storage_format: v1 storage_path: /vfsimg storage_type: nfs type: data used: 9663676416

  4. To list the network 'rhevm', enter:
     lsve -t B<nw> -m <FQDN of rhev manager> -o rhevm

    Output is similar to:

      networks: [rhevm]
        description: Management Network
        state: operational
        stp: false
  5. To list the template 'tpl01', enter:
     lsve -t tpl -m <FQDN of rhev manager> -o tpl01

    Output is similar to:

      templates: [tpl01]
        bootorder: network
        cpucore: 2
        cpusocket: 2
        creation_time: 2012-08-22T23:52:35.953-04:00
        display: vnc
        memory: 1999634432
        state: ok
        stateless: false
        type: server


FILES

/opt/xcat/bin/lsve


SEE ALSO

cfgve(1)