]>
Commit | Line | Data |
---|---|---|
6494ea4c BP |
1 | How to Build Debian Packages for Open vSwitch |
2 | ============================================= | |
3 | ||
4 | This document describes how to build Debian packages for Open vSwitch. | |
5 | To install Open vSwitch on Debian without building Debian packages, | |
6 | see INSTALL instead. | |
7 | ||
8 | These instructions should also work on Ubuntu and other Debian | |
9 | derivative distributions. | |
10 | ||
11 | ||
12 | Before You Begin | |
13 | ---------------- | |
14 | ||
15 | Before you begin, consider whether you really need to build packages | |
16 | yourself. Debian "wheezy" and "sid", as well as recent versions of | |
17 | Ubuntu, contain pre-built Debian packages for Open vSwitch. It is | |
18 | easier to install these than to build your own. To use packages from | |
19 | your distribution, skip ahead to "Installing .deb Packages", below. | |
20 | ||
21 | ||
22 | Building Open vSwitch Debian packages | |
23 | ------------------------------------- | |
24 | ||
25 | You may build from an Open vSwitch distribution tarball or from an | |
26 | Open vSwitch Git tree with these instructions. | |
27 | ||
28 | You do not need to be the superuser to build the Debian packages. | |
29 | ||
30 | 1. Install the "build-essential" and "fakeroot" packages, e.g. with | |
31 | "apt-get install build-essential fakeroot". | |
32 | ||
33 | 2. Obtain and unpack an Open vSwitch source distribution and "cd" into | |
34 | its top level directory. | |
35 | ||
36 | 3. Install the build dependencies listed under "Build-Depends:" near | |
37 | the top of debian/rules. You can install these any way you like, | |
38 | e.g. with "apt-get install". | |
39 | ||
40 | Check your work by running "dpkg-checkbuilddeps". If you've | |
41 | installed all the dependencies properly, dpkg-checkbuilddeps will | |
42 | exit without printing anything. If you forgot to install some | |
43 | dependencies, it will tell you which ones. | |
44 | ||
45 | 4. Run: | |
46 | ||
47 | fakeroot debian/rules binary | |
48 | ||
49 | This will do a serial build that runs the unit tests. If you | |
50 | prefer, you can run a faster parallel build, e.g.: | |
51 | ||
52 | DEB_BUILD_OPTIONS='parallel=8' fakeroot debian/rules binary | |
53 | ||
54 | If you are in a big hurry, you can even skip the unit tests: | |
55 | ||
56 | DEB_BUILD_OPTIONS='parallel=8 nocheck' fakeroot debian/rules binary | |
57 | ||
58 | 5. The generated .deb files will be in the parent directory of the | |
59 | Open vSwitch source distribution. | |
60 | ||
61 | ||
62 | Installing .deb Packages | |
63 | ------------------------ | |
64 | ||
65 | These instructions apply to installing from Debian packages that you | |
66 | built yourself, as described in the previous section, or from packages | |
67 | provided by Debian or a Debian derivative distribution such as Ubuntu. | |
68 | In the former case, use a command such as "dpkg -i" to install the | |
69 | .deb files that you build, and in the latter case use a program such | |
70 | as "apt-get" or "aptitude" to download and install the provided | |
71 | packages. | |
72 | ||
73 | You must be superuser to install Debian packages. | |
74 | ||
f085ba1e BP |
75 | 1. Start by installing an Open vSwitch kernel module. See |
76 | debian/openvswitch-switch.README.Debian for the available options. | |
6494ea4c | 77 | |
ff23db30 GS |
78 | 2. Install the "openvswitch-switch" and "openvswitch-common" packages. |
79 | These packages include the core userspace components of the switch. | |
80 | ||
6494ea4c BP |
81 | Open vSwitch .deb packages not mentioned above are rarely useful. |
82 | Please refer to their individual package descriptions to find out | |
83 | whether any of them are useful to you. | |
84 | ||
85 | ||
86 | Bug Reporting | |
87 | ------------- | |
88 | ||
89 | Please report problems to bugs@openvswitch.org. | |
90 |