4.3 Repositories Folder

The Repositories navigation folder contains each storage repository that has been configured within the environment. The structure of the navigation provided in the navigation tree is discussed in more detail in Section 4.2, “Summary”.

Clicking on the Repositories navigation folder in the navigation tree allows you to access different perspectives in the management pane. Each perspective provides its own view of all of the storage repositories within Oracle VM Manager. Most of the perspectives also include separate perspective toolbars that enable you to perform various configuration or management tasks specific to the view currently displayed within the management pane. The Repositories navigation folder offers the following perspectives within the management pane:

4.3.1 Repositories Perspective

The Repositories perspective lists the different storage repositories configured in your environment. The following columns are displayed in the management pane:

  • Name: The name that has been configured for the repository.

  • File System: The UUID and path location to the storage repository file system.

  • File System Size: Displays the following attributes of the storage repository file system:

    • Free: Amount of available space on the file system, in GiB.

    • Used: Amount of space that is in use on the file system, in GiB.

    • Total: Capacity of the file system, in GiB.

    • Apparent: Apparent size, in GiB. The apparent size is the total size of the entire repository.

      Note

      Oracle VM Manager uses a separate interval to collect the apparent size of the repository. That interval is longer than the interval at which other file system statistics are collected. For this reason, when changes to the contents of the repository file system occur, you might notice that it takes several minutes for the apparent size statistic to update after other file system statistics are updated.

    • Capacity (%): Percentage of the file system that is allocated. If the value is 100%, then all available disk space is allocated. If the value is greater than 100%, then the disk space is oversubscribed. For example, the repository contains several virtual disks that are sparsely allocated. If all of the virtual disks reach the maximum size, then the capacity exceeds the available disk space.

This perspective includes a toolbar that consists of the following options:

Table 4.2 Repositories Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Create New Repository

Create New Repository icon

Displays the Create a Data Repository wizard. Use this option to create a storage repository.

Edit Selected Repository

Edit Selected Repository icon

Displays the Edit Repository wizard. Use this option to edit a storage repository.

Delete Selected Repository

Delete Selected Repository icon

Displays the Delete Confirmation dialog box. Use this option to delete the selected storage repository.

Present-Unpresent Selected Repository

Present-Unpresent Selected Repository icon.

Displays the Present this Repository to Server(s) dialog box. Use this option to present or unpresent the repository to an entire server pool or to and from individual Oracle VM Servers.

Refresh Selected Repository

Refresh Selected Repository icon

Refreshes one or more selected storage repositories. Oracle VM Manager re-checks the disk contents of the selected repositories. Any detected changes are reflected in the various content tabs (Virtual Appliances, ISO files, ...) of the storage repository.

Help

Help icon

Displays context sensitive help.


4.3.1.1 Create New Repository

A storage repository should be at least 10 GB in size. In addition to this minimum size requirement, you should include enough storage space for virtual machines, templates, ISO files and other virtual machine resources.

To create a storage repository for your server pool:

  1. Select the Repositories tab.

  2. Click Create New Repository Create New Repository icon in the toolbar.

  3. In the Create a Repository dialog box, enter the following information:

    • Repository Name: The name you wish to use to identify the repository.

    • Repository Location: Either a network file server or a physical disk.

  4. If you selected Network File Server as location, click Search Search icon to select a location in the Select Network File System dialog box:

    • Select a Network File Server from the list. The available file systems appear. Note that only a refreshed file system can be used.

    • Select the file system you wish to install the storage repository on. Click OK.

      Note

      When searching for a file system, there is an option to provide a Name Filter. You can use this filter to specify search criteria to limit the objects displayed. See Section 1.16, “Name Filters” for more information.

  5. Optionally provide this additional information:

    • Share Path: Path to a subdirectory on the selected file system.

    • Description: Information you would like to add about this storage repository.

  6. If you selected Physical Disk as the Repository Location, click Search Search icon to select a location in the Select Physical Disk dialog box:

    • Select a Storage Array and, if applicable, a Volume Group from the respective lists. The available disks appear.

    • Select the physical disk you wish to install the storage repository on. Click OK.

      Note

      When searching for a physical disk, there is an option to provide a Name Filter. You can use this filter to specify search criteria to limit the objects displayed. See Section 1.16, “Name Filters” for more information.

  7. Select from the list to which Server Pool this storage repository should be provided, or alternatively select None if you are creating a repository on a local disk for use on a single Oracle VM Server. Optionally enter additional information about this storage repository in the Description field.

    Note

    When you create a storage repository on a LUN, only clustered server pools can be selected. If a non-clustered server pool or no server pool is selected, then you must specify a physical disk in local storage to create the repository.

  8. Click Next to proceed to the second section of the wizard: Present to Servers.

    When the storage repository is prepared and created, it must also be made available for use by your Oracle VM Servers before it can be populated. Typically you present the storage repository to all the Oracle VM Servers in the server pool. However, should you wish to set up storage differently, Oracle VM Manager allows you to present a repository to a selection of Oracle VM Servers instead of the entire server pool. See also Section 4.3.1.4, “Present or Unpresent Repository”

  9. In the Present to Servers dialog box, use the arrow buttons to move the required Oracle VM Servers from the left to the right pane.

  10. Click Finish to create the new storage repository and present it to the selected Oracle VM Servers. The new storage repository is displayed in the Repositories table in the management pane.

