Unix

We develop on Solaris 2.6-2.9, Red Hat 8 and Enterprise Edition, Mac OS X, and Debian Linux stable and unstable, so those currently work out-of-the-box. Other Unix-like systems should work without too much configuration.

Server Core client
(non-graphical) Core client
(graphical) API
(non-graphical) API
(graphical)

GNU tools:
GCC 3.0.4+
autoconf 2.59+
automake 1.9.3+ X X X X X

Python 2.2+
MySQLdb module 0.9.2+ (see installation instructions)
xml module
packages: python-mysqldb, python-xml X

MySQL 4.0+ or 4.1+
MySQL client
packages: mysql-server, mysql-client X

Apache with mod_ssl and PHP 4.0+
packages: apache2, apache, apache-ssl X

WxWidgets 2.4.2 (Mac: 2.5.3)
GTK+ 2.5.6

X

GL, GLU, GLUT libraries

X

X11 libraries and include files

X
X

configure option --enable-server --enable-client --enable-client (if WxWidgets and X11 found) --enable-client --enable-client (if GL/GLU/GLUT found)

	Server	Core client (non-graphical)	Core client (graphical)	API (non-graphical)	API (graphical)
GNU tools: GCC 3.0.4+ autoconf 2.59+ automake 1.9.3+	X	X	X	X	X
Python 2.2+ MySQLdb module 0.9.2+ (see installation instructions) xml module packages: python-mysqldb, python-xml	X
MySQL 4.0+ or 4.1+ MySQL client packages: mysql-server, mysql-client	X
Apache with mod_ssl and PHP 4.0+ packages: apache2, apache, apache-ssl	X
WxWidgets 2.4.2 (Mac: 2.5.3) GTK+ 2.5.6			X
GL, GLU, GLUT libraries					X
X11 libraries and include files			X		X
`configure` option	--enable-server	--enable-client	--enable-client (if WxWidgets and X11 found)	--enable-client	--enable-client (if GL/GLU/GLUT found)

Server notes

The feeder and scheduling server use shared memory. On hosts where these run, the operating system must have shared memory enabled, with a maximum segment size of at least 32 MB. How to do this depends on the operating system; some information is here.

MySQL notes

After installing and running the server, grant permissions for your own account and for the account under which Apache runs ('nobody' in the following; may be different on your machine). All mysql accounts should be password protected including root.

    mysql -u root
    grant all on *.* to yourname@localhost identified by 'password';
    grant all on *.* to yourname identified by 'password';
    grant all on *.* to nobody@localhost identified by 'password';
    grant all on *.* to nobody identified by 'password';

Set your PATH variable to include MySQL programs (typically /usr/local/mysql and /usr/local/mysql/bin).
You'll need to back up your database. Generally this requires stopping the project, making a copy or snapshot, and restarting. An example is here.

PHP notes

Make sure 'magic quotes' are enabled (this is the default). The file /etc/php.ini should contain
```
magic_quotes_gpc = On
```

Linux notes

Some info on installing BOINC on Linux is here.
To get the X11 support, select the relevant options when you're installing Linux, or (Redhat) go to System Settings/Add Software.
Notes for Debian Linux.

Apache notes

Make sure httpd.conf sets the default MIME type as follows:

DefaultType application/octet-stream

Suppose Apache runs as user 'apache' and BOINC daemons runs as user 'boincadm'. Directories created by apache need to be writeable to boincadm. This can be done in any of several ways:

Use Apache's suexec mechanism to make the CGI programs run as boincadm.
Make the CGI programs setuid and owned by boincadm.
Edit /etc/group so that boincadm belongs to group apache, i.e. the line:
```
    apache:x:48:
```
becomes:
```
    apache:x:48:boincadm
```
Add these two lines to the beginning of the apache start script (called apachectl, usually in /usr/sbin on linux):
```
    umask 2
    export umask
```
Apache will need to be stopped/restarted for this to take effect. Now any file apache creates should have group writeable permissions (thanks to the umask) and user boincadm, who now belongs to group apache, should be able to update/delete these files.

Windows

	Core client (non-graphical)	Core client (graphical)	Core client (installer)	API
Visual Studio .NET (Visual C++ 7.0)	X	X		X
WxWidgets 2.4.2		X
Installshield X			X

WxWidgets notes

Download and install the WxWidgets source according to instructions on the web site.
In Settings/Control Panel/System, select Advanced; click Environment Variables. Under 'User variables' click New. Create a variable named 'wxwin' with value 'c:\wx' (or wherever you installed it). Then restart Visual Studio.