Differences between revisions 12 and 38 (spanning 26 versions)

EMEN2 Dependencies

For basic client usage, no dependencies are required beyond the basic Python environment; the GUI clients require PyQt4. See EMEN2/EMDash for more information.

On the database server side, Berkeley DB and bsddb3 are required for basic functionality. If you want to run the web server, you will also need Twisted, Markdown, and Mako. Additional server features, such as thumbnails and plotting, are provided by EMAN2 and ImageMagick.

Please note that we include all EMEN2 dependencies in the EMAN2 binary distribution's Python environment. This is the recommended installation, and generally how we run it ourselves.

Python Environment

Python 2.6 or 2.7
- Note: do not use Python 3.0+
- http://www.python.org

Core Database

Berkeley DB 5.x+
- BDB is the storage and transactional backend for EMEN2
- Note: Relatively recent 4.8.2x release are probably OK as well
- http://www.oracle.com/technology/software/products/berkeley-db/index.html
bsddb3 5.x+
- Python bindings for Berkeley DB
- Note: Relatively recent 4.8.2x release are probably OK as well
- http://www.jcea.es/programacion/pybsddb.htm
- "easy_install bsddb3"

Web Server

Mako Templates (latest)
- A simple, fast templating system for Python
- http://www.makotemplates.org/
- "easy_install mako"
Twisted 10.x+
- An event-driven networking engine written in Python
- http://twistedmatrix.com/trac/
- "easy_install twisted"
Markdown
- Simplified rich-text editing
- "easy_install Markdown"

Web Server: Optional

EMAN2 (highly recommended)
- EMAN2 is optionally used to generate browsable micrograph previews.
- http://ncmi.bcm.edu/ncmi/software/counter_222/software_86
ImageMagick (recommended)
- Thumbnail and document preview support for "normal" image formats (jpg, png, etc.)
- Commonly installed on Linux
- http://www.imagemagick.org/
pyOpenSSL
- Network encryption
- "easy_install pyOpenSSL"

-  ⇤ ← Revision 12 as of 2010-03-29 10:02:29 → 
  Size: 1652
  Editor: root
  Comment:
+   ← Revision 38 as of 2012-03-12 08:55:45 → ⇥
  Size: 2058
  Editor: IanRees
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 3:
-[[EMEN2]] is dependent on several other packages. With the exception of Python, which is generally up to date and well-packaged on most systems, I recommend downloading the latest version from the project's site and installing it, or using easy_install for the package if possible. (Linux/Mac package management systems often have out of date software.)
+For basic client usage, no dependencies are required beyond the basic Python environment; the GUI clients require PyQt4. See [[EMEN2/EMDash]] for more information.
 Line 5:
-If I have specified a version, it is the minimum version I have tested EMEN2 with. I cannot guarantee success with versions earlier than noted.
+On the database server side, Berkeley DB and bsddb3 are required for basic functionality. If you want to run the web server, you will also need Twisted, Markdown, and Mako. Additional server features, such as thumbnails and plotting, are provided by EMAN2 and ImageMagick.

Please note that we include all EMEN2 dependencies in the EMAN2 binary distribution's Python environment. This is the recommended installation, and generally how we run it ourselves.

== Python Environment ==

 * Python 2.6 or 2.7
  * Note: do not use Python 3.0+
  * http://www.python.org
-Line 8:
+Line 16:
-* Python 2.5+
 (note: do not use Python 3.0)
 http://www.python.org
+== Core Database ==
-Line 12:
+Line 18:
+ * Berkeley DB 5.x+
  * BDB is the storage and transactional backend for EMEN2
  * Note: Relatively recent 4.8.2x release are probably OK as well
  * http://www.oracle.com/technology/software/products/berkeley-db/index.html
-Line 13:
+Line 23:
-* Berkeley DB 4.8.24+
 BDB is the storage and transactional backend for EMEN2
 http://www.oracle.com/technology/software/products/berkeley-db/index.html
+ * bsddb3 5.x+
  * Python bindings for Berkeley DB
  * Note: Relatively recent 4.8.2x release are probably OK as well  
  * http://www.jcea.es/programacion/pybsddb.htm
  * "easy_install bsddb3"
-Line 17:
+Line 29:
+== Web Server ==
-Line 18:
+Line 31:
-* bsddb3 4.8.4+ (latest)
 Python bindings for Berkeley DB
 http://www.jcea.es/programacion/pybsddb.htm
 "easy_install bsddb3"
+ * Mako Templates (latest)
  * A simple, fast templating system for Python
  * http://www.makotemplates.org/ 
  * "easy_install mako"
-Line 23:
+Line 36:
+ * Twisted 10.x+
  * An event-driven networking engine written in Python
  * http://twistedmatrix.com/trac/ 
  * "easy_install twisted"
-Line 24:
+Line 41:
-* Mako Templates (latest)
 A simple, fast templating system for Python
 http://www.makotemplates.org/
 "easy_install makotemplates"
+ * Markdown
  * Simplified rich-text editing
  * "easy_install Markdown"
-Line 29:
+Line 45:
+== Web Server: Optional ==
-Line 30:
+Line 47:
-* demjson (latest)
 A fast, compliant JSON module
 http://deron.meranda.us/python/demjson/
 "easy_install demjson"
 * note: EMEN2 may use the Python json standard library in the future
+ * EMAN2 (highly recommended)
  * EMAN2 is optionally used to generate browsable micrograph previews.
  * http://ncmi.bcm.edu/ncmi/software/counter_222/software_86
-Line 36:
+Line 51:
+ * ImageMagick (recommended)
  * Thumbnail and document preview support for "normal" image formats (jpg, png, etc.)
  * Commonly installed on Linux
  * http://www.imagemagick.org/
-Line 37:
+Line 56:
-* Twisted 10.x+
 An event-driven networking engine written in Python
 http://twistedmatrix.com/trac/
 "easy_install twisted"


* PyYAML (latest)
 Configuration file is YAML-based
 "easy_install yaml"


* pyOpenSSL
 Network encryption
 "easy_install pyOpenSSL"


* EMAN2
 EMAN2 is optionally used to generate browsable micrograph previews.
 http://ncmi.bcm.edu/ncmi/software/counter_222/software_86
+ * pyOpenSSL
  * Network encryption 
  * "easy_install pyOpenSSL"