At this point, the storage repository has been created, Oracle VM Manager has taken ownership, and the selected Oracle VM Servers have access in order to store virtual machines, ISO files, templates and so on. To modify the configuration of servers with access to the storage repository, see Section 4.3.1.4, “Present or Unpresent Repository”.

4.3.1.2 Edit Repository

To edit a storage repository:

  1. Select the repository in the tree view in the navigation pane and click Edit Selected Repository Edit Selected Repository icon in the toolbar.

    Note

    The Edit Repository dialog box is only editable if the repository is owned by the current Oracle VM Manager instance. If the repository is owned by another Oracle VM Manager instance, this dialog box is read-only.

  2. In the Edit Repository dialog box you can make the following changes:

    Repository Name: Edit the name of the selected repository.

    Server Pool: This option is available if your repository location is a Physical Disk. It allows you to change the server pool that the repository is associated with. This option makes it simple to move OCFS2 repositories from one server pool to another. Usually after changing server pool association, you should change the Oracle VM Servers or server pool where the repository is presented. See Section 4.3.1.4, “Present or Unpresent Repository” for more information on presenting a repository to Oracle VM Servers.

    Description: Optionally enter a more elaborate description of the selected repository.

    Release Ownership: This check box is displayed if the repository is currently under ownership of the current Oracle VM Manager instance. Select this check box to allow the repository to be used by another Oracle VM Manager.

    Take Ownership: This check box is displayed if the repository is not under the ownership of the current Oracle VM Manager instance. Select this check box to take ownership of the repository. The repository should first be released from the ownership of any other Oracle VM Manager instance.

    By clicking on the Present Repository tab, you can easily change the servers or server pools on which the repository is presented. See Section 4.3.1.4, “Present or Unpresent Repository” for more information on this.

    Note

    The Present Repository tab is only available if the repository is owned by the current Oracle VM Manager instance.

  3. Click OK to save the changes to the storage repository.

4.3.1.3 Delete Repository

It is possible to delete a storage repository entirely, removing the entire directory structure from the file system where it is hosted.

To delete an owned storage repository:

  1. Make sure that all content has been removed from the storage repository you wish to delete.

  2. Select one or more repositories in the table in the management pane and click Delete Selected Repository Delete Selected Repository icon in the toolbar.

  3. Confirm that you wish to delete the storage repository: click OK to continue.

It is also possible to remove a storage repository from the current Oracle VM Manager instance without actually removing any of its contents. This can be useful if you intend to make use of the repository within an alternate Oracle VM Manager instance.

To delete a storage repository without removing the contents:

  1. Select the repository in the table in the management pane and click Present/Unpresent Present/Unpresent icon. in the toolbar.

  2. In the Present Repository dialog box, unpresent the storage repository from all Oracle VM Servers. Click OK.

  3. Select the repository in the tree view in the navigation pane and click Edit Selected Repository Edit Selected Repository icon in the toolbar. Select the Release Ownership check box and click OK.

  4. Select the now unowned repository in the table and click Delete.

  5. Confirm that you wish to delete this storage repository: click OK to continue.

4.3.1.4 Present or Unpresent Repository

To present a storage repository to Oracle VM Servers:

  1. Select the Repositories tab and select the repository of your choice in the navigation pane.

  2. Click Present/Unpresent Present/Unpresent icon. in the toolbar to change the list of servers the repository is presented to.

  3. In the Present this Repository to Server(s) dialog box, use the check box to select whether to present individual Oracle VM Servers, or all Oracle VM Servers in one or more server pools. Then use the arrow buttons to move the required Oracle VM Servers or server pools between the panes.

    If you present a repository to a server pool, this has the same effect as selecting all of the Oracle VM Servers within the server pool and presenting the repository to them individually. If you add or remove servers from a server pool after you have presented the repository to a server pool, the configuration is not updated automatically. The option to present the repository to a server pool is a convenience and simply presents the repository to all servers that belong to a particular server pool at the time that you perform the action.

  4. Click OK to present the storage repository to the selected Oracle VM Servers.

4.3.1.5 Refresh Repository

Refreshing a repository allows Oracle VM Manager to update the information that it has about the contents of a repository's file system and also refreshes information about the size and available free space on the file system where the repository is located. This is useful if manual changes have been made directly to the file system where the repository is located.

To refresh a storage repository:

  1. Select one or more repositories in the table in the management pane and click Refresh Selected Repository Refresh Selected Repository icon in the toolbar. Note that a repository refresh, does not automatically refresh the contents of a virtual appliance. To do this, refer to Section 4.8.1.5, “Refresh Virtual Appliance”.