15/3/2015

BumblebeeDebianWiki

Translation(s):EnglishFranaisItaliano

BumblebeeProject
DaftarIsi
1.BumblebeeProject
1.Installation
1.Fromrepository
2.Compilingfromsource
2.Postinstallation
3.Usage
4.PowerManagement
5.IRC
6.Reportingbugs/problems
1.Commonissues
7.References

Bumblebeeaimstoprovidesupportfor NVIDIAOptimuslaptopsforGNU/Linuxdistributions.UsingBumblebee,youcanuse
yourNVIDIAcardforrenderinggraphicswhichwillbedisplayedusingtheIntelcard.
TheinstructionsonthispageappliestoDebianWheezyandnewer.DebianSqueezeandpriorarenotsupported.
ForSidandJessieusers,BumblebeepackagesareavailabledirectlyfromtheDebianrepositories,headdowntotheInstallation
section.Insummary,it'sassimpleasinstallingbumblebeeorbumblebeenvidia,andprimus.
ForWheezyusers,Bumblebeepackagesareavailablefrom

wheezybackports.Followthestepslistedonthatpagetoadd

backportstoyoursources.list(butmakesurethatyoualsoaddwheezybackports'contribrepositoryaswelltoyoursources.list,
e.g.debhttp://YOURMIRROR.debian.org/debianwheezybackportsmaincontribnonfree),andtheninstall
bumblebeeorbumblebeenvidia,andprimus.RefertotheInstallationsectionbelow.

Installation
Fromrepository
SidandJessieuserscaninstalleverythingdirectlyfromtheofficialrepositories.
Foruserswhowouldliketousethefreenouveaudriver:
sudoaptgetinstallbumblebeeprimus
Foruserswhowouldliketousetheproprietarynvidiadriver(again,requirescontribandnonfreeenabledinyoursources.list):
sudoaptgetinstallbumblebeenvidiaprimus
Usersrunninga64bitsystemwhowanttotakeadvantageofBumblebeewiththeprimusbackendwhenrunning32bitapplications
willalsowanttoinstallprimuslibs:i386.ThisrequiresMultiarchsupport.

sudodpkgaddarchitecturei386&&sudoaptgetupdate&&sudoaptgetinstallbumblebeenvidiaprimusprimusli
Wheezyuserscaninstalleverythingdirectlyfrombackports.
sudoaptgetinstalltwheezybackportsbumblebeeprimus
or
sudoaptgetinstalltwheezybackportsbumblebeenvidiaprimus
or

sudodpkgaddarchitecturei386&&sudoaptgetupdate&&sudoaptgetinstalltwheezybackportsbumblebeenvi

https://wiki.debian.org/Bumblebee#Installation

1/3

15/3/2015

BumblebeeDebianWiki

Notewheezybackportsdoesnotcontainthenewerxserverxorgvideointelpackagethatisneededbynewerintelcards.If
youfindyourselfstuckwiththefbdevorvesadriverthenyou'llneedtoupgradetojessieorsid.
Warning:Ifyouchoosetoinstallbumblebeenvidiaandthedependentnvidiadriverpackages,duringpostinst,youwillseea
debconfpromptwarningyouthatyouneedtocreateaxorg.conffileinordertousetheproprietarynvidiadriver.Thispromptonly
appliestononOptimususers,i.e.singleNvidiaGPUsystems.DoNOTallowdebconftocreateaxorg.conffile,anddoNOTrun
nvidiaxconfig!(Thispromptalwaysappearswhenyouinstallnvidiapackagesthroughtherepositories,anditcurrentlydoesnot
detectOptimus/bumblebeeusers.See Openinnvidiasupport/20130816+1:#735049:nvidiasupport:Debconfpromptsare
misleadingforNVIDIAOptimususers: 735049forabriefexplanation.)
Alternatively,Wheezy,Jessie,andSiduserscaninstalleverythingfromanexternalrepository(whichwassetupbeforebumblebee
packagesweremadeavailableintheofficialrepositories).Check http://suwako.nomanga.net/fordetails.

Compilingfromsource
RefertoBumblebee/ManualInstall.Theseinstructionsareprovidedforhistoricalreferenceonlyandarenotrecommendednowthat
packagesareavailablethroughtherepositories.

Postinstallation
Youmustaddyourusertothebumblebeegroupinordertouseoptirun,i.e.
sudoadduser$USERbumblebee
where$USERcorrespondstoyourusername.Don'tforgettologoutandlogbackinforthistotakeeffect.
Ifyouhavesudoconfiguredforyourcurrentuser,i.e.youruserisamemberofthesudogroup,thisstepisnotneeded(the
bumblebeepackagepostinstscripttakescareofaddingsudouserstothebumblebeegroupautomatically).Thisislikelytobethe
reasonwhyBumblebeeworksoutoftheboxinUbuntu,butnotinDebian,withthesameinitialsetup,i.e.Ubuntuhassudoinstalled
bydefaultDebiandoesnot.Toclarify,sudoisnotneededtousebumblebeeitsimplymakesaddingyourusertothebumblebee
groupunnecessary.

Usage
TorunyourapplicationwiththediscreteNVIDIAcardrunintheterminal:
$optirun[options]<application>[applicationparameters]
Example:
$optirunglxgearsinfo
Foralistofoptionsforoptirunopenthemanpagewithmanoptirunorrun:
$optirunhelp

PowerManagement
AprimarygoalofthisprojectistonotonlyenableuseofthediscreteGPUforrendering,butalsotoenablesmartpower
managementofthedGPUwhenit'snotinuse.We'reusingeitherbbswitch(amodule)orvga_switcheroo(kernelmodule,
experimental)todothisinBumblebee.
bbswitchispackagedinDebianandisautomaticallyinstalledwhenchoosingtoinstallbumblebeethroughtherepositories.
SinceBumblebee3.0,thisfeatureisenabledbydefault,using bbswitch.Thisallowautomaticpowermanagement,withoutany
configurationneeds.IfPowerManagementdoesn'tworkonyourlaptop,pleasegotothis PowerManagement(PM)pageand
helptoimproveBumblebee.

IRC
Ifyouhaveanyquestions,feelfreetojoin

#bumblebeeonFreenode.

Reportingbugs/problems
Firstofall:Ifyouhaveanyproblem,pleasereadthearticle
https://wiki.debian.org/Bumblebee#Installation

Troubleshooting.Ifyourissueisnotsolved,youcanjointhe
2/3

15/3/2015

BumblebeeDebianWiki

#bumblebeeIRCchanneltoaskforhelp(recommended).Seealso

http://wiki.BumblebeeProject.org/ReportingIssues

Whenaskedtocreateabugreport,runthesudobumblebeebugreportcommandinaterminal

Commonissues
Ifoptirunreturnsthefollowingerror:[ERROR]CannotaccesssecondaryGPUerror:CouldnotloadGPUdriver
Youmustedit/etc/bumblebee/bumblebee.confusingyourpreferrededitorasroot,andchange"KernelDriver=nvidia"to
"KernelDriver=nvidiacurrent",thenrestartthebumblebeedaemon,i.e.
sudoservicebumblebeedrestart
(RefertoDebianBug Openinbumblebee/3.2.13,bumblebee/3.2.14:#717687:bumblebee:cannotactivatethediscretenvidia
card: 717687forabriefexplanation.)
Ifoptirunreturnsthefollowingerror:
[ERROR]CannotaccesssecondaryGPUerror:[XORG](EE)Nodevicesdetected
YoumayhavetosettheBusIDmanually,in/etc/bumblebee/xorg.conf.nvidia.TogettheBusID,runlspci|egrep'VGA|3D'ina
terminal.Refertothecommentsinthatfileforfurtherinstructions.
Ifoptirunreturnsthefollowingerror( Openinbumblebee/3.2.15,bumblebee/3.2.17:#756522:bumblebeenvidia:cannotaccess
secondarygpuerror:Permissiondenied: 756522]]):

[ERROR]CannotaccesssecondaryGPUerror:[XORG](EE)/dev/dri/card0:failedtosetDRMinterfaceversion1.4:P
Youhavetoappendthefollowingsectionto/etc/bumblebee/xorg.conf.nvidia:

Section"Screen"
Identifier"DefaultScreen"
Device"DiscreteNvidia"
EndSection

IfoptirunerrorsoutanddmesgreportsthatyourGPUhas"fallenoffthebus"onLinux>=3.10,eitherstickwithanolder

kernel

version(<=3.9),oraddrcutree.rcu_idle_gp_delay=1toyourgrubcommandline(in/etc/default/grub,thenrunupdategrub
andreboot)asaworkaround.
Thisisaknownproblemupstreamandsuspectedtobeanissuewiththeproprietarynvidiadriver.RefertoBumblebeegithub
issue#455.

References
UbuntuWiki: Bumblebee
https://github.com/BumblebeeProject/Bumblebee/wiki/Installandusage
NvidiaGraphicsDrivers
http://BumblebeeProject.org/
http://suwako.nomanga.net/

CategoryHardware

https://wiki.debian.org/Bumblebee#Installation

3/3