Installation of Linux on PRIMERGY RX300 S8, TX300 S8, RX350 S8 and SX350 S8


Contents

Linux drivers for PRIMERGY servers

An overview of all avaliable Linux documentation you can find here:
http://partners.ts.fujitsu.com/com/products/servers/primergy/opsys/linux
and here:
http://ts.fujitsu.com/products/standard_servers/os

An overview of all avaliable Linux readmes you can find here: http://www.fujitsu.com/fts/primergy-linux-docs.
For a more detailed description on the specifics of Linux drivers, the tool primesetup and errata kernels please have a look at the elaborate "PRIMERGY Linux Drivers Readme" document. You can find this information offline in the /Unix/Linux/Doc folder on the FUJITSU ServerView SuiteTM DVD-ROM. Here you can find the newest published version of this document: http://www.fujitsu.com/fts/primergy-linux-docs.
For a more detailed description on the specifics PRIMERGY server you find an overview here:
http://manuals.ts.fujitsu.com
and here:
http://support.ts.fujitsu.com/manuals

General hints

The ACPI states S1 and S4 are currently not supported under every Linux OS.

BIOS Configuration/Setup Utility

General BIOS setup [F2]


Released Distributions


SUSE Linux Enterprise Server 11 x86 & x86_64 (Service Pack 2 and newer)

Please read first the "Release Notes for SUSE Linux Enterprise Server 11": https://www.suse.com/releasenotes/x86_64/SUSE-SLES/11-SP4/.

NOTE
i586 and i686 Machine with more than 16 GB of Memory
Depending on the workload, i586 and i686 machines with 16GB-48GB of memory can run into instabilities. Machines with more than 48GB of memory are not supported at all. To run on such a machine, lower the memory with the mem= kernel boot option.
In such memory scenarious we strongly recommend to use a x86_64 system with 64-bit SLES 11 and run the x86 (32bit) applications on it.
Please see the "Release Notes for SUSE LINUX Enterprise Server 11".

Installation with FUJITSU drivers

Install update kernel

SUSE Patch Support Database (PSDB)

A way to update your SLES installation is to download the necessary patches and errata kernels from the SUSE Patch Support Database located at
http://support.novell.com/linux/psdb
For a first access you have to register your business product by using the 14 digits code printed on the product CD box. After registering you can select the necessary RPMs as follows: ( example for kernel patch Release:20100722)

Install these RPMs as described in the "Installation notes" on this page.
Download the kernel version you need from this page.

