آموزش نصب مناسب چه کسانی است ؟
این آموزش نصب مخصوص وب مسترها ، سازمانهای متوسط و بزرگ و مراکزی که با دارا بودن سرور و زیر ساخت های مناسب و دارا بودن نیروی متخصص میخواهند نرم افزار بیگ بلو باتن را نصب کنند و این آموزش برای کاربران عادی مناسب نخواهد بود. کاربران عادی می توانند با مراجعه به صفحه خرید پلن های بیگ بلو باتن با هزینه بسیار مناسب نسبت به تهیه سرویس بیگ بلو باتن از سایت کلاسینار اقدام نمایند
در این مطلب می خوانید:
bbb-install
برای این که بتوانیدسرور BigBlueButton 2.3 را ستاپ کنید (یا از نسخۀ قبلی به نسخه 2.3 به روز رسانی کنید) تیم توسعه بیگ بلو باتن یک اسکریپت شل به نام bbb-install ایجاد کرده اند که گامهای نصب و به روزرسانی را خودکارسازی می کند .وابسته به اتصال اینتنرنتی سرور شما، bbb-install.sh می تواند سرور بیگ بلو باتن شما را کمتر از 30 دقیقه نصب و پیکربندی کند.
مثلاً، برای نصب آخرین ورژن بیگ بلو باتن 2.3 روی سرور جدید 64-bit Ubuntu 18.04 با آدرس public IP، یک نام میزبان (مثل bbb.example.com) که به آدرس public IP ختم می شود، و یک آدرس ایمیل (مثل info@example.com) ، کافی می باشد برای شروع از طریق SSH به سرور جدیدتان وارد شده و فرمان زیر را به عنوان کاربر روت (root) اجرا کنید
wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -w -a -v bionic-23 -s bbb.example.com -e info@example.com
این فرمان آخرین نسخۀ bbb-install.sh را دانلود میکند و آن را به مفسر شل یعنی Bash می فرستد و بیگ بلو باتن را با استفاده از مولفه هایی که تعیین می کنید نصب می کند:
- -w دیوار آتش (UFW) را نصب می کند تا دسترسی به پورتهای TCP/IP 22، 80 و 443 و پورتهای UDP در بازۀ 16384-32768 را محدود کند.
- -a دموهای API را نصب می کند (و انجام چند تست سریع را روی سرور تسهیل می کند)
- -v bionic-23 آخرین ساخت بیگ بلو باتن 2.3.x را نصب می کند.
- -s نام میزبانی سرور را به bbb.example.com تنظیم یا سِت می کند،
- -e یک آدرس ایمیل برای Letg’s encrypt فراهم می کند تا یک گواهی SSL معتبر برای میزبان بسازد.
توجه: اگر سرور شما نیز پشت فایروال خارجی باشد، مثل پشت دیوار آتشین شرکت یا پشت AWS Security Group، باید دستی دیوار آتشین خارجی را پیکربندی کنید تا اتصالات اینترنتی خاص را به سرور بیگ بلو باتن فوروارد کرده و بعد از آن می توانیدسرور را راه اندازی کنید.
وقتی فرمان بالا خاتمه یافت، یک پیام می بیینید که به شما یک test URL می دهد تا بیگ بلو باتن را راه اندازی کرده و به یک کلاس بپیوندید که «کلاس دمو» نام دارد.
# Warning: The API demos are installed and accessible from:
#
# https://bbb.example.com
#
# and
#
# https://bbb.example.com/demo/demo1.jsp
#
# These API demos allow anyone to access your server without authentication
# to create/manage meetings and recordings. They are for testing purposes only.
# If you are running a production system, remove them by running:
#
# sudo apt-get purge bbb-demo
URL را در کروم یا فایرفاکس را باز کرده (که مرورگرهای توصیه شده هستند). باید یک لاگین برای ملحق شدن به کلاس «کلاس دمو» را ببینید.
نام خود را وارد کرده و جوین را بزنید. آنگاه نرم افزار بیگ بلو باتن باید در مرورگر شما باز شود و شما را تشویق کند که اتصال صوتی خود را تنظیم کنید .
ببینید که صفحات وب از طریق HTTPS سرو می شوند. مرورگرها این را نیاز دارند تا بتوانند به وبکم، میکروفون یا صفحۀ شما (برای اشتراک صفحه) با استفاده از کتابخانه های اتصالات (WebRTC) اجازۀ دسترسی دهند. اگر سعی کنید که بیگ بلو باتن را بدون مشخص کردن مولفه های -s و -e نصب کنید، مشترک نمی تواند به کلاس متصل شود و ارور خواهدداشت.
نام میزبانی bbb.example.com و آدرس ایمیل info@example.com فقط مولفه های نمونه هستند شمما باید از نام دامنه خود و ایمیل خود استفاده فرمایید .بخشهای آتی شما را به جزئیاتی در مورد استفاده از bbb-install.sh راهنمایی می کند تا سرور بیگ بلو باتن خود را ستاپ یا آپگرید کنید.
بعد از تست کردن می توانید api demo ها را با دستور
sudo apt-get purge bbb-demo
پاک کنید. بعداً، می توانید سرور را به آخرین نسخۀ بیگ بلو باتن 2.3 با اجرای مجدد همان فرمان bbb-install.sh آپگرید کرده و -a را حذف کنید تا API demo ها را نصب نکند.
قسمتهای آتی به جزئیات بیشتری به ستاپ سرور جدید بیگ بلو باتن 2.3 می پردازد.
آماده سازی قبل از نصب بیگ بلو باتن
قبل از اجرای bbb-install.sh شما باید
- همه این سند در این صفحه را بخوانید
- مطمئن شوید که سرور شما از الزامات سرور کمینه (مینیمال) متابعت می کند،
- یک نام دامنه خوب (FQDN) مثل bbb.sample.com پیکربندی کنید، که به آدرس آی پی خارجی سرور شما ختم شود.
پیکربندی فایروال ؛ دیوار آتشین خارجی
اگر شما بیگ بلو باتن را روی یک سرور پشت دیوار آتشین خارجی نصب می کنید، مثل گروه امنیتی EC2 آمازون، باید دیوار آتشین خارجی را پیکربندی کنید تا ترافیک ورودی را به پورتهای زیر فوروارد کنید:
- TCP/IP port 22 (for SSH)
- TCP/IP ports 80/443 (for HTTP/HTTPS)
- UDP ports in the range 16384 – 32768 (for FreeSWITCH/HTML5 client RTP streams)
گزینه های خط فرمان
می توانید با زدن گزینۀ -h به راهنمای آبشن های نصب دسترسی داشته باشید . البته ما تصویر آبشن ها را در زیر برای شما درج کرده ایم .
اسکریپت برای نصب سرور بیگ بلو باتن 2.3 (یا جدیدتر) ظرف 30 دقیقه.
این اسکریپت از نصب سرور کوتِرن (TURN) را روی سرور جدا حمایت می کند.
Script for installing a BigBlueButton 2.3 (or later) server in about 30 minutes.
This script also supports installation of a coturn (TURN) server on a separate server.
USAGE:
wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- [OPTIONS]
OPTIONS (install BigBlueButton):
-v <version> Install given version of BigBlueButton (e.g. 'bionic-23') (required)
-s <hostname> Configure server with <hostname>
-e <email> Email for Let's Encrypt certbot
-x Use Let's Encrypt certbot with manual dns challenges
-a Install BBB API demos
-g Install Greenlight
-c <hostname>:<secret> Configure with coturn server at <hostname> using <secret>
-m <link_path> Create a Symbolic link from /var/bigbluebutton to <link_path>
-p <host> Use apt-get proxy at <host>
-r <host> Use alternative apt repository (such as packages-eu.bigbluebutton.org)
-d Skip SSL certificates request (use provided certificates from mounted volume)
-w Install UFW firewall
-h Print help
OPTIONS (install coturn only):
-c <hostname>:<secret> Setup a coturn server with <hostname> and <secret> (required)
-e <email> Configure email for Let's Encrypt certbot (required)
OPTIONS (install Let's Encrypt certificate only):
-s <hostname> Configure server with <hostname> (required)
-e <email> Configure email for Let's Encrypt certbot (required)
-l Install Let's Encrypt certificate (required)
-x Use Let's Encrypt certbot with manual DNS challenges (optional)
EXAMPLES:
Sample options for setup a BigBlueButton server
-v bionic-23 -s bbb.example.com -e info@example.com -w
-v bionic-23 -s bbb.example.com -e info@example.com -w -g
-v bionic-23 -s bbb.example.com -e info@example.com -w -g -c turn.example.com:1234324
Sample options for setup of a coturn server (on a Ubuntu 20.04 server)
-c turn.example.com:1234324 -e info@example.com
SUPPORT:
Community: https://bigbluebutton.org/support
Docs: https://github.com/bigbluebutton/bbb-install
قبل از این که bbb-install.sh بتواند یک گواهی SSL/TLS را نصب کند، باید دو نوع اطلاعات را فراهم کنید.
- یک نام دامنۀ خوب (FQDN) مثل bbb.example.com که به آدرس آی پی عمومی سرور شما حل می شود.
- یک آدرس ایمیل
نصب در شبکۀ خصوصی
اسکریپت نصب پیشفرض برای سرورهایی است که در دست عموم هستند. زیرا Let’s Encrypt باید به nginx دسترسی داشته باشد تا به نحو خودکار FQDN فراهم شده را اعتبارسنجی کند.
موقع نصب بیگ بلو باتن در شبکه خصوصی، می توان به شکل دستی FQDN را اعتبارسنجی کرد، با افزودن گزینۀ X – در خط فرمان. مثلاً:
wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -v bionic-23 -s bbb.example.com -e info@example.com -w -x
نصب دموهای API
می توانید دموهای API را با افزودن گزینۀ -a نصب کرد.
wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -v bionic-23 -s bbb.example.com -e info@example.com -w -a
نصب گرین لایت GreenLight
گرین لایت یک واسط کاربری ساده برای بیگ بلو باتن است که توسط روبی و ریلز نوشته شده است. این نرم افزار به کاربران اجازه می دهد که حساب کاربری برای اتصال به بیگ بلو بسازند، اتاقهای دائمی داشته باشند و ضبطها را مدیریت کنند. این نرم افزار همچنین به شما اجازه می دهد، که به عنوان ادمین، حسابهای کاربرها را مدیریت کنید (مثل قبول یا رد کردن کاربران).
می توانید گرین لایت را با افزودن گزینۀ -g نصب کنید.
wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -v bionic-23 -s bbb.example.com -e info@example.com -w -g
وقتی گرین لایت نصب شود، صفحه خانگی پیشفرض به سوی گرین لایت هدایت (redirect) می شود . همچنین می توانید گرین لایت را برای استفاده تخصصی تر پیکربندی کنید.
عیب یابی
سرور دانلود بسته نصب مسدود شده است
بیگ بلو باتن در حال حاضر بسته بندی روی سرولت (servlet) دیجیتال اوشن را میزبانی می کنیم، ولی فعلاً محدودۀ آی پی برای سرورهای دیجیتال اوشن در برخی کشورها مسدود شده است.
اگر شما با نصب، مشکل دارید، سعی کنید فرمان bbb-install.sh را اجرا کنید، برای این کار خط زیر را
https://ubuntu.bigbluebutton.org/bbb-install.sh
به
https://packages-eu.bigbluebutton.org/bbb-install.sh
عوض کنید.
تامکت هفت (Tomcan7) کار نمی کند
اگر در نصب اولیه می بینید که
# Not running: tomcat7 or grails LibreOffice
فقط
sudo bbb-conf –check
را دوباره اجرا کنید.
تامکت هفت شاید برای شروع شدن کمی بیشتر طول بدهد و اولین باری که sudo bbb-conf –check را اجرا می کنید، اجرا نشود.
محدودیتها
اگر شما بیگ بلو باتن را پشت دیوار آتشین نصب کنید، مثل روی EC2، این اسکریپت دیوار آتشین شما را پیکربندی نمی کند. شما باید دیوار آتشین را دستی پیکربندی کنید.
اگر در حال به روز رسانی از یک نسخۀ بسیار قدیمی 2.2.x (مثلاً 2.2.3) به جدیدترین نسخۀ 2.2. (با استفاده از -v xenial -22) هستید ، در آن صورت sudo bbb-conf –check هنوز نسخۀ قدیمی تر را نشان خواهد داد وقتی bbb-install.sh تمام می شود. برای راه حل ،
dpkg –configure -a
را اجرا کرده بعد از آن
bbb-install.sh
را دوباره اجرا کنید.
محدودیت نصب بسته ها برای ایرانیان و راه حل آن
چنانچه از سرورهای ایران بخواهید برای نصب اقدام کنید احتمالا با شکست روبرو شدید و انواع خطاهای 403 هنگام دانلود بسته های نصبی شما را کلافه کرده است.
خوب همانطور که میدانید به دلیل تحریم آیپی های ایران این اتفاق می افتد.
راه حل چیست ؟
شما باید تحریم ها را با تغییر DNS دور بزنید ..
قبل از نصب سری به سایت
ّبزنید و DNS های خود را با استفاده از راه حلی که در این سایت هست عوض کنید . بعد از تغییر DNS ها می توانید دستور اسکریپت را اجرا کنید .
یادتان نرود که بعد از اینکه نصب کامل شد مجدد DNS ها را به حالت پیشفرض تغییر دهید تا سرعت دانلود و اپلود سرور شما تغییر نکند .