Skip Headers
Oracle® VM Server User's Guide
Release 2.1

Part Number E10898-04
Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Index
Go to Feedback page
Contact Us

Go to previous page
Go to next page
View PDF

7 Managing Oracle VM Server Repositories

Oracle VM uses the concept of repositories to define where Oracle VM resources may reside. Resources include guest virtual machines, virtual machines templates (guest seed images), ISO images, shared virtual disks, and so on.

A repository is used for live migration of guests and for local storage.

This Chapter contains information on managing Oracle VM Server repositories. It contains:

7.1 Repository Directory Structure

The /OVS directory is the location of the default repository created when you install Oracle VM Server. When you register a Utility Server in a server pool using Oracle VM Manager, a number of standard resource-related sub-directories are created under the /OVS repository directory:

Table 7-1 /OVS Directory Contents

Directory Name Description


Contains ISO files imported using Oracle VM Manager.


Contains guest virtual machines deployed as public.


Contains guest virtual machine templates.


Contains shared virtual disks.


Contains virtual machine images and configuration files.

7.2 Oracle VM Server Repositories

A list of the Oracle VM Server repositories is in the file:


A configuration file for mounting repositories is in the file:


You can add a repository using the /usr/lib/ovs/ovs-makerepo script, and remove them using the /usr/lib/ovs/ovs-offlinerepo -d script.

Repositories are managed by Oracle VM Agent. To manually manage the repository daemon, use following commands:

/etc/init.d/ovsrepositories [start|stop|status|restart|reload]

7.3 Repository Configuration File

A list of the Oracle VM Server repositories is in the file:


The format used in the repository file is:

uuid source


The UUID (Universally Unique Identifier) of the repository.


The block device or NFS path to the file system used as a repository.

7.4 Repository Mount Options

You can create an optional repository option file which contains mount options for storage repositories. The repository option file must be named:


The format of this file is:

uuid options


The UUID of the repository and must match the UUID of the repository in the /etc/ovs/repositories file.


The list of mount options, as they would appear if the volume were mounted with mount -o opt1,opt2,opt3. The mount options will be used exactly as listed in the file until the end of the line.

7.5 Adding a Repository

You can add a file system or shared virtual disk as a repository using the makerepo script. This script identifies the file system or shared virtual disk as a repository and updates the repository configuration to enable it. The script takes the parameters:

/usr/lib/ovs/ovs-makerepo source shared description


The block device or NFS path to the file system to be added.


Sets whether the file system is to be shared as the cluster root (the heartbeat device), shared as a non-cluster root, or not shared. In a High Availability (HA) enabled configuration, one shared storage repository must be chosen as the cluster root in a server pool. This repository serves as the shared disk for the cluster heartbeat and quorum maintenance.

Enter C for this parameter to enable the repository as a cluster root. For all other shared storage in the server pool, and all shared storage in non-HA-enabled server pools, enter 1. For any local, host-specific storage, enter 0.


The text displayed in Oracle VM Manager.

7.6 Removing a Repository

You can remove a repository using the /usr/lib/ovs/ovs-offlinerepo script. This script unmounts a repository and removes it from the configuration.The script takes the parameters:

/usr/lib/ovs/ovs-offlinerepo [-d] uuid source


Removes the storage repository from the configuration file.


The UUID of the repository.


The block device or NFS path to the file system to be removed.