Install the update kernel following your Linux distributor's instructions. Use primesetup to install the required FUJITSU drivers for the update kernel before rebooting your system. If you use the Novell Partner Linux Driver Process (PLDP) it is not necessary to install the required FUJITSU drivers again after a kernel update.
You find a detailed description of the tool primesetup in the document "PRIMERGY Linux Drivers Readme" and a description of the PLDP in the document "PRIMERGY Novell PLDP README" (http://www.fujitsu.com/fts/primergy-linux-docs ).

Remote Deploy
Deployment of SUSE SLES 11 is only possible if the Mountby-Option "Device Name" is used instead of "Device ID".
During native installation the customer must set these option for every partition by hand.

Enabling the power capping functionality
To make the power meter device fully functional on PRIMERGY under SLES 11, use the kernel parameter "acpi_power_meter.force_cap_on=1".
If the sysfs files power_cap, power_cap_min, etc. are visible in sysfs, power capping is available.

Hints and restrictions

Installation using Persistent Device names
The installer uses persistent device names by default. If you plan to add additional storage devices to your system after the OS installation, we strongly recommend you use persistent device names for all storage devices.

To switch to persistent device names on a system that has already been installed, use the YaST2 partitioner. For each partition, select "Edit" and go to the "FStab Options" dialog. Any mount option except "Device name" provides you persistent device names. In addition, rerun the boot loader module in YaST to switch the bootloader to using the persistent device name. Just start the module and select "Finish" to write the new proposed configuration to disk. This needs to be done before adding new storage devices.

For further information please visit:
http://en.opensuse.org/SDB:Persistent_storage_device_names.

NOTE
Systems using storage attached to Fibre Channel host bus adapters (FC HBAs) may encounter issues during installation due to PCI device load ordering.
If you install on a system with FC HBAs with attached storage devices please double-check the disk you have selected as your boot disk.
If you install on a system with FC HBAs without attached storage devices please check the driver order in the file /etc/sysconfig/kernel after installation. The driver for your boot controller has to be the first one. Afterwards rerun /sbin/mkinitrd and do a reboot. Otherwise your system will not boot after attaching storage devices to your FC HBAs.

SNMP NOTE
The default setting for the logging of the SNMP daemon is "debug". This configuration is done via the parameter "SNMPD_LOGLEVEL" in the file /etc/sysconfig/net-snmp.
This configuration will increase the log file /var/log/net-snmpd.log.
To avoid the increasing of the log file edit the file /etc/sysconfig/net-snmp and change the logging from "d" (debug) to "n" (notice) or to "w" (warning).

Memory error handling: Disable the logging of correctable errors
It is recommended to use the kernel parameter "mce=ignore_ce" under SLES 11 SP2 and newer.
Otherwise the system may freeze if a broken DIMM continuously emits correctable error events.

Released host bus adapters

The following host bus adapters are released:

Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native driver.

For configuration and administration of the Emulex FC HBA's please use the tool OneCommandManager (OCM), which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD.


Onboard Intel RST (driver isci)

Support for internal SAS backup devices (LTOx)

For the installation of the onboard Intel SAS controller(Intel Rapid Storage Technology RST) the driver isci is needed.
Please insure that in the system BIOS the Onboard-SAS/SATA (SCU) is enabled and the Onboard SAS/SATA OpROM Intel RSTe is enabled
A SAS key has to be installed on the Motherboard to support internal SAS backup devices (LTOx).


Onboard LSI SAS/SATA SW RAID (driver megasr)

For the installation of the onboard LSI SAS/SATA SW RAID (MegaSR) controller the driver megasr is needed.

With a SAS key installed, this controller supports SATA as well as SAS disks. Without this key, only SATA disks are supported.

NOTE
LSI OPROM has to be enabled in BIOS Setup to use the onboard LSI SAS SW Raid!
Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerstartCD.

NOTE Virtualization
Running virtual machines under the KVM and XEN hypervisors is unsupported with the megasr driver 16.x and later.


FusionIO PCIe-SSD Adapter (ioDrive2) (driver iomemory-vsl)

The FusionIO PCIe-SSD Adapter cannot used as a boot device.
PCIe hot-plug is not supported.
For the installation of the FusionIO PCIe-SSD Adapters, the driver iomemory-vsl is needed. Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://ts.fujitsu.com/support/downloads.html or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native one.
Additionally several FusionIO command line tools and a GUI (ioSphere) are available for download from the FUJITSU Support web page.
After loading the iomemory-vsl driver, the devices are mapped to /dev/fioa, /dev/fiob ... etc.


Mellanox IB HCA 40Gb and IB HCA 56Gb FDR single/dual port Adapter (driver OFED)

Please read first the Mellanox_OFED_Linux_Release_Notes.


Intel IB HCA 40 Gb 1-port QLE7340 CK and Intel IB HCA 40 Gb 2-port QLE7342 CK (driver Intel OFED kit for IB devices (IFS))

During the installation of IFS with a two port HCA please select 'n' to the following question:
Single Port Mode reallocates all QLogic HCA resources to HCA Port 1. EnableQLogic HCA Single Port Mode? [y]:


Graphic Adapter NVIDIA Quadro NVS 300 (driver nvidia)

General:

This graphic card NVIDIA Quadro NVS 300 is only released for SLES 11 SP1 and above.
None of the Linux Operating Systems supports the NVIDIA NVS 300 with a native driver.
The implemented vesa driver allows the installation of the Operating System.
To benefit from the advantages and features of the NVIDIA NVS 300 graphic card, a closed source driver is required and can be installed afterwards.

FUJITSU releases a closed source driver which can be downloaded from the FUJITSU support page:
http://support.ts.fujitsu.com/download

NVIDIA releases frequently newer drivers on their support page:
http://www.nvidia.com/Download/index.aspx

The customer is welcomed to download the latest driver, NVIDIA has to offer. However these drivers will not be supported by FUJITSU.

The NVIDIA driver doesn't support the XEN kernel.

How to install the OEM driver:
First make sure you have the correct package, which corresponds to the architecture of the Linux distribution.
To install the driver, switch to runlevel 3 (enter "init 3" in a terminal).
Execute the *.run package and follow the instructions on the screen.

X-Server Configuration:
Once the OEM driver is installed, The Linux X-Server configuration tools don't support modifications regarding resolution, monitor detection, DualView.
Please use the OEM application "NVIDIA X Server Settings" which is installed with the driver package.
For example execute the command "nvidia-settings" in a shell.


Coprocessor Card Intel Xeon Phi 3120P, 5110P and 7120P (driver mpss)

The BIOS setting "Above 4G Decoding=enabled" is a mandatory setting for systems with GPGPU/Intel Xeon Phi Coprocessor cards installed.


iSCSI-Boot

iSCSI-Boot is released for SLES 11 SP1 and newer.
iSCSI-Boot is not released for for the XEN kernel.
iSCSI-Boot does not support channel bonding and/or MultiPath SW.
Kdump is not possible with iSCSI-Boot.
iSCSI-Boot is released for the Onboard-LAN controller (LOM).
uEFI iSCSI boot for SLES11 SP3 is not possible


SUSE Linux Enterprise Server 12 x86_64

Please read first the "Release Notes for SUSE Linux Enterprise Server 12": https://www.suse.com/releasenotes/x86_64/SUSE-SLES/12/.

Installation with FUJITSU drivers

Install update kernel

SUSE Patch Support Database (PSDB)

A way to update your SLES installation is to download the necessary patches and errata kernels from the SUSE Patch Support Database located at
http://download.novell.com/patch/psdb/
For a first access you have to register your business product by using the 14 digits code printed on the product CD box. After registering you can select the necessary RPMs as follows:

Install these RPMs as described in the "Installation notes" on this page.
Download the kernel version you need from this page.

Install the update kernel following your Linux distributor's instructions. Use primesetup to install the required FUJITSU drivers for the update kernel before rebooting your system. If you use the Novell Partner Linux Driver Process (PLDP) it is not necessary to install the required FUJITSU drivers again after a kernel update.
You find a detailed description of the tool primesetup in the document "PRIMERGY Linux Drivers Readme" and a description of the PLDP in the document "PRIMERGY Novell PLDP README" (http://www.fujitsu.com/fts/primergy-linux-docs ).

Hints and restrictions

NOTE Problem with SNMP and 10 Gb LAN adapter D2755
If more than one port of the 10Gb LAN controller card D2755 is in use without an Ethernet SFP+ module or without a "direct attach" cable, the snmpd hangs in a loop and doesn't answer any more questions.
That means the system can no longer be managed with ServerView.

The root couse is in a ixgbe driver problem which certain ioctl() calls delayed by more than 1s.

A useful workaround is to ensure that at most one port without SFP+ module or "direct attach" cable is running.
Optionally, one must summarize the connections to as few cards and do not install the cards that are not required.

NOTE Video configuration
The SLES 12 video driver for iRMC S3/iRMC S4 (Kronos3/4 Matrox/MGA-G200e) works in 24bpp mode.
Therefore the highest resolutions (>1440x900) aren't available under SLES 12 with the Video Redirection via the iRMC.

Workaround:
Use the kernel parameter "mgag200.preferreddepth=16"

NOTE ServerView
Please update the openssl packages to be able to connect to SVOM / Remote Connector Service with updates provided by SUSE, e.g.:

libopenssl1_0_0-1.0.1i-2.12.7637.0.PTF.902714.x86_64.rpm
openssl-1.0.1i-2.12.7637.0.PTF.902714.x86_64.rpm.

Released host bus adapters

The following host bus adapters are released:

Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native driver.

For configuration and administration of the Emulex FC HBA's please use the tool OneCommandManager (OCM), which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD.


Onboard Intel RST (driver isci)

Support for internal SAS backup devices (LTOx)

For the installation of the onboard Intel SAS controller(Intel Rapid Storage Technology RST) the driver isci is needed.
Please insure that in the system BIOS the Onboard-SAS/SATA (SCU) is enabled and the Onboard SAS/SATA OpROM Intel RSTe is enabled
A SAS key has to be installed on the Motherboard to support internal SAS backup devices (LTOx).


Onboard LSI SAS/SATA SW RAID (driver megasr)

For the installation of the onboard LSI SAS/SATA SW RAID (MegaSR) controller the driver megasr is needed.

With a SAS key installed, this controller supports SATA as well as SAS disks. Without this key, only SATA disks are supported.

NOTE
LSI OPROM has to be enabled in BIOS Setup to use the onboard LSI SAS SW Raid!
Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerstartCD.

NOTE driver update not possible
SLES 12 does not boot anymore after updating the MegaSR driver.

There are two workarounds for this problem available:
Workaround 1:
After the update, run "mkinitrd" manually.

Workaround 2:
Before the update, change /etc/zypp/zypp.conf as follows:
Replace the line
multiversion = provides:multiversion(kernel)
by
multiversion = kernel

NOTE Virtualization
Running virtual machines under the KVM and XEN hypervisors is unsupported with the megasr driver 16.x and later.


Mellanox IB HCA 40Gb and IB HCA 56Gb FDR single/dual port Adapter (driver OFED)

Please read first the Mellanox_OFED_Linux_Release_Notes.


Coprocessor Card Intel Xeon Phi 3120P, 5110P and 7120P (driver mpss)

The BIOS setting "Above 4G Decoding=enabled" is a mandatory setting for systems with GPGPU/Intel Xeon Phi Coprocessor cards installed.


iSCSI-Boot

iSCSI-Boot is released for SLES 12.
iSCSI-Boot is not released for for the XEN kernel.
iSCSI-Boot does not support channel bonding and/or MultiPath SW.
Kdump is not possible with iSCSI-Boot.
iSCSI-Boot is released for the Onboard-LAN controller (LOM).


Red Hat Enterprise Linux 5 x86 & x86_64 (Update 9 and newer)

Please read first the "Release Notes for Red Hat Enterprise Linux 5": https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/.

NOTE
During the Red Hat Enterprise Linux 5 installation, it can be challenging to identify individual storage devices in system configurations that include multiple storage adapters. This is particulary true for systems containing Fibre Channel adapters, because in many instances it is desirable to install Red Hat Enterprise Linux on local storage. The Red Hat Enterprise Linux 5 installation program addresses this issue by delaying the loading of the following modules until after all other SCSI devices have been loaded:

This results in any locally-attached SCSI device names starting with /dev/sda, /dev/sdb, and so on, with the FC-attached storage following.

NOTE for RHEL 5 installation with driver megasr
If you are using an Installation Number when installing Red Hat Enterprise Linux 5 on a system with onboard SAS SCU boot controller (driver megasr), be sure to deselect the Virtualization package group during the installation. The Virtualization package group option installs the kernel-xen kernel.

Installation with FUJITSU drivers

NOTE for RHEL 5 x86
During the installation process, Anaconda will automatically choose the kernel package to be installed. The kernel selected by default does not allow Red Hat Enterprise Linux 5 to detect more than 4GB of RAM. As such, if your system has more than 4GB of RAM, you need to install the kernel-PAE variant of the kernel after installation.
Note that this does not apply when a virtual install is performed.

Install update kernel

NOTE
Red Hat and FUJITSU recommend updating the installed kernel with the latest errata kernel (patch kernel). Newer errata kernels will be released on a regular basis and should be applied.

Errata kernels for Red Hat Enterprise Linux 5 are available for registered users through the Red Hat Network located at https://access.redhat.com/.

Install the update kernel following your Linux distributor's instructions. Use primesetup to install the required FUJITSU drivers for the update kernel before rebooting your system.
For a more detailed description on the specifics of Linux drivers, the tool primesetup and errata kernels please have a look at the elaborate "PRIMERGY Linux Drivers Readme" document. You can find this information offline in the /Unix/Linux/Doc folder on the ServerView Suite TMDVD-ROM. Here you can find the newest published version of this document: http://www.fujitsu.com/fts/primergy-linux-docs.

Hints and restrictions

NOTE
There are a lot of messages from the snmpd in the /var/log/messages if the ServerView agents are installed and if the systems is monitored by a ServerView S2 frontend / ServerView Operation Manager. The number of messages can be reduced by changing the log level of the snmpd.
Two configuration files have to be corrected:
in /etc/snmp/snmpd.conf please add the line
dontLogTCPWrappersConnects 1

and
in /etc/init.d/snmpd please remove the # at the beginning of the line and the option "-a"
#OPTIONS="-Lsd -Lf /dev/null -p /var/run/snmpd.pid -a"
This line has to appear then as:
OPTIONS="-Lsd -Lf /dev/null -p /var/run/snmpd.pid"

Finally restart the SNMP-Daemon with: "service snmpd restart"

NOTE for kdump
On systems with Maxmem configurations the default configuration of the crashkernel:
crashkernel=128M@16M
does not work.

The base address should be increased to 32 nor 64 for Maxmem configurations, e.g.
crashkernel=384M@64M
The reason is that otherwise the "bootmem" memory map may overlap with the crashkernel area.
See also: https://access.redhat.com/kb/docs/DOC-33301.

NOTE for Emulex FC controller
Under heavy System Load and heavy I/O we saw disappearing FC links between Emulex FC controller and Brocade switches.

Workaround:
Set lpfc_use_msi=2.

Instructions on how to update the LPFC driver's "lpfc_use_msi" module parameter to set MSI-X interrupt mode:

To verify the value of the "lpfc_use_msi" module parameter has been set as expected do:
# cat /sys/class/scsi_host/host*/lpfc_use_msi

NOTE for kdump
Booting of 2nd kernel hangs up sporadically during kdump under high load.
This situation can be circumvented by the following workaround:
Append 8250.nr_uarts=0 to KDUMP_COMMANDLINE_APPEND= in /etc/sysconfig/kdump

Released host bus adapters

The following host bus adapters are released:

Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native driver.

For configuration and administration of the Emulex FC HBA's please use the tool OneCommandManager (OCM) and for configuration and administration of the QLogic FC HBA's please use the tool SANsurfer, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD.


Onboard Intel RST (driver isci)

Support for internal SAS backup devices (LTOx)

For the installation of the onboard Intel SAS controller(Intel Rapid Storage Technology RST) the driver isci is needed.
Please insure that in the system BIOS the Onboard-SAS/SATA (SCU) is enabled and the Onboard SAS/SATA OpROM Intel RSTe is enabled
A SAS key has to be installed on the Motherboard to support internal SAS backup devices (LTOx).


Onboard LSI SAS/SATA SW RAID (driver megasr)

For the installation of the onboard LSI SAS/SATA SW RAID (MegaSR) controller the driver megasr is needed.

With a SAS key installed, this controller supports SATA as well as SAS disks. Without this key, only SATA disks are supported.

NOTE
Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerstartCD.

For the installation of the Intel Gigabit Adapters, the driver ixgbe is needed. Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://ts.fujitsu.com/support/downloads.html or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native one.

For performance improvement the following actions are recommended:

For the installation of the Intel Gigabit Adapters, the driver ixgbe is needed. Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://ts.fujitsu.com/support/downloads.html or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native one.

For performance improvement the following actions are recommended:


FusionIO PCIe-SSD Adapter (ioDrive2) (driver iomemory-vsl)

The FusionIO PCIe-SSD Adapter cannot used as a boot device.
PCIe hot-plug is not supported.
For the installation of the FusionIO PCIe-SSD Adapters, the driver iomemory-vsl is needed. Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://ts.fujitsu.com/support/downloads.html or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native one.
Additionally several FusionIO command line tools and a GUI (ioSphere) are available for download from the FUJITSU Support web page.
After loading the iomemory-vsl driver, the devices are mapped to /dev/fioa, /dev/fiob ... etc.


Mellanox IB HCA 40Gb and IB HCA 56Gb FDR single/dual port Adapter (driver OFED)

Please read first the Mellanox_OFED_Linux_Release_Notes.

Limitation / Consideration for the CX2 IB-HCA card


Graphic Adapter NVIDIA Quadro NVS 300 (driver nvidia)

General:

This graphic card NVIDIA Quadro NVS 300 is only released for RHEL5.6 and above.
None of the Linux Operating Systems supports the NVIDIA NVS 300 with a native driver.
The implemented vesa driver allows the installation of the Operating System.
To benefit from the advantages and features of the NVIDIA NVS 300 graphic card, a closed source driver is required and can be installed afterwards.

FUJITSU releases a closed source driver which can be downloaded from the FUJITSU support page:
http://support.ts.fujitsu.com/download

NVIDIA releases frequently newer drivers on their support page:
http://www.nvidia.com/Download/index.aspx

The customer is welcomed to download the latest driver, NVIDIA has to offer. However these drivers will not be supported by FUJITSU.

The NVIDIA driver doesn't support the XEN kernel.

How to install the OEM driver:
First make sure you have the correct package, which corresponds to the architecture of the Linux distribution.
To install the driver, switch to runlevel 3 (enter "init 3" in a terminal).
Execute the *.run package and follow the instructions on the screen.

X-Server Configuration:
Once the OEM driver is installed, The Linux X-Server configuration tools don't support modifications regarding resolution, monitor detection, DualView.
Please use the OEM application "NVIDIA X Server Settings" which is installed with the driver package.
For example execute the command "nvidia-settings" in a shell.


iSCSI-Boot

iSCSI-Boot is released for RHEL 5.5 and newer.
iSCSI-Boot is not released for the XEN kernel.
iSCSI-Boot does not support channel bonding and/or MultiPath SW.
Kdump is not possible with iSCSI-Boot.
iSCSI-Boot is released for the Onboard-LAN controller (LOM).
iSCSI-Boot is released only for LOM 1/2 (eth0/eth1). This is a limitation only for RHEL 5.5 and RHEL 5.6. The problem is fixed with RHEL 5.7

It is not possible to switch from eth0 to eth1 if the network is configured with dhcp.
Workaround for RHEL 5.5 and 5.6 (eth0 --> eth1):
- create a new initrd with the following options: "mkinitrd --net-dev=eth0 --net-dev=eth1"
- change the boot port in FW
- boot with the new initrd
Workaround for RHEL 5.7:
Edit the file "/etc/sysconfig/network-scripts/ifcfg-ethx" and build a new initrd.

It is not possible to switch from eth0 to eth1 if a static network configuration is used.
Workaround for RHEL 5.5 and 5.6 (eth0 --> eth1):
- change the network configuration to DHCP
- reboot the server
- switch from eth0 to eth1 (see workaround above)
- change the network configuration from DHCP to static
Workaround for RHEL 5.7:
Edit the file "/etc/sysconfig/network-scripts/ifcfg-ethx" and build a new initrd.


Red Hat Enterprise Linux 6 x86 & x86_64 (Update 4 and newer)

Please read first the "Release Notes for Red Hat Enterprise Linux 6": https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/.

Installation with FUJITSU drivers

Install update kernel

NOTE
Red Hat and FUJITSU recommend updating the installed kernel with the latest errata kernel (patch kernel). Newer errata kernels will be released on a regular basis and should be applied.

Errata kernels for Red Hat Enterprise Linux 6 are available for registered users through the Red Hat Network located at https://access.redhat.com/.

Install the update kernel following your Linux distributor's instructions.

Hints and restrictions

NOTE memory poisoning
RHEL6 supports memory poisoning (HWPOISON, aka uncorrectable recoverable memory errors), but only with the kernel parameter "transparent_hugepage=never".

NOTE FUJITSU ServerView software
The tools BIOS ASP's, ServerView Agents and ServerViewRAID have dependencies to the 32bit versions of the packages openssl, compat-libstdc++-33 and pam.
It is not possible to choose any 32bit packages during the system installation of the 64bit version of RHEL 6.
So you have to install the packages openssl.i686, compat-libstdc++-33.i686 and pam.i686 after the system installation.

NOTE Network configuration
With the NetworkManager which is default enabled in RHEL 6 it is not possible to configure a network configuration like channel bonding or bridges. And there is no other tool to do this.
So you have to disable the Networkmanager and to configure by hand-editing the ifcfg* files.
This is a limitation for RHEL 6.
But:
If adding a new LAN Card to an already existing OS installation it's easier to make the detection via NetworkManager because it automatically detects the new HW and script files are made.

NOTE Video configuration
There is only very limited support for switching color depth and resolution under RHEL6.
The following Red Hat knowledge base articles describe the procedure to change color depth if necessary:
How to create xorg.conf:
https://access.redhat.com/knowledge/node/5263
How to change the display depth of desktop:
https://access.redhat.com/kb/docs/DOC-43178
How do I add desired display mode in Red Hat Enterprise Linux 6:
https://access.redhat.com/knowledge/solutions/86603

Using this method has disadvantages, because the resulting static Xorg configuration will prevent plug-and-play operation of the X server (e.g. adding monitors on the fly).
Because Kronos 4 offers 1600x1200 pixel only at 16bpp, and X operates at 24/32 bpp by default, 1600x1200 can only be achieved by following the above procedure to change the color depth. Because this is cumbersome for users, so it is recommended to restrict Kronos 4 support to max. 1280x1024 for RHEL6.

NOTE KDUMP configuration
Using the system-config-kdump tool is not recommended for configuring kdump, because the GUI is irritating and sometimes makes wrong settings. Hand-editing /etc/kdump.conf is easier and less error-prone.
This is a limitation for RHEL 6.

When a "raw" partition is entered in /etc/kdump.conf, kdump does write a dump to the partition but the dump is not automatically recovered at the next reboot.
When raw partitions are used for dumping, the dump must be recovered manually after reboot using "makedumpfile -R" (e.g. makedumpfile -R vmcore < /dev/sdb).

NOTE MultiBitError
After a MultiBitError during running RHEL6 x86_64, the iRMC detects an IERROR if KDUMP is enabled.
Workaround:
Add the kernel parameter "mce=off" to KDUMP_COMMANDLINE_APPEND in /etc/sysconfig/kdump.
Root cause: The kdump kernel clears the MCE status registers when it starts. This prevents the BIOS from determining the cause of the machine check event after reboot. "mce=off" disables the kernel MCE handler.

Enabling the power capping functionality
To make the power meter device fully functional on PRIMERGY under RHEL 6, use the kernel parameter "acpi_power_meter.force_cap_on=1".
If the sysfs files power_cap, power_cap_min, etc. are visible in sysfs, power capping is available.

When trying to boot from RHEL 6.4 Installation DVD, a dark screen is displayed
The problem only exists if a NVidia NVS300 is installed in PRIMERGY systems and if BIOS setting "Above 4G Decoding=enabled".

The BIOS Post is displayed correctly, but instead of getting the initial graphical Installation Boot Menu of RHEL 6.4, a dark screen is displayed.

Workaround:
1. Presss ESC when dark screen is displayed, the boot prompt is displayed then.
2. Enter "linux", then installation of RHEL6.4 starts and graphic display will be available again!

The BIOS setting "Above 4G Decoding=enabled" currently is only necessary for systems with GPGPU/Intel Xeon Phi Coprocessor cards installed.
NVidia NVS300 together with GPGPU/Intel Xeon Phi Coprocessor cards is not a preferred configuration.

Memory error handling: Disable the logging of correctable errors
It is recommended to use the kernel parameter "mce=ignore_ce" under RHEL6.4 and newer.
Otherwise the system may freeze if a broken DIMM continuously emits correctable error events.

Released host bus adapters

The following host bus adapters are released:

Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native driver.

For configuration and administration of the Emulex FC HBA's please use the tool OneCommandManager (OCM) and for configuration and administration of the QLogic FC HBA's please use the tool SANsurfer, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD.


Onboard Intel RST (driver isci)

Support for internal SAS backup devices (LTOx)

For the installation of the onboard Intel SAS controller(Intel Rapid Storage Technology RST) the driver isci is needed.
Please insure that in the system BIOS the Onboard-SAS/SATA (SCU) is enabled and the Onboard SAS/SATA OpROM Intel RSTe is enabled
A SAS key has to be installed on the Motherboard to support internal SAS backup devices (LTOx).


Onboard LSI SAS/SATA SW RAID (driver megasr)

For the installation of the onboard LSI SAS/SATA SW RAID (MegaSR) controller the driver megasr is needed.

With a SAS key installed, this controller supports SATA as well as SAS disks. Without this key, only SATA disks are supported

NOTE
Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerstartCD.

NOTE RHEL 6.3 problem with the driver megasr
The "tboot" (Trusted Boot) package under RHEL 6.3 sets the kernel parameter "intel_iommu=on" by default. This may cause problems with the megasr driver which doesn't fully support the IOMMU (this has been reported to LSI).

Workarounds:
a) deselect the "tboot" package during installation
b) add the additional boot parameter "iommu=pt" on the GRUB kernel command line at the first reboot and later in /boot/grub/menu.lst.

