مشاركة عبر

تثبيت ملحق عامل Azure File Sync وإدارته على خوادم Windows التي تدعم Azure Arc

توضح هذه المقالة كيفية تثبيت ملحق عامل Azure File Sync والتحقق من صحته وإلغاء تثبيته على خوادم Windows التي تدعم Azure Arc. يقوم Azure File Sync Agent لملحق Windows بتوزيع عامل مزامنة ملفات Azure على خادم Windows متصل من خلال Azure Arc، ما يسمح للخادم بمزامنة الملفات مع مشاركة ملف Azure. يتم نشر الملحق بواسطة Microsoft ويمكن إدارته باستخدام مدخل Azure أو Azure PowerShell أو Azure CLI.

المتطلبات الأساسية

  • خادم Azure Arc الممكن (Windows فقط): يجب توصيل الجهاز الهدف ب Azure Arc (عامل Azure Connected Machine المثبت والمكتمل) وتشغيل نظام تشغيل Windows Server مدعوم. يتم دعم Azure File Sync على Windows Server 2012 R2 أو أحدث (راجع متطلبات نظام Azure File Sync وإمكانية التشغيل التفاعلي للحصول على تفاصيل حول الإصدارات المدعومة).

    هام

    ملحق عامل Azure File Sync مدعوم فقط على Windows. الخوادم التي تدعم Linux Arc غير مدعومة ل Azure File Sync.

  • يجب أن يكون لدى الخادم الممكن بواسطة Arc شهادة جذر Microsoft (المرجع المصدق الجذر من Microsoft 2011) مثبتة. لمزيد من التفاصيل، راجع هذا المستند.

  • موارد Azure: يجب أن تكون خدمة مزامنة تخزين Azure موجودة في اشتراك Azure لتسجيل الخادم الخاص بك بعد تثبيت العامل. (لا تحتاج إلى تسجيل الخادم قبل التثبيت، ولكنك ستقوم بتسجيله في Storage Sync Service لبدء المزامنة. يتم تناول ذلك في الخطوات التالية.)

  • بيئة Azure PowerShell أو Azure CLI:

    • بالنسبة إلى Azure PowerShell، قم بتثبيت الوحدة النمطية Azure PowerShell (الوحدة النمطية Az) مع الوحدة النمطية Az.ConnectedMachine . تأكد من تثبيت أحدث إصدار من Az PowerShell، ثم قم بتشغيل Connect-AzAccount لتسجيل الدخول إلى Azure.

    • بالنسبة إلى Azure CLI، قم بتثبيت Azure CLI وسجل الدخول (az login). تأكد من أن Azure CLI لديه ملحق Connected Machine مثبت عن طريق تشغيل:

      az extension add --name connectedmachine

      يوفر az connectedmachine ملحق Connected Machine الأوامر التي ستحتاجها.

  • اتصال الشبكة: يجب أن يكون لدى الخادم حق الوصول إلى الشبكة إلى نقاط نهاية Azure المطلوبة بواسطة Azure Arc وAzure File Sync (على سبيل المثال، لتنزيل الملحق والوصول إلى نقاط نهاية خدمة Azure File Sync). تأكد من أن إعدادات جدار الحماية أو الوكيل تسمح بعناوين URL الضرورية لخدمة Azure. راجع إعدادات وكيل Azure File Sync وجدار الحماية لمزيد من المعلومات.

قم بتثبيت ملحق العامل

يمكنك تثبيت Azure File Sync Agent لملحق Windows على خادم Windows ممكن بواسطة Arc باستخدام مدخل Microsoft Azure أو Azure PowerShell أو Azure CLI.

  1. افتح مورد الخادم الممكن ل Arc: في مدخل Microsoft Azure، انتقل إلى Azure Arc > Machines وحدد خادم Windows الممكن ل Arc الذي تريد تثبيت الملحق عليه.

  2. إضافة ملحق: ضمن قسم ملحقات الخادم، حدد + إضافة. في قائمة الملحقات المتوفرة، ابحث عن Azure File Sync Agent لملحق Windows وحدده (المنشور بواسطة Microsoft)، ثم حدد التالي.

لقطة شاشة توضح كيفية تثبيت ملحق عامل Azure File Sync لنظام التشغيل Windows

  1. تكوين الإعدادات: تكوين إعدادات عامل Azure File Sync التي سيتم تثبيتها على جهاز Arc. راجع الإعدادات المتوفرة للحصول على القائمة الكاملة للإعدادات ومعناها.

