Unire più siti in un unico sito
Il supporto multi-sito per la configurazione automatizzata offre un metodo per unire più siti on-premise in un unico sito cloud.
Il supporto multi-sito aggiunge prefissi e suffissi univoci ai nomi dei componenti per ogni sito on-premise, garantendo l’unicità dei nomi dopo che più siti on-premise sono stati uniti in un unico sito cloud.
Prefissi e suffissi possono essere assegnati per ciascuno dei seguenti componenti, per ogni sito on-premise.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFront™Tag
Le cartelle delle applicazioni supportano l’aggiunta di prefissi, suffissi e il rerooting. Il rerooting aggiunge una cartella di primo livello extra alla struttura di cartelle esistente di un’applicazione.
Regole per prefissi e suffissi
- Prefissi e suffissi non possono contenere nessuno dei seguenti caratteri speciali:
\ , / ; : # . * ? = < > | ( ) " ' { } [ ] - Prefissi e suffissi possono contenere spazi finali ma non spazi iniziali.
- Prefissi e suffissi devono essere racchiusi tra virgolette doppie per contenere spazi finali.
- Prefissi e suffissi vengono applicati al momento dell’importazione, dell’unione e dell’aggiunta. I file
.ymldi origine non vengono mai modificati. - Il processo di prefisso e suffisso aggiunge automaticamente prefissi o suffissi ai nomi dei componenti dipendenti, quando applicabile. Ad esempio, se i nomi dei cataloghi di macchine sono prefissati con “East”, anche i gruppi di consegna che li fanno riferimento sono prefissati con “East”.
- Se un nome di componente inizia già con il prefisso o il suffisso, non viene aggiunto alcun prefisso o suffisso. I nomi dei componenti non possono contenere doppi prefissi o suffissi 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:
Studio visualizza i componenti in ordine alfabetico.
Raggruppare i componenti per sito
Utilizzare i prefissi per raggruppare visivamente i componenti di un singolo sito. Ogni sito è elencato nel proprio gruppo, con i prefissi che controllano alfabeticamente l’ordinamento dei diversi gruppi di siti.
Raggruppare i componenti per nome
Utilizzare i suffissi per raggruppare visivamente componenti con nomi simili da più siti. I componenti con nomi simili provenienti da siti diversi si alternano visivamente.
File di mappatura prefissi e suffissi
L’aggiunta di prefissi ai siti inizia con il file SiteMerging.yml che contiene la mappatura dei prefissi e suffissi del sito per uno o più siti on-premise. È possibile gestire il file SiteMerging.yml manualmente o utilizzando i cmdlet disponibili elencati nella sezione Cmdlet per l’unione di più siti on-premise.
Esportare il sito on-premise
L’unione non può iniziare finché non è stato esportato un sito on-premise. Per esportare un sito on-premise, vedere Esportare la configurazione on-premise.
Cartella di destinazione dell’esportazione centrale
I metodi descritti in questa sezione posizionano più esportazioni di siti in una 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 un’unica posizione indipendentemente dai siti on-premise.
Le operazioni di accesso al cloud non fanno mai riferimento ai siti on-premise 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 puntare alla 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 ogni Delivery Controller migrato nel cloud. La posizione predefinita è %HOMEPATH%\Documents\Citrix\AutoConfig. È necessario specificare il parametro –SiteName per selezionare i prefissi del sito corretti.
Condivisione file diretta
Le operazioni di esportazione, importazione, unione e creazione/aggiunta forniscono un parametro per specificare una cartella di destinazione o di origine diversa dalla cartella 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 Delivery Controller East™:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
<!--NeedCopy-->
Dal Delivery Controller West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest`
<!--NeedCopy-->
Dopo aver completato le esportazioni, creare i file CustomerInfo.yml e SiteMerging.yml e posizionarli in \\share.central.net\AutoConfig.
Nota:
Non utilizzare il parametro
SiteRootFolderquando si crea il file SitePrefixes.yml con 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 on-premise in cui lo strumento è già installato.
- La macchina che ospita la condivisione file.
- Una macchina diversa.
La configurazione automatizzata deve essere installata sulla macchina che accede al cloud. Non vengono utilizzati né l’SDK PowerShell on-premise, né il 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 il Delivery Controller East al cloud:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Per unire il Delivery Controller West al cloud:
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Di seguito è riportato un esempio del 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: ""
<!--NeedCopy-->
Riferimento alla condivisione file tramite SiteMerging.yml
Questo metodo utilizza il membro SiteRootFolder del set di prefissi del sito. Sebbene più complesso del metodo di condivisione file diretta, questo metodo riduce le probabilità di puntare alla cartella sbagliata durante l’esportazione, l’importazione, l’unione o l’aggiunta.
Innanzitutto, impostare il SiteRootFolder per ogni sito nel file SiteMerging.yml. È necessario 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
<!--NeedCopy-->
In questo esempio, East è una specifica di cartella completa e West è una specifica di cartella relativa.
Per indirizzare l’esportazione a una cartella specifica del sito utilizzando il file SiteMerging.yml:
Dal Delivery Controller East:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Dal Delivery Controller West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Il cmdlet di esportazione utilizza la posizione della cartella CustomerInfo.yml per individuare il file SiteMerging.yml. Nel caso di East, il SiteRootFolder è completo. Viene utilizzato così com’è. Nel caso di West, il SiteRootFolder non è completo. Viene combinato con la posizione della cartella CustomerInfo.yml per recuperare una posizione di cartella completa per West.
Per unire il Delivery Controller East al cloud:
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Per unire il Delivery Controller West al cloud:
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Di seguito è riportato un esempio del 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: ""
<!--NeedCopy-->
Unire i siti
Citrix® raccomanda di eseguire le operazioni cloud per fasi e di effettuare una revisione completa di ogni risultato prima di procedere con l’operazione cloud successiva. Ad esempio, se si uniscono tre siti in un unico sito cloud:
- Unire il sito iniziale al cloud utilizzando il valore
SiteNameappropriato. - Rivedere i risultati in Studio.
- Se i risultati non sono corretti, determinare il problema e la sua causa, correggerlo e quindi rieseguire l’unione. Se necessario, rimuovere i componenti cloud e ricominciare da capo utilizzando
Remove-CvadAcFromSiteper il componente e i membri selezionati. Se i risultati sono corretti, continuare. - Se l’unione iniziale è corretta, unire il secondo sito al singolo sito cloud.
- Ripetere i passaggi 2 e 3.
- Se la seconda unione è corretta, unire il terzo sito al singolo sito cloud.
- Ripetere i passaggi 2 e 3.
- Rivedere le risorse dal punto di vista dell’utente e verificare che la visualizzazione sia nello stato desiderato.
Rimuovere un componente utilizzando il prefisso del sito
È possibile rimuovere selettivamente i componenti di un singolo sito utilizzando il prefisso sul parametro –IncludeByName del cmdlet Remove-CvadAcFromSite. Nell’esempio seguente, i gruppi di consegna del Delivery Controller West non sono corretti. Per rimuovere i gruppi di consegna solo per il sito West:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
<!--NeedCopy-->
Per rimuovere tutti i componenti West, eseguire i seguenti cmdlet in ordine.
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 East, utilizzare il suffisso:
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”
<!--NeedCopy-->