NOTE Virtualization
Running virtual machines under the KVM hypervisor is unsupported with the megasr driver 16.x and later.


FusionIO PCIe-SSD Adapter (ioDrive2) (driver iomemory-vsl)

The FusionIO PCIe-SSD Adapter cannot used as a boot device.
PCIe hot-plug is not supported.
For the installation of the FusionIO PCIe-SSD Adapters, the driver iomemory-vsl is needed. Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://ts.fujitsu.com/support/downloads.html or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native one.
Additionally several FusionIO command line tools and a GUI (ioSphere) are available for download from the FUJITSU Support web page.
After loading the iomemory-vsl driver, the devices are mapped to /dev/fioa, /dev/fiob ... etc.


Mellanox IB HCA 40Gb and IB HCA 56Gb FDR single/dual port Adapter (driver OFED)

Please read first the Mellanox_OFED_Linux_Release_Notes.

Limitation / Consideration for the CX2 IB-HCA card


Intel IB HCA 40 Gb 1-port QLE7340 CK and Intel IB HCA 40 Gb 2-port QLE7342 CK (driver Intel OFED kit for IB devices (IFS))

During the installation of IFS with a two port HCA please select 'n' to the following question:
Single Port Mode reallocates all QLogic HCA resources to HCA Port 1. EnableQLogic HCA Single Port Mode? [y]:


