Question: How are shared network drives mounted on the Xenium Analyzer instrument?
Answer:
The Xenium Analyzer can mount network shared drives in three configurations:
(1) NFS
(2) CIFS with SMB credentials
(3) CIFS without credentials
To do this, the first step is to create a new folder in the xeniumuser home directory:
mkdir /home/xeniumuser/shared_drive
The remaining instructions in the workflow will depend on which of the three configurations you wish to use:
(1) Using the NFS protocol
Edit the /etc/fstab file by typing
sudo nano /etc/fstab
Write the following line to the bottom of the file
<address-to-server>/path_to_shared_folder /home/xeniumuser/shared_drive nfs
Save and exit from nano by typing
ctrl-x
Update the filesystem mounts by typing
sudo mount -a
(2) Using the CIFS protocol with credentials
From the terminal create a temporary file that contains the username and password and domain if needed for the SMB share:
nano tempcred
Enter credentials as shown below. Supplying a username and password will always be required. However entering the domain name may or may not be necessary for the SMB share depending on the share configuration. If included, remove the pound sign in front of domain:
username=<username>
password=<pw>
#domain=
Save and exit from nano by typing
ctrl-x
Write this file into the write only .smbcreds file:
cat tempcred > /opt/.smbcreds
Delete the tempcred file:
rm tempcred
Edit the /etc/fstab file by typing
sudo nano /etc/fstab
Write the following line to the bottom of the file. Be sure to enter the text as a single line in the file (do not include line breaks):
<address-to-server>/path_to_shared_folder /home/xeniumuser/shared_drive cifs credentials=/opt/.smbcreds,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0
Save and exit from nano by typing
ctrl-x
Update the filesystem mounts by typing
sudo mount -a
(3) Using the CIFS protocol without credentials
Edit the /etc/fstab file by typing
sudo nano /etc/fstab
Write the following line to the bottom of the file. Be sure to enter the text as a single line in the file (do not include line breaks):
<address-to-server>/path_to_shared_folder /home/xeniumuser/shared_drive cifs credentials=/opt/.smbcreds,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0
Save and exit from nano by typing
ctrl-x
Update the filesystem mounts by typing
sudo mount -a
Notes:
The following drive names are already mounted on the Xenium Analysis Computer, so avoid mounting another volume with these names:
-
/data -
/output -
/scratch -
/conf -
/home -
/opt
The write-only credentials file for the CIFS instructions above (opt/.smbcreds ) provided to store network share credentials is only available in Instrument SW v1.8.2.1 and higher. If you need to store network credentials for your CIFS network shared drive and are on an earlier version of the software you will need to update your instrument software to at least v1.8.2.1.
Related articles:
Products: Xenium Analyzer
Last updated: June 16, 2023