ساخت منبع و راه‌اندازی Agent

منبع، نماینده‌ی یک محیط vCenter یا ESXi در پنل کاربری آروان‌کلاد است. پس از ساخت منبع، Agent را در همان محیط نصب می‌کنید و Agent با شناسه‌ی منبع یا UID به آروان‌کلاد وصل می‌شود. برای مثال، اگر vCenter دیتاسنتر سازمان‌تان را به آروان‌کلاد منتقل می‌کنید، یک منبع با نامی مانند vcenter-office می‌سازید و Agent را روی همان vCenter نصب می‌کنید.

پیش از شروع، مراحل آماده‌سازی محیط VMware را انجام دهید. در این مراحل به کلید API آروان‌کلاد و نام کاربری و رمز عبور کاربر vCenter نیاز دارید.

ساخت منبع

در پنل سرور ابری، وارد بخش «مهاجرت ابری» شوید و روی دکمه‌ی «مهاجرت ابری جدید» کلیک کنید.

در صفحه‌ی باز شده، اطلاعات زیر را وارد کنید:

• نام منبع

  یک نام برای منبع وارد کنید تا آن را در لیست منابع پیدا کنید. این فیلد اجباری است.

• برچسب‌ها

  برای دسته‌بندی منابع می‌توانید تا ۸ برچسب اضافه کنید. پس از نوشتن هر برچسب، کلید Enter را بزنید یا روی دکمه‌ی + کلیک کنید.

سپس روی دکمه‌ی «تایید» کلیک کنید. منبع جدید در لیست منابع بخش «مهاجرت ابری» نمایش داده می‌شود.

در لیست منابع، روی آیکن کپی مقابل UID منبع کلیک کنید و آن را نگه دارید. هنگام نصب Agent به این شناسه نیاز دارید.

دانلود Agent

Agent یک ماشین مجازی آماده در قالب فایل OVA است. برای دانلود آن، در بخش «مهاجرت ابری» روی دکمه‌ی «دانلود Agent» کلیک کنید.

منابع ماشین Agent در فایل OVA تعیین شده‌اند و قابل تغییر نیستند.

نصب Agent در vCenter

Agent را مانند هر فایل OVA دیگری از طریق vSphere Client نصب کنید. در این فرآیند، تنظیمات اتصال Agent را هم وارد می‌کنید تا Agent در نخستین روشن شدن، به‌شکل خودکار پیکربندی شود.

مرحله ۱: انتخاب فایل OVA

در vSphere Client، روی Datacenter ،Cluster یا Host موردنظر راست‌کلیک کنید و گزینه‌ی «Deploy OVF Template» را انتخاب کنید. در صفحه‌ی «Select an OVF template»، گزینه‌ی «Local file» را انتخاب کنید و فایل OVA دانلودشده را آپلود کنید.

مرحله ۲: انتخاب نام و محل اجرا

در صفحه‌ی «Select a name and folder»، یک نام برای ماشین Agent وارد کنید و پوشه‌ی آن را انتخاب کنید. سپس در صفحه‌ی «Select a compute resource»، باید Host یا Clusterی را انتخاب کنید که Agent روی آن اجرا می‌شود. در صفحه‌ی «Review details»، مشخصات فایل OVA را بررسی کنید.

مرحله ۳: انتخاب Datastore

در صفحه‌ی «Select storage»، گزینه‌ی Datastore موردنظر را برای دیسک Agent انتخاب کنید.

مرحله ۴: اتصال کارت‌های شبکه

در صفحه‌ی «Select networks»، کارت شبکه‌ی مدیریت Agent را به شبکه‌ای وصل کنید که vCenter و ESXiها در آن قرار دارند و کارت شبکه‌ی اینترنت را به شبکه‌ای با دسترسی اینترنت وصل کنید. نیازمندی‌های شبکه‌ی Agent در انتخاب این دو شبکه به شما کمک می‌کند.

مرحله ۵: وارد کردن تنظیمات Agent

در صفحه‌ی «Customize template»، اطلاعات زیر را وارد کنید:

• رمز عبور Agent

  رمز ورود به کنسول ماشین Agent را تعیین کنید. اگر Agent آنلاین نشود، برای بررسی لاگ‌ها یا پیکربندی دوباره به این رمز نیاز دارید. این فیلد اجباری است.

• کلید API آروان‌کلاد

  کلید API ماشین یوزری را که برای Agent ساختید وارد کنید. این فیلد اجباری است.

• UID منبع

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

• آدرس vCenter

  آدرس IP یا نام دامنه‌ی vCenter را در شبکه‌ی مدیریت وارد کنید. این فیلد اجباری است.

• نام کاربری و رمز عبور vCenter

  اطلاعات کاربری را که برای Agent در vCenter ساختید وارد کنید؛ برای مثال rvdr-agent@vsphere.local. این فیلد اجباری است.

