Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
mfsipmap.cfg(5)		    This is part of MooseFS	       mfsipmap.cfg(5)

NAME
       mfsipmap.cfg - MooseFS chunkserver IP mappings

DESCRIPTION
       The file	mfsipmap.cfg contains MooseFS chunk server IPs mapping lists.

   SYNTAX
       General	file  format:  the content is one or more different LAN	remap-
       pings. Each LAN remapping consists of first the list of client IPs that
       will have the chunk server's IPs	remapped and then the  chunk  server's
       remmapings themselves. Proper file is build like	this: client IP	list -
       mapping list - client IP	list - mapping list etc.

       Clients'	 IPs  can  be  defined	as  classes in two formats: IP/MASK or
       IP/BITS:
       n.n.n.n/m.m.m.m
       n.n.n.n/b
       Class definitions can use shortened IP, for example a.b.c.0/24  is  the
       same   as   a.b.c/24,   and   a.b.0.0/255.255.0.0   is	the   same  as
       a.b/255.255.0.0.

       Clients'	IPs can	also be	defined	as ranges in format IP - IP:
       f.f.f.f-t.t.t.t

       And lasty, clients' IPs can be defined as single	IPs, one IP per	line:
       n.n.n.n
       x.x.x.x

       Chunk server's IP mappings are always defined in	one format IP:IP:
       n.n.n.n:r.r.r.r
       If a client's IP	is defined in the list directly	 preceding  this  map-
       ping,  the  chunkserver with IP on the left side	of the mapping will be
       presented to this client	with the IP on the right side of the mapping.

       Lines starting with # character are ignored as comments.

NOTES
       This file allows	to define LAN mappings in cases	where there is no com-
       mon scheme of numbering in LANs,	i.e. where the same servers have  dif-
       ferent  IP  suffixes in each LAN. If machines have common suffixes, use
       MULTILAN_BITS and MULTILAN_CLASSES options from mfsmaster.cfg file  in-
       stead.

EXAMPLES
       File content:

       192.168.1/24
       192.168.2.1-192.168.2.24
       192.168.3.20

       10.10.10.3:10.20.30.7
       10.10.10.4:10.20.33.19

       Behaviour:

       Any  client  having IP starting with 192.168.1, starting	with 192.168.2
       and ending in 1 to 24, or with IP 192.168.3.20, if it wants to communi-
       cate with chunkserver with IP 10.10.10.3, will instead do so  using  IP
       10.20.30.7,  with  chunkserver  with  IP	 10.10.10.4  it	 will  use  IP
       10.20.33.19.

       File content:

       192.168.1/24

       10.10.10.3:10.20.30.7
       10.10.10.4:10.20.33.19

       192.168.2.1-192.168.2.24

       10.10.10.3:10.20.38.8
       10.10.10.5:10.20.38.37

       Behaviour:

       Any client having IP starting with 192.168.1, if	it wants  to  communi-
       cate  with  chunkserver with IP 10.10.10.3, will	instead	do so using IP
       10.20.30.7,  with  chunkserver  with  IP	 10.10.10.4  it	 will  use  IP
       10.20.33.1.  Any	client having IP starting with 192.168.2 and ending in
       1  to  24,  if  it  wants  to  communicate  with	 chunkserver  with  IP
       10.10.10.3,  will  instead  do so using IP 10.20.38.8, with chunkserver
       with IP 10.10.10.5 it will use IP 10.20.38.37. Notice,  that  the  same
       chunkserver (with IP 10.10.10.3)	will be	presented to clients from dif-
       ferent IP lists with different remapped IP.

       Note:  empty lines between sections are not necessary, they are used in
       the above examples only for ease	of reading.

COPYRIGHT
       Copyright (C) 2026 Jakub	Kruszona-Zawadzki, Saglabs SA

       This file is part of MooseFS.

       MooseFS is free software; you can redistribute it and/or	modify it  un-
       der  the	 terms	of  the	GNU General Public License as published	by the
       Free Software Foundation, version 2 (only).

       MooseFS is distributed in the hope that it will be useful, but  WITHOUT
       ANY  WARRANTY;  without even the	implied	warranty of MERCHANTABILITY or
       FITNESS FOR A PARTICULAR	PURPOSE. See the GNU  General  Public  License
       for more	details.

       You should have received	a copy of the GNU General Public License along
       with this program; if not, see <https://www.gnu.org/licenses/>.

SEE ALSO
       mfsmaster(8), mfsmaster.cfg(5)

MooseFS	4.59.1-1		   May 2026		       mfsipmap.cfg(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mfsipmap.cfg&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help