Project

General

Profile

File Server Setup Considerations Shared » History » Version 9

Anchi Cheng, 04/21/2016 12:37 PM

1 3 Anchi Cheng
h1. File Server Setup Considerations
2 1 Anchi Cheng
3 7 Anchi Cheng
A specific file tree structure has been assumed in Appion/Leginon.  Here is a description of it:
4 1 Anchi Cheng
5 9 Anchi Cheng
h2. Head path
6
7
Leginon and Appion are saved under the same head directory, and it is assumed to have one.
8
For example */your_file_server_mount_point/whatever* is the head directory.
9
You can have is shorter such as */whatever*, but not just */*
10
11 8 Anchi Cheng
h2. User not identified in the path
12
13 5 Anchi Cheng
# Leginon default image path is defined in [[Configure leginoncfg|leginon.cfg]].  The acceptable form is */your_file_server_mount_point/whatever/leginon*.  The images are saved by sessionname under subdirectory of this directory in a form such as 
14 1 Anchi Cheng
*/your_file_server_mount_point/whatever/leginon/sessionname/rawdata/*.
15 7 Anchi Cheng
# Leginon DD movie frames path is defined relative to the Leginon image path once it is set for the session.  In the case of the above example, the resulting path is
16
*/your_file_server_mount_point/whatever/frames/sessionname/rawdata/*.
17
# Appion processing is default under appion directory parrallel to leginon directory, i.e., /your_file_server_mount_point/whatever/appion.  This relationship is hard-coded until v2.2 release.  In later releases, the parent directory can be set differently in the webserver myamiweb config.php.  The processing are divided by sessionname and then processingtype and then runname of the process.  Therefore, your processing results are saved in the following default appion path: */your_file_server_mount_point/whatever/appion/sessionname/processing_type/runname/*
18 8 Anchi Cheng
19
h2. User identified in the path
20
21
It is possible to add one more layer below leginon directory to identify users by their username or groupname.  In this case;
22
# Leginon default image path can be made to be */your_file_server_mount_point/whatever/leginon/username/sessionname/rawdata*.
23
# frame directory is then */your_file_server_mount_point/whatever/frames/username/sessionname/rawdata*.
24
# In webserver myamiweb/config.php. APPION_PARENT_ADDITION should be set to 1.  This will preserve username subdivision and give default appion path of */your_file_server_mount_point/whatever/appion/username/sessionname/processing_type/runname/*
25 1 Anchi Cheng
26
The following permission rule is required for multi-unix-user usage of Leginon/Appion:
27
28
For Leginon:
29
30
# The web server apache user need to have read permission to all images in the rawdata directories in order to display them in the viewer.
31
# all users need to have permission to create directory in */your_file_server_mount_point/whatever/leginon*
32 7 Anchi Cheng
# If DD frames are saved and managed by Leginon, the user running the frame rawtransfer.py need to have permission to create directory in */your_file_server_mount_point/whatever/frames*
33 1 Anchi Cheng
# all users need to have read permission in a leginon rawdata directory that contains reference images.
34
# Users need to have write permission to the session they created, of course.
35
36
For Appion:
37 6 Anchi Cheng
38
# Images uploaded to Appion is considered as a Leginon session.  See above for its file tree structure.
39 1 Anchi Cheng
# The web server apache user need to have read permission to processing directories to display the results.
40
# All users need to have permission to create directory in */your_file_server_mount_point/whatever/appion*
41
# If more than one user will be processing data in the same session, they all need write permission to the session directory */your_file_server_mount_point/whatever/appion/sessionname/*