Graphic Adapter NVIDIA Quadro NVS 300 (driver nvidia)

General:

None of the Linux Operating Systems supports the NVIDIA NVS 300 with a native driver.
The implemented vesa driver allows the installation of the Operating System.
To benefit from the advantages and features of the NVIDIA NVS 300 graphic card, a closed source driver is required and can be installed afterwards.

RHEL 6 should be installed with the kernel parameter "nomodeset".
Otherwise the dmesg and /var/log/messages are filled with error messages regarding false EDID data.

FUJITSU releases a closed source driver which can be downloaded from the FUJITSU support page:
http://support.ts.fujitsu.com/download

NVIDIA releases frequently newer drivers on their support page:
http://www.nvidia.com/Download/index.aspx

The customer is welcomed to download the latest driver, NVIDIA has to offer. However these drivers will not be supported by FUJITSU.

How to install the OEM driver:
RHEL 6 is shipped with a "nouveau" driver, which has to be uninstalled, before installing the driver package.

How to uninstall the "nouveau" driver and install the OEM driver:

A detailed description can be found on the NVIDIA support page:
ftp://download.nvidia.com/XFree86/Linux-x86_64/340.58/README/commonproblems.html

X-Server Configuration:
Once the OEM driver is installed, the Linux X-Server configuration tools don't support modifications regarding resolution, monitor detection, DualView.
Please use the OEM application "NVIDIA X Server Settings" which is installed with the driver package.
For example execute the command "nvidia-settings" in a shell.


