lsve.1

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, nwand 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
  1. 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
  1. 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
  1. 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
  1. 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)|cfgve.1