Modifying a virtual server definition

Edit the libvirt-internal configuration of a defined virtual server.

About this task

Editing the libvirt-internal configuration modifies the virtual server definition persistently across host reboots. The modification is effective with the next virtual server restart.

Procedure

Modify the libvirt-internal configuration of a virtual server by using the virsh edit command (see edit):

# virsh edit <VS>

<VS>: Is the name of the virtual server as specified in its domain configuration-XML file.

By default, the virsh edit command uses the vi editor. You can modify the editor by setting the environment variables $VISUAL or $EDITOR.

Results

If your configuration does not contain necessary elements, they will be inserted automatically when you quit the editor. Also, the virsh edit command does not allow to save and quit corrupted files.

The libvirt-internal configuration is modified and will be effective with the next virtual server restart.

What to do next

To make the modification of the configuration effective, you might want to terminate the virtual server and restart it afterwards (see Terminating a virtual server and Starting a virtual server).