GPGPU Card NVIDIA Tesla K20m, K20Xm and K40 (driver nvidia)

RHEL 6 is shipped with a default "nouveau" driver, which has to be blacklisted before installing the driver package:


Coprocessor Card Intel Xeon Phi 3120P, 5110P and 7120P (driver mpss)

The BIOS setting "Above 4G Decoding=enabled" is a mandatory setting for systems with GPGPU/Intel Xeon Phi Coprocessor cards installed.

RHEL6.4 on IvyBridge systems is only released for an update kernel (2.6.32-358.11.1 or higher).
MPSS driver package for Intel Xeon Phi is compiled for the basic kernel (2.6.32-358) and must be recompiled for usage under any update kernel (for detailed instructions, please see MPSS ReadMe file: <MPSS-Directory>/docs/readme-en.txt)

Recompiling MPSS Host Driver


iSCSI-Boot

iSCSI-Boot is released for RHEL 6.1 and newer.
Please set the kernel parameter "ip=ibft netboot=iscsi iscsi_firmware" during the installation.
Disable I/OAT in system BIOS, it has no performance benefit anyway.
The NetworkManager has to be disabled.
iSCSI-Boot does not support channel bonding and/or MultiPath SW.
Kdump is not possible with iSCSI-Boot.
iSCSI-Boot is released for the Onboard-LAN controller (LOM).


