Skip Headers

Oracle® VM Server User's Guide Release 2.1 Part Number E10898-04 |
Home | Book List | Contents | Index | Contact Us

Previous | Next
| 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:

- 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.