Removed index files from all doc directories, rearranged headings, fixed broken links...
[pharos.git] / docs / configguide / jumpserverinstall.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3 .. (c) 2016 OPNFV.
4
5
6 Jump Server Configuration
7 -------------------------
8
9 Jump server install procedures are maintained by each installer project. Addional Jump server
10 configuraton BKMs will be maintained here. The below install information was used for Fuel however
11 may be outdated (please refer to Fuel Installer documents).
12
13 **Procedure**
14
15 1. Obtain CentOS 7 Minimal ISO and install
16
17   ``wget http://mirrors.kernel.org/centos/7/isos/x86_64/CentOS-7-x86_64-Minimal-1503-01.iso``
18
19 2. Set parameters appropriate for your environment during installation
20
21 3. Disable NetworkManager
22
23   ``systemctl disable NetworkManager``
24
25 4. Configure your /etc/sysconfig/network-scripts/ifcfg-* files for your network
26
27 5. Restart networking
28
29   ``service network restart``
30
31 6. Edit /etc/resolv.conf and add a nameserver
32
33   ``vi /etc/resolv.conf``
34
35 7. Install libvirt & kvm
36
37   ``yum -y update``
38   ``yum -y install kvm qemu-kvm libvirt``
39   ``systemctl enable libvirtd``
40
41 8. Reboot:
42
43   ``shutdown -r now``
44
45 9. If you wish to avoid annoying delay when use ssh to log in, disable DNS lookups:
46
47   ``vi /etc/ssh/sshd_config``
48
49   Uncomment "UseDNS yes", change 'yes' to 'no'.
50
51   Save
52
53 10. Restart sshd
54
55   ``systemctl restart sshd``
56
57 11. Install virt-install
58
59   ``yum -y install virt-install``
60
61 12. Visit artifacts.opnfv.org and D/L the OPNFV Fuel ISO
62
63 13. Create a bridge using the interface on the PXE network, for example: br0
64
65 14. Make a directory owned by qemu:
66
67   ``mkdir /home/qemu; mkdir -p /home/qemu/VMs/fuel-6.0/disk``
68
69   ``chown -R qemu:qemu /home/qemu``
70
71 15. Copy the ISO to /home/qemu
72
73   ``cd /home/qemu``
74
75   ``virt-install -n opnfv-2015-05-22_18-34-07-fuel -r 4096 --vcpus=4
76   --cpuset=0-3 -c opnfv-2015-05-22_18-34-07.iso --os-type=linux
77   --os-variant=rhel6 --boot hd,cdrom --disk
78   path=/home/qemu/VMs/mirantis-fuel-6.0/disk/fuel-vhd0.qcow2,bus=virtio,size=50,format=qcow2
79   -w bridge=br0,model=virtio --graphics vnc,listen=0.0.0.0``
80
81 16. Temporarily flush the firewall rules to make things easier:
82
83   ``iptables -F``
84
85 17. Connect to the console of the installing VM with your favorite VNC client.
86
87 18. Change the IP settings to match the pod, use an IP in the PXE/Admin network for the Fuel Master