diff mbox

[ovs-dev] INSTALL.md: Explain the effect of using different configure options.

Message ID 1459351426-1399-1-git-send-email-guru@ovn.org
State Accepted
Headers show

Commit Message

Gurucharan Shetty March 30, 2016, 3:23 p.m. UTC 
Over the years, I have seen multiple users inadvertantly end up with 2 copies
of OVS executables in their filesystem. In all the cases, it was because of
using different configure options while installing a new version of
Open vSwitch.

Signed-off-by: Gurucharan Shetty <guru@ovn.org>
---
 INSTALL.md |   19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

Comments

Ben Pfaff March 30, 2016, 3:41 p.m. UTC | #1 
On Wed, Mar 30, 2016 at 08:23:46AM -0700, Gurucharan Shetty wrote:
> Over the years, I have seen multiple users inadvertantly end up with 2 copies
> of OVS executables in their filesystem. In all the cases, it was because of
> using different configure options while installing a new version of
> Open vSwitch.
> 
> Signed-off-by: Gurucharan Shetty <guru@ovn.org>

Thanks!  Maybe this will help.

Acked-by: Ben Pfaff <blp@ovn.org>
Gurucharan Shetty March 30, 2016, 3:48 p.m. UTC | #2 
On 30 March 2016 at 08:41, Ben Pfaff <blp@ovn.org> wrote:

> On Wed, Mar 30, 2016 at 08:23:46AM -0700, Gurucharan Shetty wrote:
> > Over the years, I have seen multiple users inadvertantly end up with 2
> copies
> > of OVS executables in their filesystem. In all the cases, it was because
> of
> > using different configure options while installing a new version of
> > Open vSwitch.
> >
> > Signed-off-by: Gurucharan Shetty <guru@ovn.org>
>
> Thanks!  Maybe this will help.
>
> Acked-by: Ben Pfaff <blp@ovn.org>
>
Thank you, applied!
diff mbox

Patch

diff --git a/INSTALL.md b/INSTALL.md
index 761a81b..5b37786 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -171,11 +171,17 @@  usually invoke configure without any arguments.  For example:
 
       `% ./configure`
 
-By default all files are installed under /usr/local.  If you want
-to install into, e.g., /usr and /var instead of /usr/local and
-/usr/local/var, add options as shown here:
+By default all files are installed under /usr/local.  Open vSwitch also
+expects to find its database in /usr/local/etc/openvswitch by default.
+If you want to install all files into, e.g., /usr and /var instead of
+/usr/local and /usr/local/var and expect to use /etc/openvswitch as the default
+database directory, add options as shown here:
 
-      `% ./configure --prefix=/usr --localstatedir=/var`
+      `% ./configure --prefix=/usr --localstatedir=/var --sysconfdir=/etc`
+
+Note that the Open vSwitch installed with packages like .rpm (e.g. via 'yum
+install' or 'rpm -ivh') and .deb (e.g. via 'apt-get install' or 'dpkg -i') use
+the above configure options.
 
 By default, static libraries are built and linked against. If you
 want to use shared libraries instead:
@@ -376,7 +382,10 @@  also upgrade the database schema:
       % kill `cd /usr/local/var/run/openvswitch && cat ovsdb-server.pid ovs-vswitchd.pid`
       ```
 
-2. Install the new Open vSwitch release.
+2. Install the new Open vSwitch release by using the same configure options as
+was used for installing the previous version. If you do not use the same
+configure options, you can end up with two different versions of Open vSwitch
+executables installed in different locations.
 
 3. Upgrade the database, in one of the following two ways: