NAME

rlm_sqlippool_tool - manage SQL IP pools

SYNOPSIS

rlm_sqlippool_tool -p pool_name -s range_start -e range_end -t table_name -d -f raddb_dir -i instance [-c capacity] [-x existing_ips_file]

rlm_sqlippool_tool -y pool_defs_yaml_file -t table_name -d -f raddb_dir -i instance [-x existing_ips_file]

DESCRIPTION

rlm_sqlippool_tool is a tool to manage IP address in SQL IP pools as used by FreeRADIUS. It will either output SQL that can be used to manipulate the database or will interact directly with a database to populate an IP pool table.

The format of the SQL output or the commands operated on the database are based on the default FreeRADIUS ippool schemas. The fields populated are pool_name and framedipaddress. All other fields are left to be populated with their database defaults.

OPTIONS

-c capacity: Number of IP addreses to populate the pool with. Defaults to 65536, or the maximum number that can be provisioned between the start and end of the range.
-d dialect: SQL dialect to use in producing the output.
-e range_end: End IP address in the pool range. Either IPv4 or IPv6 addresses are allowed.
-f raddb_dir: Directory containing the FreeRADIUS configuration. If this option is specified, then rlm_sqlippool_tool will parse the configuration and attempt to talk directly to the database server specified in the FreeRADIUS configuration.
-i instance: Used in conjuction with -f. Specifies the name of the sql module instance to parse in the FreeRADIUS configuration. Defaults to sql.
-p pool_name: The pool name to populate.
-s range_start: Start IP address in the pool range. Either IPv4 or IPv6 addresses are allowed.
-t table_name: Name of the table in the database to populate.
-x existing_ips_file: A file containing exsiting IP addresses in the pool. Use of this allows for more controlled growth of a sparesly populated pool.
-y pool_defs_yaml_file: A YAML formatted file containing specifications for a number of pools.

EXAMPLES

To produce MySQL formatted SQL for a pool named local populated with addresses from 10.0.0.1 to 10.0.0.199:

$ rlm_sqlippool_tool -p local -s 10.0.0.1 -e 10.0.0.199 \
    -t dhcpippool -d mysql

To do the same but directly interacting with the SQL module configured in the FreeRADIUS configuration under /usr/local/share/examples/freeradius/raddb:

$ rlm_sqlippool_tool -p local -s 10.0.0.1 -e 10.0.0.199 \
    -t dhcpippool -f /usr/local/share/examples/freeradius/raddb

To use a YAML file to specify the pool ranges to be populated, outputting PostgreSQL formatted SQL:

$ rlm_sqlippool_tool -y pools.yaml -t dhcpippool -d postgresql

YAML FORMAT

A YAML file to populate multiple pools should be formatted like this:

pool_with_a_single_contiguous_range:
  - start:    192.0.2.3
    end:      192.0.2.250
pool_with_a_single_sparse_range:
  - start:    10.10.10.0
    end:      10.10.20.255
    capacity: 200
pool_with_multiple_ranges:
  - start:    10.10.10.1
    end:      10.10.10.253
  - start:    10.10.100.0
    end:      10.10.199.255
    capacity: 1000
v6_pool_with_contiguous_range:
  - start:    '2001:db8:1:2:3:4:5:10'
    end:      '2001:db8:1:2:3:4:5:7f'
v6_pool_with_sparse_range:
  - start:    '2001:db8:1:2::'
    end:      '2001:db8:1:2:ffff:ffff:ffff:ffff'
    capacity: 200

PREREQUISITES

To output formatted SQL, the Perl Template::Toolkit module is required.

Direct connection to databases is done using Perl DBI. The appropriate Perl DBD driver needs to be installed to enable this functionality.

AUTHORS

Nick Porter <nick@portercomputing.co.uk>