نام (NAME)

ibccconfig - پیکربندی تنظیمات کنترل ازدحام

خلاصه دستور (SYNOPSIS)

ibccconfig [common_options] [-c cckey] <op> <lid|guid> [port]

توضیحات (DESCRIPTION)

ibccconfig از پیکربندی تنظیمات کنترل ازدحام روی سوئیچ‌ها و HCAها پشتیبانی می‌کند.

هشدار -- پیش از استفاده از این ابزار باید کاملاً بدانید چه کاری انجام می‌دهید. استفاده نادرست از این ابزار می‌تواند منجر به از کار افتادن یا خرابی بستر شبکه (فابریک) شود.

گزینه‌ها (OPTIONS)

عملیات‌های پشتیبانی‌شده کنونی و پارامترهای آن‌ها:: CongestionKeyInfo (CK) <lid|guid> <cckey> <cckeyprotectbit> <cckeyleaseperiod> <cckeyviolations> SwitchCongestionSetting (SS) <lid|guid> <controlmap> <victimmask> <creditmask> <threshold> <packetsize> <csthreshold> <csreturndelay> <markingrate> SwitchPortCongestionSetting (SP) <lid|guid> <portnum> <valid> <control_type> <threshold> <packet_size> <cong_parm_marking_rate> CACongestionSetting (CS) <lid|guid> <port_control> <control_map> <ccti_timer> <ccti_increase> <trigger_threshold> <ccti_min> CongestionControlTable (CT) <lid|guid> <cctilimit> <index> <cctentry> <cctentry> ...

--cckey, -c, <cckey> تعیین کلید کنترل ازدحام (CC key). اگر هیچ کلیدی مشخص نشود، از کلید ۰ استفاده می‌شود.

فلگ‌های اشکال‌زدایی (Debugging flags)

-d: افزایش سطح اشکال‌زدایی IB. می‌تواند چندین بار استفاده شود (-ddd یا -d -d -d).

-e: نمایش خطاهای ارسال و دریافت (اتمام مهلت و سایر موارد)

-h, --help نمایش پیام راهنمای استفاده

-v, --verbose: افزایش سطح جزئیات برنامه. می‌تواند چندین بار استفاده شود (-vv یا -v -v -v)

-V, --version نمایش اطلاعات نسخه.

فلگ‌های آدرس‌دهی (Addressing Flags)

-G, --Guid نشانی مشخص‌شده یک GUID درگاه (Port GUID) است

-L, --Lid نشانی مشخص‌شده یک LID است

-s, --sm_port <smlid> استفاده از «smlid» به عنوان LID مقصد برای پرس‌وجوهای SA.

فلگ‌های انتخاب درگاه (Port Selection flags)

-C, --Ca <ca_name> استفاده از ca_name مشخص‌شده.

-P, --Port <ca_port> استفاده از ca_port مشخص‌شده.

-Y, --pkey-idx <idx>: نمایه جدول P_Key (۰ تا ۶۵۵۳۵، پیش‌فرض ۰) مورد استفاده برای MADهای خروجی SA/GMP. بسته‌های MAD مربوط به SMP (مسیردهی هدایت‌شده SMI یا با LID) همواره از نمایه ۰ کلید P_Key استفاده می‌کنند.

انتخاب درگاه محلی (Local port Selection)

پشتیبانی از چند درگاه/چند CA: در صورتی که هیچ دستگاه یا درگاه IB مشخص نشود (بخش «پارامترهای محلی umad» در زیر را ببینید)، کتابخانه libibumad درگاه مورد استفاده را بر اساس معیارهای زیر انتخاب می‌کند:

1.: اولین درگاهی که فعال (ACTIVE) باشد.
2.: در صورت نیافتن، اولین درگاهی که بالا باشد (پیوند فیزیکی UP).

اگر نام درگاه یا CA مشخص شده باشد، کتابخانه libibumad تلاش می‌کند درخواست کاربر را برآورده کند و در صورت عدم امکان، با خطا متوقف می‌شود.

برای نمونه:

ibaddr                 # استفاده از درگاه اول (معیار ۱ بالا)
ibaddr -C mthca1       # انتخاب بهترین درگاه تنها از «mthca1»
ibaddr -P 2            # استفاده از درگاه دوم (فعال/بالا) از اولین دستگاه IB موجود
ibaddr -C mthca0 -P 2  # استفاده منحصراً از درگاه مشخص‌شده

فلگ‌های پیکربندی (Configuration flags)

-y, --m_key <key>: استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر مقداری غیرعددی (مانند 'x') مشخص شود، مقدار به صورت تعاملی درخواست خواهد شد.

--config, -z <config_file> تعیین فایل پیکربندی جایگزین.

پیش‌فرض: /etc/infiniband-diags/ibdiag.conf

مثال‌ها (EXAMPLES)

ibccconfig SwitchCongestionSetting 2 0x1F 0x1FFFFFFFFF 0x0 0xF 8 0 0:0 1  # پیکربندی تنظیمات کنترل ازدحام سوئیچ
ibccconfig CACongestionSetting 1 0 0x3 150 1 0 0                          # پیکربندی تنظیمات کنترل ازدحام CA برای SL 0 و SL 1
ibccconfig CACongestionSetting 1 0 0x4 200 1 0 0                          # پیکربندی تنظیمات کنترل ازدحام CA برای SL 2
ibccconfig CongestionControlTable 1 63 0 0:0 0:1 ...                      # پیکربندی بلوک اول جدول کنترل ازدحام
ibccconfig CongestionControlTable 1 127 0 0:64 0:65 ...                   # پیکربندی بلوک دوم جدول کنترل ازدحام

فایل‌ها (FILES)

فایل پیکربندی (CONFIG FILE)

/etc/infiniband-diags/ibdiag.conf

یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های مشترک برای همه ابزارها ارائه شده است. برای جزئیات به فایل پیکربندی ارائه‌شده مراجعه کنید.

نویسنده (AUTHOR)

Albert Chu: < <chu11@llnl.gov> >