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:

Repository Directory Structure
Oracle VM Server Repositories
Repository Configuration File
Repository Mount Options
Adding a Repository
Removing a Repository

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
iso_pool	Contains ISO files imported using Oracle VM Manager.
publish_pool	Contains guest virtual machines deployed as public.
seed_pool	Contains guest virtual machine templates.
sharedDisk	Contains shared virtual disks.
running_pool	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:

/etc/ovs/repositories

A configuration file for mounting repositories is in the file:

/etc/ovs/repositories.options

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:

/etc/ovs/repositories

The format used in the repository file is:

uuid source

uuid: The UUID (Universally Unique Identifier) of the repository.
source: 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:

/etc/ovs/repositories.options

The format of this file is:

uuid options

uuid: The UUID of the repository and must match the UUID of the repository in the /etc/ovs/repositories file.
options: 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

source

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

shared

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.

description

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

-d: Removes the storage repository from the configuration file.
uuid: The UUID of the repository.
source: The block device or NFS path to the file system to be removed.