summaryrefslogtreecommitdiff
path: root/tutorial
Commit message (Collapse)AuthorAgeFilesLines
...
* Separating OVN NB and SB database processesRYAN D. MOATS2016-03-231-5/+23
| | | | | | | | | | | | OVN NB & SB DB's should be run in separate ovsdb-server processes and should run with ovn-ctl start_northd / stop_northd. This patch includes changes to unit tests, tutorial and debian scripts to remain self-consistent. Signed-off-by: RYAN D. MOATS <rmoats@us.ibm.com> Signed-off-by: Michael Arnaldi <arnaldimichael@gmail.com> Co-authored-by: Michael Arnaldi <arnaldimichael@gmail.com> Signed-off-by: Russell Bryant <russell@ovn.org>
* ovs-sandbox: Add note about OVN to initial output.Russell Bryant2016-03-071-1/+9
| | | | | | | | | | When you run ovs-sandbox, it finishes with a note describing the dummy environment it has set up. Add some additional text that indicates that OVN is also enabled when that is the case. Signed-off-by: Russell Bryant <russell@ovn.org> Acked-by: Ben Pfaff <blp@ovn.org> Acked-by: Ryan Moats <rmoats@us.ibm.com>
* ovn: Add a section on containers in OVN TutorialNuman Siddique2016-02-256-2/+216
| | | | | | Signed-Off-by: Numan Siddique <nusiddiq@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
* ovn: Remove top ovn directory from PATHs.Ilya Maximets2016-01-291-1/+1
| | | | | | | | | | | | | | | Since 5b5c922b0ca6 ("ovn-nbctl: Move ovn-nbctl to utilities directory.") there is no more executables in top ovn directory. Removing of this directory from PATHs helps to avoid problems when old executable ./ovn/ovn-nbctl used instead of ./ovn/utilities/ovn-nbctl. This may happen if source directory was updated to commit 5b5c922b0ca6 without calling 'make clean'. Fixes: 5b5c922b0ca6 ("ovn-nbctl: Move ovn-nbctl to utilities directory.") Signed-off-by: Ilya Maximets <i.maximets@samsung.com> Signed-off-by: Russell Bryant <russell@ovn.org>
* ovn-tutorial: fix a typoWilliam Tu2016-01-181-1/+1
| | | | | | | switch_in_pre_acl -> switch_out_pre_acl Signed-off-by: William Tu <u9012063@gmail.com> Signed-off-by: Russell Bryant <russell@ovn.org>
* ovs-sandbox: assign default value to ${MAKE}qhjindev2016-01-041-1/+1
| | | | | | | | | | | | | | | | When run ovs-sandbox directly from the tutorial directory (the second method in Tutorial.md), the following result show up: $ ./ovs-sandbox -b /media/sda6/network/ovs/build ./ovs-sandbox: line 304: install-man: command not found The reason is that ${MAKE} is not set in the situation. So change ${MAKE} to ${MAKE-make} to resolve the issue. GitHub-PR: #104 Signed-off-by: Qinghua Jin <qhjin_dev@163.com> Signed-off-by: Russell Bryant <russell@ovn.org>
* ovn-tutorial: Use github instead of relative links.Russell Bryant2015-11-121-23/+23
| | | | | | | | | | All of these links when viewing OVN-Tutorial on github, but most of these links didn't work when viewing OVN-Tutorial.md.html in dist-docs. Use full github links so that they always work (as long as you have internet access). Signed-off-by: Russell Bryant <russell@ovn.org> Acked-By: Kyle Mestery <mestery@mestery.com>
* ovn-tutorial: Add a section on ACLs.Russell Bryant2015-11-044-1/+154
| | | | | | | | | | | | | | | Add a section that gives a quick introduction to applying ACLs. It discusses how the ACLs are translated into OVN logical flows. It doesn't get down to the OpenFlow level because that's not supported in ovs-sandbox yet. Instead, it provides a reference to an OpenStack related blog post that talks about how OVN ACLs are used there and gives examples of the resulting OpenFlow flows. In theory, once we have a userspace conntrack implementation available, we'll be able to provide better suppot for it in ovs-sandbox. Signed-off-by: Russell Bryant <rbryant@redhat.com> Acked-by: Kyle Mestery <mestery@mestery.com>
* ovn-nb: Rename Port_Bindings 'macs' column to 'addresses'.Ben Pfaff2015-10-167-49/+49
| | | | | | | In an upcoming commit this column will also support IP+MAC pairs. Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Justin Pettit <jpettit@nicira.com>
* ovn-tutorial: Add more links.Russell Bryant2015-10-131-6/+17
| | | | | | | | | | Add links to several man pages. Also fix a minor typo. Note that openvswitch.org needs to be updated as it's missing the ovn-northd man page. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* ovn: Add an ovs-sandbox based OVN tutorial.Russell Bryant2015-10-0222-2/+1209
| | | | | | | | | | | | | While working on OVN and OVN integration, I've collected a set of scripts for quickly setting up simple test environments using ovs-sandbox with OVN enabled. It seemed like they could be useful to others for learning about OVN or doing quick testing. This patch introduces an ovs-sandbox based tutorial for exploring OVN features in a simulated environment. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* ovn: Automatically create br-int in ovn-controller.Russell Bryant2015-09-081-2/+0
| | | | | | | | | ovn-controller previously required the integration bridge to be created before running ovn-controller. This patch makes ovn-controller automatically create it if it doesn't already exist. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* sandbox: Include vtep dir into the sandbox pathMiguel Angel Ajo2015-09-041-1/+1
| | | | | | | | | Otherwise the built vtep-ctl is not available from the sandbox command line. Signed-off-by: Miguel Angel Ajo <mangelajo@redhat.com> Acked-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* ovs-sandbox: Add support for ovn-controller-vtep.Russell Bryant2015-08-211-2/+16
| | | | | | | | | | | | | | | When ovs-sandbox is run with ovn enabled, create the vtep database and run ovn-controller-vtep. This lets you do some basic testing with ovn-controller-vtep. For example: $ make sandbox SANDBOXFLAGS="--ovn" $ vtep-ctl add-ps ps0 After those commands, you can see that ovn-controller-vtep added a Chassis row to OVN_Southbound for the physical switch. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* ovn-nbctl: Move ovn-nbctl to utilities directory.Alex Wang2015-08-081-1/+1
| | | | | Signed-off-by: Alex Wang <alexw@nicira.com> Acked-by: Russell Bryant <rbryant@redhat.com>
* ovs-sandbox: Fix ovn support.Russell Bryant2015-05-151-2/+12
| | | | | | | | | The last merge from master broke ovs-sandbox OVN support. The rungdb function now takes an additional argument for whether or not the daemon should be automatically started under gdb. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* Merge "master" into "ovn".Justin Pettit2015-05-072-3/+41
|\ | | | | | | | | | | | | This brings in STT. Conflicts: tutorial/ovs-sandbox
| * ovs-sandbox: add '-r' and '-e' optionsAndy Zhou2015-04-142-3/+29
| | | | | | | | | | | | | | | | '-e' option will run ovs-vswitchd under gdb, but runs immediately instead of waiting for user input. '-r' options applies to ovsdb-server. Signed-off-by: Andy Zhou <azhou@nicira.com> Acked-by: Russell Bryant <rbryant@redhat.com>
| * ovs-sandbox: add delay before running ovs-vsctlAndy Zhou2015-04-141-0/+12
| | | | | | | | | | | | | | | | | | | | | | When running ovsdb-server under gdb, there is a race that ovs-vsctl command can be called before ovsdb-server is fully launched. This will cause ovs-vsctl to fail. This patch fixes this by delay issuing the ovs-vsctl command until ovsdb-server is fully launched. Signed-off-by: Andy Zhou <azhou@nicira.com> Acked-by: Russell Bryant <rbryant@redhat.com> Acked-by: Ben Pfaff <blp@nicira.com>
* | ovs-architecture: Recommend disable-in-band=true for integration bridge.Ben Pfaff2015-05-051-1/+2
| | | | | | | | | | | | | | Also implement in ovs-sandbox. Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Justin Pettit <jpettit@nicira.com>
* | ovs-sandbox: Use "secure" mode for br-int, in OVN mode.Ben Pfaff2015-05-051-1/+1
| | | | | | | | | | | | | | | | This is documented in ovn-architecture(7). Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Russell Bryant <rbryant@redhat.com> Acked-by: Justin Pettit <jpettit@nicira.com>
* | ovn: Constrain supported tunnel types.Justin Pettit2015-04-301-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | Limit the supported tunnel types to Geneve and STT on hypervisors, and VXLAN, Geneve, and STT on gateways. This commit adds "DESIGN.md" that describes the reasoning. Wes Felter provided suggestions for improving the wording in the architecture document. Signed-off-by: Justin Pettit <jpettit@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
* | ovn: Rename ovn-nbd to ovn-northd.Russell Bryant2015-04-161-6/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | It came up in a recent discussion that the use of 'nbd' could cause confusion since nbd is used for "Network Block Device", which may be used in many of the same environments that OVN would be used in. To avoid the possible issue, just rename ovn-nbd to ovn-northd. While we're at it, create a subdirectory under ovn/ to hold all files related to ovn-northd. For now it's just a single C file, but we may add more source files in the future. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* | Merge remote-tracking branch 'origin/master' into ovnJustin Pettit2015-04-121-2/+5
|\ \ | |/ | | | | | | Conflicts: tutorial/ovs-sandbox
| * ovs-sandbox: Tell gdb to start the daemon.Russell Bryant2015-04-051-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The current gdb support launches gdb but doesn't start the daemon. If you start ovsdb-server with gdb, ovs-sandbox produces an error as it tries to run ovs-vsctl before ovsdb-server is running. Telling gdb to start the daemon immediately avoids this error. There are cases where it's useful to go straight to the gdb prompt, too. For example, someone may want to set a breakpoint. In that case, it's easy enough to just kill it, set a breakpoint, and execute 'run' again. In passing, fix indentation to use spaces instead of tabs. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
| * ovs-sandbox: Initialize database before starting ovs-vswitchd.Ben Pfaff2015-03-271-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | Otherwise ovs-vswitchd can't immediately start working (until some other call to ovs-vsctl initializes the database). This is most obvious if one runs "ovs-vsctl list Open_vSwitch ." as the first command, because the output will not show the changes that ovs-vswitchd will make to the database at startup (in particular initializing datapath_types and iface_types), which is confusing. Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Russell Bryant <rbryant@redhat.com>
* | ovn: Introduce ovn-controller.Justin Pettit2015-04-121-1/+13
| | | | | | | | | | | | | | | | | | Add new ovn-controller daemon that runs locally on transport nodes. This initial version registers itself in the Chassis table and registers logical ports to the appropriate rows in the Bindings table. Signed-off-by: Justin Pettit <jpettit@nicira.com> Acked-by: Russell Bryant <rbryant@redhat.com>
* | ovs-sandbox: Use new ovn-sb database name.Justin Pettit2015-04-091-10/+10
| | | | | | | | | | | | | | | | | | Commit ec78987 (ovn: Rename "ovn" database to "ovn-sb".) changed the name of the database, but didn't update ovs-sandbox to use this new name. Signed-off-by: Justin Pettit <jpettit@nicira.com> Acked-by: Russell Bryant <rbryant@redhat.com>
* | ovs-sandbox: Add support for ovn-nbd.Russell Bryant2015-04-021-3/+12
| | | | | | | | | | | | | | | | | | Update ovs-sandbox to run ovn-nbd when it is run with OVN enabled. In passing, also fix the indentation of two lines to use spaces instead of tabs. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* | ovs-sandbox: add initial support for ovnRussell Bryant2015-03-121-1/+35
|/ | | | | | | | | | | This patch adds initial support for OVN to ovs-sandbox. If you pass "-o/--ovn" to ovs-sandbox, it will create a db from the ovn and ovn-nb schemas and tell ovsdb-server to use them. It also adds ovn/ to $PATH so that as ovn executables are added, they will be available in the sandbox. Signed-off-by: Russell Bryant <rbryant@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* ovs-sandbox: Add -d option to run ovsdb-server under GDBAndy Zhou2015-02-222-3/+9
| | | | | Signed-off-by: Andy Zhou <azhou@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
* ovs-sandbox: Show the running program on xterm's titleAndy Zhou2015-02-221-2/+5
| | | | | | | | | | When debugging multiple programs under GDB, it will be easier to identify xterms with the program name displayed as title. Without this patch, xterms will have the title of "gdb", which is the first program the xterm executes. This change is useful for the next patch. Signed-off-by: Andy Zhou <azhou@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
* ovs-sandbox: Add an option to allow running ovs-vswitchd under gdbAndy Zhou2015-02-193-4/+49
| | | | | | | | | | | It is some times useful to leverage the sandbox facility to experiment and explore the internals of ovs-vswitchd. Since GDB requires console access for user inputs, this patch launch an xterm for GDB, The main terminal continue to run the sub-shell as before. Exiting the sub-shell will also kill the ovs-vswitchd under GDB (but not GDB itself currently) Signed-off-by: Andy Zhou <azhou@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
* doc: Fix up markdown syntax in tutorial/Tutorial.mdThomas Graf2014-12-051-88/+89
| | | | | Signed-off-by: Thomas Graf <tgraf@noironetworks.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* dist-docs: New utility to generate a documentation bundle for the website.Ben Pfaff2014-12-021-1/+1
| | | | | | | | | | | | | | This utility isn't going to be as portable as most of the Open vSwitch utilities, unfortunately. I'm happy to take improvements to make it able to work with, e.g., the "man" program from BSD. (I haven't tested with that program, but I suspect that it is somewhat different from the GNU version.) The output of this program can already be viewed at: http://openvswitch.org/support/dist-docs/ Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Thomas Graf <tgraf@noironetworks.com>
* doc: Add more cross references between docsThomas Graf2014-10-301-1/+1
| | | | | | | Suggested-by: Lori Jakab <lojakab@cisco.com> Signed-off-by: Thomas Graf <tgraf@noironetworks.com> Reviewed-by: Flavio Leitner <fbl@redhat.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* doc: Convert docs to Markdown languageThomas Graf2014-10-282-90/+85
| | | | | | | | | | | Converts the majority of docs over to use the Markdown language for pretty printing on GitHub. It's a rough first convertion without exploiting the full potential of Markdown at this point. Section titles and indentation are fixed as needed. Minimal docs interlinking is added. Signed-off-by: Thomas Graf <tgraf@noironetworks.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* ovs-sandbox: Use the correct makeYAMAMOTO Takashi2014-06-052-2/+2
| | | | | | | | On some platforms including NetBSD, GNU make is usually installed as "gmake". Signed-off-by: YAMAMOTO Takashi <yamamoto@valinux.co.jp> Acked-by: Ben Pfaff <blp@nicira.com>
* packets: Fix typo in reserved multicast Ethernet addresses.Ben Pfaff2013-06-052-7/+7
| | | | | | | | | The reserved multicast Ethernet addresses begin with 01:80:c2, not 01:08:c2. Reported-by: Padmanabhan Krishnan <kprad1@yahoo.com> Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Ethan Jackson <ethan@nicira.com>
* ovs-sandbox: Use $schema for creating the db.Duffie Cooley2013-05-011-1/+1
| | | | | | | | The code here went to some trouble to properly set $schema and then ignored it. Signed-off-by: Duffie Cooley <dcooley@nicira.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* tutorial: Correct typos.Ben Pfaff2013-04-221-2/+2
| | | | | Reported-by: Yeming Zhao <zhaoyeming@gmail.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
* Add a tutorial for advanced Open vSwitch features.Ben Pfaff2013-04-1910-0/+1141
Signed-off-by: Ben Pfaff <blp@nicira.com>
View Lorry Controller Status