تثبيت OneAgent Windows بصمت على Windows Server باستخدام PowerShell

OneAgent Windows: تثبيت صامت على Windows Server باستخدام PowerShell، مرتبط بـ Dynatrace Managed، بمعاملات صريحة وخطوات تحقق واضحة.
Installer OneAgent sur Windows Server en mode silencieux

على أسطول من خوادم Windows Server سرعان ما تظهر حدود التثبيت التفاعلي لـ OneAgent. النقر على «التالي» على ثلاثة خوادم اختبار أمر مقبول، أما تكرار العملية نفسها على مئتي خادم IIS ومضيف .NET وخدمات Windows، دون خطأ في مجموعة المضيفين (host group) ودون نسيان الوكيل الوسيط (proxy)، فوهم. المطلوب هو نشر صامت لـ OneAgent Windows، مضبوط المعاملات وقابل للتشغيل بأدواتك المعتادة: GPO أو SCCM/MECM أو Ansible عبر WinRM أو سكربت PowerShell بسيط.

مع Dynatrace Managed يتضاعف الرهان. فمن جهة، يجب أن يصل الوكيل إلى عنقود (cluster) مستضاف في بنيتك التحتية، بشهاداتك الداخلية ووكلائك الوسطاء الصادرين، وأحيانًا بخوادم ActiveGate مخصصة لكل منطقة. ومن جهة أخرى، حصة الترخيص ميزانية ثابتة تديرها بنفسك في Cluster Management Console (انظر البيئات وحصص الترخيص): نشر Full-Stack غير مضبوط على خوادم لا تحتاج إليه يُدفع ثمنه فورًا.

يشرح هذا الدليل تثبيتًا صامتًا لـ OneAgent على Windows Server مرتبطًا ببيئة Managed، من جلب المثبّت إلى التحقق، مرورًا بالمعاملات الأساسية والتعديلات بعد التثبيت.

ما الذي يتغير على OneAgent Windows

المبدأ هو نفسه في OneAgent على Linux: مثبّت خاص ببيئتك، ومعاملات سطر أوامر لتحديد وضع المراقبة ومجموعة المضيفين ومنطقة الشبكة (network zone)، ثم أداة oneagentctl لتعديل الإعداد. لكن بعض الفروق العملية تستحق الانتباه:

  • المثبّت ملف تنفيذي (.exe) يغلّف حزمة MSI. يقبل وضعًا صامتًا ومعاملات --set-… نفسها المستخدمة على Linux.
  • يعمل الوكيل كخدمة Windows، ويجب أن تملك جلسة التثبيت صلاحيات مسؤول محلي.
  • يجب إعادة تشغيل تطبيقات IIS و.NET وخدمات Windows التي بدأت قبل التثبيت حتى تُقاس في وضع Full-Stack.
  • قد تحجب برامج مكافحة الفيروسات وأنظمة EDR الحقن أو تبطئه: خطّط للاستثناءات التي يوصي بها فريق الأمان بالاستناد إلى الوثائق.

متطلبات OneAgent Windows

  • إصدار من Windows Server مدعوم في إصدار OneAgent لديك (راجع مصفوفة التوافق).
  • حساب مسؤول محلي وWindows PowerShell (كُتبت الأمثلة أدناه للإصدار 5.1).
  • رمز API (token) للبيئة بصلاحية تنزيل المثبّتات.
  • معرّف البيئة، الظاهر في العنوان https://{votre-domaine}/e/{id-environnement}.
  • القيمة المستهدفة لمجموعة المضيفين ومنطقة الشبكة.
  • نحو 775 ميغابايت للتثبيت في %PROGRAMFILES%\dynatrace\oneagent ونحو 11.5 غيغابايت إجمالًا باحتساب السجلات والـ dumps وبيانات الاستمرارية والتحديثات (في %PROGRAMDATA%\dynatrace\oneagent).
  • إذا كانت شهادة العنقود صادرة عن بنية مفاتيح عامة داخلية (PKI)، فيجب أن تكون سلطة الجذر موجودة في مخزن شهادات الجهاز.

