Quick reference

• The official LizardFS docker image.

• Maintained by: openEuler CloudNative SIG.

• Where to get help: openEuler CloudNative SIG, openEuler.

LizardFS | openEuler

Current LizardFS docker images are built on the openEuler. This repository is free to use and exempted from per-user rate limits.

LizardFS is a fork of MooseFS and shares a similar design and core components. It continues MooseFS’s overall architecture, where the mfsmaster (Master Server) plays a central role. The mfsmaster manages metadata, file namespace, and coordinates chunkservers, making it the key component for the distributed file system to function properly.

Learn more on LizardFS Website.

Supported tags and respective Dockerfile links

The tag of each lizardfs docker image is consist of the version of lizardfs and the version of basic image. The details are as follows

Tag	Currently	Architectures
3.12.0-oe2403sp3	lizardfs 3.12.0 on openEuler 24.03-LTS-SP3	amd64, arm64
3.12.0-oe2403sp1	LizardFS 3.12.0 on openEuler 24.03-LTS-SP1	amd64, arm64

Usage

In this usage, users can select the corresponding {Tag} based on their requirements.

• Pull the openeuler/lizardfs image from docker

  docker pull openeuler/lizardfs:{Tag}
  

• Run with an interactive shell

  You can also start the container with an interactive shell to use lizardfs.

  docker run -it --rm openeuler/lizardfs:{Tag} bash
  

• Create mfsmaster.cfg

  Create mfs configuration directory:

  mkdir -p /etc/mfs
  

  Create mfs configuration file /etc/mfs/mfsmaster.cfg:

  DATA_PATH = /var/lib/mfs
  EXPORTS_FILENAME = /etc/mfs/mfsexports.cfg
  
  WORKING_USER = root
  WORKING_GROUP = root
  

• Create mfsexports.cfg

  /etc/mfs/mfsexports.cfg:

  * / rw,alldirs,maproot=0
  

• Create empty optional files

  For single-node tests, these can be empty. There're used for rack/host mapping and advanced topology placement.

  • /etc/mfs/mfstopology.cfg
  • /etc/mfs/mfsipmap.cfg

• Initialize metadata

  Inside you data path (/var/lib/mfs):

  mkdir -p /var/lib/mfs
  cd /var/lib/mfs
  echo -e "MFSM NEWMETADATA 1\nEMPTY METADATA FILE" > metadata.mfs.empty
  

  This creates an empty metadata file, needed for first-time startup.

• Start the LizardFS Master

  mfsmaster start
  

Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images.