Table of Contents
General description
CHARON-AXP supports emulation of DEC-KGPSA-CA PCI Fibre Channel adapter.
Every instance of KGPSA-CA works in one of the two following modes:
- Fabric virtualization mode (creating virtual fabric in combination with virtual FC-3 Storage Controller). This is default mode.
- CHARON PCI Pass Through mode (using a specific CHARON PCI Pass Through driver)
Loading KGPSA storage adapter
Syntax for loading KGPSA-CA storage adapter:
load KGPSA <name> |
Example:
load KGPSA FGA |
In AlphaStation 400 configuration use the following syntax for KGPSA-CA storage adapter loading:
load KGPSA FGA irq_bus=isa |
The adapter instance name ("FGA" in the example above) is used then for parametrization, for example:
set FGA container[100]="/my_disks/vms_distributive.vdisk" |
Numbers in the square brackets represent KGPSA-CA units. They can be in the range 0..32766, but no more than 255 units can be configured on a single controller.
By default KGPSA-CA adapter uses first available PCI slot. If instead some particular slot is needed, refer to this section for details of specific placement of PCI peripherals on CHARON-AXP PCI bus.
Configuration parameters
The KGPSA-CA PCI FC adapter emulation has the following configuration parameters:
host_bus_location
Parameter | host_bus_location | ||
---|---|---|---|
Type | Text String | ||
Value | Pass through mode only! Establish connection between virtual DEC-KGPSA-CA PCI FC adapter and physical EMULEX LightPulse PCI/PCI-X/PCIe FC adapter (pass through mode) Syntax:
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. Syntax:
Example:
|
container
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:
This parameter is initially not set, thus creating NO storage elements on the controller. |
media_type
Parameter | media_type[N] N is 0..32766 (no more than 255 units) | |
---|---|---|
Type | Text String | |
Value | Instructs CHARON-AXP 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-AXP 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:
|
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-AXP to report the corresponding virtual FC device as removable. By default the removable configuration parameter is set to "false". Example:
|
geometry
Parameter | geometry[N] N is 0..32766 (no more than 255 units) | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | Text String | ||||||||||||
Value | This formatted string value specifies the explicit geometry of the disk storage element. The string format is <X>”/”<Y>[“/”<Z>] or <X>”,”<Y>[“,”<Z>][“,”<B>] where:
If this parameter is not set, CHARON-AXP will configure the geometry based on the most probable disk type. Initially not set. Example:
It is possiblle to specify each parameter independently of another one. The following syntax is used for that:
|
use_io_file_buffering
Parameter | use_io_file_buffering[N] N is 0..32766 (no more than 255 units) | |
---|---|---|
Type | Boolean | |
Value | When set to "true", instructs CHARON-AXP to enable host operating system I/O cache on read/write operations. Note that this caching has a significant effect only in case of mapping to disk containers, not physical drives. When enabled, host operating system I/O cache may significantly improve I/O performance of the virtual system. At the same time maintaining I/O cache requires additional host resources (CPU and memory) which may negatively affect overall performance of the virtual system. Initially is set to "false". Example:
|
io_queue_depth
Parameter | io_queue_depth[N] N is 0..32766 (no more than 255 units) | |
---|---|---|
Type | Numeric | |
Value | Specifies KGPSA 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 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 of the purpose. By default parallel execution of I/O requests is disabled. Example:
|
min_n_of_threads
Parameter | min_n_of_threads | |
---|---|---|
Type | Numeric | |
Value | Instructs KGPSA I/O to reserve a given number of working threads in a range 1..64, thus improving the performance. All units of KGPSA 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:
|
Empty disk images are created with the "mkdskcmd" utility.
CHARON-AXP is able to boot from disk images of any OpenVMS/Alpha and Tru64 version.
Mapping to host resources
Fabric virtualization mode
In this mode KGPSA-CA PCI FC adapter can be directly mapped to physical disks (both local and iSCSI) and disk images as shown in the following example:
|
See the "Configuration parameters" section for details.
Pass Through mode
The CHARON PCI Pass Through mode allows connection between virtual DEC-KGPSA-CA PCI FC adapter and physical EMULEX LightPulse PCI/PCI-X/PCIe FC adapter plugged into host’s PCI/PCI-X/PCIe slot.
Syntax:
|
Example:
load KGPSA FGA host_bus_location="/dev/kgpsa0" |
The following is a list of EMULEX LightPulse PCI/PCI-X/PCIe FC adapters supported by CHARON-AXP PCI Pass Through driver and suitable for emulation of KGPSA-CA PCI FC adapter in CHARON PCI Pass Through mode:
Supported | Not Supported | Not tested |
---|---|---|
LP8000 | LPe1150 (FC2142SR, A8002A) | LPe11000 |
Pass Through mode establishing sequence
To establish "pass through" mode do the following:
- Install the EMULEX LightPulse PCI/PCI-X/PCIe FC adapter (see below for a list of supported models) to some spare PCI/PCI-X/PCIe slot of the host system
- Build PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC
- Install PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC
- Add PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC to Linux startup
- Map KGPSA-CA adapter(-s) to EMULEX LightPulse PCI/PCI-X/PCIe FC adapter instance(-s) in CHARON-AXP configuration file
If kernel of the host system has been upgraded or reinstalled all the steps of the PPT KGPSA driver installation must be repeated
Building PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC
To build PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC do the following:
Step | Description | |
---|---|---|
1 | Make sure that the required building tools and include files are installed. If they are absent install them:
The kernel version must match the version of the installed kernel-headers (i.e. this packages must have same versions. It can be verified via Check that the "kernel" and the "kernel-headers" have the same version, and ensure that system is booted from this kernel version (not from some older one and etc) with " | |
2 | Open xterm and change the default directory to "
| |
3 | Issue "make clean; make" commands to build kernel object:
It is prohibited to use a module built on a certain version of kernel on another one. | |
4 | Check that there are no compilation errors and the file "ppt_kgpsa.ko " has been built |
Installation of PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC
To install PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC do the following:
Step | Description | |
---|---|---|
1 | Unload standard "lpfc" driver; to do that issue the following command:
| |
2 | Load "
| |
3 | Issue "dmesg" command and check that no error appeared during the driver loading, also check that the driver has found all KGPSA devices:
|
Adding PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC to Linux startup
To add PPT driver for EMULEX LightPulse PCI/PCI-X/PCIe FC to Linux startup do the following:
Step | Description | |
---|---|---|
1 | Disable auto-loading of Linux standard "lpfc" driver on boot. To do that add "blacklist lpfc" to the black list file "/etc/modprobe.d/blacklist.conf " | |
2 | Copy the KGPSA-CA kernel module to the location of Linux kernel modules, for example:
The particular path may be different, depending on the kernel version and Linux distribution. | |
3 | Enable auto load of the module:
| |
4 | Regenerate new "initramfs" image with "mkinitrd":
The particular path may be different, depending on the kernel version and Linux distribution. |
Configuration of KGPSA-CA in pass through mode
FCMGR utility description
To configure KGPSA-CA adapter in pass through mode a special SRM console utility "FCMGR" is used (it has the same functionality as the "WWIDMGR" utility of the native HP Alpha hardware).
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. Only right part of the displayed WWID is used for specification, for example:
|
| 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:
|
Configuration steps using FCMGR utility
Once the configuration steps described above are done, start the CHARON VM and wait for the P00>>> prompt.
Please refer to the following example with two FC adapters PGA and PGB defined:
|
The next step is to configure paths for the FC storage:
|