Package Deployer और Windows PowerShell का उपयोग करके पैकेज परिनियोजित करें

Microsoft Dynamics CRM Package Deployer किसी परिवेश पर पैकेज परिनियोजित करने में व्यवस्थापकों को सक्षम करता है.

नोट

Package Deployer, Dynamics 365 Customer Engagement (on-premises) संगठनों के साथ भी कार्य करता है.

कोई “पैकेज “ निम्न में से किसी या सभी से बना हो सकता है:

• एक या एक से अधिक Dataverse समाधान फ़ाइलें.

• फ़्लैट फ़ाइलें या Configuration Migration उपकरण से आयात की गई डेटा फ़ाइलें. Configuration Migration उपकरण के बारे में जानकारी के लिए, देखें अपना कॉन्फ़िगरेशन डेटा देखें.

• वह अनुकूलित कोड, जिसे किसी परिवेश पर पैकेज परिनियोजित करने के दौरान या बाद में चलाया जा सकता है.

• इस पैकेज के लिए विशिष्ट HTML सामग्री जिसे पैकेज परिनियोजन प्रक्रिया की शुरुआत में या अंत में प्रदर्शित किया जा सकता है. उन समाधानों और फ़ाइलों का विवरण प्रदान करना उपयोगी हो सकता है, जिन्हें इस पैकेज में परिनियोजित किया गया है.

  डेवलपर Visual Studio में पैकेज परिनियोजन टेम्पलेट का उपयोग करके पैकेज बनाते हैं. अधिक जानकारी: Package Deployer के लिए पैकेज बनाएँ

  कोई पैकेज बना दिए जाने के बाद, आप उसे या तो CRM Package Deployer चलाकर या उस उपकरण के लिए Windows PowerShell cmdlets का उपयोग करके परिनियोजित कर सकते हैं.

महत्त्वपूर्ण

किसी उत्‍पादन संगठन में कोई पैकेज आयात करने और चलाने से पहले, उस पैकेज का परीक्षण उत्पादन संगठन की किसी गैर-उत्पादन प्रतिरूपित छवि पर करें.

कोई भी पैकेज परिनियोजित करने से पहले हमेशा अपने उत्पादन संगठन का बैकअप ले लें.

Package Deployer उपकरण का उपयोग करके पैकेजों को परिनियोजित करना

आप पैकेज परिनियोजित करने के लिए Package Deployer उपकरण (packagedeployer.exe) का उपयोग निम्न तरीक़ों से कर सकते हैं.

पैकेज तैनात करने के लिए CRM Package Deployer टूल का उपयोग करें

कमांड लाइन पर CRM Package Deployer टूल का उपयोग करें

पैकेज परिनियोजित करने के लिए Package Deployer उपकरण का उपयोग करें

Package Deployer उपकरण एक बार में केवल एक पैकेज संसाधित कर सकता है. हालाँकि, यह उपयोगकर्ताओं को Package Deployer उपकरण निर्देशिका में उपलब्ध एकाधिक पैकेज से परिनियोजित करने के लिए किसी पैकेज का चयन करने की योग्यता प्रदान करता है. पैकेज की परिभाषा के आधार पर इस उपकरण की कुछ स्क्रीन और क्रियाएँ अलग-अलग हो सकती हैं. आपको Package Deployer उपकरण स्थापित नहीं करना पड़ेगा. बस उसे डाउनलोड करें और चलाएँ.

1. परिनियोजित किए जाने वाले पैकेज को प्राप्त करें. पैकेज, में आपके द्वारा कोई पैकेज परियोजना बनाने पर आपके Visual studio प्रोजेक्ट फ़ोल्डर (<प्रोजेक्ट>\Bin\Debug) Visual Studio में बनाई गई फ़ाइलों और फ़ोल्डर का संग्रह होता है. अपने प्रोजेक्ट डीबग फ़ोल्डर से निम्न की प्रतिलिपि बनाएँ:

   • <PackageName> फ़ोल्डर: इस फ़ोल्डर में समाधान, आयात कॉन्फ़िगरेशन और आपके पैकेज की सामग्री होती है.

   • <PackageName>.dll: असेंबली में आपके पैकेज के लिए कोड होता है। डिफ़ॉल्ट रूप से, असेंबली का नाम आपके Visual Studio प्रोजेक्ट का नाम ही होता है.

     Visual Studio का उपयोग करके कोई पैकेज बनाने के बारे में विस्तृत जानकारी के लिए, Package Deployer उपकरण के लिए पैकेज बनाएँ देखें.

     इस विषय के लिए, आइए मान लेते हैं कि Visual Studio प्रोजेक्ट डीबग फ़ोल्डर (<Project>\Bin\Debug) के पैकेज फ़ोल्डर और असेंबली c:\DeployPackage फ़ोल्डर में कॉपी की जाती हैं.

