All platforms

Note for International use - We lack sufficient manpower at present for any real internationalization support. In particular some users have reported problems with the use of ',' rather than '.' in numbers. The only known solution at present is to set English to your language.

Testing

After installing on any of the systems below, you should test to make sure it's working. While we have unit testing, it is mainly for developers. Instead, we suggest just running the following 4 basic tests:

Mac OS X

Mac OS X 10.7 - 10.8 are supported for EMAN2 nightly builds (10.6 is only supported in older, pre 2.1 releases). Download the appropriate dmg from the nightly build page, copy "EMAN2" to your "/Applications" folder. Instructions on loading the environment variable init script are included in the README.txt file included in the disk image.

There is also a visual installation guide that explains the process with screenshots.

Linux

In the following installation instruction, we assume you are installing EMAN2 in your home directory (no root privileges required), it can also be installed system-wide, in which case each user needs to source the eman2.bashrc file.

There are 2 Linux binaries:

If you are upgrading from a previous version of EMAN2, please rename or completely remove the old EMAN2 directory before installing the new version. Unpacking the new version on top of an older version can sometimes cause problems. It is critical that you re-run the installer after unpacking the new version, and insure that your .bashrc or other login file is updated. This is the suggested sequence:

rm -rf EMAN2.old
mv EMAN2 EMAN2.old
tar xvjf eman2.daily.linux64.tar.gz
cd EMAN2
./eman2-installer

When the installer is done (takes only a few seconds), it will display an instruction to add eman2.bashrc to your login script (or similar, depending on what shell you use).

If you are familiar with Linux, this instruction should be clear. Just make sure you open a new terminal window to test the installation.

If you are a Linux novice, you need to understand that there are several different 'shells' you can use within your terminal window. The 'shell' is what provides the terminal prompt and what interprets the commands you type. Why there are different ones is a long story, but the default shell for most linux installations is called BASH. Every time you open a new terminal window or log in to the computer with something like SSH, the shell initializes itself by reading a file called .bashrc. EMAN2 has some additions to this file to tell the shell where you installed it, so it can find all of the e2* commands when you run them. You also need to know that on Linux, files starting with '.' are considered hidden files, so if you do an 'ls' you won't see this file, and it may be hidden in your file browser. If you do an 'ls -al', you will see the hidden files too. An easy way to add a line of text to a file, is to (replace text with the line you need to add):

cd
echo text >>.bashrc

This completes the installation. Follow the testing instructions above. If there are problems, please use EMAN2 Google Group. If you cannot use the Google Group for some reason, please feel free to email sludtke@bcm.edu.

Additional tips:

Windows

Environement Variable Setting For EMAN2 (All platforms)

In some rare cases, the EMAN2 installer will not be able to update your environment variables properly. In such cases, we need set up environment variables like PATH, LD_LIBRARY_PATH and PYTHONPATH for EMAN2 to work correctly. These environment variables should be automatically set when you run eman-installer script when you install binary EMAN release.

export EMAN2DIR=${HOME}/EMAN2
export PATH=${PATH}:${EMAN2DIR}/bin
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${EMAN2DIR}/lib
export PYTHONPATH=${PYTHON_PATH}:${EMAN2DIR}/lib

setenv EMAN2DIR ${HOME}/EMAN2
setenv PATH ${PATH}:${EMAN2DIR}/bin
setenv LD_LIBRARY_PATH ${EMAN2DIR}/lib    #setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${EMAN2DIR}/lib if you have LD_LIBRARY_PATH set
setenv PYTHONPATH ${EMAN2DIR}/lib         #setenv PYTHONPATH ${PYTHONPATH}:${EMAN2DIR}/lib  if you have PYTHONPATH set

right click "my computer"->properties->Advanced->Environment Variables
in "system variables"edit the "path" entry, and add: 
C:\EMAN2\bin;C:\EMAN2\lib;C:\EMAN2\python\Python27;C:\EMAN2\python\Python27\Lib\site-packages\PyQt4\bin.

Create a new system variable PYTHONPATH, add: 
C:\EMAN2\lib;C:\EMAN2\bin. 
(note: In the example I suppose you installed EMAN2 into C:\ directory, change it accordingly if you install EMAN2 in other directory.)