دليل تطبيقي خطوة بخطوة

الخطوة 1: اختبار الاتصال

في وحدة تحكم PowerShell بصلاحيات المسؤول:

$headers = @{ Authorization = "Api-Token {token}" }
Invoke-WebRequest -UseBasicParsing `
  -Uri "https://{votre-domaine}/e/{id-environnement}/api/v1/time" `
  -Headers $headers | Select-Object StatusCode

# If the zone goes through an Environment ActiveGate
Test-NetConnection -ComputerName {activegate-host} -Port 9999

يتطلب الاستدعاء /api/v1/time النطاق (scope) DataExport: فمع رمز مقصور على التنزيل يثبت الخطأ 401 أو 403 أن الشبكة وTLS يعملان، بينما يؤكد الرد 200 صلاحية الرمز أيضًا. أما عند ظهور خطأ في الشهادة فالسبب في الغالب سلطة الجذر الداخلية المفقودة.

الخطوة 2: تنزيل المثبّت

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$out = "C:\Temp\Dynatrace-OneAgent-Windows.exe"
New-Item -ItemType Directory -Force -Path C:\Temp | Out-Null

Invoke-WebRequest -UseBasicParsing `
  -Uri "https://{votre-domaine}/e/{id-environnement}/api/v1/deployment/installer/agent/windows/default/latest" `
  -Headers $headers -OutFile $out

Get-Item $out | Select-Object Name, Length

يتضمن الملف التنفيذي معرّف البيئة ورمز اتصال الوكيل. خزّنه على مشاركة ملفات يقتصر الوصول إليها على حسابات النشر.

الخطوة 3: التحقق من التوقيع

Get-AuthenticodeSignature $out | Format-List Status, SignerCertificate

الحالة المتوقعة هي Valid. أي حالة مختلفة يجب أن توقف النشر حتى يتم التحليل.

الخطوة 4: تشغيل التثبيت الصامت

$installArgs = @(
  "--set-monitoring-mode=fullstack",
  "--set-host-group={application}_{environnement}",
  "--set-network-zone={zone-reseau}",
  "--set-app-log-content-access=true",
  "--quiet"
)
$p = Start-Process -FilePath $out -ArgumentList $installArgs -Wait -PassThru
"Exit code: $($p.ExitCode)"

يدل رمز الإرجاع 0 على نجاح التثبيت. وللخادم الذي يُراقَب على مستوى البنية التحتية فقط، استخدم --set-monitoring-mode=infra-only. وإذا لزم وكيل وسيط: --set-proxy={proxy-host}:{port}. يمكن تغيير مجلد التثبيت الافتراضي بالمعامل INSTALL_PATH="D:\dynatrace" الخاص بـ MSI، ويقبله الملف التنفيذي لكن لا تقبله الواجهة الرسومية للمثبّت.

الخطوة 5: فحص الخدمة والسجلات

Get-Service | Where-Object { $_.DisplayName -like "*Dynatrace*" } |
  Select-Object Name, DisplayName, Status, StartType

Get-ChildItem "C:\ProgramData\dynatrace\oneagent\log" -Recurse |
  Sort-Object LastWriteTime -Descending | Select-Object -First 10 FullName

يجب أن تكون الخدمة في حالة Running وبتشغيل تلقائي. وتوجد سجلات الوكيل افتراضيًا في %PROGRAMDATA%\dynatrace\oneagent\log.

الخطوة 6: إعادة تشغيل التطبيقات المقيسة

iisreset /restart
# or, for a specific application service
Restart-Service -Name {nom-du-service}

نسّق إعادة التشغيل هذه مع فرق التطبيقات: فبدونها تبقى العمليات القائمة ظاهرة لكنها غير متتبَّعة.