2. Package Deployer उपकरण प्राप्त करें. Package Deployer टूल NuGet पैकेज के रूप में उपलब्ध है. Package Deployer का उपयोग करने के लिए, आपको उसे अपने स्थानीय कंप्यूटर पर डाउनलोड करना होगा और nuget.exe का उपयोग करके उसे निकालना होगा.
   
   https://www.nuget.org/downloads से nuget.exe डाउनलोड करें और उसे अपने कंप्यूटर पर सहेजें, मान लीजिए कि d:\. फिर कमांड प्रॉम्प्ट पर निम्नलिखित कमांड रन करके उस पैकेज की सामग्रियों को किसी फ़ोल्डर में निकालें, मान लीजिए कि आपके कंप्यूटर पर PD:
   d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
   
   आपके द्वारा Package Deployer टूल निकाल लेने के बाद, [ExtractedLocation]\tools फ़ोल्डर को ब्राउज़ करके PackageDeployer.exe फ़ाइल ढूँढें.

3. c:\DeployPackage से पैकेज फ़ोल्डर और असेंबली की [ExtractedLocation]\tools फ़ोल्डर पर प्रतिलिपि बनाएँ.

4. फ़ाइलों की प्रतिलिपि बनाने के बाद, [ExtractedLocation]\tools फ़ोल्डर में PackageDeployer.exe फ़ाइल डबल-क्लिक करके उपकरण चलाएँ.

5. उस उपकरण की मुख्य स्क्रीन पर जारी रखें क्लिक करें.

6. Microsoft Dynamics 365 for Customer Engagement से कनेक्ट करें स्क्रीन में, अपने Dynamics 365 server से कनेक्ट करने के लिए प्रमाणीकरण विवरण प्रदान करें जहां आप पैकेज को परिनियोजित करना चाहते हैं. अगर आपके पास एक से अधिक व्यवस्थापन हैं और उस व्यवस्थापन का चयन करना चाहते हैं, जहाँ आप यह पैकेज परिनियोजित करना चाहते हैं, तो हमेशा उपलब्ध व्यवस्थापनों की सूची प्रदर्शित करें चेक बॉक्स का चयन करें. लॉगिन क्लिक करें.

7. यदि आपके Dynamics 365 server पर एक से अधिक संगठन हैं, तो कनेक्ट करने के लिए एक Dynamics 365 ऐप्स संगठन चुनें.

8. परिनियोजित करने के लिए एक पैकेज चुनें और अगला पर क्लिक करें.

   

9. अपने पैकेज को परिनियोजित करने के लिए, उसके बाद आने वाली स्क्रीन पर दिए जाने वाले निर्देशों का अनुसरण करें.

   ये स्क्रीन आपके द्वारा परिनियोजन के लिए, चयन किए गए पैकेज की परिभाषा के आधार पर दिखाई देती हैं. उस शुरू से अंत तक के पैकेज परिनियोजन के लिए, जो Package Deployer उपकरण का उपयोग करता है, पैकेज को परिनियोजित करने के लिए विषय देखें: Package Deployer का उपयोग करके CRM सर्वर पर नमूना Unified Service Desk अनुप्रयोगों को परिनियोजित करें

आदेश पंक्ति पर Package Deployer उपकरण का उपयोग करें

सिस्टम व्यवस्थापक और अनुकूलक, क्षेत्रीय भाषा कोड जैसे पैरामीटर आदेश पंक्ति से packagedeployer.exe को पास कर सकते हैं. इन पैरामीटर को केवल आदेश पंक्ति पर Package Deployer उपकरण चला कर कॉन्फ़िगर किया जा सकता है.

नोट

यह सुविधा सबसे पहले Dynamics CRM Online 2016 Update 0.1 में पेश की गई थी

उपलब्‍ध पैरामीटर इस तालिका में हैं.

मापदंड	विवरण	डिफ़ॉल्ट मान
RuntimePackageSettings	Packagedeployer.exe को आदेश पंक्ति पैरामीटर, जैसे LCID तथा SkipChecks को स्वीकार करने के लिए निर्देश दें.	लागू नहीं
LCID=localeID	यह पैकेज में उपलब्‍ध स्‍थानीय IDs से स्‍थानीय ID, जैसे English-United States के लिए 1033 या French-France के लिए 1036 निर्दिष्ट करता है. यदि निर्दिष्ट नहीं है, तो डिफ़ॉल्ट भाषा का उपयोग किया जाएगा.	डिफ़ॉल्ट भाषा का उपयोग करें
SkipChecks=true/false	इस पैरामीटर का उपयोग केवल तब करें, जब लक्ष्‍य परिवेश में कोई अन्‍य समाधान या अनुकूलन शामिल न हों. जब सही पर सेट है, तो समाधान आयात कुछ सुरक्षा जाँच को बायपास करेगा, जिससे आयात की कार्यक्षमता में सुधार हो सकता है.	गलत

निम्न उदाहरण CRM Package Deployer को कुछ सुरक्षा जाँचों को बाइपास करके आयात की भाषा को पोलिश पर सेट करने का निर्देश देता है.

packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"

नोट

