RLM_SQLIPPOOL_TOOL(8)       System Manager's Manual      RLM_SQLIPPOOL_TOOL(8)

نام (NAME)
       rlm_sqlippool_tool - مدیریت استخرهای آدرس IP در پایگاه‌داده SQL

خلاصه دستور (SYNOPSIS)
       rlm_sqlippool_tool -p pool_name -s range_start -e range_end -t
       table_name -d dialect -f raddb_dir -i instance [-c capacity] [-x
       existing_ips_file]

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


توضیحات (DESCRIPTION)
       ابزار rlm_sqlippool_tool برای مدیریت نشانی‌های IP در استخرهای IP
       پایگاه‌داده SQL به کار می‌رود که توسط FreeRADIUS استفاده می‌شوند. این
       ابزار یا دستورات SQL مناسب برای دستکاری پایگاه‌داده را در خروجی چاپ
       می‌کند، یا مستقیماً با پایگاه‌داده ارتباط برقرار کرده و جدول استخر IP را
       مقداردهی و پر می‌کند.

       قالب خروجی SQL یا دستوراتی که روی پایگاه‌داده اجرا می‌شوند، بر اساس
       طرح‌واره‌های (schemas) پیش‌فرض ippool در FreeRADIUS هستند. فیلدهایی که پر
       می‌شوند شامل pool_name و framedipaddress هستند. سایر فیلدها رها می‌شوند
       تا با مقادیر پیش‌فرض پایگاه‌داده پر شوند.


گزینه‌ها (OPTIONS)
       -c capacity
              تعداد نشانی‌های IP برای پر کردن استخر. مقدار پیش‌فرض ۶۵۵۳۶ یا
              بیشترین تعداد قابل تخصیص میان ابتدا و انتهای بازه است.

       -d dialect
              گویش (dialect) پایگاه‌داده SQL برای تولید خروجی.

       -e range_end
              نشانی IP انتهای بازه استخر. استفاده از نشانی‌های IPv4 یا IPv6
              مجاز است.

       -f raddb_dir
              پوشه حاوی پیکربندی FreeRADIUS. در صورت مشخص شدن این گزینه، ابزار
              rlm_sqlippool_tool پیکربندی را تجزیه کرده و تلاش می‌کند مستقیماً
              با سرور پایگاه‌داده مشخص‌شده در پیکربندی FreeRADIUS ارتباط برقرار
              کند.

       -i instance
              همراه با گزینه -f به کار می‌رود. نام نمونه (instance) ماژول sql
              در پیکربندی FreeRADIUS را برای تجزیه مشخص می‌کند. مقدار پیش‌فرض
              sql است.

       -p pool_name
              نام استخر برای مقداردهی و پر کردن.

       -s range_start
              نشانی IP ابتدای بازه استخر. استفاده از نشانی‌های IPv4 یا IPv6
              مجاز است.

       -t table_name
              نام جدول در پایگاه‌داده برای پر کردن.

       -x existing_ips_file
              فایلی حاوی نشانی‌های IP موجود در استخر. استفاده از این گزینه
              امکان رشد کنترل‌شده‌تر استخرهای پراکنده (sparse) را فراهم می‌کند.

       -y pool_defs_yaml_file
              فایلی با قالب YAML حاوی مشخصات چندین استخر.


مثال‌ها (EXAMPLES)
       برای تولید خروجی SQL با قالب MySQL برای استخری به نام local که با
       نشانی‌های 10.0.0.1 تا 10.0.0.199 پر شده باشد:

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

       برای انجام همین کار ولی از طریق ارتباط مستقیم با ماژول SQL پیکربندی‌شده
       در FreeRADIUS زیر مسیر /etc/raddb:

              $ rlm_sqlippool_tool -p local -s 10.0.0.1 -e 10.0.0.199 \
                  -t dhcpippool -f /etc/raddb

       برای استفاده از یک فایل YAML جهت مشخص کردن بازه‌های استخر و تولید خروجی
       SQL با قالب PostgreSQL:

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


قالب YAML (YAML FORMAT)
       یک فایل YAML برای پر کردن چندین استخر باید به این صورت قالب‌بندی شود:

              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)
       برای تولید خروجی SQL قالب‌بندی‌شده، ماژول Perl Template::Toolkit مورد
       نیاز است.

       ارتباط مستقیم با پایگاه‌های داده با استفاده از Perl DBI انجام می‌شود.
       برای فعال شدن این قابلیت باید درایور Perl DBD متناسب نصب شده باشد.


همچنین ببینید (SEE ALSO)
       radiusd.conf(5), raddb/mods-available/sql

نویسندگان (AUTHORS)
       Nick Porter <nick@portercomputing.co.uk>

                                                         RLM_SQLIPPOOL_TOOL(8)