LCTL-NODEMAP_ADD_RANGE(8)

NAME
lctl-nodemap_add_range - define a range of NIDs for a nodemap

SYNOPSIS
lctl nodemap_add_range or
lctl nodemap add_range --name NODEMAP_NAME --range NID_RANGE

DESCRIPTION
nodemap_add_range adds a range of NIDs to an existing nodemap. The NID range cannot overlap with an existing NID range except with a dynamic overlay range. Clients with NIDs that fall into the new range will be moved into the given nodemap and any future RPCs will be subject to the properties configured for that nodemap.

OPTIONS

--name NODEMAP_NAME
    The name of the nodemap that this range should be added to.

--range NID_RANGE
    The NID range that should be added to the nodemap. The syntax for the range is the same as the rootsquash syntax, with the added constraint that the range must be contiguous.

Formal LNet NID Range Definition
    NID_RANGE    :== ADDR_RANGE@NET
    ADDR_RANGE   :== '*' | NETMASK | IPV6_ADDR | IPADDR_RANGE | NUM_RANGE
    IPADDR_RANGE :== NUM_RANGE.NUM_RANGE.NUM_RANGE.NUM_RANGE
    NUM_RANGE    :== NUMBER | EXPR_LIST
    EXPR_LIST    :== '['RANGE_EXPR[,RANGE_EXPR]']'
    RANGE_EXPR   :== NUMBER | MIN-MAX | MIN-MAX/SKIP
    NET          :== NET_TYPE[NUMBER]
    NET_TYPE     :== "lo" | "tcp" | "o2ib" | "ptlf" | "gni" | "gip" | "kfi"
    NUMBER       :== NONNEGATIVE_DECIMAL | HEXADECIMAL
Where NETMASK is an IPv4 or IPv6 network mask in CIDR notation, IPV6_ADDR is a single IPv6 address, MIN-MAX/SKIP indicates a sequence of numbers starting at MIN and incrementing by SKIP each time until no larger than MAX, and MIN-MAX is equivalent to MIN-MAX/1.

EXAMPLES
    # lctl nodemap_add_range --name remotesite --range 192.168.1.[1-254]@tcp
    # lctl nodemap_add_range --name othersite --range 192.168.2.[1-254]@tcp

AVAILABILITY
lctl nodemap_add_range is part of the lustre(7) filesystem package since release 2.6.0

SEE ALSO
lustre(7), lctl-nodemap-activate(8), lctl-nodemap-add-idmap(8), lctl-nodemap-del(8), lctl-nodemap-del-idmap(8), lctl-nodemap-del-range(8), lctl-nodemap-modify(8) lctl-nodemap-new(8),