Manage the VMM library
Read this article to learn how to manage the System Center - Virtual Machine Manager (VMM) library by refreshing it, moving files around, and removing orphaned resources.
Refresh the library
By default VMM refreshes library shares once every hour.
- You can change the default refresh settings in General > Library Settings > Settings > Modify, from to 366 hours (14 days). You can also disable automatic library refreshes.
- To manually refresh, select Library > library server or share > Refresh share.
During a library refresh, the following occurs:
- VMM adds these file types to the Library view: virtual hard disks (except for those attached to a stored VM), virtual floppy disks, ISO images, answer files, PowerShell scripts. Snapshots imported into the library with Hyper-V and VMware VMs are displayed on the Checkpoints tab of the VM properties. The snapshot files aren't displayed.
- VMM indexes but doesn't display these file types:
- Files associated with stored VMs (VM configuration file, attached virtual hard disks, saved state files, imported snapshots, checkpoints).
- Files associated with VM templates.
- Configuration files:
- Hyper-V (.exp -export, .vsv -savedstate, .bin)
- Virtual Server (.vmd, .vsv)
- VMware (.vmtx, .vmx)
You have direct access to copy and move library files through Windows Explorer. Each file in a library share has a unique GUID and is periodically indexed during library refreshes. After a file is refreshed you can move it to any other location on a library share managed by VMM and refresh automatically tracks the file movement. After the move, file metadata is updated during the next library refresh.
In addition you can allow unencrypted file transfers to and from a library server.
- To transfer unencrypted file transfers the feature must be allowed on both the source and destination servers.
- To enable the option click Library > Library Server and navigate to the server. Click Actions > Library Server > Properties, select Allow unencrypted file transfers.
Disable and remove file-based resources
You can remove a file-based resource either temporarily or permanently from the library.
- To disable resources click Library > Library servers > and select the library share. Select the resource and click Actions > Disable. click Enable to re-enable.
- To remove files we recommend you use VMM rather than simply deleting the file resources. When you remove the file in the library any resources that use the file are updated automatically. To remove a file click Library > Library servers > and select the library share. Select the resource and click Actions > Remove. Select Yes to confirm.
Remove a library server or share
There are circumstances in which you need to remove a library server or share. For example if you're no longer using the resources on a share or you temporarily want to remove those resources.
- To remove a library share click Library > Library servers > and select the library share. In Actions, click Library Share > Remove. Click Yes to confirm. Note that removing a share doesn't delete the files on it. They are no longer be indexed by library refreshes.
- To remove a library server click Library > Library servers. Click Actions > Library Server > Remove.
- Note that:
- Specify an account with administrative permissions on the server.
- VMM provides a list of dependent resources. If you process VMM removes any references to the removed files on dependent resources. When you remove a library server the Library Server role is removed from the VMM agent running on the server. If the server isn't performing any other VMM roles the agent is removed.
- If you remove a highly available library server the cluster is removed from the Library view. The individual cluster nodes aren't removed, but they're not displayed in the library. To remove the nodes from VMM remove the VMM agent from each computer.
Remove orphaned resources
When you remove a library share from VMM management, and there are templates that reference resources that were located on the library share, a representation of the library resource appears in the VMM library as an orphaned resource.
To remove orphaned resources, modify the templates that reference the orphaned resources to use valid library resources in the VMM library. If you add the library share again, VMM doesn't automatically reassociate the template with the physical library resource. You must complete these steps to correct template issues and to remove any orphaned resources.
- Click Library > Orphaned Resources.
- You won't be able to delete an orphaned resource until templates that reference it are updated to valid references. To view the templates right-click the orphaned resource > Properties. To update the template click it and then in the Properties dialog, locate the resource that's missing > Remove.
- Add a new resource that's valid.
- When you've completed these steps for all templates, closed the Properties dialog. To verify there aren't any dependencies right-click the orphaned resource > Properties > Dependencies. Then right-click the orphaned resource > Delete.