X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Finstallation-virtualbox.rst;h=98bc2bb1d449c65ea68d9c071ab91784d08f2d6d;hb=ba456a2db7dc1d1e3ab3bb15b5878dd01dfa2756;hp=30e029d74dcfea556d382ad564241b378a99d928;hpb=c1be4252fcf2a9fa9132e71899b29e4fb0d6e3b1;p=it%2Fdep.git diff --git a/docs/installation-virtualbox.rst b/docs/installation-virtualbox.rst index 30e029d7..98bc2bb1 100644 --- a/docs/installation-virtualbox.rst +++ b/docs/installation-virtualbox.rst @@ -1,10 +1,10 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. SPDX-License-Identifier: CC-BY-4.0 .. ===============LICENSE_START======================================================= -.. Copyright (C) 2019 AT&T Intellectual Property +.. Copyright (C) 2019-2020 AT&T Intellectual Property .. =================================================================================== -.. This documentation file is distributed under the Creative Commons Attribution -.. 4.0 International License (the "License"); you may not use this file except in +.. This documentation file is distributed under the Creative Commons Attribution +.. 4.0 International License (the "License"); you may not use this file except in .. compliance with the License. You may obtain a copy of the License at .. .. http://creativecommons.org/licenses/by/4.0 @@ -18,66 +18,67 @@ Networking ----------- -The set up requires two VMs connected by a private network. With VirtualBox, this can be done by going under its "Preferences" menu and set up a private NAT network. +^^^^^^^^^^ +The set up requires two VMs connected by a private network. With VirtualBox, this can be +done by going under its "Preferences" menu and setting up a private NAT network. -1. "Preference", then select the "Network" tab; -2. Clicking on the "+" icon to create a new NAT network. A new entry will appear in the NAT networks list; -3. Double clicking on the new network to edit its details, including giving int a name such as "RICNetwork"; -4. On the next page, make sure to check: "Enable Network", uncheck the "Supports DHCP" box, and make a note of the "Network CIDR" (for this example, it is 10.0.2.0/24); -5. Click on the "Port Forwarding" button to create the following rules: +#. Pick "Preferences", then select the "Network" tab; +#. Click on the "+" icon to create a new NAT network. A new entry will appear in the NAT networks list +#. Double click on the new network to edit its details; give it a name such as "RICNetwork" +#. In the dialog, make sure to check the "Enable Network" box, uncheck the "Supports DHCP" box, and make a note of the "Network CIDR" (for this example, it is 10.0.2.0/24); +#. Click on the "Port Forwarding" button then in the table create the following rules: - 1. "ssh to ric", TCP, 127.0.0.1, 22222, 10.0.2.100, 22; - 2. "ssh to aux", TCP, 127.0.0.1, 22223, 10.0.2.101, 22; - 3. "entry to ric", TCP, 127.0.0.1, 22224, 10.0.2.100, 32080; - 4. "entry to aux", TCP, 127.0.0.1, 22225, 10.0.2.101, 32080. + #. "ssh to ric", TCP, 127.0.0.1, 22222, 10.0.2.100, 22; + #. "ssh to aux", TCP, 127.0.0.1, 22223, 10.0.2.101, 22; + #. "entry to ric", TCP, 127.0.0.1, 22224, 10.0.2.100, 32080; + #. "entry to aux", TCP, 127.0.0.1, 22225, 10.0.2.101, 32080. -6. "Ok" all the way back to create the network. +#. Click "Ok" all the way back to create the network. Creating VMs -------------- +^^^^^^^^^^^^ Create a VirtualBox VM: -1. "New", then enter the following in the pop-up: Name it for example **myric**, of "Linux" type, and at least 4G RAM and 10G disk; -2. "Create" to create the VM. It will appear in the list of VMs. -3. Highlight the new VM entry, right click on it, select "Settings". +#. "New", then enter the following in the pop-up: Name it for example **myric**, of "Linux" type, and at least 6G RAM and 20G disk; +#. "Create" to create the VM. It will appear in the list of VMs. +#. Highlight the new VM entry, right click on it, select "Settings". - 1. Under the "System" tab, then "Processor" tab, make sure to give the VM at least 2 vCPUs. - 2. Under the "Storage" tab, point the CD to a Ubuntu 18.04 server ISO file; - 3. Under the "Network" tab, then "Adapter 1" tab, make sure to: + #. Under the "System" tab, then "Processor" tab, make sure to give the VM at least 2 vCPUs. + #. Under the "Storage" tab, point the CD to a Ubuntu 18.04 server ISO file; + #. Under the "Network" tab, then "Adapter 1" tab, make sure to: - 1. Check "Enable Network Adapter"; - 2. Attached to "NAT Network"; - 3. Network name for what was created in the previous section: "RICNetwork". + #. Check "Enable Network Adapter"; + #. Attached to "NAT Network"; + #. Select the Network that was created in the previous section: "RICNetwork". Repeat the process and create the second VM named **myaux**. Booting VM and OS Installation ------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Follow the OS installation steps to install OS to the VM virtual disk media. Make sure to install openssh server. +Follow the OS installation steps to install OS to the VM virtual disk media. During the setup you must +configure static IP addresses as discussed next. And make sure to install openssh server. VM Network Configuration -------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^ -Depending on the version of the OS, the networking may be configured during the OS installation or after. The network interface is configured with static IP address: +Depending on the version of the OS, the networking may be configured during the OS installation or after. +The network interface is configured with a static IP address: - IP Address: 10.0.2.100 for myric or 10.0.2.101 for myaux; -- Network: 10.0.2.10/24, or network mask 255.255.255.0 +- Subnet 10.0.2.0/24, or network mask 255.255.255.0 - Default gateway: 10.0.2.1 -- Name server: 8.8.8.8 +- Name server: 8.8.8.8; if access to that is is blocked, configure a local DNS server -Accessing the VMs ------------------ +Accessing the VMs +^^^^^^^^^^^^^^^^^ -Because of the port forwarding configurations, the VMs are accessible from the VirtualBox host via ssh. +Because of the port forwarding configurations, the VMs are accessible from the VirtualBox host via ssh. - To access **myric**: ssh {{USERNAME}}@127.0.0.1 -p 22222 - To access **myaux**: ssh {{USERNAME}}@127.0.0.1 -p 22223 - -