mfsipmap.cfg(5)

🌸 mfsipmap.cfg — MooseFS chunkserver IP mappings 💅

okay bestie, welcome to the <rainbow>mfsipmap.cfg(5)</rainbow> glow-up ✨ this is the MooseFS page about chunkserver IP mappings, and by the end of this you're gonna be so good at it, fr fr 🫶

---

💖 NAME 💖

mfsipmap.cfg — MooseFS chunkserver IP mappings 🗺️✨

---

🦋 DESCRIPTION 🦋

So <pink>mfsipmap.cfg</pink> is the file that holds MooseFS chunk server IPs mapping lists. That's it, that's the whole vibe 💅

✨ SYNTAX ✨

General file format, bestie: the content is one or more different LAN remappings. Each LAN remapping is built from first the list of client IPs that are gonna get the chunk server's IPs remapped, and then the chunk server's remappings themselves. So a proper file goes 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

And the way class definitions can use a shortened IP?? iconic. For example, a.b.c.0/24 is literally 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 the format IP - IP:

f.f.f.f-t.t.t.t

And lastly (lastly bestie, I promise 😭), clients' IPs can just be single IPs, one IP per line:

n.n.n.n
x.x.x.x

Now — chunk server's IP mappings are always defined in exactly one format, IP:IP:

n.n.n.n:r.r.r.r

Here's the tea ☕: if a client's IP is sitting in the list directly preceding this mapping, then the chunkserver with the IP on the left side of the mapping is gonna be presented to that client with the IP on the right side of the mapping. slay ✨

Oh and — lines starting with the # character are ignored, they're comments 💬

---

👑 NOTES 👑

This file is your girl when you need to define LAN mappings in cases where there's no common scheme of numbering in LANs, i.e. where the same servers have different IP suffixes in each LAN. No cap 🫠

But wait — if your machines do have common suffixes? Then use the MULTILAN_BITS and MULTILAN_CLASSES options from the mfsmaster.cfg file instead 🌈 (different file, different bestie).

---

🔥 EXAMPLES 🔥

Example numero uno 💖

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 an IP starting with 192.168.1, or starting with 192.168.2 and ending in 1 to 24, or with IP 192.168.3.20 — if it wants to communicate with the chunkserver with IP 10.10.10.3, it will instead do so using IP 10.20.30.7 ✨ and with the chunkserver with IP 10.10.10.4 it will use IP 10.20.33.19 💅

---

Example numero dos 🦋

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 an IP starting with 192.168.1 — if it wants to communicate with the chunkserver with IP 10.10.10.3, it will instead do so using IP 10.20.30.7, and with the chunkserver with IP 10.10.10.4 it will use IP 10.20.33.1. ⭐

Any client having an IP starting with 192.168.2 and ending in 1 to 24 — if it wants to communicate with the chunkserver with IP 10.10.10.3, it will instead do so using IP 10.20.38.8, and with the chunkserver with IP 10.10.10.5 it will use IP 10.20.38.37. 🌸

Notice, bestie: the same chunkserver (with IP 10.10.10.3) will be presented to clients from different IP lists with different remapped IPs. main character energy tbh 👑

💀 Note: empty lines between sections are not necessary — they're in the above examples only for ease of reading. don't come for me, it's just aesthetics.

---

💜 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 under 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)

---

and that's the whole page bestie, we ate and left no crumbs 🍓 this was MooseFS 4.59.2-1, from May 2026 — ily, go remap some IPs 💖✨🎀