Red Hat Enterprise Linux 7 x86_64

Please read first the "Release Notes for Red Hat Enterprise Linux 7": https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/.

Installation of RHEL 7.x
On some systems during the installation of RHEL 7.x this System Event Log (SEL) entry is created:
"Generic IPMI event: GenId '00', SensorType 'OS Boot', EventType '6F', SensorName '', EventData: 07 00 00"

This message can be ignored.

Installation with FUJITSU drivers

Install update kernel

NOTE
Red Hat and FUJITSU recommend updating the installed kernel with the latest errata kernel (patch kernel). Newer errata kernels will be released on a regular basis and should be applied.

Errata kernels for Red Hat Enterprise Linux 7 are available for registered users through the Red Hat Network located at https://access.redhat.com/.

Install the update kernel following your Linux distributor's instructions.

Hints and restrictions

NOTE Video configuration
The RHEL 7 video driver for iRMC S3/iRMC S4 (Kronos3/4 Matrox/MGA-G200e) works in 24bpp mode.
Therefore the highest resolutions (>1440x900) aren't available under RHEL 7 with the Video Redirection via the iRMC.

Workaround:
Use the kernel parameter "mgag200e.preferreddepth=16"

Released host bus adapters

The following host bus adapters are released:

Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD. If there is no driver offered on the Support web page please use the native driver.