आदेश पंक्ति पर एकाधिक पैरामीटर के साथ आपके packagedeployer.exe चलाने पर पैरामीटर्स को अलग-अलग करने के लिए पाइप वर्ण | का उपयोग करें.

packagedeployer.exe को पास किए जाने वाले पैरामीटर और मानों के बारे में अधिक जानकारी के लिए, CRM Package Deployer के लिए पैकेज बनाएँ देखें.

पैकेज परिनियोजित करने के लिए, Windows PowerShell का उपयोग करें

Package Deployer उपकरण पैकेज परिनियोजित करने के लिए Windows PowerShell समर्थन भी प्रदान करता है. अधिक जानकारी: पैकेज परिनियोजन मॉड्यूल का उपयोग करके शुरू करें

लॉग फ़ाइलों का उपयोग करके पैकेज परिनियोजन समस्याओं का निवारण करें

जब कोई उपकरण और परिनियोजन पैकेज का उपयोग करके Microsoft Dynamics 365 for Customer Engagement आवृत्ति में साइन करता है, तो उस दौरान उत्पन्न होने वाली त्रुटियों के संबंध में विस्तृत जानकारी देने के लिए Package Deployer उपकरण लॉगिंग समर्थन प्रदान करता है. डिफ़ॉल्ट रूप से, उपकरण तीन लॉग फ़ाइलें उत्पन्न करता है जो उस कंप्यूटर पर निम्न स्थान पर उपलब्ध होती हैं जहाँ आप उपकरण चलाते हैं: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. कोई भिन्न फ़ोल्डर निर्दिष्ट करने के लिए, -LogWriteDirectory PowerShell cmdlet पैरामीटर का उपयोग करें. अधिक जानकारी: पैकेज पुनर्प्राप्त करने के लिए, cmdlet का उपयोग करें

• Login_ErrorLog.log: Dynamics 365 इंस्टेंस में लॉग इन करने के लिए टूल का उपयोग करते समय उत्पन्न होने वाली समस्याओं के बारे में जानकारी प्रदान करता है. अगर साइन इन करने के दौरान कोई भी समस्या उत्पन्न होती है, तो उस उपकरण की लॉगिन स्क्रीन पर एक संदेश दिखाई देता है, जिसमें इस लॉग फ़ाइल का लिंक मौजूद होता है. यह संदेश बताता है, कि लॉगिन अनुरोध को संसाधित करते समय कोई त्रुटि उत्पन्न हुई थी और उपयोगकर्ता उस त्रुटि लॉग को देख सकता है. आप इस लॉग फ़ाइल को देखने के लिए मैसेज की लिंक को क्लिक कर सकते हैं. जब आपके टूल में कोई भी साइन-इन इश्यूज़ पहली बार आपके सामने आते हैं तब लॉग फ़ाइल बनाई जाती है. उसके बाद, उस लॉग फ़ाइल का उपयोग किसी साइन-इन समस्या, जब कभी भी यह उत्पन्न हो, से संबंधित लॉग जानकारी का उपयोग करने के लिए किया जाता है.

• PackageDeployer.log: पैकेजों की तैनाती के दौरान उपकरण में निष्पादित प्रत्येक कार्य के बारे में विस्तृत जानकारी प्रदान करता है। आप स्क्रीन के बॉटम में लॉग फ़ाइल देखें लिंक पर क्लिक करके टूल में से लॉग फ़ाइल देख सकते हैं.

• ComplexImportDetail.log: उपकरण का उपयोग करके अंतिम परिनियोजन में आयात किए गए डेटा के बारे में विस्तृत जानकारी प्रदान करता है। इस उपकरण का उपयोग करके जब भी आप एक पैकेज परिनियोजित करते हैं, तो लॉग फ़ाइल में से मौजूदा विवरण उसी निर्देशिका में ComplexImportDetail._old.log नाम की एक फ़ाइल में स्थानांतरित कर दिए जाते हैं और ComplexImportDetail.log फ़ाइल उस उपकरण के उपयोग से किए गए नवीनतम आयात के संबंध में जानकारी प्रदर्शित करती है.

पैकेज परिनियोजित करने के लिए सर्वोत्तम अभ्यास

पैकेज परिनियोजित करते समय, Dynamics 365 व्यवस्थापकों को निम्न क्रिया करनी चाहिए:

• साइन की गई पैकेज एसेंबली पर ज़ोर देना चाहिए, ताकि वे किसी एसेंबली को वापस उसके स्रोत में ट्रैक कर सकें.

• किसी पूर्व-उत्पादन आवृत्ति (प्राथमिक रूप से उत्पादन आवृत्ति की प्रतिरूपित छवि) पर मौजूद पैकेज को किसी उत्पादन सर्वर पर चलाने से पहले उसकी जाँच करें.

• किसी पैकेज को परिनियोजित करने से पहले उत्पादन आवृत्ति का बैकअप ले लें.

इसे भी देखें

CRM के लिए पैकेज बनाएँ Package Deployer