blob: 829ececbc793d432327e519d1c90fc566b85275c [file] [log] [blame]
Patrick Williams35aa29f2014-07-03 04:09:37 -05001=== Building an image ===
2
3git clone --recursive git@github.com:open-power/op-build.git
Dan375638d2014-11-24 09:27:07 -06004cd op-build
Patrick Williams35aa29f2014-07-03 04:09:37 -05005. op-build-env
6op-build palmetto_defconfig && op-build
Brian Silverdd815de2014-07-11 10:22:08 -05007
8Building on *64-bit* Ubuntu/Debian systems
9==========================================
10
111. Install Ubuntu 14.04 or Debian 7.5 64-bit.
122. Install the packages necessary for the build:
Joel Stanley250ed722015-02-02 14:33:15 +103013> sudo apt-get install cscope ctags libz-dev libexpat-dev libc6-dev-i386 \
14 build-essential g++ git bison flex gcc-multilib g++-multilib \
15 libxml-simple-perl libxml-sax-perl libxml2-dev libxml2-utils xsltproc
Jeremy Kerrbf821102014-08-20 12:48:54 +0800163. Continue with the clone, environment setup, and build as noted above.
Brian Silverdd815de2014-07-11 10:22:08 -050017
18Building on *64-bit* Fedora systems
19==========================================
20
211. Install Fedora 20 64-bit.
222. Install the packages necessary for the build:
Chris Austenbfdc3272015-03-03 15:44:53 -060023> sudo yum update vim-minimal
24> sudo yum install vim gcc-c++ flex bison git ctags cscope expat-devel patch glibc-devel.i686 libgcc.i686 zlib-devel zlib-static libstdc++.i686 libxml2-devel.i686
Brian Silverdd815de2014-07-11 10:22:08 -0500253. Install PERL modules necessary for the build:
Chris Austenbfdc3272015-03-03 15:44:53 -060026> sudo yum install "perl(XML::Simple)" "perl(YAML)" "perl(XML::SAX)" "perl(Fatal)" "perl(Thread::Queue)" "perl(Env)" "perl(XML::LibXML)" "perl(Digest::SHA1)"
Brian Silverdd815de2014-07-11 10:22:08 -050027
28Troubleshooting
29===============
30
caustenb6bef672014-07-15 09:11:39 -050031* If git is complaining about "fatal: reference is not a tree" with a commit matching a buildroot change, try:
32> rm -rf op-build/buildroot
Brian Silverdd815de2014-07-11 10:22:08 -050033> cd op-build
34> git clone --recursive git@github.com:open-power/buildroot.git
35
Brian Silverdd815de2014-07-11 10:22:08 -050036
37* If make is complaining during skiboot link phases, revert make to version 3.81
38-- On Fedora
39--> sudo rpm -del --nodeps make
40--> sudo wget ftp://fr2.rpmfind.net/linux/centos/6.5/os/x86_64/Packages/make-3.81-20.el6.x86_64.rpm
41--> sudo rpm --install make-3.81-20.el6.x86_64.rpm
42
caustenb6bef672014-07-15 09:11:39 -050043(instructions for make reversion from http://curiositydrivendevelopment.blogspot.com)