For configuration and administration of the Emulex FC HBA's please use the tool OneCommandManager (OCM) and for configuration and administration of the QLogic FC HBA's please use the tool SANsurfer, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerView Suite DVD.


Onboard Intel RST (driver isci)

Support for internal SAS backup devices (LTOx)

For the installation of the onboard Intel SAS controller(Intel Rapid Storage Technology RST) the driver isci is needed.
Please insure that in the system BIOS the Onboard-SAS/SATA (SCU) is enabled and the Onboard SAS/SATA OpROM Intel RSTe is enabled
A SAS key has to be installed on the Motherboard to support internal SAS backup devices (LTOx).


Onboard LSI SAS/SATA SW RAID (driver megasr)

For the installation of the onboard LSI SAS/SATA SW RAID (MegaSR) controller the driver megasr is needed.

With a SAS key installed, this controller supports SATA as well as SAS disks. Without this key, only SATA disks are supported.

NOTE Virtualization
Running virtual machines under the KVM hypervisor is unsupported with the megasr driver 16.x and later.

NOTE
Please use the latest driver offered by FUJITSU, which you can find on the Support web page under http://support.ts.fujitsu.com/download or on the FUJITSU ServerstartCD.


Mellanox IB HCA 40Gb and IB HCA 56Gb FDR single/dual port Adapter (driver OFED)

Please read first the Mellanox_OFED_Linux_Release_Notes.


Intel IB HC 40 Gb 1-port QLE7340 CK and Intel IB HCA 40 Gb 2-port QLE7342 CK (driver Intel OFED kit for IB devices (IFS))

During the installation of IFS with a two port HCA please select 'n' to the following question:
Single Port Mode reallocates all QLogic HCA resources to HCA Port 1. EnableQLogic HCA Single Port Mode? [y]:


GPGPU Card NVIDIA Tesla K40 (driver nvidia)

RHEL 7 is shipped with a default "nouveau" driver, which has to be blacklisted before installing the driver package:


Coprocessor Card Intel Xeon Phi 3120P and 5110P (driver mpss)

The BIOS setting "Above 4G Decoding=enabled" is a mandatory setting for systems with GPGPU/Intel Xeon Phi Coprocessor cards installed.


iSCSI-Boot

iSCSI-Boot is released for RHEL 7.
The NetworkManager has to be disabled.
iSCSI-Boot does not support channel bonding and/or MultiPath SW.
Kdump is not possible with iSCSI-Boot.
iSCSI-Boot is released for the Onboard-LAN controller (LOM).


Oracle Virtual Machine 3.2.2 (and newer) and Oracle Linux 6 (Update 4 and newer) (x86_64)

Please read first the "Oracle Virtual Machine 3 Release Notes" resp. the "Oracle Linux 6 Release Notes". You can find them here: http://docs.oracle.com/.

Install update kernel

NOTE
Oracle and FUJITSU recommend updating the installed kernel with the latest errata kernel (patch kernel). Newer errata kernels will be released on a regular basis and should be applied.

Errata kernels for Oracle VM and Oracle Linux are available through the Oracle public yum repository located at http://public-yum.oracle.com/.

Install the update kernel following your Linux distributor's instructions.

Hints and restrictions

NOTE UEFI
UEFI boot is not supported by Oracle VM 3.x

