.\"     # DS - begin display
.de DS
.RS
.nf
.sp
..
.\"     # DE - end display
.de DE
.fi
.RE
.sp
..
.TH radrelay.conf 5 "27 May 2005" "" "FreeRADIUS configuration file"
.SH "نام (NAME)"
radrelay.conf \- فایل پیکربندی برای حالت «radrelay» کارگزار FreeRADIUS
.SH "توضیحات (DESCRIPTION)"
فایل
\fBradrelay.conf\fP
در دایرکتوری پایگاه دادهٔ radius، به طور پیش‌فرض
\fB/etc/raddb\fP
قرار دارد. این فایل پیکربندی سراسری را برای کارگزار FreeRADIUS، زمانی که کارگزار در حالت «radrelay» کار می‌کند، تعریف می‌نماید.
.SH "قالب فایل (FILE FORMAT)"
برای توضیحات دقیق دربارهٔ قالب فایل، به «man radiusd.conf» مراجعه کنید. مدخل‌های پیکربندی در radrelay.conf تا حد زیادی مشابه هستند، همراه با چند تفاوت که در اینجا ذکر شده است.
.SH "همانندسازی برای نسخه‌های پشتیبان (REPLICATION FOR BACKUPS)"
بسیاری از مراکز چندین کارگزار radius اجرا می‌کنند؛ حداقل یک سرور اصلی و یک سرور پشتیبان. هنگامی که سرور اصلی از کار می‌افتد، بیشتر NASها متوجه این موضوع شده و به سرور پشتیبان سوئیچ می‌کنند.
.PP
این امر موجب می‌شود بسته‌های حسابرسی (accounting) شما به سرور پشتیبان ارسال شوند — و حتی برخی از NASها زمانی که سرور اصلی دوباره فعال می‌شود، به سرور اصلی بازنمی‌گردند.
.PP
نتیجه این است که رکوردهای حسابرسی از دست می‌روند، و/یا مدیر سیستم برای ترکیب فایل‌های جزئیات (detail) مختلف از چندین سرور، متحمل زحمت فراوان می‌شود. همچنین بدین معناست که پایگاه دادهٔ نشست‌ها («radutmp» که برای radwho و تشخیص استفادهٔ هم‌زمان به کار می‌رود) از هماهنگی خارج می‌شود.
.PP
برنامهٔ radrelay این مشکل را با «بازپخش» (relay) بسته‌ها از یک سرور به سرور دیگر حل می‌کند تا هر دو دارای مجموعهٔ یکسانی از داده‌های حسابرسی باشند.
.SH "بافرینگ برای کارگزارهای با بار کاری بالا (BUFFERING FOR HIGH-LOAD SERVERS)"
اگر کارگزار RADIUS ناگهان تعداد زیادی بستهٔ حسابرسی دریافت کند، ممکن است توان پردازشی کافی (CPU) برای پردازش به‌موقع همهٔ آن‌ها وجود نداشته باشد. این مشکل به‌ویژه زمانی که بسته‌های حسابرسی به یک پایگاه داده در پس‌زمینه (back-end) ارسال می‌شوند، مشهود است.
.PP
به طور مشابه، ممکن است یک پایگاه داده داشته باشید که نشست‌های فعال («live») را پیگیری می‌کند و پایگاه دادهٔ دیگری که داده‌های پیشینهٔ حسابرسی را ثبت می‌نماید. در این حالت، دسترسی به پایگاه دادهٔ اول سریع است زیرا کوچک است. دسترسی به پایگاه دادهٔ دوم ممکن است کندتر باشد، زیرا ممکن است حاوی چندین گیگابایت داده باشد. علاوه بر این، نوشتن به‌موقع روی پایگاه دادهٔ اول بسیار مهم است، در حالی که داده‌ها می‌توانند با چند دقیقه تأخیر و بدون هیچ مشکلی روی پایگاه دادهٔ دوم نوشته شوند.
.SH "بازپخش بسته‌های حسابرسی (RELAYING OF ACCOUNTING PACKETS)"
فایل
\fBradrelay.conf\fP
حالت «radrelay» کارگزار را کنترل می‌کند که می‌تواند هر دو عملکرد فوق را به طور هم‌زمان انجام دهد.
.SH "نحوه استفاده (USAGE)"
ابتدا باید کارگزار اصلی radius را پیکربندی کنید تا در یک فایل detail مجزا و اضافی ثبت لاگ کند. این کار را می‌توان با افزودن یک نمونهٔ اضافی از ماژول detail به
\fBradiusd.conf\fP
انجام داد:
.PP
برای نمونه:

