c13a87e30f9e98b54244e322b77c451646a08573
[vpp.git] / docs / reference / vppvagrant / VagrantVMSetup.rst
1 .. _VagrantVMSetup:
2
3 .. toctree::
4
5 Accessing your VM
6 ^^^^^^^^^^^^^^^^^
7 ssh into the newly created box:
8
9 .. code-block:: shell
10
11     $ vagrant ssh <id>
12
13 Sample output looks like:
14
15 .. code-block:: console
16
17   $ vagrant ssh c1c
18   Welcome to Ubuntu 16.04 LTS (GNU/Linux 4.4.0-21-generic x86_64)
19
20    * Documentation:  https://help.ubuntu.com/
21   Last login: Mon Jun 25 08:05:38 2018 from 10.0.2.2
22   vagrant@localhost:~$
23
24
25 .. note::
26   
27   Type **exit** in the command-line if you want to exit the VM.
28
29 Become the root with:
30
31 .. code-block:: shell
32
33     $ sudo bash
34
35 Now *install* VPP in the VM. Keep in mind that VPP is already built (but not yet installed) at this point based on the commands from the provisioned script *build.sh*. 
36
37 When you ssh into your Vagrant box you will be placed in the directory */home/vagrant*. Change directories to */vpp/build-root*, and run these commands to install VPP based on your OS and architecture:
38
39 For Ubuntu systems:
40
41 .. code-block:: shell
42     
43     # dpkg -i *.deb
44
45 For CentOS systems:
46
47 .. code-block:: shell
48     
49     # rpm -Uvh *.rpm
50
51
52 Since VPP is now installed, you can start running VPP with:
53
54 .. code-block:: shell
55   
56     # service vpp start