CentOS 5 Install

CentOS 5 requires python 2.4 in order for the package manager (yum) to function. Here is a solution to installing python 2.6 along side it with the required libraries, PIL and NumPy.

CentOS 5 i386 (32-bit) - works for 64-bit as well

1. Make sure you have a compiler installed: yum groupinstall 'Development Tools'
2. Download the source for python 2.6.7 wget http://www.python.org/ftp/python/2.6.7/Python-2.6.7.tar.bz2
3. Extract it tar xjfv Python-2.6.7.tar.bz2
4. Change into the new source directory cd Python-2.6.7
5. Configure it to coincide with system python (EXTREMELY IMPORTANT) ./configure --prefix=/opt
6. Compile it and install it make && make install
7. In another directory, download PIL wget http://effbot.org/downloads/Imaging-1.1.7.tar.gz
8. Extract it tar xzfv Imaging-1.1.7.tar.gz
9. Enter the new source directory cd Imaging-1.1.7
10. Using the 2.6 binary in opt, build PIL /opt/bin/python setup.py build_ext -i
11. Test it too (optional but recommended) /opt/bin/python selftest.py
12. Copy over the libraries so you can compile OverViewer /usr/local/src/Imaging-1.1.7/libImaging/* /opt/include/python2.6/
13. Install PIL /opt/bin/python setup.py install
14. In another directory, download the source for numpy svn co http://svn.scipy.org/svn/numpy/trunk numpy
15. Change directories to the source cd numpy/
16. Using the 2.6 binary build numpy /opt/bin/python setup.py build
17. And install it /opt/bin/python setup.py install
18. In another directory, download Overviewer git clone git://github.com/brownan/Minecraft-Overviewer.git
19. Change to that directory cd Minecraft-Overviewer/
20. Replace the first line of overviewer.py with: #!/usr/bin/env python26
21. Copy terrain.png to your Minecraft-Overviewer directory
22. Compile the c module for overviewer, again with 2.6 binary /opt/bin/python setup.py build
23. Make sure your server isn't running and enjoy ./overviewer.py ../$WORLDFOLDER $DESTFOLDER

CentOS 5 x86_64 (64-bit)

1. Follow the instructions on this page on installing Python 2.6: Python 2.6 on Centos 5.x
2. Install the following packages: yum install python26-imaging python26-devel
3. Make sure you have a compiler installed: yum groupinstall 'Development Tools'
4. Download NumPy source: svn co http://svn.scipy.org/svn/numpy/trunk numpy
5. Enter the numpy folder: cd numpy
6. Build numpy: python26 setup.py build
7. Install numpy: python26 setup.py install
8. Replace the first line of overviewer.py with: #!/usr/bin/env python26

Avoid compiling

I have not tried this myself, but if you want to avoid compiling numpy yourself, there is an rpm that I have found:

1. wget http://download.opensuse.org/repositories/home:/ashigabou/CentOS_5/x86_64/python-numpy-1.2.0-1.4.x86_64.rpm
2. rpm -ivh python-numpy-1.2.0-1.4.x86_64.rpm

Compiling the C Extension (required)

1. Install the following packages: yum install python26-imaging-devel
2. Copy the Imaging headers into the python2.6 include folder: cp /usr/include/python2.6/Imaging/* /usr/include/python2.6/
3. Build the modules: python26 setup.py build

Problems and Solutions

• I receive OSError: [Errno 13] Permission denied error when I run Overviewer!

  • Run this ls -l /dev/ | grep shm
  • If you see drwxr-xr-x instead of drwxrwxrwx then you have two options.
    1. Run overviewer as a single process with -p 1, or
    2. Have your server administrator update the fstab.

• I have other issues

  • Every other issue that I've come across is mentioned in the documentation in README.rst

• Overviewer reports a syntax error

  • Make sure you're using the right version of python. Specifically, either follow step #8 above ("Replace the first line of overviewer.py..."), or make sure that you're using "python26 overviewer.py ..." and _not _"python overviewer.py ..."