Leginon

h1. Using Redux to serve images on myamiweb

*Before you begin:*

Redux is new for CentOS 6 (PHP 5.3). 

If you want to install *Appion/Leginon 2.2 on CentOS 5*, you do not need to install Redux. Instead, you must follow the directions to [[Install the MRC PHP Extension]].

h2. Installation

# Follow [[Web_Server_Installation]] but ignore warning on not using php 5.3

# Install myami-redux branch of myami on the webserver machine.

** Install redux prerequisites as found in its README file

** Redux needs write permission at its installation location to write fftw wisdom file.

** Install python filesystem abstraction for redux caching like this:

<pre>

sudo easy_install fs

</pre>

h2. Configurations:

h3. configure redux

<pre>

> cd /YourMyamDownload/redux

> cp redux.cfg.template redux.cfg

</pre>

* You can also copy it to /etc/myami/redux.cfg if you prefer.

* Turn on redux caching if desired,

<pre>

[cache]

enable: yes

path: /var/cache/myami/redux

disksize:  500

memsize: 500

</pre>

*You need to make sure the cache path exists and writable by the user that starts the redux server (reduxd)*

** Input the desired disk_cache_path, disk_cache_size, and mem_cache_size in the next few lines

** Create the disk_cache_path before running redux if cache will be used

h3. Assign redux server in myamiweb

* At myamiweb/config.php

<pre>

define('SERVER_HOST',"localhost")

</pre>

h2. Test Installation

# Using Redux to do simple input output (simple client with no reduxd server needed):<pre>redux --filename=test.jpg --oformat=PNG > test.png</pre>Make sure the resulting test.png is in fact an image and not an error message.

# Run the server:  run the following on a command line:<pre>reduxd</pre>leave it running for the following...

# Test command line client connecting to the server<pre>redux --server_host=localhost --filename=test.jpg --oformat=PNG > test.png</pre>Note: The input file name is from the perspective of the reduxd server, so be sure to give it an absolute path (unlike the first test, which was not accessing the server)

h2. Setup fftw to use wisdom (Not yet available for myami-2.2-redux)

*This applies only if you see the messge "*** Using custom copy of fftw3"* in the previous redux test.

fftw runs much faster on odd image dimension if a wisdom is saved. It is best to create the wisdom ahead of time using the stand alone script pyami/fft/fftwsetup.py.  It will store the wisdom you create in your home directory, but you can then copy it to any other home directory that wants to use it, or copy it as root to a file called /etc/fftw/wisdom which any user can access.

h3. Using fftwsetup.py:

FIrst, you need to know the typical image dimension redux needs to process, especially the large ones and ones that are not powers of 2.

<pre>

cd /YourMyamDownload/pyami/fft

./fftwsetup.py 1 number_of_rows number_of_colums

</pre>

For example, for K2 summit super-resolution image there are 7676 rows and 7420 columns, therefore, the command line is

<pre>

./fftwsetup.py 1 7676 7420

</pre>

This may take a few minutes.

Run this for as many dimensions you know will be used and move it for general use as instructed above if preferred.

h2. Using redux server with myamiweb

# start reduxd server if not already running from the above test:<pre>reduxd</pre>

# click on "[test dataset]" on your main myamiweb home page, or go directly to the URL: myamiweb/viewerxml.php

# test by accessing your own images from Leginon in myamiweb/imageviewer.php

h2. starting reduxd at boot

<pre>

sudo cp -v myami/redux/init.d/reduxd /etc/init.d/

sudo service reduxd start

</pre>

h2. Alternative reduxd installation on file server rather than web server

This approach is less tested, but has been found necessary in the case of a very high load system (multiple microscopes acquiring data, multiple processing jobs, multiple web clients and servers, etc).  The problem has been that all of this demand for image I/O is occuring over NFS, and the NFS server is not coping with the high demand.  One solution we have been investigating is to run reduxd directly on the file server rather than the web server.  This means reduxd has direct access to the image files (not through NFS) and the web server now accesses reduxd over the network rather than locally.  This has two potential benefits:  1) less load on the NFS server, 2) only transferring JPEGs over the network, not MRCs.

How to do it:

# Install required myami components on the file server, at least pyami, sinedon, numextension, redux, leginon, modules, and any other 3rd part packages required by those.

# (optional) edit init.d/reduxd and use the optional high priority command line (see comment in that file)

# Configure redux.cfg on file server and start reduxd

# On web server, configure config.php:  turn off all caching options, set redux server host to be the file server

# skip starting reduxd on the web server

# skip imcache as described below, since this also uses redux locally and accesses images over NFS

{{include(leginon:Using imcache to cache mrc images as jpeg images of the default size on myamiweb)}}