مرحله ۶: پایان نصب

در صفحه‌ی «Ready to complete»، تنظیمات را بررسی کنید و روی «Finish» کلیک کنید. پس از پایان Deploy، ماشین Agent را روشن کنید.

در نخستین روشن شدن، Agent کارت‌های شبکه را بررسی می‌کند، تنظیماتی را که وارد کردید ذخیره می‌کند و سرویس خود را اجرا می‌کند. پس از آن می‌توانید اتصال Agent را بررسی کنید.

نصب Agent روی ESXi مستقل

اگر vCenter ندارید و از ESXi مستقل استفاده می‌کنید، فایل OVA را از طریق ESXi Host Client به‌شکل یک ماشین مجازی ایجاد کنید. مراحل این کار با vCenter متفاوت است و در این حالت، تنظیمات Agent را پس از روشن شدن آن به‌شکل دستی وارد می‌کنید. برای این کار، ماشین Agent را روشن کنید و مراحل بخش پیکربندی دستی Agent را انجام دهید.

پیکربندی دستی Agent

اگر Agent را روی ESXi مستقل نصب کرده‌اید یا بخواهید تنظیمات آن را اصلاح کنید، از این روش استفاده کنید. برای مثال وقتی کلید API یا اطلاعات vCenter را اشتباه وارد کرده‌اید و Agent نمی‌تواند وصل شود.

از طریق vSphere Client یا ESXi Host Client، کنسول ماشین Agent را باز کنید و با رمز عبوری که هنگام نصب تعیین کردید وارد شوید. سپس دستور زیر را اجرا کنید:

sudo rvdr-first-setup

این دستور اطلاعات موردنیاز Agent را یکی‌یکی از شما می‌پرسد:

• RVDR API URL

  آدرس API آروان‌کلاد. مقدار پیش‌فرض https://napi.arvancloud.ir است و برای استفاده از آن کافی است Enter را بزنید.

• RVDR API key

  کلید API ماشین یوزر.

• UID منبع

  شناسه‌ی منبعی که در پنل کاربری ساختید.

• آدرس، نام کاربری و رمز عبور vCenter یا ESXi

  اطلاعات کاربری که برای Agent ساختید.

تنظیمات در فایل /etc/rvdr-agent/config.yaml ذخیره می‌شوند. پس از آن، سرویس Agent را دوباره اجرا کنید:

sudo systemctl restart rvdr-agent

بررسی اتصال Agent

پس از روشن شدن Agent، در پنل کاربری به بخش «مهاجرت ابری» برگردید و روی دکمه‌ی نمایش مجدد کلیک کنید. وقتی Agent به آروان‌کلاد وصل شود، مرحله‌ی «نصب Agent» در ردیف منبع با تیک سبز مشخص می‌شود و دکمه‌ی «شروع پیکربندی» مقابل آن نمایش داده می‌شود.

اگر Agent آنلاین نشد، وارد کنسول ماشین Agent شوید و لاگ‌های نخستین روشن شدن آن را با دستور زیر بررسی کنید:

sudo journalctl -f -u rvdr-apply-ovf-env.service

در این لاگ‌ها، خط network verified نشان می‌دهد که Agent هر دو کارت شبکه‌ی مدیریت و اینترنت را شناسایی کرده است. در حالت عادی، لاگ‌ها با پیام زیر تمام می‌شوند:

=== RVDR appliance first-boot automation completed successfully ===

اگر این پیام را نمی‌بینید، خطاهای پیش از آن را بررسی کنید. بیش‌تر این خطاها به این دلیل رخ می‌دهند که Agent به اینترنت و APIهای آروان‌کلاد یا به vCenter و ESXiها دسترسی ندارد. در این حالت، نیازمندی‌های شبکه را دوباره بررسی کنید.

اگر نخستین روشن شدن با موفقیت تمام شده اما Agent هنوز آنلاین نیست، لاگ‌های عملیاتی Agent را بررسی کنید:

sudo journalctl -f -u rvdr-agent.service

در حالت عادی، Agent به‌شکل دوره‌ای برنامه‌ی مهاجرت را از آروان‌کلاد دریافت می‌کند و پیام‌هایی مانند نمونه‌ی زیر ثبت می‌کند:

level=INFO msg="Polling RVDR API for schedules..." app=rvdr_agent
level=INFO msg="Poll and schedule sync complete" app=rvdr_agent

اگر در این لاگ‌ها خطا می‌بینید، کلید API آروان‌کلاد و نام کاربری و رمز عبور vCenter را بررسی کنید. این دو مورد رایج‌ترین دلیل وصل نشدن Agent هستند و می‌توانید با پیکربندی دستی Agent آن‌ها را اصلاح کنید.

پس از آنلاین شدن Agent، می‌توانید ماشین‌های مجازی را برای مهاجرت پیکربندی کنید.