This page explains the steps for setting up a Windows machine for testing of Qt, compatible with the setup used in the Qt Project CI system.
See CI Machine Configuration [qt-project.org] for more information about the CI machine setup.
This is a work in progress and may miss some important details.
- Install Windows 7 32-bit and create at least one user account which can be used for the rest of the steps.
- The account should be named something other than “qt”.
- Various assumptions will need to hold for the CI scripts to work without modification: system directories such as “C:\Windows” and “C:\Users” should be located at these paths and not elsewhere.
- If a VM, install any needed VM tools (e.g. VMware tools for a VMware virtual machine).
- Download and install Strawberry Perl 188.8.131.52 32-bit [strawberryperl.com]
- Use all default options, which means perl.exe will be placed into system PATH.
- Download and install git for Windows version 1.7.10-preview20120409.exe [msysgit.googlecode.com]
- Important: use the “Run Git from the Windows Command Prompt” option, which places git.cmd (but not git.exe) in PATH.
- Important: do not install a newer version of git. Newer versions replace the aforementioned git.cmd script with a git.exe. Currently, some puppet scripts require git.cmd, and it is not easy to update these to support both the git.cmd and git.exe cases together.
- All other options leave as default.
- Restart computer after above installations.
- Otherwise the SYSTEM account (and hence the puppet scheduled task) won’t have git or perl in PATH.
- Download bootstrap_win.pl [qt.gitorious.org] to Desktop or any working folder (it is only needed for setup and may be later removed).
- From an Administrator shell (Start -> Run, hold ctrl+shift as running ‘cmd’), run:
- perl bootstrap_win.pl --puppet-url https://downloads.puppetlabs.com/windows/puppet-3.0.0rc3.msi git://qt.gitorious.org/qtqa/sysadmin
- This script will download and install puppet, clone the qtqa/sysadmin repository, and run puppet once. It needs to be run as Administrator because puppet will otherwise not have the necessary permissions to install itself as a scheduled task.
- If problems occur while running this script, the steps normally done by the script can be run manually.
- During the above step, a dialog box ought to pop up stating that the machine needs to be rebooted. Allow it to reboot (or save some time and reboot it yourself).
- the rest is yet to be written!