fix mageia doc typos
[os-autoinst:os-autoinst.git] / doc / mageia-installation.md
1 # Glen Ogilvie - nelg@mageia.org
2 # December 2013
3
4 The automated installer here has been tested for Mageia 3 and Mageia 4,
5 with more work going into Mageia 4.
6
7
8 # For this to work on Mageia 2/3
9 ## KVM
10
11 Ensure that libvirtd is running, and that you have hardware support for libvirtd.
12 Set the permissions on /dev/kvm for the user you are running the test under, for example:
13
14 ```bash
15   setfacl -m "user:test:rw" /dev/kvm
16   su - test
17   cd tmp
18   ../os-autoinst/tools/isotovideo Mageia-3-beta4-x86_64-DVD.iso
19 ```
20
21 Provided that os-autoinst is in ~test/ and the iso is in ~test/tmp/
22
23 ### Required RPMs
24 ```bash
25   urpmi swig perl-Data-Dump
26   urpmi perl-devel
27   urpmi ffmpeg2theora
28   urpmi tigervnc
29   urpmi perl-Inline
30   urpmi mtools
31
32 ```
33 #### Mageia 3 (Optional, for openvc support)
34 ```bash
35   urpmi opencv-devel
36   urpmi lib64opencv_nonfree
37 ```
38 ## env
39 This instructions assumes you are going to use a user on your system called test,
40 and that you have your hypervisor setup, see above:
41
42 0.  Switch to your test user:
43     `su - test`
44 1.  Download os-autoinst, using git:
45     `git clone git://github.com/nelg/os-autoinst.git`
46 2.  Compile:
47
48 ```bash
49   ./autogen.sh
50   ./configure --with-opencv
51   make
52 ```
53
54 3.  Download, or place a copy of Mageia-3-beta4-x86_64-DVD.iso or simular into ~test/tmp
55     `cd ~/tmp
56     wget ..`
57 4.  Ensure you have at least 8gb free disk space.
58     `df -h`
59 5.  Copy the enviroment file to ~/tmp
60 ```bash
61     cd ~/tmp
62     cp ~/os-autoinst/env-mageia3.sh.sample env.sh
63     vi env.sh
64 ``` 
65     (See comments within file)
66
67 6.  Run the test
68     `../os-autoinst/tools/isotovideo Mageia-3-beta4-x86_64-DVD.iso`
69
70 ## watching the test
71 To watch the test, use
72   `vncviewer -PreferredEncoding=raw localhost:99`
73
74 Note, the -PreferredEncoding=raw flag is really important.  Without this, your CPU usage will rocket up and the waitidle tests will generally fail, which will tend to cause the automated install to not work very well.
75
76
77 To watch after the test has run, use:
78   `mplayer video/Mageia-3-beta4-x86_64-DVD.ogv`
79 You can step through individual frames after pausing it, using the . key.
80
81 ## Editing the tests
82 Tests can be edited by editing ~/os-autoinst/distri/mageia/inst.d/
83 Also, general behaviour of the tests can be changed by editing env.sh, where the tests support it.  Currently, read the source to find out.
84
85 - - -
86
87 # Testing Mageia 4
88 This is currently capable of installing Mageia 4 from Mageia-4-RC-x86_64-DVD.iso,
89 with the following variations, as set in env.sh
90
91 KDE, Gnome or no desktop, LVM or non-LVM based partitioning.
92
93 At 28 Dec 2013, there is a bug in the installer that sometimes will
94 cause the installer to mis-align, in which case the test will fail, as it
95 can't match what it expects to find. 
96
97 Currently it relies on recognising certain parts of the install screen,
98 using md5sum's.  This is unreliable, but needed because things in the installer
99 change depending on factors like disk size, and the automated installer
100 needs to push the right buttons. The final output will always have the word fail in it. 
101 To check, look at the video, and see if serail0 file ends up with "010_consoletest_setup OK" in it.
102
103 If your computer is powerful enough, you can run multiple install tests at the 
104 same time.  
105
106 To get stated with testing Mageia4, do the following:
107 ```bash
108   su - test
109   git clone git://github.com/nelg/os-autoinst.git
110   cd os-autoinst; ./autogen.sh; ./configure --with-opencv; make; cd ..
111   mkdir -p ~/tmp/test{1..2}
112   cp ~/os-autoinst/env-mageia4.sh.sample1 ~/tmp/test1/env.sh 
113   cp ~/os-autoinst/env-mageia4.sh.sample2 ~/tmp/test2/env.sh 
114   rsync / wget Mageia ISO.
115   ln Mageia-4-RC-x86_64-DVD.iso ~/tmp/test1/
116   ln Mageia-4-RC-x86_64-DVD.iso ~/tmp/test2/
117 ```
118
119 Window 1
120 ```bash
121   cd ~/tmp/test1/
122   ~/os-autoinst/tools/isotovideo Mageia-4-RC-x86_64-DVD.iso
123 ```
124 Window 2
125 ```bash
126   cd ~/tmp/test1/
127   ~/os-autoinst/tools/isotovideo Mageia-4-RC-x86_64-DVD.iso
128 ```
129
130 Viewing (careful with your mouse):
131 ```bash
132   vncviewer -PreferredEncoding=raw localhost:98
133   vncviewer -PreferredEncoding=raw localhost:99
134 ```
135
136 Screenshot viewing (preferred):
137   Turn on previews and use dolphin to view ~/tmp/test1/qemuscreenshot and ~/tmp/test2/qemuscreenshot
138
139