How to Install OVN Host Driver for Solaris 10 Update 11

Asset ID:	1-71-1574329.1
Update Date:	2017-07-11
Keywords:

Solution Type Technical Instruction Sure

Solution 1574329.1 : How to Install OVN Host Driver for Solaris 10 Update 11

Applies to:

Oracle Fabric Interconnect F1-15 - Version All Versions and later
Oracle Fabric Interconnect F1-4 - Version All Versions and later
Information in this document applies to any platform.

Goal

This document provides brief steps on how to Install solaris host drivers 5.1.x for Solairs 10 update 11 in OVN

Solution

The installation procedure requires the following:

• The Solaris hosts must have at least one dual-port Oracle ConnectX2 QDR HCA.
• The HCA installed in the host must be running the correct minimum version of firmware for the corresponding HCA.
• Root permissions on the Solaris host.
• The server must have Solaris 10 Update 11 successfully installed and running.
• One server reboot after the patches are installed.

Details

Installation Procedure

To install the Solaris host drivers, follow this procedure:

Step 1 Locate the Oracle host software as documented in Downloading Supported Drivers on page 5 in release notes.

Step 2 Copy the drivers (both the kernel and userland packages) onto the server. These packages can go anywhere in the file system (for example, the root, /tmp or /ORCLovn).

Step 3 Install the kernel package on the Solaris host by issuing the pkgadd command.

Note : By default, the pkgadd command runs in interactive mode, so it displays prompts that will need to be answered. Be aware that in default mode, the command will not run to completion without user intervention. However, can run the pkgadd command in non-interactive mode by specifying the -n argument. Non-interactive mode assumes “yes” to prompts, thereby removing the need for customer intervention.

These examples show running the pkgadd command in default mode (interactive).

-bash-3.00> pkgadd -d ORCLovnk_5.1.1_808.i386.pkg
The following packages are available:
1 ORCLovnk Oracle Virtual Network drivers
(i386) 5.1.1_808
Select package(s) you wish to process (or ‘all’ to process
all packages). (default: all) [?,??,q]:
Processing package instance <XSIGviok> from </ORCLovnk_5.1.1_808.i386.pkg>
Oracle Virtual Network drivers(i386) 5.1.1_808
/*

* (C) 2012, 2103 Oracle Inc. All rights reserved. This material may not be
* reproduced, displayed, modified or distributed without the express prior
* written permission of the copyright holder.
*/
## Executing checkinstall script.
Using </> as the package base directory.
## Processing package information.
## Processing system information.
5 package pathnames are already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of <ORCLovnk> [y,n,?] y
Installing Oracle Virtual Network drivers as <ORCLovnk>
## Executing preinstall script.
## Installing part 1 of 1.
/
Installation of <ORCLovnk> was successful.
-bash-3.00>

Step 4 When the kernel package is successfully installed, install the userland package by issuing the pkgadd command.

-bash-3.00> pkgadd -d ORCLovnu_5.1.1_808.i386.pkg

The following packages are available:
1 ORCLovnu Oracle Virtual Networking Applications
(i386) 5.1.1_808
Select package(s) you wish to process (or ‘all’ to process
all packages). (default: all) [?,??,q]:
Processing package instance <XSIGviou> from </ORCLovnu_5.1.1_808.i386.pkg>
Oracle Virtual Network Applications(i386) 5.1.1_808
/*
* (C) 2012, 2013 Oracle Inc. All rights reserved. This material may not be
* reproduced, displayed, modified or distributed without the express prior
* written permission of the copyright holder.
*/
## Executing checkinstall script.
Using </> as the package base directory.
## Processing package information.
## Processing system information.
1 package pathname is already properly installed.
## Verifying package dependencies.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of <ORCLovnu> [y,n,?] y
Installing Oracle Virtual Networking Applications as <ORCLovnu>

## Executing preinstall script.
## Installing part 1 of 1.
/opt/ORCLovn/bin/cxflash
/opt/ORCLovn/bin/xsadmd
/opt/ORCLovn/bin/xsigo-support <symbolic-link>
/opt/ORCLovn/hca-firmware/etc/supported_hca.txt
/opt/ORCLovn/hca-firmware/prebuilt-firmware/firmware.tar.gz
/opt/ORCLovn/manifest/xsadmd/xml
/opt/ORCLovn/scripts/xsadmd
/opt/ORCLovn/scripts/xsadmd_lib.sh
/opt/ORCLovn/scripts/xsigo-support.sh
/opt/ORCLovn/scripts/xsmaster.sh
/opt/ORCLovn/scripts/xsadmd_lib.sh
/opt/ORCLovn/scripts/xsvnic.sh
/opt/ORCLovn/xsadmd.conf
[ verifying class <none>]
## Executing postinstall script.
Installation of <ORCLovnu> was successful.
-bash-3.00>

Step 5 Verify that both the kernel and userland host drivers are installed by issuing the pkginfo command while grepping for “ORCLovn” which is part of the driver file name.

