.\" .\" *********************************************************************
.\" .\" *                                                                   *
.\" .\" *             Copyright 2015-2018, Intel Corporation                *
.\" .\" *                                                                   *
.\" .\" *                       All Rights Reserved.                        *
.\" .\" *                                                                   *
.\" .\" *********************************************************************

.TH opaconfig 1 "Intel Corporation" "Copyright(C) 2015\-2018" "Master map: IFSFFCLIRG (Man Page)" 
.SH NAME
opaconfig

.NL

.PP

\fB(Switch and Host)\fR
Configures the Intel(R) Omni-Path Software through command line interface or TUI menus.
.SH Syntax
.NL
opaconfig [-r \fIroot\fR] [-G] [-v|-vv] [-u|-s|-e \fIcomp\fR] [-E \fIcomp\fR] [-D \fIcomp\fR]
.br
[--user\(ulqueries|--no\(uluser\(ulqueries] [--answer \fIkeyword=value\fR]
.PP
or
.br
opaconfig -C
.PP
or
.br
opaconfig -V
.SH Options
.NL

.TP 10
No option
.NL
Starts the Intel(R) Omni-Path Software TUI.

.TP 10
--help 
.NL
Produces full help text.

.TP 10
-r \fIroot\fR 
.NL
Specifies alternate root directory. Default is / .

.TP 10
-G 
.NL
Installs GPU Direct components (must have NVidia drivers installed).

.TP 10
-v 
.NL
Specifies verbose logging.

.TP 10
-vv 
.NL
Specifies very verbose debug logging.

.TP 10
-u 
.NL
Uninstalls all ULPs and drivers with default options.

.TP 10
-s 
.NL
Enables autostart for all installed drivers.

.TP 10
-e \fIcomp\fR 
.NL
Uninstalls the given component with default options. This option can appear more than once on the command line.

.TP 10
-E \fIcomp\fR 
.NL
Enables autostart of a given component. This option can appear with -D or more than once on the command line.

.TP 10
-D \fIcomp\fR 
.NL
Disables autostart of given component. This option can appear with -E or more than once on the command line.

.TP 10
-C 
.NL
Outputs list of supported components.

.IP

\fBNOTE:\fR
Supported components may vary according to OS. Refer to
\fIIntel(R) Omni-Path Fabric Software Installation Guide\fR

, OS RPMs Installation Prerequisites for the list of components by supported OS.
.IP
Supported components include: opa\(ulstack mpi\(ulselector intel\(ulhfi oftools opa\(ulstack\(uldev delta\(ulipoib opamgt\(ulsdk mvapich2\(ulgcc\(ulhfi mvapich2\(ulintel\(ulhfi openmpi\(ulgcc\(ulhfi openmpi\(ulintel\(ulhfi openmpi\(ulgcc\(ulcuda\(ulhfi sandiashmem mvapich2\(ulgcc openmpi\(ulgcc mpisrc delta\(uldebug 
.IP
Supported components when using command on a Management Node with Intel(R) Omni-Path Fabric Suite installed, include: fastfabric opafm 
.IP
Supported component name aliases include: opa ipoib mpi psm\(ulmpi verbs\(ulmpi pgas opadev 
.IP
Additional component names allowed for -E and -D options: ibacm rdma\(ulndd delta\(ulsrp delta\(ulsrpt
.TP 10
-V 
.NL
Outputs version.

.TP 10
--user\(ulqueries 
.NL
Permits non-root users to query the fabric (Default).

.TP 10
--no\(uluser\(ulqueries 
.NL
Prohibits non-root users from querying the fabric.

.TP 10
--answer \fIkeyword=value\fR 
.NL
Provides an answer to a question that may occur during the operation. Answers to questions not asked are ignored. Invalid answers result in prompting for interactive installs, or using default options for non-interactive installs.

.IP

\fBPossible Questions\fR
(\fIkeyword=value\fR):
.RS
.TP 10

.sp
UserQueries 
Allow non-root users to access the UMAD interface?

.TP 10
.BR

.PP

.B NOTE:
Allowing access to UMAD device files may present a security risk. However, this allows tools such as opasaquery and opaportinfo to be used by non-root users.

.RE

.RS
.TP 10

.sp
IrqBalance 
Set IrqBalance to Exact?

.RE

.SH Example 
.NL
# opaconfig
.br
Intel OPA \fIx.x.x.x.x\fR Software
.br

.br
   1) Show Installed Software
.br
   2) Reconfigure OFED IP over IB
.br
   3) Reconfigure Driver Autostart
.br
   4) Generate Supporting Information for Problem Report
.br
   5) FastFabric (Host/Chassis/Switch Setup/Admin)
.br
   6) Uninstall Software
.br

.br
   X) Exit