Anchor

	TOC
	TOC

Include Page

	KBCOMMON:KB-CSSstyle
	KBCOMMON:KB-CSSstyle

...

Every instance of KGPSA-CA works in one of the two following modes:

Fabric virtualization mode 18401789411551 (creating virtual fabric in combination with virtual FC-3 Storage Controller). This is default mode.
Pass Through mode 18401789411551 (using a specific CHARON PCI Pass Through driver)
Fabric presentation mode 18401789411551 (using Linux FC HBA directly)

...

load KGPSA <name>

Example:

load KGPSA FGA

Please note:

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:

...

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

KGPSA-CA PCI Fibre Channel adapter in Pass Through mode only !

Establish connection between virtual DEC-KGPSA-CA PCI FC adapter and physical EMULEX LightPulse PCI/PCI-X/PCIe FC adapter (KGPSA-CA PCI Fibre Channel adapter in Pass Through mode)

Syntax:

load KGPSA <controller name> host_bus_location="/dev/kgpsa<X>"

Example:

load KGPSA FGA host_bus_location="/dev/kgpsa0"

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:

set <controller name> wwid[unit-number]="XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX"

Example:

set FGA wwid[2]="6008-05F3-0005-2950-BF8E-0B86-A0C7-0001"

Div

class	pagebreak

container

"/dev/sd<L>" addressing is not persistent, so it is strongly recommended to use "/dev/disk/by-id/wwn-*" syntax instead to refer the disk by its WWID - especially in the enviroments utilizing FC and SAN storages.

These disks must not be formatted by the host OS.

Example:

set FGA container[0]="/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4"

It is also possible to use not a whole disk, but previously created partitions on it. In this case the syntax is the following: "/dev/sd<L><N>" where N is the number of partition to be used.

Example:

set FGA container[0]="/dev/sdc3"

Loop (virtual block) devices
- "/dev/loop<N>"
  Example:
  set FGA container[100]="/dev/loop0"
Multipath disk
- "/dev/dm-<N>"
- "/dev/mapper/mpath<N>"
- "/dev/mapper/disk<N>"
  Be Be careful not to destroy all the information from the disk dedicated to CHARON-AXP by mistake.
  These disks must not be formatted by the host OS.
  Example:
  set FGA container[200]="/dev/dm-0"