NOTE TPM
TPM is not yet released with Oracle VM 3.x or Oracle Linux 6.x

NOTE SCU
The proprietary LSI MegaSR RAID stack is not supported with Oracle VM and Oracle Linux. Thus, the OPROM of the SCU SAS controller has to be switched to the Intel OPROM in the system BIOS to support the native OS driver (sci). Note that this is a nonRAID driver. RAID functionality has to be added by the Linux md driver if desired. If you have more than 1 disk attached to the SCU and these disks were part of a RAID before, please make sure that the RAID configuration is deleted on all disks.

NOTE KDUMP
When configuring the crash kernel for UEK, only the standard crash kernel settings (i.e.: crashkernel=256M@64M) are supported. The new settings used by the Red Hat compatible kernel (i.e.: crashkernel=auto) are not supported and cause the kdump service to fail to start.

Released host bus adapters

The following host bus adapters are released:


Oracle Linux 7 (x86_64)

Please read first the "Oracle Linux 7 Release Notes". You can find them here: http://docs.oracle.com/.

Install update kernel

NOTE
Oracle and FUJITSU recommend updating the installed kernel with the latest errata kernel (patch kernel). Newer errata kernels will be released on a regular basis and should be applied.

Errata kernels for Oracle VM and Oracle Linux are available through the Oracle public yum repository located at http://public-yum.oracle.com/.

Install the update kernel following your Linux distributor's instructions.

Hints and restrictions

NOTE Installation
Please see also the hints and restrictions for Red Hat Enterprise Linux 7.

NOTE TPM
TPM is not yet released with Oracle Linux 7.x

NOTE SCU
The proprietary LSI MegaSR RAID stack is not supported with Oracle VM and Oracle Linux. Thus, the OPROM of the SCU SAS controller has to be switched to the Intel OPROM in the system BIOS to support the native OS driver (sci). Note that this is a nonRAID driver. RAID functionality has to be added by the Linux md driver if desired. If you have more than 1 disk attached to the SCU and these disks were part of a RAID before, please make sure that the RAID configuration is deleted on all disks.

Released host bus adapters

The following host bus adapters are released:


XEN with RHEL 5

XEN is only released on systems with more than 4 Gigabyte main memory.

SATA SW RAID (driver: megasr) is not supported with XEN.

If you are planning to install any fully virtualized guest OS, please check, if your system supports this mode. If it is supported you must enable the VT mode in BIOS setup. After this change you also have to power down the system and power it up again. Just rebooting is not sufficient on most systems to be able to install the fully virtualized guest OS.

Hints and restrictions

Wake on LAN with RHEL 5.9 and newer
It is not possible to poweron a system by "Wake on LAN" via an Intel LAN-Controller with a driver e1000, e1000e or igb if the XEN network bridge is configured for the LAN port you want to use.

Workaround:
Stop the network-bridge with the command
"/etc/xen/scripts/network-bridge stop" before poweroff the system.


XEN with SUSE SLES 11

XEN is only released on systems with more than 4 Gigabyte main memory.

SATA SW RAID (driver megasr) is supported with SLES 11 XEN.

If you are planning to install any fully virtualized guest OS, please check, if your system supports this mode. If it is supported you must enable the VT mode in BIOS setup. After this change you also have to power down the system and power it up again. Just rebooting is not sufficient on most systems to be able to install the fully virtualized guest OS.

Hints and restrictions

Kdump with SLES 11 XEN
The kdump with SLES 11 XEN works only after changing the default value of the parameter "KDUMP_DUMPFORMAT".
Please change the value of the parameter from "compressed" to "ELF".

The parameter can be changed in the config file /etc/sysconfig/kdump or with YAST/kdump/Dump Filtering.

Kdump with SLES 11 SP3 XEN
The kdump with SLES 11 SP3 XEN works only after changing the default value of the parameter "KDUMP_DUMPLEVEL".
Please change the value of the parameter from "31" to "0".

The parameter can be changed in the config file /etc/sysconfig/kdump or with YAST/kdump/Dump Filtering.

In addition, the parameter "KDUMP_DUMPFORMAT" needs to be changed, please see above.

Kdump with SLES 11 XEN: system hangs
Sometimes it happens that a kdump is not written (local or via network).
If this issue occurs the system hangs and a manual reset is necessary.

Workaround:
The problem can be solved by setting the "nox2apic" parameter in /etc/sysconfig/kdump.

/etc/sysconfig/kdump:
KDUMP_COMMAND_LINE_APPEND="nox2apic"

CPU scaling with SLES 11 XEN
Cpufreq under Xen 3.3 isn't done by Dom0 but by the Hypervisor itself, using the xen command line option "cpufreq=xen". This option is appended to the "kernel" line in /boot/grub/menu.lst:

kernel /xen.gz-3.3.0 cpufreq=xen

Up from SLES 11 SP3 with Xen 4.2 the parameter "cpufreq=xen" is no longer required.

Cpufreq Control is done with the "xenpm" tool which is part of the xen-tools package under SLES 11.

Memory support for dom0 with SLES 11 XEN
Under SLES11, there is a general limit for Dom0 memory of 500GB.
Please see:
http://www.novell.com/docrep/2009/09/SUSE_Linux_Enterprise_Server_Virtualization_Technology_Support_en.pdf.

.


© FUJITSU
All rights reserved.
LINUX is a trademark of Linus Torvalds.
All hardware and software names are trademarks of their respective manufactures.
Linux_Readme_RXTX300S8_v2_8.html

Last update: June 20, 2016