...
Configuration parameters
The KGPSA-CA PCI FC adapter emulation has the following configuration parameters:
| Anchor | ||||
|---|---|---|---|---|
|
| Parameter | storage_controller_path_id |
|---|---|
| Type | Text String |
| Value | Instructs the CHARON VM to create a set of virtual FC devices and connect to the virtual system through the virtual KGPSA FC Adapter.
Syntax:
where the "Storage controller path ID" parameter is a storage (for example SAN) controller path ID. This ID can be obtained from the "Host Device Check" utility ("Storage Controllers" section). Once specified, all the disks attached to the storage are automatically mapped as disk units to CHARON VM. Example:
It is also possible to use wildcards for specifying the ID number: Example:
In this case CHARON will collect the LUNs from all the matching paths. This syntax works disregarding whether Windows MPIO is active or not. If it is active, CHARON VM uses "active" path (because it works through Windows), if Windows MPIO is OFF, CHARON VM selects the first matching path (and warns you in the LOG file).
|
In this mode WWID and UDID values are taken from the storage controller directly. Note that some storage controllers may not support aquiring UDID, in this case this way of mapping cannot be used in case of OpenVMS (Tru64 Unix is Ok)!| Div | ||
|---|---|---|
| ||
| Anchor | ||||
|---|---|---|---|---|
|
| Parameter | host_bus_location |
|---|---|
| Type | Text String |
| Value | Establish connection between virtual DEC-KGPSA-CA PCI FC adapter and physical EMULEX LightPulse PCI/PCI-X/PCIe FC adapter (pass through mode) Syntax:
where X, Y, and Z describe location of physical EMULEX LightPulse PCI/PCI-X/PCIe FC adapter in the host computer (see Pass Through mode 55203975669364 for details). Example:
|
wwid
| Parameter | wwid[N] N is 0..32766 (no more than 255 units) |
|---|---|
| Type | Text String |
| Value | Sets WWID for emulated KGPSA adapter unit in case if the WWID can not be obtained directly from the device CHARON VM is mapped to. For example in case of disk images or local physical drives CHARON VM cannot get its WWID from the the host system, so it is automaticaly introduce some generated WWID. In case if this WWID is not acceptable it can be replaced with the custom one using the "wwid" parameter. Syntax:
Example:
|
| Div | ||
|---|---|---|
| ||
| Anchor | ||||
|---|---|---|---|---|
|
| Parameter | container[N] N is 0..32766 (no more than 255 units) | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Type | Text String | |||||||||||||||||||||
| Value | Possible values of the parameter are strings in one of the following forms:
|
Be careful not to destroy all the information from the disk dedicated to CHARON VM by mistake.media_type
| Parameter | media_type[N] N is 0..32766 (no more than 255 units) |
|---|---|
| Type | Text String |
| Value | Instructs CHARON VM to use the supplied value as the PRODUCT field in the FC INQUIRY data returned to a software running on virtual HP Alpha system in response to FC INQUIRY command. If not specified, CHARON VM attempts to guess the FC INQUIRY data based on virtual FC device type and underlying container (which is specified in the corresponding container configuration parameter). Initially is not specified. Example: |
| Div | ||
|---|---|---|
| ||
removable
| Parameter | removable[N] N is 0..32766 (no more than 255 units) |
|---|---|
| Type | Boolean |
| Value | When set to "true", the removable configuration parameter instructs CHARON VM to report the corresponding virtual FC device as removable. By default the removable configuration parameter is set to "false". Example: |
geometry
...
io_queue_depth
| Parameter | io_queue_depth[N] N is "XXYY" number, where:
|
|---|---|
| Type | Numeric |
| Value | Specifies KZPBA I/O requests (read or write) for a given unit in a range 2..128 Setting this parameter enables KZPBA instance to run up-to the specifiied specified numbers of I/O requests (read or write) for unit N in parallel, thus improving the performance. The default value set by controller is optimal for most of the cases. It may be needed to enlarge this number if guest OS I/O queue for a certain unit contains too much pending entries. In this case the value should be equal to an average size of the queue, collected statistically. Please do not set this parameter without clear understanding the purpose. By default parallel execution of I/O requests is disabled. Example:
|
| Div | ||
|---|---|---|
| ||
min_n_of_threads
| Parameter | min_n_of_threads |
|---|---|
| Type | Numeric |
| Value | Instructs KZPBA I/O to reserve a given number of working threads in a range 1..64, thus improving the performance. All units of KZPBA instance share the I/O threads. The default value is equal to number of units plus 2. For optimization it is possible to set this parameter to sum of the "io_queue_depth" parameters for each unit plus 2. This assumption seems optimal for most of the cases. Please do not set this parameter without clear understanding the purpose. Example:
|
...
It provides the following functionality:
| Command | Description | ||
|---|---|---|---|
| Scans connected SAN using FC adapters, discovers FC ports, storage controllers, logical units and then builds volatile FC database. The "/verbose" qualifier enables FC communication trace on console (for diagnostic and troubleshooting). | ||
| Displays corresponding part of volatile FC database. | ||
| Fills the environment variables wwid0..wwid3 and n1..n4 to identify path(s) to logical unit with the specified UDID. These variables are later used by "INIT" to create device database entries and by OpenVMS/Tru64 to get access to boot and dump disks. This command does NOT make any change to other environment variables. | ||
fc set {boot | dump} wwid <X> | Fills the environment variables wwid0..wwid3 and n1..n4 to identify path(s) to logical unit with the specified WWID. These variables are later used by "INIT" to create device database entries and by OpenVMS/Tru64 to get access to boot and dump disks. This command does NOT make any change to other environment variables. This parameter is useful if UDID is absent.
|
| |
| Clears environment variables wwid0..wwid3 and n1..n4, which automatically disable (but do NOT delete) device database entries representing FC attached devices. This command does NOT affect volatile FC database. |
Example of usage:
|
...
Once the configuration steps described above are done, start the CHARON VM and wait for the P00>>>the P00>>> prompt.
Please refer to the following example with two FC adapters PGA and PGB defined:
|
| Div | ||
|---|---|---|
| ||
The next step is to configure paths for the FC storage:
|
...