NAME

cfgve - Configure the elements for a virtual environment.

SYNOPSIS

cfgve -t dc -m manager -o object [-c -k nfs|localfs | -r]

cfgve -t cl -m manager -o object [-c -p cpu type| -r -f]

cfgve -t sd -m manager -o object [-c | -g | -s | -a | -b | -r -f]

cfgve -t nw -m manager -o object [-c -d data center -n vlan ID | -a -l cluster | -b | -r]

cfgve -t tpl -m manager -o object [-r]

DESCRIPTION

The cfgve command can be used to configure a virtual environment for '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, cfgve command supports five types of object: dc, cl, sd, nw and tpl.

The mandatory parameter -o object is used to specify which object to configure.

OPTIONS

-a To attach the target object.
-b To detach the target object.
-c To create the target object.

For creating of Storage Domain, the target storage domain will be created first, then attached to data center and activated.

The parameters that used to create the storage domain are gotten from 'virtsd' table. The detail parameters in the virtsd table:

-d data center

The name of data center.

Specify the 'Data Center' that will be used for the object to be attached to. It is used by <nw> type.

-f It can be used with -r to remove the target object by force.

For removing of Storage Domain, if -f is specified, the storage domain will be deactivated and detached from data center before the removing.

-g To activate the target object.
-h Display usage message.
-k storage type

To specify the type of the storage type when creating the data center.

Supported type: nfs; localfs.

-l cluster

Specify the cluster for the network to attach to.

-m manager

Specify the manager of the virtual environment.

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

-n vlan ID

To specify the vlan number when creating a network.

-o object

The name of the target object.

-p cpu type

To specify the cpu type when creating the cluster. Intel Penryn Family is default type.

Supported type: Intel Conroe Family, Intel Penryn Family, Intel Nehalem Family, Intel Westmere Family, AMD Opteron G1, AMD Opteron G2, AMD Opteron G3

-r To remove the target object.

For removing of Storage Domain, the storage space will be formatted after removing.

-s To deactivate the target object.
-t type

Specify the type of the target object.

Supported types: dc - Data Center cl - Cluster sd - Storage Domain nw - Network tpl - Template

RETURN VALUE

0 The command completed successfully.

1 An error has occurred.

EXAMPLES

1. To create the Storage Domain 'sd1', enter:
 cfgve -t sd -m <FQDN of rhev manager> -o sd1 -c
2. To deactivate the Storage Domain 'sd1' from data center, enter:
 cfgve -t sd -m <FQDN of rhev manager> -o sd1 -s
3. To remove the Storage Domain 'sd1', enter:
 cfgve -t sd -m <FQDN of rhev manager> -o sd1 -r
4. To create the network 'nw1', enter:
 cfgve -t nw -m <FQDN of rhev manager> -o nw1 -c
5. To remove the template 'tpl01', enter:
 cfgve -t tpl -m <FQDN of rhev manager> -o tpl01 -r

FILES

/opt/xcat/bin/cfgve

SEE ALSO

lsve(1)