For example:

> pkginfo | grep -i ORCLovn
system ORCLovnk Oracle Virtual Network drivers
application ORCLovnu Oracle Virtual Network Applications

Step 6 As an option, can also display information about each driver package that was installed.

For Example:

> pkginfo -l ORCLovnk
PKGINST:        ORCLovnk
NAME:             Oracle Virtual Network drivers
CATEGORY:     system
ARCH:            i386
VERSION:       5.1.1_808
BASEDIR:        /
VENDOR:        Oracle Inc.
DESC:            Oracle Virtual Adapter Drivers
PSTAMP:        solbuild0120090918093550
INSTDATE:     Sep 18 2009 10:05
HOTLINE:       Please contact Oracle representative
EMAIL:           See Oracle Support Website
STATUS:         completely installed
FILES:           12 installed pathnames
                     5 shared pathnames
                     5 directories
                     4 executables
                     4080 blocks used (approx)

> pkginfo -l ORCLovnu
PKGINST:       ORCLovnu
NAME:           Oracle Virtual Network drivers
CATEGORY:   application
ARCH:          i386
VERSION:     5.1.1_808
BASEDIR:      /
VENDOR:      Oracle Inc.
DESC:          Oracle Virtual Networking Applications
PSTAMP:      solbuild0120090918093551

INSTDATE:    Sep 18 2009 10:05
HOTLINE:     Please contact Oracle representative
EMAIL:         See Oracle Support Website
STATUS:       completely installed
FILES:           21 installed pathnames
                     1 shared pathnames
                     8 directories
                     8 executables
                9668 blocks used (approx)

Step 7 Verify that all cabling is complete and correct. If the physical layer connectivity is not functional, the Oracle nodes might not come online correctly.

Step 8 When all the patches and host drivers are installed, reboot the server:

> reboot -- -rv

Note : The first time you install the OVN Solaris host drivers (as in this example) you will need to use the reboot -- -rv command. The reboot -- -rv command is also required if you install a new HCA in the Sun physical host server. In all other situations, the standard reboot command (without the -- -rv qualifiers) is valid.

Step 9 When the server finishes rebooting, log back in and confirm that the Oracle service is running:

> svcs xsadmd

STATE STIME FMRI
online 11:10:35 svc:/application/xsadmd:default

Step 10 Display all the installed Oracle software and dependencies by issuing the modinfo command and grepping for “xs” to find the Oracle installed software components.

For example:

> modinfo | grep xs
185 fffffffff60da000        3af8 227       1     xstn (Xsigo Transport nexus driver v1)
186 fffffffff60de000        fdf8       -      1     xstl (Xsigo Transport services v0.2)
190 fffffffff611d000        15858 229     1     xsvhba (Xsigo Virtual HBA)
196 fffffffff5def460         f38 107         1     xsvc (xserver svc)

Step 11 Verify that the attachment points and XSTN nodes are up and running on the Solaris host:
              • the host’s HCA is up and connected.
              • the host’s IB fabric is running.
              • the InfiniBand port link is connected to the Fabric Interconnect. Oracle uses the InfiniBand port as transport to the server:
              • related IB services are connected.

The bold text in the following example highlights the HCA and IB functionality that should be verified.

> cfgadm -a

Ap_Id                                                                      Type                 Receptacle                      Occupant                   Condition
c0                                                                        scsi-bus             connected                       configured                 unknown
c0::dsk/c0t0d0                                                            disk                  connected                       configured                  unknown
hca:24E89097FEE21C                                                        IB-HCA                connected                       configured                         ok
ib                                                                        IB-Fabric            connected                        configured                         ok
ib::24E89097FEE21D,ffff,ipib                                              IB-VPPA             connected                         configured                        ok
ib::24E89097FEE21D,ffff,xstn                                              IB-VPPA            connected                          configured                       ok

ib::24E89097FEE21E,ffff,ipib                                              IB-VPPA             connected                         configured                       ok
ib::24E89097FEE21E,ffff,xstn                                              IB-VPPA             connected                         configured                       ok
ib::daplt,0                                                               IB-PSEUDO        connected                               configured                        ok
ib::rdsib,0                                                               IB-PSEUDO        connected                              configured                         ok
ib::rpcib,0                                                               IB-PSEUDO         connected                              configured                  ok
ib::sdpib,0                                                               IB-PSEUDO         connected                               configured                        ok
usb0/1                                                                  unknown             empty                           unconfigured                  ok
usb0/2                                                                  unknown             empty                           unconfigured                  ok
usb1/1                                                                  unknown             empty                           unconfigured                  ok
usb1/2                                                                  unknown             empty                           unconfigured                  ok
usb2/1                                                                  unknown             empty                           unconfigured                  ok
usb2/2 unknown empty unconfigured ok

References

http://docs.oracle.com/cd/E38500_01/pdf/E17740.pdf

Attachments

This solution has no attachment