Connecting Clients to your LizardFS installation¶
The most exciting part of this tutorial - you will finally be able to store files on your installation!
Linux / *NIX / *BSD / MacOS/X client¶
Install the client package
Check Getting and installing LizardFS for instructions how to install package
Example for Debian/Ubuntu:
$ apt-get install lizardfs-client
Make sure that the mfsmaster host is set in your /etc/hosts file. For our example configuration it would be:
Create a mountpoint:
$ mkdir /mnt/lizardfs
Mount the filesystem to the mountpoint with just the default options from mfsmount.cfg if any:
$ mfsmount /mnt/lizardfs
That’s it. Simple, straight and easy.a
Optional settings for performance on *NIX¶
On most systems adding big_writes to the options will significantly increase your throughput since it will force the fuse libraray to use writes > 4k.
$ mfsmount -o big_writes,nosuid,nodev,noatime /mnt/lizardfs
will mount with fuse option: big_writes and default system mount options: nosuid, nodev and noatime.
Read ahead cache
If you want to make use of the read ahead caching feature which will sig- nificantly improve your read performance, you will require to configure the following options:
-o cacheexpirationtime=MSEC set timeout for read cache entries to be considered valid in milliseconds (0 disables cache) (default: 0) -o readaheadmaxwindowsize=KB set max value of readahead window per single descriptor in kibibytes (default:
mfsmount -o cacheexpirationtime=500 -o readaheadmaxwindowsize=4096 mountpoint/
* cacheexpirationtime - depends on latency, 500 should be alright for most installations. Higher values = data will be kept in cache longer, but it will also occupy more RAM. * readaheadmaxwindowsize - depends on latency and cacheexpirationtime, 1024-8192 are usually fine. Higher values = bigger portions of data asked in single request.
readaheadmaxwindowsize can be adjusted to the installation - starting with 1024 and increasing it until tests show no performance gain is a good idea.
You can now store your files on your brand new installation.
See FUSE to find out more about the fuse library.
System Settings for LizardFS clients¶
Recommended tuning for Windows™ Clients:
- Make sure your Power Options are set to “High Performance”.
- Increase the number of Transfer and Receive Buffers in the configuration of your network interface
- Increase the number of Queues available in your network interface setting
- If at all possible set all network devices in your network to use Jumbo Frames.
The precise number for your respective host / NIC will be different in every setup, but they for sure will be far higher than the default settings.
Windows™ GUI client¶
Install our client from exe package provided
Add your credentials and the address and port of the master server.
Select the drive you want your lizardFS filesystem to appear as in your windows session.
It should look like in the following image:
Figure 2: main view of LizardFS Windows™ client
Windows™ CLI Client¶
Together with the GUI client the installation package adds a CLI client to your Windows™ system. It is located in:
|-H||The address of the Master|
|-P||The port to use at the Master|
|-D||The drive letter to use for the mounted FS|
The Windows™ Client can also be run as a Windows™ Service. This is provided by the LizardSControler command.
LizardSControler -p -lic-file <LICENSE_FILE> -H <ADDRESS_OF_MASTER>
where LICENSE_FILE should be the name of the file containing a valid License and ADDRESS_OF_MASTER should be the hostname or IP address of the LizardFS master server.
Further configuration options¶
(Must follow the -p command)
|-H HOST||set master server host address.|
|-P PORT||set master server port. Default 9421.|
|-D DRIVE||set <DRIVE> as a mount point i.e. D:. Default L:|
|-f SUBFOLDER||mount only given LizardFS subfolder|
|-uid UID||set new UID. Default is 1000.|
|-gid GID||set new GID. Default is 1000.|
|-umask UMASK||set new UMASK. Default is 000.|
|-pass PASS||authenticate to LizardFS master using MD5 password.|
|-lic LICENSE||set new LICENSE.|
|-lic-file LICENSE_FILE||load new LICENSE from LICENSE_FILE.|
Installation and runtime¶
After you have done the configration, you can add the service to your Windows system by running:
and start it by running:
If you would like to uninstall the service again, just run:
To terminate the service, run:
A full list of options can be displayed using: