blob: 02289e1149a42532c6db6449ebc47fbf771f2058 [file] [log] [blame]
Seshu-Kumar-M5d61a3f2017-10-05 16:05:01 +05301.. _open_cli_schema_version_1_0:
2.. This work is licensed under a Creative Commons Attribution 4.0 International License.
3.. http://creativecommons.org/licenses/by/4.0
4.. Copyright 2017 Huawei Technologies Co., Ltd.
5
6Install and Configure an Ubuntu VM
7==================================
8
9Get Ubuntu
10----------
11Get the Ubuntu ISO image from ubuntu.com. The recommended version is 16.04.3 LTS (Long Term Support), desktop edition.
12
13Get VirtualBox and VirtualBox Guest Additions
14---------------------------------------------
15Make sure you have the VirtualBox Guest Additions ISO for your version of VirtualBox. I'm using VirtualBox 5.1.28. Save the Guest Additions ISO on your host computer along with the Ubuntu ISO. Get the Guest Additions ISO from here:
16 http://download.virtualbox.org/virtualbox
17*NOTE*: Guest Additions versions prior to 5.1 will not work with Ubuntu 16.04.3. If you have an earlier version of VirtualBox, you should upgrade to the latest 5.1 version.
18
19Create a new VM in VirtualBox for Ubuntu
20----------------------------------------
21Type: Linux
22Version: Ubuntu (64-bit)
23At least 2048 MB memory
24At least 40 GB VDI
25Network: Attached to: NAT
26
27Create a port-forwarding rule for SSH
28-------------------------------------
29Create a port-forwarding rule so that you can use PuTTY (or other SSH client) to connect to the VM.
30Go to "Network" settings in VirtualBox, add a port forwarding rule:
31Name: SSH
32Protocol: TCP
33Host IP: 127.0.0.1
34Host Port: 1022
35Guest IP: <leave blank>
36Guest Port: 22
37
38Create Shared Folder
39--------------------
40This is oriented to Windows users. If you're using a MAC or a Linux host computer, the details may be different. You can share any folder on the host computer with the Ubuntu VM. On Windows, a practical choice is to share the C:\Users folder, so that your Windows home directory will be accessible from the Ubuntu VM.
41Go to "Shared Folders" settings in VirtualBox, add a share:
42Folder Path: C:\Users
43Folder Name: Users
44Auto-mount: <checked>
45Read-only: <unchecked>
46
47Install Ubuntu in the VM
48------------------------
49On the "Storage" panel in VirtualBox, click on "[ optical drive ]" and then "Choose Disk Image". Select your Ubuntu ISO image.
50
51After selecting the ISO image, start the VM.
52Follow the prompts to install Ubuntu.
53
54Proxy Configuration (optional)
55------------------------------
56If you're behind a corporate firewall, configure some proxy settings. NOTE: your proxy configuration may require username and password credentials, not shown here.
57**Ubuntu system proxy setting:**
58 System Settings → Network → Network proxy
59 (Replace "proxyhost" and port with your actual proxy information)
60
61**apt proxy setting:**
62 Edit /etc/apt/apt.conf and add one line at the top (replace "proxyhost:port" with your actual proxy information):
63 Acquire::http::Proxy "http://proxyhost:port";
64 Reboot the VM.
65
66Install SSH Server
67------------------
68sudo apt update
69sudo apt install openssh-server
70
71Connect to the VM from your host computer
72-----------------------------------------
73 The PuTTY SSH client is popular. A connection to localhost:1022 (or whatever port you have forwarded) will go to the VM.
74
75Install VirtualBox Guest Additions
76----------------------------------
77On the "Storage" panel in VirtualBox, click on "[ optical drive ]" and then "Choose Disk Image". Select your VirtualBox Guest Additions ISO image.
78
79In a VM terminal window, mount the cdrom:
80 sudo mkdir -p /media/cdrom
81 sudo mount /dev/cdrom /media/cdrom
82Install necessary dependencies:
83 sudo apt update
84 sudo apt install gcc g++ dkms
85Install the guest additions. NOTE: look for errors in the command output! If you see an error that says you are missing kernel headers, the most likely cause is that you are using a VirtualBox version that is too old. The error message is misleading.
86 cd /media/cdrom
87 sudo ./VBoxLinuxAdditions.run
88
89Add yourself to the vboxsf user group (replace "userid" with your user ID):
90 sudo usermod -a -G vboxsf userid
91Reboot the VM.
92In a VM terminal window, verify that you can access your home directory on the host computer, which should be mounted under here:
93 /media/sf_Users