الخطوة 7: الضبط باستخدام oneagentctl

$ctl = "C:\Program Files\dynatrace\oneagent\agent\tools\oneagentctl.exe"
& $ctl --get-host-group
& $ctl --get-network-zone
& $ctl --set-host-group={nouveau-groupe} --restart-service

يجب تنفيذ هذه الأوامر بصلاحيات المسؤول. وكما على Linux، فإن تغيير مجموعة المضيفين يؤثر في القواعد والتنبيهات المرتبطة بها.

النشر على نطاق واسع

الأداة الأسلوب الموصى به نقطة انتباه
SCCM / MECM تطبيق بسطر أوامر صامت وكشف يعتمد على الخدمة لا تضمّن الرمز نصًا واضحًا في وحدة التحكم أبدًا
GPO (سكربت بدء التشغيل) سكربت PowerShell متكافئ التنفيذ (idempotent) يقرأ المثبّت من مشاركة ملفات صلاحيات قراءة المشاركة لحسابات الأجهزة
Ansible (WinRM) win_get_url ثم win_command بالمعاملات متغيرات المجموعة لمجموعة المضيفين والمنطقة

في جميع الحالات، اختبر وجود الخدمة أولًا قبل إعادة تشغيل المثبّت، لتفادي عمليات إعادة تثبيت لا لزوم لها في كل دورة.

أفضل الممارسات

  • تحقق من سلسلة شهادات العنقود على خادم تجريبي قبل أي نشر واسع.
  • اعمل برمز مخصص للتنزيل، بأضيق نطاق ممكن، ومخزَّن في خزنة أسرار.
  • وحّد مجموعات المضيفين ومناطق الشبكة في متغيرات النشر، ولا تكتبها يدويًا أبدًا.
  • نسّق استثناءات مكافحة الفيروسات وEDR مع فريق الأمان مسبقًا.
  • جدولة إعادة تشغيل IIS والخدمات ضمن نافذة تغيير.
  • راقب استهلاك وحدات المضيف في CMC بعد كل موجة نشر.

الأسئلة الشائعة

كيف أعرف أن التثبيت الصامت نجح؟

يجب أن يكون رمز الإرجاع 0، ثم أن تكون خدمة Dynatrace في حالة Running بتشغيل تلقائي. وعند الفشل، راجع السجلات في %PROGRAMDATA%\dynatrace\oneagent\log.

لماذا يفشل استدعاء API بخطأ في الشهادة؟

في الغالب لأن سلطة الجذر في PKI الداخلية، التي وقّعت شهادة العنقود، غير موجودة في مخزن شهادات الجهاز.

هل يجب إعادة تشغيل IIS بعد التثبيت؟

نعم في وضع Full-Stack: فبدون إعادة التشغيل تبقى تطبيقات IIS و.NET والخدمات التي بدأت سابقًا ظاهرة لكنها غير متتبَّعة. جدولها ضمن نافذة تغيير.

الخلاصة

يتلخص التثبيت الصامت لـ OneAgent على Windows Server في سطر أوامر واحد، لكنه لا يكون موثوقًا في سياق Managed إلا إذا كانت البيئة جاهزة: شهادات داخلية معروفة، وخوادم ActiveGate ومناطق شبكة قائمة، واصطلاحات تسمية مشتركة، ورمز محمي. وبسكربت PowerShell متكافئ التنفيذ وبعض الفحوص المنتظمة، تحوّل عملية يدوية محفوفة بالمخاطر إلى نشر قابل للتكرار والتدقيق.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Déployer OneAgent sur Linux dans un environnement Managed

تثبيت OneAgent على Linux مع Dynatrace Managed: النشر خطوة بخطوة

Next Post
Kubernetes et OpenShift : connecter Dynatrace Operator à un cluster Managed

Dynatrace Operator Kubernetes وOpenShift: الاتصال بعنقود Managed

Related Posts