1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
losmoketest.py
--------------
Yifan Jiang <yfjiang@suse.com>
http://dev-builds.libreoffice.org/
The tool is designed to enable test machine fully automatically run smoketest
with both daily and pre release build located in dev-build.libreoffice.org.
The purpose of daily build testing is obvious, we want to catch bugs as early
as possible:) some ideas canbe found here:
http://wiki.documentfoundation.org/Testing_Daily_Builds#Is_parallel_installation_possible_.2F_planned.3F
For the purpose of smoketest for pre release testing, currently there is an
about 24 hrs lag syncing RC build from dev-build to official site. We need to
guarantee at least the very basic function working before more people download
the RC build from official site and play with it, in as short as 24 hrs.
The tool is named as losmoketest for its purpose, meanwhile it help you to
check, download and install the latest build. By the fact the installation is
designed not to be different from manually doing these repeated work, the
installed libreoffice build can also be good for manual test.
Quick Start
-----------
This chapter describe step by step tutorials for a typical quick use of the
tool. More functions can be discovered in section "The Tool -> Usage".
[Linux]
0. If you do not have a python environment, firstly download python here:
http://www.python.org/download/
1. Download binary:
http://dev-builds.libreoffice.org/daily/losmoketest-0.2.tar.bz2
2. Unpack it to, for example, your home directory:
tar xvjf losmoketest-0.2.tar.bz2 -C $HOME
3. Open a terminal
4. In the terminal, input (there's an Enter between each lines):
su -
(enter your root password when it prompts)
cp /etc/sudoers /etc/sudoers.ori
echo "$USER ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
exit
5. In the terminal, input (there's an Enter between each lines):
cd $HOME/losmoketest-0.2
python ./losmoketest.py
A msg OK(1) would be shown When the result successfully
finished. Otherwise, please send the 'log' file to the author or mailing
list libreoffice-qa@lists.freedesktop.org for more investigation.
6. After finish testing, recover the sudoers file by (there's an Enter
between each lines),
su -
(enter your root password)
cp /etc/sudoers.ori /etc/sudoers
exit
[Windows]
0. If you do not have a python environment, firstly download python here:
http://www.python.org/download/
1. Download binary:
http://dev-builds.libreoffice.org/daily/losmoketest-0.2.tar.bz2
2. Unpack it to, for example, C:\
3. Open a console by clicking Start menu -> Run ...
4. Input 'cmd' and press Enter
5. In the terminal, input (there's an Enter between each lines):
cd C:\losmoketest-0.2
.\losmoketest.py
A msg OK(1) would be shown When the result successfully
finished. Otherwise, please send the 'log' file to the author or mailing
list libreoffice-qa@lists.freedesktop.org for more investigation.
The tool
--------
[Prerequisite]
- Python > 2.6
http://www.python.org/download/
- A machine free to play (The test may *override* your existed
libreoffice3.4 installation).
- On Linux, add the following line in /etc/sudoer:
$USER ALL=(ALL) NOPASSWD: ALL
where $USER is your real user name. With this line, every command
initialed with `sudo` will not be asked to input a password. Please
consider the security risk brought by it.
[Features Availability]
Full features are implemented on Linux x86 and x86_64, rpm and deb:
- Checking and dowloading the latest build
- Install the latest build
- Run smoke test on the build (not stable)
Partial features are implemented on Windows:
- Checking and dowloading the latest build
- Install the latest build (Thanks *blip* help find out the command for silent install)
Partial features are implemented on Mac:
- Checking and dowloading the latest build
[Usages]
1. Test the latest pre releases build:
$ cd /path/to/losmoketest
$ ./losmoketest.py # Test the latest pre releases build:
$ ./losmoketest.py -t daily_master # Test the latest daily master build
$ ./losmoketest.py -t daily_branch # Test the latest daily branch build (now 3.4)
2. Just Install the latest LOCAL build:
$ cd /path/to/losmoketest
$ ./losmoketest.py -i # Install the latest pre releases build in losmoketest/_download
$ ./losmoketest.py -i -t daily_master # Install the latest daily master build in losmoketest/_download
$ ./losmoketest.py -i -t daily_branch # Install the latest daily branch build (now 3.4) in losmoketest/_download
3. Just Verify the installed build:
$ cd /path/to/losmoketest
$ ./losmoketest.py -v
4. More tips in:
$ cd /path/to/losmoketest
$ ./losmoketest.py -h
[Tested on]
- SLED 11 sp1 x86
- SLED 11 sp1 x86_64
- OpenSuSE 11.4 x86
- Ubuntu 10.10 x86
[TODO]
1. verify_smoketest() improvement (replace it with more simple script
rather than complicated cppunittester)
2. 'git' it when we have a stable code base
3. handling mac and windows build
[Known issue]
1. The cppunittest performs not quite stable in different libreoffice
build, some times it just hangs there without noticing :(
2. The version tag is desired to get dynamically. The current hard coded
3.4 is not reliable, especially not reliable when verify_smoketest()
tries to set LD_LIBRARY_PATH.
3. Parallel installation with official build has a dependancy on Tinderbox
improvement (the dev-build is ideally to be installed on something like
/opt/lo-dev).
|
