Prerequisites
- You will need an active SLAC unix account to access your data (contact Lisa Dunn).
You will need to register as an S3DF user in the "CryoEM" facility with your SLAC unix username. Please go to coact.slac.stanford.edu, then go to Repos→Request Facility Access and select "CryoEM", INCLUDE YOUR PROPOSAL NUMBER/PROJECT CODE IN THE NOTES FIELD, then submit. For further information, see: https://s3df.slac.stanford.edu/public/doc/#/accounts-and-access?id=access
The proposal number/project code (e.g., CT### or CE###) MUST be included in the notes field of the S3DF CryoEM facility access request. S3DF registration requests without this information will be rejected, and you will have to submit a ticket via email to s3df-help@slac.stanford.edu with that information to have your request re-opened for resubmission.
All experimental data is kept on the S3DF network filesystem:
The S3DF bastion hosts (e.g. accessed by running ssh s3dflogin.slac.stanford.edu
) do NOT mount the experimental and group data (see the message displayed in your terminal upon successful login to an S3DF bastion host). You will need to access your data via one of the load-balanced hosts listed below.
- S3DF interactive pool (see: https://s3df.slac.stanford.edu/public/doc/#/interactive-compute?id=interactive-pools).
- S3DF DTN hosts (see: https://s3df.slac.stanford.edu/public/doc/#/data-transfer?id=data-transfer)
- S3DF Globus endpoint via the #s3df_globus5 data collection (see: https://s3df.slac.stanford.edu/public/doc/#/data-transfer?id=globus)
The SDF cluster has been decommissioned as of August 2024. All Cryo-EM experimental and group project data is accessible from the S3DF cluster.
Data Transfer Methods
rsync/scp/bbcp
The unix command line utilities rsync
, scp
, and bbcp
(https://www.slac.stanford.edu/~abh/bbcp/bbcp.pdf) can be used over ssh to bulk transfer/synchronise data across different locations. The data transfer nodes (dtn01.slac.stanford.edu, dtn02.slac.stanford.edu, and the centos7.slac.stanford.edu cluster
have been decommissioned. Please log into the load-balanced hostname s3dfdtn.slac.stanford.edu
with your SLAC unix credentials instead). You will need to be registered as a CryoEM facility user in S3DF before you can access the S3DF DTN hosts (see Prerequisites above). Once logged into an S3DF DTN host, the data will be mounted at:
- Experimental data: /fs/ddn/sdf/group/cryoem/exp/<YYYYMM>/<YYYYMMDD>-<proposal>_<instrument>
- Group project data: /fs/ddn/sdf/group/cryoem/g/<proposal>
Globus
One can create a free Globus account at https://globusonline.org. If your institution is a part of the Globus network, you can register with your institution's credentials. From there, download the client (Globus Connect Personal) so that files may be copied a local host, or to another Globus Endpoint run by your institution, if available. You may also use the Globus web client (https://www.globus.org/).
The Globus 4 endpoint at slac#cryoem is no longer supported.
(Globus shut down all version 4 endpoints worldwide on December 18th 2023).
You will need to be registered as a CryoEM facility user in S3DF before you can access the S3DF Globus endpoint (see Prerequisites above). Once your S3DF registration has been approved, you can log into Globus with your home institution's credentials (if they are a part of the Globus network) or a personal Globus account and access the #s3df_globus5 data collection. You will be asked to authenticate with your SLAC unix credentials. Once authenticated, the data will be mounted at the following paths:
- Experimental data: /fs/ddn/sdf/group/cryoem/exp/<YYYYMM>/<YYYYMMDD>-<proposal>_<instrument>
- Group project data: /fs/ddn/sdf/group/cryoem/g/<proposal>
SAMBA
If you are onsite at SLAC, you can access the data via samba/cifs. You should connect to zslaccfs
in order to browse the global directory. From there you can access the cryo-EM disks under cryoem
.
You should login with your SLAC Windows Account to use this.
- On your Linux machine, open a terminal window.
- Install the necessary software with the command sudo apt-get install -y samba samba-common python-glade2 system-config-samba.
- Type your sudo password and hit Enter.
- Allow the installation to complete.
- Open a new file browser window.
- At the bottom of the left navigation pane, click "Other Locations"
- At the bottom of the window, in the "Connect to Server" field, Type smb://zslaccfs/
- Open the cryoem directory.
- Log in with your SLAC Windows account username and password, leave the "Workgroup" field as the default value or if using Ubuntu the domain should be "slac".
- You can now browse the CryoEM disks in your Linux file browser.
Alternatively, you can mount it via command line.
Install cifs-utils. sudo apt-get install cifs-utils
- Create a directory where you want to mount it. sudo mkdir /mnt/slac
sudo mount -t cifs -o username=SLAC_USERNAME,vers=1.0,domain=slac,uid=`id -u` //zslaccfs.slac.stanford.edu/cryoem/ /mnt/slac
Note that the
uid
is important so that you as user can have the correct permissions on your local desktop.
Alternatively, you can mount it via command line.
Install cifs-utils. sudo apt-get install cifs-utils
- Create a directory where you want to mount it. sudo mkdir /mnt/slac
sudo mount -t cifs -o username=SLAC_USERNAME,vers=1.0,domain=slac,uid=`id -u` //zslaccfs.slac.stanford.edu/cryoem/ /mnt/slac
Note that the
uid
is important so that you as user can have the correct permissions on your local desktop.
SSHFS
You can also use the FUSE based SSHFS to mount the filesystem via ssh. It is recommended to ssh into s3dfdtn.slac.stanford.edu
in order to use this method. Please note you will need to be a registered S3DF user (see Prerequisites above) to access the S3DF DDTN hosts.
Using SSHFS, the filesystem will be mounted locally so that you may browse the directory as you would with SAMBA etc.
Summary
Globus | SAMBA | SSHFS | RSYNC/SCP | BBCP | |
---|---|---|---|---|---|
Software Install | Globus Connect Personal clients available (https://www.globus.org/globus-connect-personal) | Implementation already baked into MAC OS and Windows. Simple install for Linux via package managers | Requires FUSE library. Not available for Windows | Command line tools usually already installed in most Linux and MAC OSes. GUIs available for SCP. | Command line tools only |
Graphical Interface | Yes (Web/Globus Connect Personal client) | Yes (OS) | Yes (OS) | Yes (WinSCP) | No |
Command line interface | Yes | Yes (standard OS) | Yes (standard OS) | Yes (standard OS) | Yes (standard OS) |
Performance | Fast | Fast | Slow | Slow | Fast |
Access | Anywhere | At SLAC Only | Anywhere | Anywhere | Anywhere |
Credentials | Globus ID + SLAC Unix + S3DF | SLAC Windows Active Directory | SLAC Unix + S3DF | SLAC Unix + S3DF | SLAC Unix + S3DF |
Ease of Use | Easy | Easy | Medium | Easy | Difficult |