لقطة شاشة توضح كيفية تكوين ملحق عامل Azure File Sync لنظام التشغيل Windows

  1. أقام: حدد Review + create لنشر الملحق. سيبدأ Azure تثبيت الملحق الذي يقوم بتثبيت أحدث إصدار من عامل Azure File Sync على الخادم. في غضون بضع دقائق، يجب تثبيت الملحق. يمكنك مراقبة تقدم التوزيع في مدخل Microsoft Azure. بمجرد الانتهاء، سيظهر الملحق بالحالة نجح التزويد في قائمة الملحقات.

التثبيت باستخدام قالب ARM

يمكنك أيضا نشر ملحق عامل Azure File Sync إلى خادم Windows ممكن بواسطة Arc باستخدام قالب Azure Resource Manager (ARM). هذا الأسلوب مفيد للأتمتة أو عمليات النشر واسعة النطاق.

1. إعداد ملف المعلمات

parameters.json إنشاء ملف مع تفاصيل التخصيص الخاصة بك، بما في ذلك اسم الجهاز الظاهري وإعدادات الملحق:

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "AgentInstallDir": { "value": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "UseCustomProxy": { "value": true },
    "ProxyAddress": { "value": "http://proxy.contoso.com" },
    "ProxyPort": { "value": "80" },
    "ProxyAuthRequired": { "value": true },
    "ProxyUserName": { "value": "ProxyUserName" },
    "ProxyPassword": { "value": "ProxyPassword" },
    "EnrollInMicrosoftUpdate": { "value": true },
    "EnableAgentAutoUpdate": { "value": true },
    "AutoUpdateScheduledDayOfWeek": { "value": "Monday" },
    "AutoUpdateScheduledHourOfDay": { "value": "23" },
    "EnableServerDiagnostics": { "value": true },
    "vmName": { "value": "ArcVM1" },
    "location": { "value": "eastus2euap" }
  }
}

2. إعداد ملف القالب

template.json إنشاء ملف كما هو موضح هنا. يحدد هذا القالب مورد الملحق ويرسم معلمات لإعدادات الملحق:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "0.43.0.0",
  "parameters": {
    "vmName": { "type": "string" },
    "location": { "type": "string" },
    "agentInstallDir": { "type": "string", "defaultValue": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "useCustomProxy": { "type": "bool", "defaultValue": false },
    "proxyAddress": { "type": "string", "defaultValue": "" },
    "proxyPort": { "type": "string", "defaultValue": "0" },
    "proxyAuthRequired": { "type": "bool", "defaultValue": false },
    "proxyUsername": { "type": "string", "defaultValue": "" },
    "proxyPassword": { "type": "securestring", "defaultValue": "" },
    "enrollInMicrosoftUpdate": { "type": "bool", "defaultValue": true },
    "enableAgentAutoUpdate": { "type": "bool", "defaultValue": false },
    "autoUpdateScheduledDayOfWeek": { "type": "string", "defaultValue": "Tuesday" },
    "autoUpdateScheduledHourOfDay": { "type": "string", "defaultValue": "18" },
    "enableServerDiagnostics": { "type": "bool", "defaultValue": true }
  },
  "variables": {
    "AgentInstallDir": "[parameters('agentInstallDir')]",
    "UseCustomProxy": "[parameters('useCustomProxy')]",
    "ProxyAddress": "[parameters('proxyAddress')]",
    "ProxyPort": "[int(parameters('proxyPort'))]",
    "ProxyAuthRequired": "[parameters('proxyAuthRequired')]",
    "ProxyUserName": "[parameters('proxyUserName')]",
    "ProxyPassword": "[parameters('proxyPassword')]",
    "EnrollInMicrosoftUpdate": "[parameters('enrollInMicrosoftUpdate')]",
    "EnableAgentAutoUpdate": "[parameters('enableAgentAutoUpdate')]",
    "AutoUpdateScheduledDayOfWeek": "[parameters('autoUpdateScheduledDayOfWeek')]",
    "AutoUpdateScheduledHourOfDay": "[parameters('autoUpdateScheduledHourOfDay')]",
    "EnableServerDiagnostics": "[parameters('enableServerDiagnostics')]"
  },
  "resources": [
    {
      "name": "[concat(parameters('vmName'),'/AzureFileSyncAgentExtension')]",
      "type": "Microsoft.HybridCompute/machines/extensions",
      "location": "[parameters('location')]",
      "apiVersion": "2021-05-20",
      "properties": {
        "publisher": "Microsoft.StorageSync",
        "type": "AzureFileSyncAgentExtension",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": {
          "agentInstallDir": "[variables('AgentInstallDir')]",
          "useCustomProxy": "[variables('UseCustomProxy')]",
          "proxyAddress": "[variables('ProxyAddress')]",
          "proxyPort": "[variables('ProxyPort')]",
          "proxyAuthRequired": "[variables('ProxyAuthRequired')]",
          "proxyUsername": "[variables('ProxyUserName')]",
          "enrollInMicrosoftUpdate": "[variables('EnrollInMicrosoftUpdate')]",
          "enableAgentAutoUpdate": "[variables('EnableAgentAutoUpdate')]",
          "autoUpdateScheduledDayOfWeek": "[variables('AutoUpdateScheduledDayOfWeek')]",
          "autoUpdateScheduledHourOfDay": "[variables('AutoUpdateScheduledHourOfDay')]",
          "enableServerDiagnostics": "[variables('EnableServerDiagnostics')]"
        },
        "protectedSettings": {
          "proxyPassword": "[parameters('proxyPassword')]"
        }
      }
    }
  ]
}

