Chapter 4 Discovering Storage

This section gives you the syntax and examples to use to discover storage using the CLI.

4.1 Discovering a file server

  1. To discover a file server use the following syntax:

    create FileServer plugin=value accessHost=value adminServers=value [ refreshServers=value ] [ uniformedExports= { Yes | No } ] [ name=value ] [ description=value ]

    For example:

    OVM> create FileServer plugin="Oracle Generic Network File System" \
      accessHost=10.172.76.125 adminServers="MyServer1.virtlab.info,MyServer2.virtlab.info" \
      name=MyNFSServer

    For more information on the syntax and usage, see Section A.38, “create FileServer” .

  2. After discovering a file server, you should attach an admin server to it so that administrative operations can be performed on the file server by Oracle VM Manager. To add an admin server to the file server, use the syntax:

    addAdminServer { FileServer | StorageArray } instance server=value

    For example:

    OVM> addAdminServer FileServer name=MyNFSServer server=MyServer

    For more information on the syntax and usage, see Section A.4, “addAdminServer” .

  3. You should also attach a refresh server to the file server which is used to refresh the file system. To add a refresh server to the file server, use the syntax:

    addRefreshServer FileServer instance server=value

    For example:

    OVM> addRefreshServer FileServer name=MyNFSServer server=MyServer

    For more information on the syntax and usage, see Section A.6, “addRefreshServer” .

  4. The final step is to refresh the file server so Oracle VM Manager has the most current information about the file server. To refresh the file server, use the syntax:

    refresh { AccessGroup | Assembly | FileServer | FileSystem | PhysicalDisk | Repository | Server | StorageArray | VirtualAppliance } instance

    For example:

    OVM> refresh FileServer name=MyNFSServer 

    For more information on the syntax and usage, see Section A.142, “refresh” .

4.2 Discovering a storage array

  1. To discover a storage array use the following syntax:

    create StorageArray plugin=value storageType= { FIBRECHANNEL | ISCSI | LOCAL | UNKNOWN } [ storageName=value ] [ accessHost=value ] [ accessPort=value ] [ accessUsername=value accessPassword=value ] [ useChap= { Yes | No } ] [ adminHost=value adminUserName=value adminPassword=value ] [ pluginPrivateData=value ] name=value [ description=value ] [ lipScan= { Yes | No } ]

    For example:

    OVM> create StorageArray plugin="Oracle Generic SCSI Plugin" name=MyISCSIServer \
      storageType=ISCSI accessHost=10.172.76.130 accessPort=3260

    For more information on the syntax and usage, see Section A.49, “create StorageArray” .

  2. After discovering a storage array, you should attach at least one admin server to it so that administrative operations can be performed on the storage array by Oracle VM Manager. To add an admin server to the storage array, use the syntax:

    addAdminServer { FileServer | StorageArray } instance server=value

    For example:

    OVM> addAdminServer StorageArray name=MyISCSIServer server=MyServer

    For more information on the syntax and usage, see Section A.4, “addAdminServer” .

  3. Next you should add the storage initiators to an access group for each Oracle VM Server that is to be granted access to the storage. In this example we add the storage initiators for each Oracle VM Server to the default access group that is created when a storage array is discovered. First, find the name of the access group by listing the access groups for the server using the show StorageArray command, for example:

    OVM> show StorageArray name=MyISCSIServer
      ...
      Access Group 1 = Default access group @ MyISCSIServer @ 0004fb00000900005264cefc5b9a1cb8
        [Default access group @ MyISCSIServer]  Access group name
      Storage Plug-in = oracle.generic.SCSIPlugin.GenericPlugin (1.1.0)  
        [Oracle Generic SCSI Plugin]
      ...

    Next, find the storage initiator name for each Oracle VM Server using the show Server command, for example:

    OVM> show Server name=MyServer1
       ...
      Storage Initiator 1 = iqn.1988-12.com.oracle:e774e056fd3
             Storage initiator name
      Storage Initiator 2 = storage.LocalStorageInitiator in 
        00:e0:81:4d:40:f5:00:e0:81:4d:40:be:00:e0:81:4d
      ...

    Then add the storage initiator for each Oracle VM Server to the default access group using the syntax:

    add StorageInitiator instance to AccessGroup instance

    For example:

    OVM> add StorageInitiator name=iqn.1988-12.com.oracle:d72d82d0817f to AccessGroup \
      name='Default access group @ MyISCSIServer' 

    For more information on the syntax and usage, see Section A.13, “add StorageInitiator” .

  4. Validate the storage array. Validation should be performed when any changes are made to the storage. To validate the storage array, use the syntax:

    validate StorageArray instance

    For example:

    OVM> validate StorageArray name=MyISCSIServer

    For more information on the syntax and usage, see Section A.182, “validate” .

  5. Refresh the storage array so Oracle VM Manager has the most current information about the storage. To refresh the storage array, use the syntax:

    refresh { AccessGroup | Assembly | FileServer | FileSystem | PhysicalDisk | Repository | Server | StorageArray | VirtualAppliance } instance

    For example:

    OVM> refresh StorageArray name=MyISCSIServer

    For more information on the syntax and usage, see Section A.142, “refresh” .