'\" t
.\"     Title: mfstopology.cfg
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 06/17/2017
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MFSTOPOLOGY\&.CFG" "5" "06/17/2017" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
mfstopology.cfg \- LizardFS network topology definitions
.SH "DESCRIPTION"
.sp
The file \fBmfstopology\&.cfg\fR contains assignments of IP addresses into network locations (usually switch numbers)\&. This file is optional\&. If your network has one switch or decreasing traffic between switches is not necessary then leave this file empty\&.
.SH "SYNTAX"
.sp
Syntax is:
.sp
\fIADDRESS\fR \fISWITCH\-NUMBER\fR
.sp
Lines starting with \fB#\fR character are ignored\&.
.sp
\fIADDRESS\fR can be specified in several forms:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB*\fR
all addresses
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBn\&.n\&.n\&.n\fR
single IP address
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBn\&.n\&.n\&.n/b\fR
IP class specified by network address and bits number
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBn\&.n\&.n\&.n/m\&.m\&.m\&.m\fR
IP class specified by network address and mask
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBf\&.f\&.f\&.f\-t\&.t\&.t\&.t\fR
IP range specified by from\-to addresses (inclusive)
.RE
.sp
\fISWITCH\-NUMBER\fR can be specified as any positive 32\-bit numer\&.
.SH "NOTES"
.sp
If one IP belongs to more than one definition then last definition is used\&.
.sp
As for now distance between switches is constant\&. So distance between machines is calculated as: \fB0\fR when IP numbers are the same, \fB1\fR when IP numbers are different, but switch numbers are the same and \fB2\fR when switch numbers are different
.sp
Distances are used only to sort chunkservers during read and write operations\&. New chunks are still created randomly\&. Also rebalance routines do not take distances into account\&.
.SH "COPYRIGHT"
.sp
Copyright 2008\-2009 Gemius SA, 2013\-2015 Skytechnology sp\&. z o\&.o\&.
.sp
LizardFS 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 3\&.
.sp
LizardFS 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\&.
.sp
You should have received a copy of the GNU General Public License along with LizardFS\&. If not, see http://www\&.gnu\&.org/licenses/\&.
.SH "SEE ALSO"
.sp
mfsmaster(8), mfsmaster\&.cfg(5)