=head1 NAME

B<cfgve> - Configure the elements for a virtual environment.

=head1 SYNOPSIS

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

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

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

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

B<cfgve> B<-t> tpl B<-m> manager B<-o> object [B<-r>]


=head1 DESCRIPTION

The B<cfgve> command can be used to configure a virtual environment for 
'Storage Domain', 'Network' and 'Template' objects.

The mandatory parameter B<-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 B<-t type> is used to specify the type of the target 
object.

Basically, B<cfgve> command supports five types of object: B<dc>, B<cl>, 
B<sd>, B<nw> and B<tpl>. 

=over 3

B<dc> - The B<create> and B<remove> operations are supported.

B<cl> - The B<create> and B<remove> operations are supported.

B<sd>  - The B<create>, B<attach>, B<detach>, B<activate>, 
B<deactivate> and B<remove> operations are supported.

B<nw>  - The B<create>, B<attach>, B<detach> and B<remove> operations are supported.

B<tpl> - The B<remove> operation is supported.

=back

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


=head1 OPTIONS

=over 2

=item B<-a>
To attach the target object.

=item B<-b>
To detach the target object.

=item B<-c>
To create the target object.

For creating of B<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:

=over 3

B<virtsd.node> - The name of the storage domain.

B<virtsd.sdtype> - The type of storage domain. Valid value: data, iso, export. 
Default value is 'data'.

B<virtsd.stype> - The storage type. "nfs" or "localfs".

B<virtsd.location> - The location of the storage. 
B<nfs>: Format: [nfsserver:nfspath]. 
The NFS export directory must be configured for read write access and must 
be owned by vdsm:kvm.
B<localfs>: "/data/images/rhev" is set by default.

B<virtsd.host> - A host must be specified for a storage doamin as SPM 
(Storage Pool Manager) when initialize the storage domain. The role of SPM 
may be migrated to other host by rhev-m during the running of the datacenter 
(For example, when the current SPM encountered issue or going to maintenance 
status.

B<virtsd.datacenter> - The storage will be attached to. 'Default' data center 
is the default value. 

=back

=item B<-d> I<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.

=item B<-f>
It can be used with B<-r> to remove the target object by force.

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

=item B<-g>
To activate the target object.

=item B<-h>
Display usage message.

=item B<-k> I<storage type>

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

Supported type: nfs; localfs.

=item B<-l> I<cluster>

Specify the cluster for the network to attach to.

=item B<-m> I<manager> 

Specify the manager of the virtual environment. 

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

=item B<-n> I<vlan ID>

To specify the vlan number when creating a network.

=item B<-o> I<object>

The name of the target object.

=item B<-p> I<cpu type>

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

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

=item B<-r>
To remove the target object.

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

=item B<-s>
To deactivate the target object.

=item B<-t> I<type>

Specify the B<type> of the target object.

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

=back

=head1 RETURN VALUE

0  The command completed successfully.

1  An error has occurred.

=head1 EXAMPLES

=over 2

=item 1.
To create the Storage Domain 'sd1', enter:

 cfgve -t sd -m <FQDN of rhev manager> -o sd1 -c

=item 2.
To deactivate the Storage Domain 'sd1' from data center, enter:

 cfgve -t sd -m <FQDN of rhev manager> -o sd1 -s

=item 3.
To remove the Storage Domain 'sd1', enter:

 cfgve -t sd -m <FQDN of rhev manager> -o sd1 -r

=item 4.
To create the network 'nw1', enter:

 cfgve -t nw -m <FQDN of rhev manager> -o nw1 -c

=item 5.
To remove the template 'tpl01', enter:

 cfgve -t tpl -m <FQDN of rhev manager> -o tpl01 -r

=back

=head1 FILES

/opt/xcat/bin/cfgve

=head1 SEE ALSO

L<lsve(1)|lsve.1>