3. نشر القالب

استخدم أمر PowerShell التالي لنشر القالب إلى مجموعة الموارد الخاصة بك:

New-AzResourceGroupDeployment -ResourceGroupName "<ResourceGroupName>" -TemplateFile "template.json" -TemplateParameterFile "parameters.json"

استبدل <ResourceGroupName> باسم مجموعة الموارد التي تحتوي على الجهاز الذي يدعم Arc. سيؤدي ذلك إلى نشر ملحق عامل Azure File Sync مع الإعدادات المحددة إلى خادم Windows الذي يدعم Arc الهدف.

الإعدادات المتوفرة

يمكنك تكوين الإعدادات التالية أثناء تثبيت ملحق عامل Azure File Sync:

الاسم الغرض نوع القيمة / الخيارات افتراضي
AgentInstallDir دليل لتثبيت عامل Azure File Sync مسار الملف C:\Program Files\Azure\StorageSyncAgent\
EnableAgentAutoUpdate تثبيت آخر تحديثات العامل تلقائيا true / false false
AutoUpdateScheduledDayOfWeek يوم من الأسبوع لجدولة التحديث التلقائي Sunday إلى Saturday Tuesday
AutoUpdateScheduledHourOfDay ساعة من اليوم للتحديث التلقائي المجدول 0 إلى 23 (تنسيق على مدار 24 ساعة) 18 (6 مساء)
EnableServerDiagnostics تمكين التسجيل التشخيصي للعامل أو تعطيله true / false true
EnrollInMicrosoftUpdate التسجيل في خدمة Microsoft Update true / false true
UseCustomProxy استخدام خادم وكيل مخصص للاتصال true / false false
ProxyAddress عنوان خادم الوكيل المخصص عنوان URL أو عنوان IP (على سبيل المثال، http://proxy.example.com أو https://192.168.1.1) (مطلوب إذا كان UseCustomProxy )true
ProxyPort منفذ اتصال الخادم الوكيل رقم المنفذ (على سبيل المثال، 8080) (مطلوب إذا كان UseCustomProxy )true
ProxyAuthRequired يشير إلى ما إذا كان الوكيل يتطلب مصادقة true / false false
ProxyUserName اسم المستخدم لمصادقة الوكيل سلسلة اسم المستخدم (مطلوب إذا كان ProxyAuthRequired )true
ProxyPassword كلمة المرور لمصادقة الوكيل سلسلة كلمة المرور (مطلوب إذا كان ProxyAuthRequired )true

إذا كان جهاز Azure Arc يحتوي بالفعل على عامل Azure File Sync مثبت، تثبيت الملحق بنجاح ولن يعدل عامل Azure File Sync الموجود المثبت على الجهاز.

التحقق من صحة التثبيت

بعد التثبيت، تحقق من نشر ملحق عامل Azure File Sync بنجاح وأن العامل قيد التشغيل على الخادم الخاص بك.

في مدخل Microsoft Azure، انتقل إلى مورد خادم Arc الممكن وافتح شفرة Extensions . تأكد من إدراج ملحق عامل Azure File Sync وتظهر حالتهSucceeded. يمكنك النقر فوق الملحق لعرض مزيد من التفاصيل مثل رقم الإصدار ورسالة الحالة. بالإضافة إلى ذلك، على الخادم نفسه، يمكنك التأكد من تثبيت Azure File Sync Agent (على سبيل المثال، تحقق من البرامج والميزات أو تأكد من تشغيل خدمة FileSyncSvc ).

سيتضمن الإخراج معلومات حول الملحق، مثل provisioningState الخاص به (والذي يجب أن يكون ناجحا إذا تم تثبيت العامل بشكل صحيح)، والنوع (اسم نوع الملحق)، و typeHandlerVersion (الذي يشير إلى إصدار عامل Azure File Sync الذي تم تثبيته). تحقق من نجاح حالة التوفير وأن الإصدار الذي تم الإبلاغ عنه يطابق إصدار العامل المتوقع. إذا لم يكن الملحق مدرجا أو لم تنجح الحالة، فراجع تفاصيل الخطأ في الإخراج أو في مدخل Microsoft Azure لاستكشاف الأخطاء وإصلاحها.

الخطوات التالية

بعد تثبيت الملحق، يجب تثبيت عامل Azure File Sync في جهاز Arc. ومع ذلك، لتمكين Azure File Sync على الأجهزة، تحتاج إلى إكمال الخطوات التالية.

  • تسجيل الخادم باستخدام Azure File Sync: تثبيت العامل هو الخطوة الأولى فقط. لبدء مزامنة الملفات، يجب عليك تسجيل Windows Server الخاص بك باستخدام Azure Storage Sync Service لتأسيس الثقة بين الخادم وAzure File Sync. اتبع الخطوات الواردة في إدارة الخوادم المسجلة باستخدام Azure File Sync (تسجيل/إلغاء تسجيل خادم) لتسجيل الخادم الخاص بك إذا لم تكن قد فعلت ذلك بالفعل.

  • إنشاء مجموعات المزامنة ونقاط النهاية السحابية: بعد التسجيل، قم بإنشاء مجموعة مزامنة في Storage Sync Service. تربط مجموعة المزامنة مشاركة ملف Azure (نقطة نهاية السحابة) ومجلدا على الخادم المسجل (نقطة نهاية الخادم). راجع كيفية نشر Azure File Sync للحصول على دليل شامل حول إعداد Storage Sync Service وإنشاء مجموعات المزامنة وإضافة نقاط نهاية الخادم.

  • تعرف على المزيد واستكشاف الأخطاء وإصلاحها: للحصول على معلومات إضافية، راجع التخطيط لتوزيع Azure File Sync لفهم المتطلبات وأفضل الممارسات. إذا واجهت مشكلات أثناء التثبيت أو تسجيل الخادم، فراجع استكشاف أخطاء تثبيت عامل Azure File Sync وتسجيله وإصلاحها للمشكلات والحلول الشائعة.

إلغاء تثبيت ملحق العامل

إذا لم تعد بحاجة إلى ملحق عامل Azure File Sync على خادم معين ممكن بواسطة Arc، يمكنك إلغاء تثبيت الملحق باستخدام مدخل Microsoft Azure أو Azure PowerShell أو Azure CLI. لن يؤدي إلغاء تثبيت الملحق إلى إزالة عامل Azure File Sync من الخادم.

ستؤدي إزالة عامل Azure File Sync إلى إيقاف أي مزامنة سحابية على هذا الخادم. إذا كان الخادم مسجلا حاليا في Storage Sync Service وشارك في مجموعات المزامنة، فإن إلغاء تثبيت العامل سيؤدي إلى قطع اتصال المزامنة وطبولوجيا مزامنة الملف. إذا قررت إزالة العامل على جهاز Arc، فتأكد من رؤية إلغاء التوفير أو حذف نقطة نهاية خادم Azure File Sync للحصول على إرشادات مفصلة حول إلغاء تثبيت عامل Azure File Sync.

لإلغاء تثبيت ملحق عامل Azure File Sync باستخدام مدخل Microsoft Azure:

  1. في مدخل Microsoft Azure، انتقل إلى خادم Arc الممكن وافتح قسم Extensions + applications .
  2. ابحث عن ملحق عامل Azure File Sync في قائمة الملحقات المثبتة. حدد الملحق لفتح تفاصيله.
  3. حدد إلغاء تثبيت (أو حذف الملحق) وتأكد من المطالبة بإزالة الملحق. سيقوم Azure بإلغاء تثبيت الملحق من الجهاز.
  4. انتظر حتى تتم إزالة الملحق. سيختفي إدخال الملحق من قائمة الملحقات بمجرد اكتمال إلغاء التثبيت. على خادم Windows، سيتم إلغاء تثبيت برنامج عامل Azure File Sync تلقائيا كجزء من هذه العملية.

يمكنك التحقق من الإزالة عن طريق التحقق من قائمة الملحقات في مدخل Microsoft Azure (يجب ألا يظهر الملحق بعد الآن)، أو عن طريق تشغيل أوامر التحقق من الصحة أعلاه (التي يجب ألا تعثر على الملحق بعد الآن). إذا فشل الملحق في إلغاء التثبيت، فتحقق من Azure Activity Log أو عرض مثيل الملحق للحصول على تفاصيل الخطأ.