4.8 Managing Storage Repositories

4.8.1 Creating a Storage Repository
4.8.2 Presenting or Unpresenting a Storage Repository
4.8.3 Editing a Storage Repository
4.8.4 Deleting a Storage Repository
4.8.5 Enabling Storage Repository Back Ups

You use Oracle VM Manager to create and configure storage repositories, and to present one or more storage repositories to Oracle VM Servers in a server pool. During the creation and configuration of the storage repository the Oracle VM Agent on the Oracle VM Server will act as the worker component performing the instructions given through Oracle VM Manager. This chapter discusses the flow of the operations you perform after the discovery of your physical storage hardware, LUNs, file systems and so on, in order to make a storage repository available to the Oracle VM Servers in your server pool. Once the storage repository is accessible, you can start adding storage resources and building VMs with those resources.

Depending on the configuration of Oracle VM Servers in your environment, some restrictions may apply to the creation of storage repositories due to the nature of the storage. Keep in mind the following guidelines when working with storage repositories:

Oracle VM Manager allows you to perform a number of management operations on the storage repositories under its control. Table 4.2, “Storage Repository Management Operations” describes the possible operations at the level of a storage repository. To access these functions in Oracle VM Manager, open the Repositories tab, use the tree view in the navigation pane to select repositories, then choose the appropriate button from the toolbar above.

Note

Storage repositories are presented to individual servers, and not necessarily to all servers within a server pool. This means that it is possible that a repository may not be available for use on a particular server. You should keep this in mind when you deploy a VM on a specific Oracle VM Server. To see which servers have access to a storage repository, select the repository in the navigation pane and verify the access status in the management pane with the Perspective set to Info.

Table 4.2 Storage Repository Management Operations

Operation

Description

Create repository

See Section 4.8.1, “Creating a Storage Repository”.

Present repository

  1. Select a repository in the tree view and click Present/Unpresent Present/Unpresent icon. in the toolbar above.

  2. In the Present Repository dialog box, there is an option to either present the repository to an entire server pool or to individual servers. Use the arrow buttons to determine to which server pool or Oracle VM Servers the current repository should be presented (or not presented).

    Note

    If you present a repository to a server pool, this has the same effect as selecting all of the sOracle VM Servers within the server pool and presenting the repository to them individually.

  3. Click OK to save your changes.

See Section 4.8.2, “Presenting or Unpresenting a Storage Repository”.

Edit repository

  1. Select a repository in the tree view and click Edit Selected Repository Edit Selected Repository icon in the toolbar above.

  2. In the Edit Repository dialog box there are two tabs:

    On the Repository tab you can make the following changes:

    • Name: Edit the name of the selected repository.

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

    • Release Ownership: Select this check box to allow the repository to be used by another Oracle VM Manager.

    On the Present Repository tab there is an option to either present the repository to an entire server pool or to present the repository to individual servers. Use the arrow buttons to determine to which server pool or Oracle VM Servers the current repository should be presented (or not presented).

    Note

    If you present a repository to a server pool, this has the same effect as selecting all of the sOracle VM Servers within the server pool and presenting the repository to them individually.

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

See Section 4.8.3, “Editing a Storage Repository”.

Delete repository

  1. Select one or more repositories in the table and click Delete Selected Repository Delete Selected Repository icon in the toolbar above.

  2. Click OK to execute the delete operation.

See Section 4.8.4, “Deleting a Storage Repository”.

Refresh and resync repository

Select one or more repositories in the table and click Refresh and Resync Selected Repository Resync Selected Repository icon in the toolbar above.

Oracle VM Manager re-checks the disk contents of the selected repositories. Any detected changes will be reflected in the various content tabs (Assemblies, ISO files, ...) of the storage repository.


4.8.1 Creating a Storage Repository

After you complete the preparation phase described above in Section 4.6.1, “Discovering File Servers” and Section 4.6.4.1, “Discovering a SAN Server”, Oracle VM Manager is fully aware of the underlying physical storage providers available for use as a storage repository.

Important

