Unisci più siti in un unico sito
Il supporto multi-sito per la configurazione automatizzata fornisce un metodo per unire più siti locali in un unico sito cloud.
Il supporto multi-sito aggiunge prefissi e suffissi univoci ai nomi dei componenti per ogni sito locale, garantendo l’univocità del nome dopo che più siti locali vengono uniti in un unico sito cloud.
È possibile assegnare prefissi e suffissi a ciascuno dei seguenti componenti, in base al sito locale.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogNegozio FrontEtichetta
Le cartelle delle applicazioni supportano prefissi, suffissi e rerooting. Il rerooting aggiunge una cartella di primo livello alla struttura di cartelle esistente di un’applicazione.
Regole per prefissi e suffissi
- I prefissi e i suffissi non possono contenere nessuno dei seguenti caratteri speciali:
\ , / ; : # . * ? = < > | ( ) " ' { } [ ] - I prefissi e i suffissi possono contenere spazi finali, ma non spazi iniziali.
- I prefissi e i suffissi devono essere racchiusi tra virgolette doppie per contenere spazi finali.
- I prefissi e i suffissi vengono applicati al momento dell’importazione, dell’unione e dell’aggiunta. I file sorgente
.ymlnon vengono mai modificati. - Il processo di prefisso e suffisso aggiunge automaticamente prefissi o suffissi ai nomi dei componenti dipendenti, ove applicabile. Ad esempio, se i nomi dei cataloghi delle macchine hanno il prefisso “Est”, anche i gruppi di distribuzione che vi fanno riferimento hanno il prefisso “Est”.
- Se il nome di un componente inizia già con il prefisso o il suffisso, non viene aggiunto alcun prefisso o suffisso. I nomi dei componenti non possono contenere prefissi o suffissi doppi identici.
- Prefissi e suffissi possono essere utilizzati singolarmente o in combinazione.
- L’uso di un prefisso o di un suffisso su un componente è facoltativo.
Nota:
Lo Studio visualizza i componenti in ordine alfabetico.
Raggruppa i componenti per sito
Utilizzare i prefissi per raggruppare visivamente i componenti di un singolo sito. Ogni sito è elencato nel proprio gruppo con un prefisso alfabetico che controlla l’ordinamento dei diversi gruppi di siti.
Raggruppa i componenti per nome
Utilizzare i suffissi per raggruppare visivamente componenti con nomi simili provenienti da più siti. I componenti con nomi simili provenienti da siti diversi si alternano visivamente.
File di mappatura prefissi e suffissi
L’assegnazione del prefisso al sito inizia con il file SiteMerging.yml che contiene il mapping del prefisso e del suffisso del sito per uno o più siti locali. È possibile gestire manualmente il file SiteMerging.yml oppure utilizzando i cmdlet disponibili elencati nella sezione Cmdlet per l’unione di più siti locali .
Esportazione del sito on-premise
L’unione non può iniziare finché non viene esportato un sito locale. Per esportare un sito locale, vedere Esportazione della configurazione locale.
Cartella di destinazione dell’esportazione centrale
I metodi descritti in questa sezione inseriscono più esportazioni di siti in un’unica posizione di condivisione file centrale. Il file SiteMerging.yml , il file CustomerInfo.yml e tutti i file di esportazione risiedono in quella posizione di condivisione file, consentendo di eseguire l’importazione da una posizione indipendente dai siti locali.
Le operazioni di accesso al cloud non fanno mai riferimento ai siti locali o ad Active Directory, consentendo quindi di eseguire operazioni di accesso al cloud da qualsiasi luogo.
Esistono due metodi per farlo:
- Condivisione file diretta: per importare, unire o aggiungere dalla condivisione file diretta, è necessario decidere da quale macchina si desidera eseguire l’operazione di accesso al cloud
- Riferimento alla condivisione file tramite
SiteMerging.yml: questo metodo utilizza il membroSiteRootFolderdel set di prefissi del sito e riduce le probabilità di indirizzare la cartella sbagliata durante l’esportazione, l’importazione, l’unione o l’aggiunta.
Se non si utilizza un metodo di condivisione file centrale, eseguire l’importazione, l’unione o l’aggiunta dai singoli Delivery Controller. Creare e replicare il file SiteMerging.yml su ciascun Delivery Controller in fase di migrazione nel cloud. Il percorso predefinito è %HOMEPATH%\Documents\Citrix\AutoConfig. È necessario specificare il parametro –SiteName per selezionare i prefissi del sito corretti.
Condivisione diretta dei file
Le operazioni di esportazione, importazione, unione e nuovo/aggiunta forniscono un parametro per indirizzare o indirizzare una cartella diversa da quella predefinita, %HOMEPATH%\Documents\Citrix\AutoConfig. Gli esempi seguenti utilizzano una condivisione file centrale in \\share.central.net a cui l’amministratore ha già accesso, avendo fornito le credenziali necessarie.
Per indirizzare l’esportazione a una cartella specifica del sito, utilizzare il parametro –TargetFolder :
Dal responsabile delle consegne dell’Est:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
Dal West Delivery Controller:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest`
Una volta completate le esportazioni, crea i file CustomerInfo.yml e SiteMerging.yml e inseriscili in \\share.central.net\AutoConfig.
Nota:
Non utilizzare il parametro
SiteRootFolderquando si crea SitePrefixes.yml quando si utilizza questo metodo di riferimento diretto alla condivisione file.
Per importare, unire o aggiungere dalla condivisione file diretta, è necessario decidere da quale macchina si desidera eseguire l’operazione di accesso al cloud. Le opzioni includono:
- Uno dei Delivery Controller locali in cui lo strumento è già installato.
- La macchina che ospita la condivisione dei file.
- Una macchina diversa.
La configurazione automatizzata deve essere installata sulla macchina che accede al cloud. Non vengono utilizzati né l’SDK PowerShell locale, né Delivery Controller, né Active Directory, quindi i requisiti di esecuzione per l’accesso al cloud sono più semplici rispetto ai requisiti di esportazione.
Per unire East Delivery Controller al cloud:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Per unire West Delivery Controller al cloud:
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Di seguito è riportato un esempio di file SitePrefixes.yml utilizzato nell’esempio precedente.
East:
SiteRootFolder: "" # Important: leave this empty
AdminScopePrefix: "East_"
AdminRolePrefix: "East_"
ApplicationAdminPrefix: "East_"
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "East"
ApplicationGroupPrefix: "East_"
ApplicationUserPrefix: "East_"
DeliveryGroupPrefix: "East_"
GroupPolicyPrefix: "East_"
HostConnectionPrefix: "East_"
MachineCatalogPrefix: "East_"
StoreFrontPrefix: "East_"
TagPrefix: "East_"
AdminScopeSuffix: "_east"
AdminRoleSuffix: "_east"
ApplicationAdminSuffix: "_east"
ApplicationFolderSuffix: "_east"
ApplicationGroupSuffix: "_east"
ApplicationUserSuffix: "_east"
DeliveryGroupSuffix: "_east"
GroupPolicySuffix: "_east"
HostConnectionSuffix: "_east"
MachineCatalogSuffix: "_east"
StoreFrontSuffix: "_east"
TagSuffix: "_east"
West:
SiteRootFolder: "" # Important: leave this empty
AdminScopePrefix: "Western "
AdminRolePrefix: "Western "
ApplicationAdminPrefix: "Western "
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "Western"
ApplicationGroupPrefix: "Western "
ApplicationUserPrefix: "Western "
DeliveryGroupPrefix: "Western "
GroupPolicyPrefix: "Western "
HostConnectionPrefix: "Western "
MachineCatalogPrefix: "Western "
StoreFrontPrefix: "Western "
TagPrefix: "Western "
AdminScopeSuffix: ""
AdminRoleSuffix: ""
ApplicationAdminSuffix: ""
ApplicationFolderSuffix: ""
ApplicationGroupSuffix: ""
ApplicationUserSuffix: ""
DeliveryGroupSuffix: ""
GroupPolicySuffix: ""
HostConnectionSuffix: ""
MachineCatalogSuffix: ""
StoreFrontSuffix: ""
TagSuffix: ""
Riferimento alla condivisione file tramite SiteMerging.yml
Questo metodo utilizza il membro SiteRootFolder del set di prefissi del sito. Sebbene più complesso rispetto al metodo di condivisione diretta dei file, questo metodo riduce le probabilità di indirizzare la cartella sbagliata durante l’esportazione, l’importazione, l’unione o l’aggiunta.
Per prima cosa, imposta SiteRootFolder per ogni sito nel file SiteMerging.yml. Devi farlo nella posizione condivisa.
New-CvadAcSiteMergingInfo –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder \\share.central.net\AutoConfig
New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder \\share.central.net\AutoConfig
In questo esempio, East è una specifica di cartella completamente qualificata, mentre West è una specifica di cartella relativa.
Per indirizzare l’esportazione a una cartella specifica del sito utilizzando il file SiteMerging.yml:
Dal responsabile delle consegne dell’Est:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Dal West Delivery Controller:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Il cmdlet di esportazione utilizza il percorso della cartella CustomerInfo.yml per individuare il file SiteMerging.yml. Nel caso di East, SiteRootFolder è completamente qualificato. Si usa così com’è. Nel caso di West, SiteRootFolder non è completamente qualificato. Viene combinato con il percorso della cartella CustomerInfo.yml per recuperare un percorso della cartella completamente qualificato per West.
Per unire East Delivery Controller al cloud:
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Per unire West Delivery Controller al cloud:
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Di seguito è riportato un esempio di file SitePrefixes.yml utilizzato nell’esempio precedente.
East:
SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
AdminScopePrefix: "East_"
AdminRolePrefix: "East_"
ApplicationAdminPrefix: "East_"
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "East"
ApplicationGroupPrefix: "East_"
ApplicationUserPrefix: "East_"
DeliveryGroupPrefix: "East_"
GroupPolicyPrefix: "East_"
HostConnectionPrefix: "East_"
MachineCatalogPrefix: "East_"
StoreFrontPrefix: "East_"
TagPrefix: "East_"
AdminScopeSuffix: "_east"
AdminRoleSuffix: "_east"
ApplicationAdminSuffix: "_east"
ApplicationFolderSuffix: "_east"
ApplicationGroupSuffix: "_east"
ApplicationUserSuffix: "_east"
DeliveryGroupSuffix: "_east"
GroupPolicySuffix: "_east"
HostConnectionSuffix: "_east"
MachineCatalogSuffix: "_east"
StoreFrontSuffix: "_east"
TagSuffix: "_east"
West:
SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
AdminScopePrefix: "Western "
AdminRolePrefix: "Western "
ApplicationAdminPrefix: "Western "
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "Western"
ApplicationGroupPrefix: "Western "
ApplicationUserPrefix: "Western "
DeliveryGroupPrefix: "Western "
GroupPolicyPrefix: "Western "
HostConnectionPrefix: "Western "
MachineCatalogPrefix: "Western "
StoreFrontPrefix: "Western "
TagPrefix: "Western "
AdminScopeSuffix: ""
AdminRoleSuffix: ""
ApplicationAdminSuffix: ""
ApplicationFolderSuffix: ""
ApplicationGroupSuffix: ""
ApplicationUserSuffix: ""
DeliveryGroupSuffix: ""
GroupPolicySuffix: ""
HostConnectionSuffix: ""
MachineCatalogSuffix: ""
StoreFrontSuffix: ""
TagSuffix: ""
Unisci i siti
Citrix consiglia di eseguire le operazioni cloud in più fasi e di effettuare una revisione completa di ogni risultato prima di eseguire la successiva operazione cloud. Ad esempio, se si uniscono tre siti in un unico sito cloud:
- Unisci il sito iniziale al cloud utilizzando il valore
SiteNameappropriato. - Esaminare i risultati in Studio.
- Se i risultati non sono corretti, individuare il problema e la sua causa, correggerlo e quindi eseguire nuovamente l’unione. Se necessario, rimuovere i componenti cloud e ricominciare da zero utilizzando
Remove-CvadAcFromSiteper il componente e i membri selezionati. Se i risultati sono corretti, continuare. - Se l’unione iniziale è corretta, unisci il secondo sito al singolo sito cloud.
- Ripetere i passaggi 2 e 3.
- Se la seconda unione è corretta, unisci il terzo sito al singolo sito cloud.
- Ripetere i passaggi 2 e 3.
- Esaminare le risorse dal punto di vista dell’utente e verificare che la vista sia nello stato desiderato.
Rimuovi un componente utilizzando il prefisso del sito
È possibile rimuovere selettivamente singoli componenti del sito utilizzando il prefisso sul parametro –IncludeByName del cmdlet Remove-CvadAcFromSite . Nell’esempio seguente, i gruppi di consegna West Delivery Controller non sono corretti. Per rimuovere i gruppi di consegna solo per il sito Ovest:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Per rimuovere tutti i componenti West, eseguire i seguenti cmdlet nell’ordine indicato.
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”
Remove-CvadAcFromSite –Applications –IncludeByName “Western *”
Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”
Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”
Remove-CvadAcFromSite –Tags –IncludeByName “Western *”
Per rimuovere i criteri di gruppo dei componenti orientali, utilizzare il suffisso:
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”