Massdistribution av stängda Commerce-självbetjäningskomponenter
Viktigt
Delar av eller hela funktionaliteten som beskrivs i den här artikeln är tillgänglig som en del av en förhandsversion. Funktionen och dess innehåll kan ändras. Mer information om förhandsversioner finns i Frågor och svar om tjänstuppdateringar för en version.
Varning
När Commerce Scale Unit (CSU) har uppdaterats till version 10.0.29 eller senare, måste kassaversionen (Modern POS eller Store Commerce) vara 10.0.27 eller senare (kan ses i kassan som version 9.27). Detta beror på migreringen till .NET Core.
Det här ämnet gäller komponentinstallationsprogram med stängt ramverk som frisläpps varje månad, med början med version 10.0.18, och som är tillgängliga i det delade tillgångsbiblioteket i Microsoft Dynamics Lifecycle Services (LCS). Observera att de flera av de första versionerna av dessa nya installationsprogram betecknas som (Förhandsversion). Det enda syftet med denna beteckning är att skilja mellan de nya installationsprogrammen medan Microsoft fastställer om det finns ytterligare funktionella krav för att använda dem. Det betyder inte att installationsprogrammet inte är giltigt för produktion. Baserat på frisläppning av dessa nya installationsprogram planerar Microsoft att fasa ut de gamla (äldre) installationsprogrammen i eller runt oktober 2023.
Denna artikel beskriver hur du använder de nya installationsprogrammen för att utföra tysta installations- och serviceuppdateringar via kommandoradsargument. Med dessa argument kan du använda massdistribution på flera olika sätt.
Notering
- Stängda installationsprogrammen med självservicen kommer inte att göras tillgängliga i Commerce headquarters och kan bara laddas ned via LCS.
- Från och med Commerce version 10.0.32, krävs .NET 6 som en förutsättning för de förseglade självbetjäningskomponenterna.
Avgränsare för massdistribution
I följande tabell visas avgränsarna som kan användas vid kommandoradskörningen.
| Avgränsare | Beskrivning |
|---|---|
| -AadTokenIssuerPrefix | Prefixet för Microsoft Azure Active Directory (Azure AD) tokenutfärdare. |
| -AsyncClientAadClientId | Det Azure AD klient-ID som Async Client ska använda under kommunikationen med headquarters. |
| -AsyncClientAppInsightsInstrumentationKey | Instrumentationsnyckel för Async Client AppInsights. |
| -AsyncClientCertFullPath | Den helt formaterade URN-sökvägen som använder tumavtryck som sökmått för Async Client-identitetscertifikatsplatsen som ska användas för autentisera med Azure AD vid kommunikation med headquarters. Till exempel är store://My/LocalMachine?FindByThumbprint=<MyThumbprint> en korrekt formaterad URN. Värdet <MyThumbprint> ersätts med det certifikattumavtryck som ska användas. Använd inte den här parametern tillsammans med parametern -AsyncClientCertThumbprint. |
| -AsyncClientCertThumbprint | Tumavtrycket för Async Client-identitetscertifikatet som ska användas för att autentisera med Azure AD för kommunikation med headquarters. Det här tumavtrycket används för att söka efter plats och namn för LocalMachine/Min lagringsplats för att hitta rätt certifikat att använda. Använd inte den här parametern tillsammans med parametern -AsyncClientCertFullPath. |
| -ClientAppInsightsInstrumentationKey | Klientens AppInsights-instrumentationsnyckel. |
| -CloudPosAppInsightsInstrumentationKey | Cloud POS AppInsights-instrumentationsnyckel. |
| -Config | Konfigurationsfilen som ska användas under installationen. Ett exempel på ett filnamn är Contoso.CommerceScaleUnit.xml. |
| -CposAadClientId | Det Azure AD-klient-ID som Cloud Pos ska använda under enhetsaktivering. Den här parametern behövs inte för lokal distribution. |
| -Device | Enhets-ID som visas på sidan Enheter i headquarters. |
| -EnvironmentId | Miljö-ID. |
| -HardwareStationAppInsightsInstrumentationKey | Maskinvarustationens AppInsights-instrumentationsnyckel. |
| --InPlaceUpgradeFromModernPOS | Används för uppgradering från Modern POS till Store Commerce. Om inte andra parametrar används är standardantagandet att hämta Modern POS-enhetstoken och sedan avinstallera Modern POS. |
| Installera | En parameter som anger om den komponent som det här installationsprogrammet tillhandahåller ska installeras. Den här parametern behövs för att en installation ska kunna utföras och den har inte något inledande bindestrecktecken. |
| -InstallOffline | För Modern POS anger den här parametern att offlinedatabasen också ska vara installerad och konfigurerad. Använd även parametern -SQLServerName. I annat fall försöker installationsprogrammet att hitta en standardinstans som uppfyller kraven. När du använder Azure Active Directory (Azure AD) autentisering fungerar inte POS offline, eftersom online-anslutning alltid krävs. |
| -Port | Den port som ska associeras med och användas av den virtuella Retail Server-katalogen. Om ingen port anges används standardporten 443. |
| -Register | Register-ID som visas på sidan Register i headquarters. |
| -RetailServerAadClientId | Det Azure AD klient-ID som Retail Server ska använda under kommunikationen med headquarters. |
| -RetailServerAadResourceId | Resurs-ID:t för Retail Server Azure AD-appen som ska användas när enheten aktiveras. Den här parametern behövs inte för lokal distribution. |
| -RetailServerCertFullPath | Den helt formaterade URN-sökvägen som använder tumavtryck som sökmått för Retail Server-identitetscertifikatet som ska användas för autentisera med Azure AD vid kommunikation med headquarters. Till exempel är store://My/LocalMachine?FindByThumbprint=<MyThumbprint> ett korrekt formaterat URN där värdet <MyThumbprint> ersätts med certifikattumavtrycket som ska användas. Använd inte den här parametern tillsammans med parametern -RetailServerCertThumbprint. |
| -RetailServerCertThumbprint | Tumavtrycket för Retail Server-identitetscertifikatet som ska användas för att autentisera med Azure AD för kommunikation med headquarters. Det här tumavtrycket används för att söka efter plats och namn för LocalMachine/Min lagringsplats för att hitta rätt certifikat att använda. Använd inte den här parametern tillsammans med parametern -RetailServerCertFullPath. |
| -RetailServerURL | URL-adressen till Retail Server som installationsprogrammet ska använda. (Den här URL:en är även känd som Commerce Scale Unit-URL:en [CSU].) För Modern POS används det här värdet under enhetsaktivering. |
| -SkipAadCredentialsCheck | En switch som anger om förutsättningskontrolleran för Azure AD-autentisering ska hoppas över. Standardvärdet är falskt. |
| -SkipCertCheck | En switch som anger om förutsättningskontrolleran för certifikat ska hoppas över. Standardvärdet är falskt. |
| --SkipEnhancedModernPOSUpgradeValidation | En växel om du vill hoppa över standardvalideringen som körs innan enhetstoken kan hämtas från Modern POS. Den här flaggan ska bara användas i testmiljöer och bör inte användas i produktionen. |
| -SkipIisCheck | En switch som anger om förutsättningskontrollerna för Internet Information Services (IIS) ska hoppas över. Standardvärdet är falskt. |
| -SkipNetFrameworkCheck | En switch som anger om förutsättningskontrolleran för .NET Framework ska hoppas över. Standardvärdet är falskt. |
| -SkipScaleUnitHealthcheck | En switch som anger om hälsokontrollen av installerade komponenter ska hoppas över. Standardvärdet är falskt. |
| -SkipSChannelCheck | En switch som anger om förutsättningskontrolleran för säker kanal ska hoppas över. Standardvärdet är falskt. |
| -SkipSqlFullTextCheck | En switch som anger om validering av SQL Server-förutsättningen som kräver fulltextsökning ska hoppas över. Standardvärdet är falskt. |
| -SkipSqlServerCheck | En switch som anger om förutsättningskontrollerna för SQL Server ska hoppas över. Standardvärdet är falskt. |
| --SkipUninstallModernPOSAfterUpgrade | En växel som hoppar över avinstallationen av Modern POS efter att uppgraderingen till Store Commerce och enhetstoken har hämtats från Modern POS. |
| -SqlServerName | SQL Server-namnet. Om namnet inte angetts försöker installationsprogrammet hitta standardinstansen. |
| -SslcertFullPath | Den helt formaterade URN-sökvägen som använder tumavtryck som sökmått för certifikatplatsen som ska användas för att kryptera HTTP-trafik till skalningsenheten. Till exempel är store:\/\/My\/LocalMachine\?FindByThumbprint\=\<MyThumbprint\> ett korrekt formaterat URN där värdet <MyThumbprint> ersätts med certifikattumavtrycket som ska användas. Använd inte den här parametern tillsammans med parametern -SslCertThumbprint. |
| -SslCertThumbprint | Tumavtrycket för certifikatet som ska användas för att kryptera HTTP-trafik till skalningsenheten. Det här tumavtrycket används för att söka efter plats och namn för LocalMachine/Min lagringsplats för att hitta rätt certifikat att använda. Använd inte den här parametern tillsammans med parametern -SslCertFullPath. |
| -StoreSystemAosUrl | URL för headquarters (AOS). |
| -StoreSystemChannelDatabaseId | Kanaldatabasens ID (namn). |
| -TenantId | Azure AD-klientorganisationens ID. |
| -TransactionServiceAzureAuthority | Transaction Service Azure AD-utfärdaren. |
| -TransactionServiceAzureResource | Transaction Service Azure AD-resursen. |
| -TrustSqlServerCertificate | En switch som anger om servercertifikatet ska vara betrott medan en anslutning till SQL Server upprättas. För att undvika säkerhetsrisker ska produktionsdistributioner aldrig leverera ett sant värde här. Standardvärdet är falskt. |
| --UseCommonApplicationData | En växel för att ändra platsen för enhetstoken. Istället för att vara i användarsammanhanget lagras token på en delad plats så att alla Windows-användare kan komma åt samma token, vilket möjliggör användning av Store Commerce oavsett aktiv användare. Användarna måste fortfarande vara i gruppen RetailChannelUsers. |
| -Verbosity | Den loggningsnivå som begärs under installationen. Normalt bör värdet inte användas. |
| -WindowsPhoneAppInsightsInstrumentationKey | Maskinvarustationens AppInsights-instrumentationsnyckel. |
Allmän översikt
Det nya ramverket för installationsprogram för självbetjäning har olika funktioner och förbättringar. Det nya ramverket genererar installationsprogrammet enbart för Modern POS, maskinvarustation och CSU (egen värd). Det är viktigt att du förstår den grundläggande kommandoradsanvändningen för stängda installationsprogram, som bör se ut ungefär som i följande exempel.
<Component Installer Name>.exe install --<Parameter Name> "<Parameter Information>"
Installationsprogrammet kräver parametern install (eller uninstall för att ta bort installationen) och alla parametrar som är specifika för den installationen. Parameternamn bör innehålla de parametrar som behövs, t.ex. registrering, CSU-URL eller certifikatinformation. Parameterinformationen bör innehålla eventuell ytterligare information om parametrarna.
Det stängda ramverket har skapats för att det ska vara möjligt att göra följande ändringar:
- Stängd – Det nya ramverket för installationsprogram separerar Microsoft-distribuerade installationsprogram för baskomponenter från de utökningsbara anpassningarna. Anpassningarna installeras efteråt men tas sedan bort när det gäller uppdateringar (så att uppdateringar endast kan tillåtas för Microsofts baskomponent, endast för anpassningar eller för båda).
- Utan GUI – Det finns inte längre ett användargränssnitt (UI). I stället finns det en helt kommandoradsstyrd körbar fil för varje komponentinstallationsprogram. Den här ändringen är en av flera viktiga ändringar eller funktioner som används för att fokusera det nya ramverket för installationsprogram på användning för massdistribution.
- Djupare loggning – Förbättrade installationsprogramsloggar gör det möjligt att validera installationens slutförande eller fel, vilka steg som har utförts och eventuella varningar och fel som genererats.
- Rensning – Inom det nya ramverket arbetar komponentinstallationsprogrammen hårdare för att underhålla installationskatalogerna, genom att rensa hela innehållet i komponentmappen innan de installerar de nyare komponenterna. Denna rensning säkerställer att det inte finns några över kvarlämnade filer som kan orsaka problem och förhindra en lyckad installation.
Tre komponenter har inte migrerats till det nya ramverket: den virtuella kringutrustningssimulatorn, Async Server Connector service (används för Dynamics AX 2012 R3 support) och Real-time Service Replacement (används för Dynamics AX 2012 R3 support).
Notering
Installationsprogram lagras lokalt och sparas. Det är viktigt att med tiden hantera eller ta bort de sparade installationsprogrammen så att de inte upptar diskutrymme. Det rekommenderas att behålla det aktuella installationsprogrammet för baskomponenterna och eventuella tilläggsinstallationsprogram för de senaste versionerna för återställning från extrema situationer.
Migrering
Migrering från de gamla självbetjäningsramverkets komponentinstallationsprogrammen till de nya ramverkets komponentinstallationsprogram kräver avinstallation av de gamla komponenterna.
- Modern POS – Det nya ramverket för installationsprogram gör att programmet får ett nytt programsignatur-ID. Därför krävs en fullständig avinstallation av gamla komponenter innan det nya ramverkets Modern POS-komponent installeras. På grund av kravet på fullständig avinstallation måste enhetsaktiveringen göras igen. (Återaktiveringen av enheten är ett engångskrav, förutsatt att avinstallationen inte sker igen.)
- Maskinvarustation – Som IIS-webbplats kräver det nya ramverket för installationsprogram att basmappstrukturen omarbetas. Därför krävs en fullständig avinstallation av gamla komponenter innan det nya ramverkets maskinvarustationskomponent installeras.
- Commerce Scale Unit (CSU, självvärdbaserad) – Som en serie IIS-webbplatser kräver det nya ramverket för installationsprogram att basmappstrukturen omarbetas. Därför krävs en fullständig avinstallation av gamla komponenter innan det nya ramverkets CSU-komponent (självvärdbaserad) installeras.
Modern POS
Innan du börjar
Det är mycket viktigt att du tar bort den gamla Modern POS-komponenten med självbetjäning. Mer information finns i migreringsstegen tidigare i denna artikel. SQL-instansen som används måste ha både lägena Windows-autentisering och SQL Server-autentisering. Du kan hantera och ändra den här konfigurationen under rubriken Säkerhet i fönstret Egenskaper i SQL Server Management Studio.
Notering
På ett endatorsystem som en utvecklartopologi eller en demomiljö, eller när Commerce Scale Unit och Modern POS är installerade på samma dator, är det möjligt för Store Commerce att inte kunna slutföra enhetsaktiveringen. Det här problemet beror på att Store Commerce inte kan ringa nätverkssamtal till samma dator (det vill säga till sig själv). Även om detta aldrig ska vara ett scenario i en produktionsinställning kan problemet minskas genom att ett Loopback-undantag för AppContainer inaktiveras så att kommunikation kan ske till samma dator. Olika program är allmänt tillgängliga för att aktivera denna loopback. För mer information om loopback, se Hur du aktiverar loopback och felsöker nätverksisolering. Det är viktigt att du känner till att en loopback kan vara en säkerhetsrisk, så du rekommenderas inte att använda en loopback om du inte är säker på att det behövs.
Exempel på tyst distribution
Det här avsnittet innehåller exempel på kommandon som används för installation av Modern POS.
Installera Modern POS tyst
Följande kommando installerar (eller uppdaterar) Modern POS tyst. Det har standardkommandostrukturen som används för tyst service av komponenter som för närvarande är installerade. Strukturen använder de grundläggande värdena i <InstallerName>.exe.
Följande grundläggande kommando visar vilka tillgängliga alternativ som finns tillgängliga om en installation begärs. Du rekommenderas att använda det här kommandot när du först testar eller använder installationsprogrammet.
CommerceModernPOS.exe help install
Notering
En konfigurationsfil behövs inte för Modern POS. Installationsprogrammet har nu parametrar (visas tidigare i denna artikel) för de olika värden som används under enhetsaktivering.
Följande kommando specificerar alla parametrar som ska användas under enhetsaktiveringen när Modern POS-programmet har installerats. I det här exemplet används Houston-3, som är ett vanligt värde i Dynamics 365 Commerce-demodata.
CommerceModernPOS.exe install --Register "Houston-3" --Device "Houston-3" --RetailServerURL "https://MyDynamics365CommerceURL.dynamics.com/Commerce"
Följande kommando anger de parametrar som ska användas för att installera och konfigurera offlinedatabasen. SQL Server specificeras tillsammans med den konfigurationsfil som ska användas. Om inte ett betrott SQL-certifikat används krävs --TrustSqlServerCertificate parametern. Vi rekommenderar inte att du hoppar över kontroller när du installerar i produktion.
CommerceModernPOS.exe install -InstallOffline -SQLServerName "SQLExpress" -Config "ModernPOS.Houston-3.xml"
Följande kommando anger de parametrar som ska användas för att uppgradera från Modern POS till Store Commerce (med en offlinedatabas i bruk). Dessa parametrar hämtar enhetstoken som används i Modern POS (ta bort behovet av en manuell process för enhetsaktivering) och avinstallerar sedan Modern POS. SQL Server specificeras tillsammans med den konfigurationsfil som ska användas.
CommerceModernPOS.exe install -InstallOffline -SQLServerName "SQLExpress" --InPlaceUpgradeFromModernPOS
Du kan blanda och matcha dessa koncept för att uppnå de installationsresultat du vill ha.
Maskinvarustation
Innan du börjar
Det är mycket viktigt att du tar bort den gamla maskinvarustationskomponenten med självbetjäning. Mer information finns i migreringsstegen tidigare i denna artikel. Det finns inte längre ett informationsverktyg för handlarkonto. I stället installeras information om handlares konto när en kassaterminal kopplas ihop med maskinvarustationen. När du testar installationsprogrammet för första gången rekommenderar vi att du kör följande kommando:
CommerceHardwareStation.exe help install
Exempel på tyst distribution
Det här avsnittet innehåller exempel på kommandon som används för installation av maskinvarustation.
Installera maskinvarustation tyst
Följande kommando installerar (eller uppdaterar) maskinvarustationen tyst. Det har standardkommandostrukturen som används för att serva komponenter som för närvarande är installerade. Strukturen använder de grundläggande värdena i <InstallerName>.exe.
Följande grundläggande kommando kör det körbara filinstallationsprogrammet.
HardwareStation.exe install --Port 443 --CSUURL "https://MyDynamics365CommerceURL.dynamics.com/" --StoreSystemChannelDatabaseID "Houston" --CertThumbprint "MySSLCertificateThumbprintOftenHasNumbers"
Notering
En konfigurationsfil behövs inte för maskinvarustation. Installationsprogrammet har nu parametrar (visas tidigare i denna artikel) för de olika värden som krävs.
Följande kommando anger alla parametrar som krävs för att hoppa över förutsättningskontroller under en standardinstallation.
Notering
Vi rekommenderar inte att du hoppar över kontroller om du inte gör noggranna tester i förväg, eller förutom i utvecklingssituationer. Vi rekommenderar inte att du hoppar över kontroller när du installerar i produktion.
HardwareStation.exe install --SkipFirewallUpdate --SkipOPOSCheck --SkipVersionCheck --SkipURLCheck --Config "HardwareStation.Houston.xml"
Det är vanligt att blanda och matcha dessa koncept för att uppnå de installationsresultat du vill ha.
Commerce Scale Unit (självvärdbaserad)
När du testar installationsprogrammet för första gången rekommenderar vi att du kör följande kommando:
CommerceStoreScaleUnitSetup.exe help install
Innan du börjar
Det är mycket viktigt att du tar bort den gamla CSU-komponenten (självvärdbaserad) med självbetjäning. Mer information finns i migreringsstegen tidigare i denna artikel.
Exempel på tyst distribution
Det här avsnittet innehåller exempel på kommandon som används för installation av CSU (självvärdbaserad).
Installera CSU-komponent (självvärdbaserad) tyst
Följande kommando installerar (eller uppdaterar) CSU (självvärdbaserad). Det har standardkommandostrukturen som används för tyst service av komponenter som för närvarande är installerade. Strukturen använder de grundläggande värdena i <InstallerName>.exe.
Jämfört med andra självbetjäningsinstallationsprogram är Commerce Scale Unit (CSU) mer komplicerat och kräver en ganska stor mängd ytterligare information. Följande kommando är det minimikommando (med parametrar) som krävs för att köra det körbara filinstallationsprogrammet när det inte finns någon konfigurationsfil. Om inte ett betrott SQL-certifikat används krävs --TrustSqlServerCertificate parametern.
CommerceScaleUnit.exe install --port 446 --SSLCertThumbprint "MySSLCertificateThumbprintOftenHasNumbers" --RetailServerCertFullPath "store://My/LocalMachine?FindByThumbprint=MyCertificateThumbprintUsedByRetailServer" --AsyncClientAADClientID "MyAAD-Client-IDFor-AsyncClient" --RetailServerAADClientID "MyAAD-Client-IDFor-RetailServer" --CPOSAADClientID "MyAAD-Client-IDFor-CloudPOS" --RetailServerAADResourceID "https://retailstorescaleunit.retailserver.com" --Config "Contoso.StoreSystemSetup.xml"
Notering
En konfigurationsfil krävs fortfarande för CSU (självvärdbaserad).
Följande kommando är ett mer ingående kommando som kör det körbara filinstallationsprogrammet med några alternativa parametrar. Om inte ett betrott SQL-certifikat används krävs --TrustSqlServerCertificate parametern.
CommerceScaleUnit.exe install --Port 446 --SSLCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --AsyncClientCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --RetailServerCertFullPath "store://My/LocalMachine?FindByThumbprint=MyCertificateThumbprintUsedByRetailServer" --AsyncClientAADClientID "MyAAD-Client-IDFor-AsyncClient" --RetailServerAADClientID "MyAAD-Client-IDFor-RetailServer" --CPOSAADClientID "MyAAD-Client-IDFor-CloudPOS" --RetailServerAADResourceID "https://retailstorescaleunit.retailserver.com" --Verbosity 0 --Config "Contoso.StoreSystemSetup.xml"
Följande kommando anger parametrar som krävs för att hoppa över förutsättningskontroller under en standardinstallation.
Notering
- Vi rekommenderar inte att du hoppar över kontroller om du inte gör noggranna tester i förväg, eller förutom i utvecklingssituationer. Vi rekommenderar inte att du hoppar över kontroller när du installerar i produktion.
- Om inte ett betrott SQL-certifikat används krävs
--TrustSqlServerCertificateparametern.
CommerceScaleUnit.exe install --skipscaleunithealthcheck --skipcertcheck --skipaadcredentialscheck --skipschannelcheck --skipiischeck --skipnetcorebundlecheck --skipsqlservercheck --skipnetframeworkcheck --skipversioncheck --skipurlcheck --Config "Contoso.StoreSystemSetup.xml" --SSLCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --AsyncClientCertFullPath "store://My/LocalMachine?FindByThumbprint=MySSLCertificateThumbprintOftenHasNumbers" --RetailServerCertFullPath "store://My/LocalMachine?FindByThumbprint=MyCertificateThumbprintUsedByRetailServer" --AsyncClientAADClientID "MyAAD-Client-IDFor-AsyncClient" --RetailServerAADClientID "MyAAD-Client-IDFor-RetailServer" --CPOSAADClientID "MyAAD-Client-IDFor-CloudPOS" --RetailServerAADResourceID "https://retailstorescaleunit.retailserver.com"
Du kan blanda och matcha dessa koncept för att uppnå de installationsresultat du vill ha.