A storage repository should be at least 10GB 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. In the toolbar above the navigation pane, click Create New Repository Create New Repository icon .

  3. In the Create a Data 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 Physical Disk as location, proceed to Physical Disk as the Repository Location. 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 3.14, “Name Filters” for more information.

      This figure shows the Repository Information dialog box.
  5. Optionally provide this additional information:

  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 3.14, “Name Filters” for more information.

      This figure shows the Repository Information dialog box.
  7. Select from the list to which Server Pool this storage repository should be provided. 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.

  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.8.2, “Presenting or Unpresenting a Storage 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.

    This figure shows the Present to Servers dialog box.
  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.8.2, “Presenting or Unpresenting a Storage Repository”.

4.8.2 Presenting or Unpresenting a Storage Repository

As part of the storage repository creation you can select the Oracle VM Servers to which the repository must be made available. However, you can modify this selection afterwards and present the repository to new servers or unpresent it from servers already selected earlier.

Presenting the storage repository to an Oracle VM Server is the equivalent of mounting a file system. Essentially, when you present the repository to the Oracle VM Servers in your server pool, the repository file system is mounted by the root user on each Oracle VM Server. This is an essential factor in the HA configuration of the Oracle VM setup.

To present a storage repository to your 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 above 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.

    This figure shows the Present this Repository to Servers(s) dialog box.
  4. Click OK to present the storage repository to the selected Oracle VM Servers.

Note

NFS-based storage repositories can be shared by multiple server pools controlled by the same Oracle VM Manager. OCFS2-based storage repositories always belong to a single clustered server pool. Therefore only members of that server pool appear in either pane.

Your external storage setup is now complete. The storage repository is made available to your Oracle VM Servers. When the server pool is ready you can start creating virtual machines. For more information, see Chapter 6, Managing Server Pools and Oracle VM Servers.

4.8.3 Editing a Storage 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 above.

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

    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 servers or server pool where the repository is presented. See Section 4.8.2, “Presenting or Unpresenting a Storage Repository” for more information on this.

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

    Release Ownership: Select this check box to allow the repository to be used by another Oracle VM Manager.

    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.8.2, “Presenting or Unpresenting a Storage Repository” for more information on this.

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

4.8.4 Deleting a Storage Repository

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

  3. Confirm that you wish to delete this storage repositories: click OK to continue.

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

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

When your server pool is fully configured with Oracle VM Servers, network and storage, you use Oracle VM Manager for all management and maintenance operations on the storage repository. The storage resources residing in the repository (ISO files, templates, and so on) are also managed through Oracle VM Manager. Management operations on the storage resources inside a storage repository are discussed in detail in a separate chapter: Section 7.5, “Virtual Machine Resources”. Detailed instructions for the use of different types of storage entities with virtual machines are discussed in Chapter 7, Managing Virtual Machines.

4.8.5 Enabling Storage Repository Back Ups

An Oracle VM Server can be configured to enable third party applications to perform a back up of the contents of a storage repository. To enable this, an Oracle VM Server is configured to provide an NFS share that a third party back up tool can use to access the contents of the repository. The Oracle VM Server must be in a clustered server pool and have the OCFS2-based storage repository presented to it.

When you have created a repository export, use the Repository Path (displayed in the management pane table) and the Oracle VM Server hostname or IP address to connect to the NFS mount point from the third party back up software.

To create a repository export:

  1. Click the Servers and VMs tab.

  2. In the navigation pane, select the Oracle VM Server on which you want to create the repository export location.

  3. Select Repository Exports from the Perspective drop-down list in the management pane.

  4. Click Create Repository Export.. Create Repository Export... icon in the toolbar.

  5. The Create Repository Export dialog box is displayed.

    This figure shows the Create Repository Export dialog box.

    Enter or select the following:

    • Client IP/Host Name: The IP address or hostname of the computer for which to grant access to the repository contents. This is likely to be the machine on which the third party back up and restore software is running.

    • Repository: An OCFS2-based storage repository presented to the Oracle VM Server. This is the repository you want to back up.

    • Options: The parameters to include in the NFS mount configuration, for example:

      rw, async, no_root_squash

      Click OK.

  6. To edit a repository export, select the entry in the table in the management pane and click Edit Repository Export.. Edit Repository Export... icon in the toolbar.

  7. To delete a repository export, select the entry in the table in the management pane and click Delete Repository Export Delete Repository Export icon in the toolbar.