.DS
	detail radrelay-detail {
.br
		filename = ${radacctdir}/radrelay/detail
.br
		permissions = 0600
.br
		dir_permissions = 0755
.br
		locking = yes
.br
	}
.br
	...
.br
	accounting {
.br
		...
.br
		radrelay-detail
.br
		...
.br
	}
.br
.DE
این پیکربندی باعث می‌شود بسته‌های حسابرسی در فایل
\fI${radacctdir}/radrelay/detail\fP
ثبت شوند. این فایل نباید توسط اسکریپت‌های استاندارد چرخش لاگ (log rotation) چرخانده شود، زیرا برنامهٔ
\fBradrelay\fP
آن را خوانده و خواهد چرخاند.
.SH "نمونه RADRELAY.CONF (RADRELAY.CONF EXAMPLE)"
برای دستورالعمل‌های تفصیلی دربارهٔ مدخل‌های پیکربندی، معنای آن‌ها و نحوهٔ استفاده از آن‌ها به فایل
\fBradrelay.conf\fP
مراجعه کنید.
.PP
برای اینکه بخش «radrelay» کارگزار فایل detail فوق را بخواند،
\fBradrelay.conf\fP
را با بخش زیر پیکربندی کنید:

.DS
.br
	listen {
.br
		type = detail
.br
		filename = ${radacctdir}/radrelay/detail
.br
		max_outstanding = 100
.br
		identity = radrelay
.br
	}
.br
.DE

کارگزار بسته‌های حسابرسی را از فایل detail می‌خواند و آن‌ها را دقیقاً همان‌گونه که از NAS دریافت کرده بود پردازش می‌کند. بنابراین، باید بخش «accounting» در
\fBradrelay.conf\fP
را طوری پیکربندی کنید که رکوردهای حسابرسی را در یک ماژول «sql» بنویسد، یا آن‌ها را به یک کارگزار RADIUS دیگر پروکسی نماید.
.PP
سپس، کارگزار را از طریق دستور زیر راه‌اندازی کنید:
.PP
.nf
$ radiusd \-n radrelay
.fi
.PP
کارگزار باید راه‌اندازی شود، فایل detail را بخواند و بسته‌های حسابرسی را از آن پردازش کند.
.SH "نکات (NOTES)"
هنگامی که کارگزار در حالت radrelay اجرا می‌شود، فایل
\fBradiusd.conf\fP
به هیچ وجه خوانده نمی‌شود. لطفاً
\fBradrelay.conf\fP
را ویرایش کنید.
.SH "اعتبارات (CREDITS)"
برنامهٔ اصلی «radrelay» توسط Miquel van Smoorenburg برای پروژهٔ Cistron radius نوشته شد و توسط Simon Ekstrand به FreeRADIUS پورت گردید. برنامهٔ «radsqlrelay» توسط Kostas Kalavras نوشته شد. این برنامه هرگز به عنوان بخشی از یک انتشار رسمی FreeRADIUS عرضه نشد، اما به عنوان مبنایی برای طراحی این پیاده‌سازی عمل کرد.
.PP
.SH "فایل‌ها (FILES)"
/etc/raddb/radrelay.conf
.SH "همچنین ببینید (SEE ALSO)"
.BR radiusd (8),
.BR radiusd.conf (5)
.SH "نویسنده (AUTHOR)"
Alan DeKok <aland@ox.org>