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:

 B<dc>  - Data Center (For type of 'dc', all the elements belongs to the data center will be listed.)
 B<cl>  - Cluster
 B<sd>  - Storage Domain (To get the status of Storage Doamin, show it from I<data center> it attached to.
 B<nw>  - Network
 B<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 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 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 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 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)