File representing a physical disk of the HP Alpha system (disk image)
- [<drive>":\"<path-name>”\”]<file-name>[“.vdisk”]
  These files can be created from scratch with "mkdskcmd" utility. Data and OS disk backups are transferred from the original system via tapes or network and restored into these container files.
  Mapping may also include the full path (recommended), for example: "/my_disks/my_boot_disk.vdisk"
  Example:
  set FGA container[401]="my_dka401.vdisk"

This parameter is initially not set, thus creating NO storage elements on the controller.

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:

Physical disk
- "/dev/sd<L>", where "L" is letter, for example "/dev/sdb"
- "/dev/disk/by-id/..." - addressing by the disk ID, for example "/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4"
- "/dev/disk/by-label/..." - addressing by the disk label, for example "/dev/disk/by-label/MyStorage"
- "/dev/disk/by-uuid/..." - addressing by the disk UUID, for example "/dev/disk/by-uuid/0e808a2f-cdd3-4944-a245-f729ffd73882"
  Please note that existing data on such a disk may be destroyed, depending on how it is used in the emulator.

Note

Div

class	pagebreak

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:

set FGA media_type[0]="HSZ70"

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:

set FGA removable[400]=true

Div

class	pagebreak

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:

X corresponds to the number of sectors per track
Y corresponds to the number of tracks per cylinder
Z corresponds the number of cylinders on the unit. If omitted, Z is calculated based on X, Y and the total number of sectors on the unit that reflects the size of the disk storage element. This is an optional parameter.
B corresponds to the total size of the disk (in blocks) reported to the guest OS. If omitted it is calculated automatically. This is an optional parameter.

If this parameter is not set, CHARON-AXP will configure the geometry based on the most probable disk type.

Initially not set.

Example:

set FGA geometry[201] = "255/255"

It is possible to specify each parameter independently of another one. The following syntax is used for that: set FGA geometry[300]="*,*,*,16777210"

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:

set FGA use_io_file_buffering[300]=true

Div

class	pagebreak

io_queue_depth

...

set FGA container[0]="/my_disks/my_dka401.vdisk"set FGA container[100]="/dev/sdb"
set FGA container[200]="/dev/sdc2"
set FGA container[300]="/dev/dm-0"

See the "KGPSA-CA PCI Fibre Channel adapter - Configuration parameters" section for details.

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

...

Install the EMULEX LightPulse PCI/PCI-X/PCIe FC adapter (see above 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

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

...

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 "rpm -q -a | grep kernel-" )

Check that the "kernel", the "kernel-devel" 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 "uname -a" command.

Step	Description
1	Make sure that the required building tools and include files are installed. If they are absent install them: `# yum groupinstall "Development Tools"` `# yum install kernel kernel-headers kernel-devel`
Info
2	Open xterm and change the default directory to "`/opt/charon/drivers/kgpsa`": `# cd /opt/charon/drivers/kgpsa`
3	Issue "make clean; make" commands to build kernel object: `# make clean; make` 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

...

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:

Div

class	small

# cp /opt/charon/drivers/kgpsa/ppt_kgpsa.ko /lib/modules/3.10.9-200.fc20.x86_64/kernel/drivers/scsi/

The

The particular path may be different, depending on the kernel version and Linux distribution.

3

Enable auto load of the module:

# echo ppt_kgpsa > /etc/modules-load.d/ppt_kgpsa.conf

4

Regenerate new "initramfs" image with "mkinitrd":

# mkinitrd -f /boot/initramfs-3.10.9-200.fc20.x86_64.img 3.10.9-200.fc20.x86_64

The particular path may be different, depending on the kernel version and Linux distribution.

...

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

Div

class	pagebreak

...

Command	Description
`fc rescan {/verbose}`	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).
`fc show {adapter \| port \| device}`	Displays corresponding part of volatile FC database.
`fc set {boot \| dump} udid <X>`	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. Please note: Only right part of the displayed WWID is used for specification, for example: `P00>>>fc res` `polling for units on kgpsa0, slot 2, bus 0, hose 0 ...` `pga0.0.0.2.0 PGA0 F/W Rev 2.72A2` `WWN 1000-0000-0263-0040` `fabric WWN 2003-0060-0263-0040` `directory WWN 20fc-0060-0263-0040` `port 020100 CED 8GSH 0 F88V` `WWN 5000-1fe0-0000-0bf1` `lun 0000000000000000 DEC HSG80CCL V88F` `UDID:-1 WWID:01000010:6000-1fe0-0000-0bf0-3030-3030-373f-3f3f` `lun 0000000000000100 COMPAQ RZ1ED 0000` `UDID:-1 WWID:01000010:6000-1fe0-0000-0bf0-3030-3030-3030-3030` `P00>>>fc set boot wwid 6000-1fe0-0000-0bf0-3030-3030-3030-3030`
`fc clear`	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.

...

The CHARON-AXP FC Fabric presentation mode allows to use Linux FC HBA directly. When using this mode, there is no need to load KGPSA adapter(s) as it was described before. The following syntax has to be used instead:

Example:

load kgpsa_generic_storage PGA interface="host3"

Below please find step-by-step explanation on how to configure "kgpsa_generic_storage" instance.

...

This mode is available only for CHARON-AXP on RHEL and CentOS 7.x

...

and later versions

...

.

FC HBA interfaces finding

...

# lsscsi
..
[2:0:0:0] disk ATA Hitachi HDS72101 A610 /dev/sda
[3:0:0:0] storage HP MSA CONTROLLER 7.20 -
[3:0:0:2] disk HP MSA VOLUME 7.20 /dev/sdb
...
[5:0:0:2] disk Generic- USB3.0 CRW-MS/HG 1.00 /dev/sdi
[6:0:0:0] storage HP MSA CONTROLLER 7.20 -

So the connected hosts are 3 and 6 ("MSA CONTROLLER").

...

load kgpsa_generic_storage PGA interface="0x10000090faa00a31"

...

The configuration given with port name is independent on hardware change, modules load order, etc

By host id name

load kgpsa_generic_storage PGA interface="fc_host3"

...

load kgpsa_generic_storage PGA interface="host3"

...

The configuration given with host id name might change on hardware change, modules load order, etc

Include Page

	KBCOMMON:KB-GoToTop
	KBCOMMON:KB-GoToTop

...

Name of FC, SCSI host or adapter's port/node name, defining a connection to Linux FC HBA, for example:

