628c765718
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@13681 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
187 lines
4.3 KiB
Plaintext
187 lines
4.3 KiB
Plaintext
=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<-r>]
|
|
|
|
B<cfgve> B<-t> cl B<-m> manager B<-o> object [B<-c> | 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<-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> 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<-t>
|
|
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
|
|
|
|
=item B<-m>
|
|
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<-o>
|
|
The name of the target object.
|
|
|
|
=item B<-d>
|
|
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<-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<-g>
|
|
To activate the target object.
|
|
|
|
=item B<-s>
|
|
To deactivate the target object.
|
|
|
|
=item B<-a>
|
|
To attach the target object.
|
|
|
|
=item B<-b>
|
|
To detach the target object.
|
|
|
|
=item B<-r>
|
|
To remove the target object.
|
|
|
|
For removing of B<Storage Domain>, the storage space will be formatted after removing.
|
|
|
|
=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<-h>
|
|
Display usage message.
|
|
|
|
=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>
|