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 5.14.2.1 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:
  1. 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!