Mapping	Description
fc_host6	Emulation over Linux SG (FC) host 6
host6	Emulation over Linux SG (FC) host 6
2000-0000-C923-EA51	Emulation over Linux SG (FC) host given with port/node name
0x20000000C923EA51	Emulation over Linux SG (FC) host given with port/node name
wwn-0x20000000C923EA51	Emulation over Linux SG (FC) host given with port/node name

Example:

load kgpsa_generic_storage PGA interface="host3"

...

I/O model is used for request processing.

...

This parameter is needed for debugging puproses only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Value	Description
sync	synchronous
async	asynchronous (default)

...

The port name in format: %04x-%04x-%04x-%04x. Option to fake guest's port name.

...

This parameter is needed for debugging puproses only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Example:

load kgpsa_generic_storage PGA port_name=2000-0000-C923-EA51

...

The node name in format: %04x-%04x-%04x-%04x. Option to fake guest's node name.

...

This parameter is needed for debugging puproses only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Example:

load kgpsa_generic_storage PGA node_name=2000-0000-C923-EA51

...

The list of the LUNs to be excluded. If empty (default), nothing is excluded.

No multi line is possible for this parameter; the maximum number of symbols inside the double quotes is 255. Use "lun_include" parameter instead if a lot of LUNs must be excluded to specify only the included LUNs.

Example:

Div

class	small

load kgpsa_generic_storage PGA lun_exclude="6008-05F3-0005-2950-C758-BCC2-E88B-0007,6008-05F3-0005-2950-8B03-E26B-E231-0005"

Please note

...

: lun_exclude parameter cannot exclude storage mapped to LUN 0 because of its special function.

lun_include

The list of the LUNs to be included. If empty (default), all LUNs are included.

No Please note: no multi line is possible for this parameter; the maximum number of symbols inside the double quotes is 255. Use "lun_exclude" parameter instead if a lot of LUNs must be included to specify only the excluded LUNs.

Example:

Div

class	small

load kgpsa_generic_storage PGA lun_include="6008-05F3-0005-2950-C758-BCC2-E88B-0007,6008-05F3-0005-2950-8B03-E26B-E231-0005"

scsi_version

This approach of FC emulation downgrades all attached devices to the specifically defined version of SCSI. This is done to make legacy guest operating systems happy with attached modern devices.

Value (ANSI SCSI version)	Description
any	Any version
v1	SCSI-1
v2	SCSI-2
v3	SCSI-3
v3_SPC1	SCSI-3, primary command level 1
v3_SPC2	SCSI-3, primary command level 2 (default)
v3_SPC3	SCSI-3, primary command level 3
v3_SPC4	SCSI-3, primary command level 4

Refer Refer to your guest OS documentation for more details and public resources for general specification of SCSI.

...

A fake device id (if not "lp8000" is needed), the default is "0xF800" ("lp8000").

...

This parameter is needed for some specific cases only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Example:

load kgpsa_generic_storage PGA device_id=0xFA00

...

A fake vendor id (if not "lp8000" is needed), the default is "0x10DF" ("lp8000").

...

This parameter is needed for some specific cases only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Example:

load kgpsa_generic_storage PGA vendor_id=0x10EA

...

A fake revision id (if not "lp8000" is needed), the default is "0x02" ("lp8000").

...

This parameter is needed for some specific cases only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Example:

load kgpsa_generic_storage PGA revision_id=0x01

...

Value	Description
false	Responses delivered to the emulated KGPSA card in order they were submitted to Linux. This is the default value.
true	Responses delivered to the emulated KGPSA card in order they were completed by Linux

...

This parameter is needed for some specific cases only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Example:

load kgpsa_generic_storage PGA scsi_serialize_io = true

...

Value	Description
unlimited	Linux SG I/O applies limitation of 16 I/Os. Requests are submitted unless write to SG I/O fails. This is the default value.
1...16	Only the specified number of the requests are submitted in parallel.

...

This parameter is needed for some specific cases only, so it is strongly recommended not to specify any value without particular instructions from Stromasys.

Example:

load kgpsa_generic_storage PGA scsi_max_queue_depth = 1

...

Versions Compared

Old Version 75

New Version Current

Key

Configuration parameters

host_bus_location

wwid

container

media_type

removable

geometry

use_io_file_buffering

io_queue_depth

FC HBA interfaces finding

By host id name

lun_include

scsi_version

Page Comparison

Versions Compared

Old Version 75

New Version Current

Key

Configuration parameters

host_bus_location

wwid

container

media_type

removable

geometry

use_io_file_buffering

io_queue_depth

FC HBA interfaces finding

By host id name

lun_include

scsi_version