From b2ecf5f144854837c5718a9d66ec113517a6043a Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Wed, 5 Feb 2020 17:02:52 -0800 Subject: [PATCH] Add a workarounds section (#1016) Add a section for known workarounds to NVIDIA driver issues --- source/_figures/nvidia/nvidia-gnome-crash.png | Bin 0 -> 45152 bytes source/tutorials/nvidia.rst | 156 +++++++++++++++--- 2 files changed, 133 insertions(+), 23 deletions(-) create mode 100644 source/_figures/nvidia/nvidia-gnome-crash.png diff --git a/source/_figures/nvidia/nvidia-gnome-crash.png b/source/_figures/nvidia/nvidia-gnome-crash.png new file mode 100644 index 0000000000000000000000000000000000000000..0e11eb9521ade34903f7ee8d6300214fc59de55c GIT binary patch literal 45152 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�yDDRj9z4(UT0OYIk1*gDmfjuCYV0OvmXCsU!^)Gsc@_RojyYj!XJrcBj%y<<~nV^44BM$4l;A zArYw@cz%Xh*~#@U8G%{+oZ8?3r{H!0IS*!D?VeSi(vm9knAS8?W?Ld=1mMko$4v{O z{{8vx8Mr%;EQFsHL_a+q%S!76S>_0k$=vd|=PO4BSWMs`;$?Zo)*D8mH5xssj1*#a zwX|jNViZ=6y%JEH8L=eF)@e>!3a6%>NOiiJ^UacHO}M`3{QnVl2fA$=K@f)Z{!iDI zNfY~N>Y6Yy`twl+gg}vG>TWsOn_V7f=smwGK=9QcK`~&xd7-L1y^-E3o%Ru^9`qkp zMeD}5Q?p;-oqiFSXM`KiO0B(Yxwz_!)~K&Q?9p&lrte0U zYu?pGS(<#=pb2%EleHa}x1!vh4oD6u_@m}QJCO`y7cj4#ZHc(lR$m$(>ein zuzl9U0Tnb~-?`{D%~lA3W=gL{yn*;VCly;P5)>~Z_O3)@A}e{=0cCdE^e(bx+E@M9 zEIUYlC;>V(cS99}|SZuEK5)-iG~XXUCK{-j>ILhq51L3Iq50JK6z#7gDPM z`lQ^qd%avwNZE?QlNi-ZX}Q0z;x;Au94BFaXm9d*6ZQmPl6Kw6Eeullj)Tp6mJ7C6 z4u57Q86k$G!+E7hg0lrVSiiT2U6+JK zPUXpsZ!D55tV{qeOqK|QxS?GAzH0;Bp%9anJRLy4NIm2GMCQn3{C_sx>c1$hRES45 z8Y8UU{$B}U%k@{Ta^_&J$>|kSmeEggyTu^;n^I~)vze>MAEup2b*az02+Q5&sN*a0 zlRH$J&buM5IYGnk+Ks!g4%($E_t5V5Jr1wG&QP5WY&NBav=2^~gh+|Lce_ehPkV&d zi$nXJPsJ`(7v!XivCijnko2>h)?I5Gb#|I%fANtew?nV`wVQ>ug7jGX0j2p3me;P= z?aZ_}1_5lCSH3};XJ9awA>9|!w8Iw2ypr!AX$qK@4UVA7qHC<5xI@-f0(>`-6cR31 zyp-)NLX0lt!O(}{5zba!Lc-nLQ+vkJTwGwaf>m~J_H*i)L=$us7`1GFX*O3`<40Ic z)K|C8$(BUlfc4yl{gTI(f^|1O@>lfayz-=>{3VR*MaG6v#n83S6mt5}y0>;snUw8V z?Z(kRDS@&ThdunRDRA$@w#3cL-mV?ZZlq1{%ZcbIif}dbR-Z zkKN?X`+rhIIAv?%ZYUN@MT-D@BwQw0)a*A&xn}w_n8yO*ZrhfHoOH9)LiUt-_+PK? z*FRh^iP5VL-$GGo z-@DV!IP7DIk41I2m;R~gaNe`9+icJOo?=kft${NJ+1Q$HgrZkgbCP>Fj;+nUjG-FF zd8Mq7KbS!MjnQl>L6qcFWpcul;%$yU1Ir-^*KFv2@*3v54*Xtd7 z>@g(q^WRa`r`xmXE`!F_VR-z%LZMHOkH1&jmVU`uFUqqU-|E{FjRk*5~jaCN^uRkJeG5H@y|p)G#~Nx z7Uj>frT<48)9148a!vOO6X%-UoQP`(Qq-sfxM_39c8x=zJ(GkV)JpY%fL7ZPxAS0Y zfywGxm8px6!QydXf3u%#>Qg^kNR)%F(SOlZ>3zzc_q|T(7PZ|(KxQ7~lzSgg=tHF% zu=;eW@9I_Ry0zMN^{*uK%}95uil`KMrf2Yna-KFAN3%oA+_U9od<>~ggyY$Cc=)l; z%4s+eW~AMB-@RxP*~<2Y3z|BL<2uV7WoUT&UXf0zYQhft46PLU?&kGNC8P!U02B

wpXg^X-NM4ypu-`{A*`CPXrF_ zpz`G%Q(iA9gBwC!72s5Lgmgx(T|JL$2Kz(roKwSEh5`q2hFLmjWM?3m>(?$suv|W- zhWzT2LT!!|6n}%R=!IG;qVtV|@*t6Y^x=Dei1i@@dg=(Ab*L+?X|%Kz2o$I=i*Xp zqH*JP;s~LViK=V`XX9i)(i!HQWf_c!(kqKIls$Hp4F%+pND?2wUbqyD)4DJPH!47J zaznHC;uB9irtNf+d#1dYpz&ccIsIe}XpB-FYw(ZXf64x${=SWVhhp;5OV68G;6|*0 ziS>ZPK>?O8TO7KHxPkOy4Is!tbSeE(qOw2}FSH>7}C zUW6A@D!ggaTEoWcAUsO>kVnN7q0oqz6p`;T;I(Lw z;8h{&0BivZdE|B7iUg$r12_XI5F6=J#9HmcU+u|0#2X|;kKPPjn;lO<<+5)whBX(^ zj-jsRLP*Pq3ayQ)lf?tf5)1#4M;4Xrg>lBL zLK)Oh+Tr-I13ZPIOCA;!C$ZFGHe9n7+pk-7ZWd8qZ``=XURdSVuU*Oa(LYH{cL&3j zd%?yqnaAq8;vLkp(t(atbYr#BfbZ)&t#78Y*}g1@nOSNY9`o=lGc#&P%*@Qpj8`+0nBg16bG??j+xy-^ zPjyvgWWXPhSzUkN&%$4d%_=$$Vw*u>ir5ErjLWe~`KoW<-iWktsA9H56NYsMV=}TD z?BLGn(c>wQPj`rP+zt1pYp-9sfYTB$4F(%G?9;nvO?Ab%aidd{Cb(PMm!E|<2jLfY zG%k+Ki4(^mu|jzci8uHEMWkb0g}p{C+_~1uz*47x124 z+nmp9hYlI+5@bHyR}TO1gLknEkl#V?!)G!n#5+izL6UTYv=2mn{qe`itmyz(`2P35 z=URk6r~&x|wqN&0{w+(#I$u8T)2G*j3FDD=p-x2~NFf2ZrT~Jyxm;eBF&s8T?ug-w zK55BYx6ePnXb<5tF@mrJ*)c9AWPu|`49}!f42?Sw$t6SJ zumbwfLBOLnb1m`SfB$VZZEb176V+|g(WCnG>CL8N$Bsgx$EF=^U$}F=MZ8dKn&w`X zOPdjO;b_8wg-=P1=^Wiq@HLu#*uA6u3xaVTIe_PkcrY{>5)KGD$6!Px7J2oRm#kjH zA|pn0TO>+3kcu1Lpt)Qc5Eys-_%XwV4Q6)~Nsjmy1kk*b5xS$a692WeHCTVgj2THM zD4t*q4ybSgDw4@KYO&u<5dUOzV}sI&x@CBU02VsDru+kWE+ujZ-E|NO z;wCewOE_*reI522Z|nmXOxv}!RR~lue~Arg#L9v*az0-)1YSc`k7N?uZBc(pwom|~VeIn` zKW{Syj)EoK`L2~xR49B-_Yu{&WRB{OYj$%41pghAD zr0EM%L%C5+!Ta%}?cKXW6dgZ$@cPvYc-9b>(F3Rr-WPD7wSi_tgnaAG*ZG!#5OSFy z)>Br%yvSMc0$LzoXM;*;2-(Z)#?7(u-0+F)DY7y>8ErcN$v6EWeXKXQYn-`V|fW8GXvaDLqwJKJw zLJTD&4R6`9-Yi~w^~KtnN{Zt7`~j^ihCYr>+w6-+fA;Jd)24Nplxt)9SfSO(rlzDq zhfi!ZNa1UjMSkP-FmFwSchTt(djyejU`Wc40Ex&c~`utpNdsaN6kVj#Fe554nwsiGKEHRX_}J$YZ*=(Fv#pZ0?9Ew+4IRSQRZ=#|2tcLs703glW-108*Bgq-x)%#) zP7s^S3O5Ba`JIpWTrnaN)VhF%bCX=ImMV3}0ZfJns{3T4PWKVV5f*}YqjPtRrleI% zj~_RNiMu-6fUmj?X(GBhwSzz1_Sn&b{>!pMhYTWo*pzi7VZKB#(Pb4$pR9KJ@P-_REKthF~(V1A`0MjiqUEvOF?E{~u zbKc9f%-!9lPwT=J&g-Nur`hE#x^YnW3*F@1hhjgmE!L*3_)mWF77Jhb##`w-KKk5| zOZ9l_NinITPD@K8M1*`0F?tHaOT{O`Sv@VJBV9nU*))&QlgpZdZ6vyMYT~r1oh*tc zU*uS@VViQ3|NQH366UO#Q&Xvl;6P5JYuc28?%lmERl3&JmwKN2%H%Z89T^Xf#M||% zgV^wkV3wjKYJp04oR<7gYbLFYID|yuhO(lnSVcoNYdSV#(5x%Uv-&>jWgT@|}FIyH?OJKC8jo0VybQbYIX@iZlC*23dCpRF0& zItm1HSA{_|f70#w2P6p8n z_jvkA&5OXCB^6i)5P*PAVha!o2urVA!sQPf#y`HIq@C+IgLw=ze{*|TQ{ zozOpcjZkzS79nt8r5jQ#^{Rh?vgvaJ>kEUzR>0(lH8MVBxWF-R!xG^3tt;$qy9xqI z06bP`=v5PzWe5q(W)1YGb^|4w?s>0`6n){Puy?D^rTDT6-`YyP0ta!(KgE7ET-bsw zK9nM*iMGgUb(!bp^^4+xAMigx!h^YpX!j@l#tY0UdKm&{?&3mwSJvbV45u{<0mc@< zN&|?l+-Ph29GAIE^!x$LOBOFMD1LFnK?=*r$zOizF@XiM3R7y5&=}h`n9`c#5+k@M zbOe#&0uK1r7him;>VqImXm?W=M!}|<5F6U4;kv|fXT2wjBK(&vB^LV(u~KEESSN#< zU;O-MyqsXr4a(pYHmIEls|*4N8#M^rvE;!@W@umsGCDiHR2raW=IaV%u?FtNHDrC*(WH}xKk9f1@h0~{ZN_SQk#3o7T-%4I;ZJYcB()#aw`&)JvXx?T7 zHA;rg)L2c0Wd+B@%}DQt$G-L$2Zg^z4`ylrVZ}?guB8qC@K=GVNh#30cI|={L@t}+ z+#h`K4yjnyHeuA&YJrN1GCdI&E}Um!tQr^pkO-ms*s){ePe3MH00^~)uwhop1XxIl zWqv196ubB{Y)TLI6eL(UMIQM;?IVRoBR>mI&tl}#xer>8PC=+mi`k6}IDw=eG4D~-bMPtNCViAAhiIpu_#3l%f*u@|-sqBMbmu6X_ z5=_@GFzp;0v7EuO!bX4#ZCJ{DoXRCTw{IRdb`*5bugT&_+gQE)U=w#`Dd56+cw=}) zsb81>-#225{DQuK&Fz23lUJBZHE*KdBAgqzRyjBP~!T^SF(3((vVIa0N1Obfo z_S>)9d9u@?n73C-Gs(j?Wrb+Trc<0aNW>k~FMuD*t2PDVIS5~LPq-FaQvylhqb?wx zR3kmwL?ApNoj}e|EH8KYmd)#A5(<$_c&#G_)%Q)G#V^173{nI_f#!Gu$D4%&ig&Zq znt@`~tNwfb{7F@nopab{ESrK_$N(dK;^j9-+$1=ZC1>|1uzqmVyKuqW(5DTyPe1*L z#%zh(HE=mUcAtox8K^jXEg8s~@yN~6+GK7OAOT|RH#Y{SvK z*%`>5d`(Ryn+g@fsm7%Z!uwW>1TYcO3Ou@s#|QC`X^L=locL6a7}{PB%(5_f;rUkU zbFeNrK{l^&2fpVHktE#569jNT5+9UUG~tvjeO{du3Sv%rxg zhN0;FZ?b%pWoAap5*4X+A#E+(bx-| z^~Ca;xRQq9A9(EH(@>{;9~Mhfl!vPf-z?wTadmaY)DWKn&$7#sf%t@&6j{p9ZbZY9 zf+f+JN4N~b7l``vVza+ual>x%EIoOza@lTxGt<8rta+L7P5~Js=F`{&E(x}a;HL)+ zz|&xP#PP=coMKJ9%>n;|O*L9HQiwJfga;Dhf#F+EbhrY51akMDI0XwRhfck-e6JA; zBfJB{dl({lmL9l6GRG~q*F#Sb5z=6P#3%rOgewdW_Q1bCz6TvC0S2>t!7&93L92d) zAA)J5D0?Dy5^E4hc!2>3jB-?wu~5! zvt8FIh^c_&GL=7n1V@Q0F$N@W2tTm1o~5&EyJ+z5AKb}74h+1Yf&?1Cz8JJU14h{Y zLkSe7a~;LF2D}n54o+M}h780$QN8O8^rHm`#@Q4wU_h0jGkGyla_B?j^dz(a`4|rh zel*on{^z#8SF-eHm+G#i8KgX*x0zTyQ+4e(RbhD~D{~rf%i4u^7X`Cs1~QipYk)nF z*|-|?LL29K{Bs#7k7Nm@pC3nwdJHj;T4reDh|O709A4ey%nLR~^dspRSx*=TAF)Ib z$|kCV{s+LjPoo{2CUo#faMDhXdbRD0AcG1&gQg~*ow6LKU?d;<1)weaRx5Nwe==e! zk*|+P0}TWPn*fYJx2P{aOiA3C;XLF1b-fV`{b0^h5eUQt`PAuAGoFUlGTK7|N_(ge z?-fJ)RLFMF5QaQqYFN9*rhX+)$;3V(RaDAwrIsIGv>0~epq;NT?WnUDA)m*9*VJZ5 z+?_bq-9gEs*%t8V1C*(&CjY~5z99p}?2?NK&8-**;4Kd*V;jk)Ku&f+Uu)mKG}zvN$+ z8j2Zf92P3MGq0wmqiV8M$GSbUw8kx8^P{@`^+c{I_Yyi)a<1zuu`R~{soCUnheU%z zb=-BIvdYyOel0YsW$a$7Y-0c~w-qjfZ+f&z$%ko5EM+F3x!PsTO5UUfCW06`Khs#) zNrAa;NM5@xjP&AY?Myn$9~~$E2mIv0<+@+U<)O6t_iSt#jrEtBlOMJ9Vp7=!vCnrTd$Fv0{rMj8$ zEzMp@<)`G~5O9XK504ivA{<3H{FoGQp%HzgH-sN%HwV3RF2|fiC2<2_rtb4<4RsPXf zwDZKo|FY+8xje0adYzSK4y*8$n3@beMjTJop7O?-(dZOaoe=egGmVXi>-^Nenx%v7 zlk@#_6tvqPnV!$GLNcoS29$+L}x;TJuj79iOY_Gk8HG4Rk0>=*{+5 z6f;OQahLBhtkR7oJ0n~oW~Qa^b>Y$qGL`6*Pu%FR4pwD;Th-Ps;o??CU zAS@j#X6b|;g=~#YV;S7zjy+N=mP&f}o!32x$<|?k``)f<-yyE9G|s$9D4Tg$z1oVa zu5#DCVP%&`)DC-6mpMZdRF7-wmrw^SC!|Y0Yuhp*|EJH()OPvg3zRHqnO@Fp?>46^ z{MP8ww^c%E{*;!dP=1EAq zeHF>dLBl)lxZR$6>;|7pknX!1oW z5j--S2>g}a?HY_%o)5*-&j zLIaj>mL{|UWrZVCNW86^et;L47}$*l142d-({6OZLl4}&>n=Ni3;>~fuGA*%8T3Si zrGX~sBi+^oS9%{+&~_VpgwoSYO|7;F^Nd5llEZ+!ZU9;vFDg zp&se#w9`(M*n_a*nApt0e#x5?M8V?@Ja9jG2O=6ShIw6i%b=HJ^ zMr;M7iL<8xZ%07ZSB5tfCum#DgAUpc6aqMvM)MO48)TQc&+DJ-P+8eZkWF|#urzZ= z1dv3O@V9`p()jV?;Fk>vTGT&+9yH%7PFC#`?Gwi8kW<>SqhMKM*KPFK69ilch$Z%s zRSZqd_VUCYCwgXU5}gzZQ(d^)C)=xYODS98_6bvEWU-)i`}9b{4luUwSqwG}z~(ix zJ3hJ1QkKt4Ja6tCTRn^r{@hw?t^qMd3yh#*E*a>b2jl~@2!rem_7i(SWWkco$ zg%@|LEw?ZLFLBrc0GFF>x-qO2)GfXWz)t{CfnM$#Av-aNNucn=mtTDR+_R6pbv98JZJ6Uwa9q@8Q|m~paHkYp@cS#24J^r>0%&%cwPeIMyQRVI)hhB zNg4K0M;-=#$M6Ou1=L}LD{}x^59x#+?joh|)t4V@ykJ4lD4#S29rB*URyYfEBJd2C z$Jzp<^PAROb9IIZsfIWr%>0q!SkWU$#{vP?@K1mE9gr2;GA#z5>M3|fApH@u1ownT zqOkh==i#%0NEt0C7b=87ni_inTpiB0B=(X6@|y2JvfuiipIz#c9z>7_Eb1dj>N<`& zrnr*lq%>v{1nHH5N{oeW2fV9RVv={Ma<4&JI>Tmz?6>b;R?n1;WZKjzh=VjN zb>LrM@fqrWF=Tfg>a?D3XHXNRd$-1l0tMjXh7KWd|by zYUFaam~5gj!z=OAx2j8U5QsXd*2Yt~9x4=34OZ1UXvO)$FEC)hY6NhIZ#u~0Q(N&+ zszGpv_N2!7H5pbiufpCwYq;BiEII{82;9)?8?ZTH zdAly$zKuwzk1tJ1vCs}VO|~gWO%}a38e0bBMz|v+I2Aw4n5=mB1Fzv-5YJV z{yOWd2^&vw#JfxO#Q*r@wsh5*mM&ewr@$8?BvcHw;wgd@c3PD}81SQcZwe(~d2>wu z@sGc=6ik7Cp>v7@jR!eOy#pq_ff)?X!mq|=B||UhQ%k?vq9;rk&%~gW)JKqRpil(r z#6ct!+$e&`+viZ=k45ajvQQsfCtN`B5%Eg~zmf{X*zhC*cmxOt%8C$R-cw{-<1S7I zwv|Og4D0LbgXd>_(H%kzs1V{E6oF|9UMf7J8BHo!Aeu-UavXSYn$dR*E4B=VD|VnT zq=n)>AR~0cYO=l2r?zT)fanroDH}|YwA2=kjVg`yYn(lzfrE->xus+OuG?n^)%(=x zInF{I!_PdB<~fL~x+M!1Hgm!W^e8Uo@rA}blXDpxr`+_kR<60`iqVDG#qinuHY?H# zjW5X0kQM{?PKb*0rNy_XfLm_9-u_H|c>CEA+F;H^E-ebB@zQOKDlZY{Qb$O8kv4ms zmaJbKDuNWIuZwohv(G*Q3y@gSFTvU_NlHS34JC`A6MY7g=j4-5IQpm~MBvd1T@(jZ zR|(E zyD9sQ>k$Y7=8SS9^y5f9xZ#T>%V^ka5Ytq(O>r80GrEJS!VyH=KK}Tl*dxJ15o*y) z=O&`TU3cDsTjjrCYB~`LQ5(WfLK~J;@WRDz(9Wv&xfgp1Ve{m>`puLoYG=@j|KEx4 z>Y07(`2yFOh3?9xHEy_(85vU@LD5u@36dv?xF%{W+W)$Ps1h7iu9dRkrNN6NuG2&J zC#UqfZfCB5eO_6@7V$7PHZ#F1TN*IendL$IAx?S_3t%}1!Ku_W6X;lsEk%DU{g@1Ay4B)L#7WmK|pwrl3}t1FAL4)?}mcabDV8CZoXxh)1me#(5k zyG(jFe)!&7TE={XRaG8cDyEvRk`OVwO1fMzaet%MdoYdxlbQ6Qp{Ja5eBdA|?@XM+ zG%aAPsx}z03Z3YPpL=x3uEV!6B-VoTLU`)FTnUSDaOP?NOtPpL{tA9&S_Uv z2viV3!IQQ22HWpAPEKT9=|t?~=2g5 zbdJYxBJN(SE(Eds=ki4L1m9vuhWv8dvXOebSI1{xaPJBG9TM_@`p;OPHH``qAk-Ig z-SAy0J^NaQWUCy+hu`6J77q20t*XF{la*M(?=BM1ytG0zwuL}aF1RYu3jJKj%LpG% z+#IL|C7RIJL|lMVpk8noO$lx4BJQyzq=)elnJ%JHQbI(*xihcHQOQE17dvxPYjD5^ zSWQ3qr3*0AAVn#xlycIC5%#c7Tn@r<%B>ZKCZFA;l&g^Rh#MZ^;+KMfRrUcBQufeK zw^`+A@EZ8pv~yL3Zl?+~MrvI}mkYxo{Wv;VdqGMPc4JVA`? z$OympEn5#C$-b)FqX=XSWLJrOwgvR5qy}=?6g=Ix)1YBfwtV3?5qh9?5lxe~uxu_cs)DwCj8bAI#EdsFa=)#CD@xb{( zTwI5T4G4H}kM>y*nAXs-kXg?{o}ddbED%>nI#2)@b|vOTGbx|vvR;pxKH$5GVn5D7M&CT=ACs1lvJ_ zCmD>=Mgvk*X{wXqV8@!D=zu{yX!)moR5`YVvo?!{Aw7xaM+A08b&@XmvWZj)(y!Vb zpOO9q+1__#Q%2%u6t$IZEP$w|0To+st1b!p`M?Zy%*pM1Fq9fI+|@SZI7uKaRI)xd zVrj#nfN7(k8?ozsecDKJSa2-)z&cEP@QL&`Uz}=s2Bk=8Q?kE7qW1ANf!A0vY za~;p8WT61>CD=8)qHv3huyZ=be32$YHc^AFypNA)^FAs7M50mwqUffR3nz@kyPZOQpMD)=sQ||MeNc z{6Y$Os5?vsYs_V@=OB|8tRgO^$+mf+Zf`XHO&Naf4Pl;MVy-z4s&6{!cIi8v1=!pd z2Hh^>bDKRxAIzg}k>o&VqOU8MVHvT1pPJ?^Z8Lcaec@%7heDN@)V^z&lm_r&bNrrZ zM-wy}x1i-nJ#Q?h`HAmW$kUSF(^4Rkinv<349D1ZMRJObb*2!S+{`A(;f0f;-|N22 zKDIzH1cu;4hVy=MeAK3fBg3@snlF*uL$2H`PnqL?u103}J4vb4PpG~ZB`SKJcl8Tw zGyzr{>&X zJrCw=(y|<33SXq-VIt778%5z#%q|aV8H6D>D&)27DdE9~2jvO1u)N5JrLp+G8`I~Q zdUqSEY@`-o<{tE3JPoh#H3^lCN%#HvYiDOcunItEFx9Gd!-aiF1g+0woo_vM<2WWp zE25~cwT2zgc%#H{(ZMC>@l|u%;}qJ-#6s|Sz18ivb(l&>zRbCF({#4Ptx8FxpO1}t z%9Nj-xe!z0(Qz2pCu}9spGd8B+A`KN?2@4Oz%y4UT%yOWk)Ox~NXHq6auv%Z#_XPj!(Tbduf(zCrkmX{t!TFfIlg%g>Yy<%u}lQ39ZuW3uD)O* zPT&w6yZ2>jftze=iy{ zO|W%`RA~oQ`QIPv>8Ntf<(vUYpA^}5n;{Cw2IU#}a-_w~ot8=!+vD1ilt#4Oz}UhRQyLVsK{qqIqd|EW~SrPCgh zo!z<2*iYRTV+0(E83y~9m|3(AOPxa^9b~2Ow+|HElve)tH|^ z<&?4YN02AwiB2BTnbVngcbDk%I(@2v< zEBt79XJShLtt_M&Pswtf)uO1L@QrDU^TS9PafJ$^Rkec@25Sm=h=hB;Gk6Wu;=M(s zx@LuzFu60_8@vqhNxb}&EQM`b8W+x+62w8CkP^Jk6l3y7g@g;WoUd06K0@_T}=s#VOchj)ne_IcA$foyBUkjfhQ zydwa#mO;3eno&@TIB=TQ_*2s3ybc8$xh2X8XIQl^mzPB<6fQd8?F@-7lztPndQ#Ne zfWHvvHYh=9#m7AAMcBO|0Ju%Uv!)aYxP^&K8pCEhU&3QswK6a=gC5G-9KE)l_SIm%I z&Sn9d1nWwb2U$G^>2^B>RufJxLi==utWa$*7YFHQuC1%>XZ6nUqwvKkfzMk@b)BBE z(ZQF;hE%WJToPDp!i5DX%vOY6;-J}l2c9*+9~$^mxn5A|Vb0Z)q4+vj1YF2Bp7v$o zJ>0tST{w3x{t3?+Z{bSirRYOu=vK>c@YRBpSw|wOGN9k1{Fb=ifI^RnQmD!R|Ia0R z%o;=l4VV!aP?@PNesgsAv--_SCV^*xnkn&vm^hH{K(560)Pbi0$D1}b@7lRln^}L_ z9`MraYQ@7}gB4YxqtYp!OSaCoZJWmZ;rGA(^)FYizE81?s`P2G71X?1yhM+J2<>fq zPYa-e37TpLfIb4y2Nd1Oldnep6{cVYX6I~Wv}l)=1(K5%#vwxlWIbRFOk#4x6bQA@ zDS%~N5KU`?oEB9O2ME>95}7hIh;AuOchO4>PssS~IghYL|ADe-X!mjzIb^v(QHT(_ z9KQe-r=rRt+7eOAHF2QGf@=rc2eQK0I(t#o)DFk00&zpT0!Hi^uwxE?Ic)x!+y1aNcdVExYELtA6^^A8F5P!inSk zp7?yIzw5PEN9WI*egD7z{_fkaNo44aYIr3I+JVGDM~EDSD?q}?=u-nB3)*6c;MTYv z7{yH9ZZs<#cSCh6fWki-@LcnTi~S(EmQ4eR0OxA}Yo1ZD!u?x^iv5`?aB+?>@f~n- zVea|Vval#19c8u!t~Noupa_G@<4Ln2%slZatC6;I@~){U4*Fy)m^cWJEphPD*x9ZT`GjEAG2nyS)l(>})yk{2h1Ps%^h}_qOfZHYs>%zaGT} z|M8FA=bih#XP$X{Waxw>h%^OBguCy$U5Y?+(_eMF7SZP4x@F_D&ph#oPkj95n{HgX zbkPG3{8Mif{)?_Q%`|baV6Nc~QnoVJ2uQ_+BE9UEhmy8oDNY|MuZip(wUUr$y5O0a z=D6B2fA55CVe=#%#~n^$2!n=ISdaO&s@M|Mj2W{?<38P3U$h6p|yeW=>O+ z?jRGOqkUi10BO4Zx@#p4wE4B?TU%Zj9Xa`pZ+vajrsgkv;q%vBcg@ThQzdaEO0;s} z8!U)}h&up>D{x-%u^%~jx!4@@+!I34N6G`kxo-p^C;4(jWv;Yv7nRszy&FC{U)HZw zZ72Ga3^(FdYkRB|9zXer)nE@+5lHqAVj; zSTgp)OWyL?J8mqvcF#x1{o;%-oeN2Mj;)^c$ z*T42O)c;xATQ9xw`b*l$7hinA*yw=85wybZfA`xZi{}pyy(ocV%7t#Z@WS&Y7bI2= zA3E6DvUg^1{t|_$f^D%q3PrxdKw2 zA0c~C2Y3R6*r8lqO9{}Pqa=Lj#$x%AVKnh*6slCQ>58n}xJZCt*F_#R&i#z52Pw$H zm`%RCg2X;We)k+coN*UngvygctrV1N*?$V=1C0V=!s4qz_Pb4Sz>I}tceyzD-MqQ8 zh6awc9(X|(f%fo)=b!iVlaFevkDeO%+0TBmaYN&scicK-`V`I4y}Nd7m5k6!rX8Fb zIx%<7%xP05N;{Bh(AK(Fu7sw>zet;qcJS4&eEG=Xo_%|tk@j)!x!>FS!qY$e!Od&e ztdtI-$q5YBa0h}Rd1S%%RVkSbM2j$1m8hb%;s8my&Oox9ChsMHntaG3bV$KW;QZdu zCqkia)(E^IKEN6TS@|6U-mwk~za#N;5=upnC1=`mAJaK0U#J_#gE&{m8xz0e6v8kP z3gcVDYFTLtV@aw4B`nZ3Ad(!@|H)Wrb7SGIyKevBgAZi+pBg^-+AE{iU3>M)`|g%@ zpc^l~=)!;fb5DK!pKiS2x`7i%G&pPK^b0RIPccQ^Zcc%RANu!qzVj_9|FQ_=YwYQ6 zyX4{v*R5SC<>D(}{<7X~Y-~`U!>2y^35k!JZ@!_S;m_~C_l90okRsM%{m7O0kvJ%; z=0;vyU}Q-0L}JcZMALVbXGYXIfXXqcc}}o$BxoLBLa}ECh9!Tx<(RT~CAKZY79w$L z*16_I*?27l~Z+>I(qIpxNOq@J7{dE&VL|NsBH_~HvktHy#k|D;gdd+%M}``&jXS*A^$Bv~+F{2wGH)U@~&S6n({ z`eZ2!=bUrSf&I@dU%o^Wf-74zoK zlxUDD(b2Zg{y~d1K5+j(7B8AFyJO>qrlUuCJp8e8#l2c~^QPtv>l^m%eO8aOa>YGz zKs@x&zbvv){3Ny1(IciEObr0Uz`Gm3aF}Dm9&)JZhLwJRDKLAUm$Cb1>+vIA2q__h zr3r8VkG8O{BrFBQkp4Uzp(x?nK%L#SgPI(2=KtnZqGFchDHS(W*d&O8;LXE`(MUeW z(L{C^;fBn+A!}0)d>V$hFmBAMV|;g{TJi*Er4J(&rS_yW{Fg=t$4(85j-Hgi(7;0S z4h#((l@RG@*KY4ywsg_*<%|FP=e6gbe{TI>|D-eARQ*CG;z8LOy6gC{KDhw=Q6*et zSx8=}Rf7es8qwRy5|J#ZNtkzI!L~;}AYQI2#z>0Z9kh`aKw#ik{0LmqQK$na1c`Lp*Xs;)C6d&J=%N5H9>)(aEAl znk)p%i{hXh0ue$W`5Xb1+-Ng1y+jy+m&za2)(3wlp}{juD&!jq&U zA)pvxNPLXM4;fQg#hxN1LcRtm^S+bAg6O+}5237ZepkgU=SbG)9`7;i*q0E(pOMj0^fA;V}}gteeEZeNI13bj{Ld9=(iJRATo? z3^b~x^;cQYM4Uo<+kTzx7Q%q&47rEFpOPiox0I@&9b}7ilsMI452sqLKL98ZptS*$ zb?6{5r>k#yiZF095g3U9EMX22qDG7m-{`O6uLzhpfPSXHm59GEHpzg?IlM7`{qe-h zA;YNb7wqahbehT{f(T3C94OHXS}rimaRWRRYyh-x5e-$q9dwEBz*KR|L{hVkOatpz znvdIvU46cdoF23hT`SG{8u#WS>crby3U6I$wus*-vqJ0)F~OPjAo3A_{uuUuB(T8) zAnfWy1C4!flOawqcaVm#NY1K-5lkx}Xk#krpiaEc0riR;kgV?c5m=XiKuPmS3c3P^ z8q+_pi{UaAFgI-qru&w^E7#)P6d2a!Jrw6tL6 ziGQyk5lAnM1iN{{)z~O@r3U(uo@f_I=QCUD8OL{o*$U5ZcuSvdHC$+Jz0bi2I$^?zBl zZ1K!nm(96lsoLyYm(A9-()8!D*&5e~n)({4Osh_)b}I9iSDW8r9lhj()kW;y*~^zy zZnOzDXdS=HSMZMCZa3bxeD10hxB7qN_Aub&LD?h%!otklHYlg?PBUoGW{eAh3j=xC zBJhzbO6MVSWSD>t9sq%f3XrZ3ZhPTb4(5Xv2#usd_0DU&j*d6a|I!l5Ha&u9eHq_#@ZoCD6*&^zIXtxB{!&fH%IoP|=yIxx#xJvPhXbz-5Z5|6un z-UI^7!$gMFab&Q?4z^9!K^rpY$DJb~ThdFbvuq@6@h31+@=kiTe%_ujo><&Yb=<6= ziz!rpea$S!=4EBtJ!4GLf1S+^)ZcgQmT_$j(41(WdS|Qnl4uTWsFgrcho_!!KRqbn zsBx&W_k*!s>MUe&s=CmO60tD+v1)=<#8%pxag#%+LN zgG>L&>G&Rk8jTH|`{$D6LzfCOaxTqa9e@n7Ao@$~{=q2Z?+y8=(x{N_$=e!YX zb19q^t~v{0vABxfQlUy?NK-%o@~mm=l5mX`*2tfw3cJu+}5XH$OhR{)drCF$jEQ)suD*u0qI+ zL<}5iy)8<=vWYTu%Mcq;o+-<7h(38u`jO@7n(kK0PR4Y%)YTlcLJ_I1WAfv^3SpSj zS`Gmr!P5TfolBg9|1%=RlN56V8FD0gN9E?MJ$$MIXHz|&$qAN%9LkqOa7jj{DaRC` zDd-O)8Po=y`0VCKSFT)n;)y5z^WE1QbwU|x$in1feRS^M%FEz{E#p=Dl4vaEwak&m zu0NBh73yc#Py!KC&hEmys;5|~Pcu)8whU*KAdr8x?P>7I=PB#7ok}?ELVNS)v*_6*4O$Q6 z=T`d;^}MX%6>tYq`cqhPQs^)qR;b)^$HynC>}in^4vowLnWmwwQElen=BIyq{q?K& z+;h*eEYCjs>^EQETHpO$%WzAFkL!_1%5qqqn7%v0rC9fg$4^6?XKl*vyUPlwNV}+s zbefBix%TP}E4fDp#zHOQN)YV}R)Yp)9NX-VR}QGM6l&Yj+oHIpkaJE6CuCx6oZpHU z)?Qu1B5MN=IHvUBK_P}^@wByNB;E&0L2BbtXaVOb#;yvnnS<9}du>^k`|rPhS(ay> zd1kW+Th<`>kI;8LBISeX5&Tyar#cv$+YylnESj?My+0UG=OZs>KIFo*hzjB6G+s7@ zDXWJ7!eZiDKsc1UQtqM3yD41gRwRaOkE4Yyvx8tY;hY~DjXm|9#nCK_>{M9>N`*)V zA8!3Myc;Ui@?Zd^37r*`H_O*B4 z*?J8)18tlELT)0)5W2+$c^WBH!5v_*(7bR*!$GJxG(-vS_Ybm5O0pU<7uJNz$e4F5 zxl$Ed3}!M4?}@_~e^U3gc1Nb|%(kaRMCYq&DFl#NyhzB_7F>Kr@->UJeK+$jwP&^Q zeLa$}U)0)MKB$jkbk5zDjn7^?*qGf<=3x2h&(lvo{oS1}ul?zr3=?9wqiI^V7d4Q8 z_C(1i@dSS2d`A|i zOfm<>9Bh9ceDG(FKKke*kNon12OfCx$tSlMVH1hiVgv$sLI5;1bGLXM@t5fCSSe3y zdp$BZvF6TbcWe%sw+S{QC84w{QP*gCRWj*kjAGJpcUjKYahqMit*Q%$29x z$32~kwM;{v)Os(rhU0YT9h3=Layrco8owpK$WXTu4GrI-II?)jZ75DTVN1Ukb=pX9 zs5$g!NejW=Xkrv))jDVbr05pPUJIE+W|$l1XR0&U=FH>~!0$58FQ9;Krw+@4l>`V- zKBQ;}HR=Y|xlz1-_P@@;>&voSzI^$I@4x-+Td&^v_REJK{>2_IJpTCOpZ@)?@4xp) zt*T}*6jNNx9u%)X2v69u+;kxBK)4Kq72O{@iwU#TuT1D?WqjnG^%N%MFpQM)Z9Q;z z+13a#z+3^*Noz6K(Q}jSax(s3?#6&z&d7zP{idbUTKRvlkybXslG5!bnww09o&2Gy)V4*!Y3bp_}R@*-hA_|U;p^$si%H*=gyst zYH473CeQ^e=q=TSSboa=ETZ>RTdBf-e$n_Sj5fG;4eH0J)3?f9xu!s#&hVl~${lrZ zQMis|L|gxf?ZBq6RjKRV@ihm`FU1vFfbdx4j#`=pvauRGSjtOJNTC&f)erw2ZZh4w z{@Ns{yi--PPDYlm6u{VS9Oj+YKnU93 z#Kl{BqOW!=%*vlE7mDiP{Z5Z%s&cGHwXdLzRDZNu?B{xWuT$}jHep8f@#g3Q0vM^uSWORAm&i93Xg`*Mg({1{uJuDnOAq5E z((YluHzcU;EBv~$aBzbM4gwgtD`o{GZmsF1jY9#8MyH9mPGP$Yl=hT2MCR6$;K_|6 zXF>dS)?#qj9@sC)Jgnz-?KjQ%mtTH)S(cYx`pvCd|JbZR0V#*U!TG3<22KO5@`~}o zK^#%USJPbGi%Q2 zNV_6Ru4~w*ao)Dj#$`L@;_8LYXCZg!1Fwy-A3{OCo5g4CT5#tXppZ9d;(| zDvoYrVc*o;-hTV-OP4Nv{nf2~glQ-S&A3%;l!hCas8DnAJP(&j&yQO5R3{FOjOK3l zO#IaET9)muCB!aNK@$iEntJwf#B3j}DUN8!tCO4MoRu@3@xL}#t$RmP)i(%yJ$2cU zc;j=@AR2j=NG#i~Bxbw%w6)W`TrE{PMdPY!5RKi8&Va;q*ALz5$j4tT?ABS_a)d1} z*hN`P*EQ}P`AJU#Edd@NgHdmWexjivpbGa$dp+C)d*L)^Gpzs&DBts*URmR zau`PNJ3aqAj}w@n_NQIp@o<*g9w2az2o67M04b|4(0UJjf^LMxMOB78Gg|A+|Dnaf zlZ!SjS20r?M!`aPS##D+j02%Xnhx%UL5>XzB+Odn^4dvB@Vjz`tgwck&c3usT(?b` z(l-J#MI%*M?c7OWe$3*aE?K}2C510Z#y=~ZI`l|29c9i0+v+dZi{O{ zUbyAIl5- zk*s9Q;<~L(0%Rr0KVR9A5*gOmKHw~S&hHh_K~p)mqSTg(liTFLcmYIk&x&?lb+bz` zUDZ!|$xWuZdlk%m7$nKvP4vXlv`#{f_2VkJ$KiXTnOeZnn>lE(W$ls)eWSEClikodar)Ge}8`ol8Ygu&h5WXk1KD z>mP)yvTfr_AJDF6kUX;by@m_6iV!{ayx1C`?yP5!Q9=sD@kh<&O8jpZNs7wi>d;fF zFP7rd%qryXI|nR6WmNvc(*3=I{@i*TZOUEKR8eQ#!Xa54Cikr~a--Q=Ym%&(?;7fV zPHx--q*50P1%s{i}c-X!ALy@^6g6`UfYw=g|L=4V+wwP(2O>;9r<~k7{ zxun~n_}rq>lIp0!Y0v+O^Wa2}=|ksnkI+NT&+6LdFb!YG0bX{Z0fBeX#@ul3@FaOy zdIzQbLw(Epkb9XCQ`~~g^I(PI6J5?(h^v4b_l7SO9i5yZKBT-fSWNHdq;GOmVRFB- zt#JfU8@J|AR$e^WoN|YFlCt&V;dk!}7k9$V#NRTyTClL~P><bMR zTH$@zZMoJYfqcod*^iJia01q@xt+}ij>wER|Np(Exyv&(+;e2~kPxkTsBtd3n}m6$ zS7=Db0()(Lc{nh0b1)lYb?Gd{`(UB^tX^(T#;6993gbI#JF6h@EjkozjU!B!>ksry zosZ4X?yM2CY66Xspbw`u5s0^0AnXDo6)xqZ4M9leW$5OV=63-8ybi1y7?4>CwqQILx?i5^R}cNp5LPt$h4T6);8SR;fjX^mu|vTAI^o2| kx@lXFpU{6~mqQZzU#LC`Lq3Ouga7~l07*qoM6N<$g2@1cB>(^b literal 0 HcmV?d00001 diff --git a/source/tutorials/nvidia.rst b/source/tutorials/nvidia.rst index deedb9e4..8b5542f1 100644 --- a/source/tutorials/nvidia.rst +++ b/source/tutorials/nvidia.rst @@ -34,6 +34,13 @@ Prerequisites * A |CL| system with a desktop installed * An NVIDIA device installed + +Known issues +============ + +Systems with multiple graphics devices, including integrated graphics (iGPU), +are known to be problematic. + .. note:: NVIDIA Optimus Some systems come with a hybrid graphics configuration for a balanced power @@ -51,17 +58,79 @@ Prerequisites graphics devices or NVIDIA Optimus* in the system firmware. +**See the** `Troubleshooting`_ **section for more known issues and solutions.** + + Installation ************ +Configure workarounds +===================== + +Some workarounds are required for the NVIDIA proprietary drivers to be usable +and sustainable on |CL|. + + +#. Remove the kernel command-line parameter *intel_iommu=igfx_off* or disable + input–output memory management unit (IOMMU), also known as Intel® + Virtualization Technology for Directed I/O (VT-d), in your system EFI/BIOS. + See `this GitHub report + `_ and the NVIDIA + documentation on `DMA issues + `_ + for more information. + + The *intel_iommu-igfx_off* kernel parameter can be removed with the command + below: + + .. code-block:: bash + + echo "intel_iommu=igfx_off" | sudo tee /etc/kernel/cmdline-removal.d/intel-iommu.conf + +#. Create a custom systemd unit that overwrites the :file:`libGL` library + after every |CL| update with a pointer to the NVIDIA provided copy instead + of the version provided by |CL|. These libraries conflict causing the + NVIDIA driver to break when |CL| updates mesa. See the NVIDIA documentation + on `installed components + `_ + for more information. + + a. Create a systemd service unit to overwrite the |CL| provided + :file:`libGL.so.1` files with a symlink to the NVIDIA copies. + + .. code-block:: bash + + sudo tee /etc/systemd/system/fix-nvidia-libGL-trigger.service > /dev/null <<'EOF' + [Unit] + Description=Fixes libGL symlinks for the NVIDIA proprietary driver + BindsTo=update-triggers.target + + [Service] + Type=oneshot + ExecStart=/usr/bin/ln -sfv /opt/nvidia/lib/libGL.so.1 /usr/lib/libGL.so.1 + ExecStart=/usr/bin/ln -sfv /opt/nvidia/lib32/libGL.so.1 /usr/lib32/libGL.so.1 + EOF + + b. Reload the systemd manager configuration to pickup the new serivce. + + .. code-block:: bash + + sudo systemctl daemon-reload + + c. Add the service as a depndency to the |CL| updates trigger causing the + service to run after every update. + + .. code-block:: bash + + sudo systemctl add-wants update-triggers.target fix-nvidia-libGL-trigger.service + Install DKMS ============ -The :ref:`Dynamic Kernel Module System (DKMS) -` allows the NVIDIA kernel modules to be automatically -integrated when kernel updates occur in |CL|. - -Install the appropriate DKMS bundle using the instructions below: +The :ref:`Dynamic Kernel Module System (DKMS) ` allows +the NVIDIA kernel modules to be automatically integrated when kernel updates +occur in |CL|. Install the appropriate DKMS bundle using the instructions +below: .. note:: The Long Term Support (LTS) kernel variant is more likely to remain @@ -206,22 +275,6 @@ Install the NVIDIA drivers lsmod | grep ^nvidia -#. Run a |CL| system verification to restore files that the NVIDIA installer - likely deleted. - - .. code-block:: bash - - sudo swupd repair --quick --bundles=lib-opengl - - .. warning:: - - Although a limited version of :command:`swupd repair` is run above, - other uses of the :command:`swupd repair` command should be avoided - with the proprietary NVIDIA drivers installed. - - The NVIDIA software places some files under the :file:`/usr` subdirectory - that are not managed by |CL| and conflict with the |CL| stateless design. - #. Optional: Create a link for the nvidia-settings desktop entry to :file:`~/.local/share` so that it appears in the launcher for easy access. @@ -265,12 +318,22 @@ not in use. #. Reboot the system and log back in. -#. Trigger a flatpak update that will download the runtime corresponding +#. Trigger a :command:`flatpak update` to download the runtime corresponding with the new NVIDIA drivers for the flatpak apps that require it. + .. important:: + + Some flatpak applications won't start after updating the NVIDIA drivers + until the flatpak runtime is updated with the corresponding driver + version. + .. code-block:: bash - flatpak update + flatpak update + + + + Uninstallation ************** @@ -278,6 +341,16 @@ Uninstallation The NVIDIA drivers and associated software can be uninstalled and nouveau driver restored with the instructions in this section. +#. Remove the files created for workarounds. + + .. code-block:: bash + + sudo rm /etc/kernel/cmdline-removal.d/intel-iommu.conf + sudo rm /etc/systemd/system/fix-nvidia-libGL-trigger.service + sudo rm /etc/systemd/system/update-triggers.target.wants/fix-nvidia-libGL-trigger.service + sudo systemctl daemon-reload + + #. Remove the :file:`modprobe.d` file that prevents nouveau from loading. .. code-block:: bash @@ -320,6 +393,43 @@ Troubleshooting installation files into a directory named :file:`NVIDIA-Linux-x86_64-`. +* The X server logs under :file:`/var/log/X*` contain useful + information about display and driver loading. Check all the files and + timestamps when troubleshooting. + +* The DKMS build logs under :file:`/var/lib/dkms/nvidia*` contain information + about kernel module builds which can be useful if the NVIDIA driver breaks + between kernel upgrades. + + +No display or blank screen +========================== + +Check to see if the display has come up on another graphics device, including +the integrated graphics device. + +You might get a black screen or the login screen might not come up after +installing the NVIDIA drivers until an Xorg configuration has been defined for +your monitors. + + +"Oh no! Something has gone wrong" GNOME crash +============================================= + + +.. figure:: /_figures/nvidia/nvidia-gnome-crash.png + :alt: NVIDIA driver GNOME crash on Clear Linux OS + :align: center + + NVIDIA driver GNOME crash dialogue on Clear Linux OS. + +There have been reports of GNOME crashing with an "Oh no! Something has gone +wrong" error message with NVIDIA drivers installed while other graphics +devices are enabled. + +Try disabling other graphics devices, including integrated graphics, in your +system's EFI/BIOS. + Brightness control ==================