Citrix Provisioning

Exécution silencieuse de l’assistant de configuration

Installation silencieuse du logiciel du produit

Vous pouvez installer de manière silencieuse les machines cibles, les serveurs Citrix Provisioning et les consoles vers un répertoire d’installation par défaut en utilisant la commande suivante :

<Installer Name>.exe /s /v"/qn"
<!--NeedCopy-->

Pour définir une autre destination, utilisez l’option INSTALLDIR :

<Installer Name>.exe /s /v"/qn INSTALLDIR=D:\Destination"
<!--NeedCopy-->

Remarque :

Après avoir effectué une installation en mode silencieux d’un client Citrix Provisioning, les mises à niveau ultérieures à l’aide de l’assistant de mise à niveau Upgrade Wizard échouent car le client ne redémarre pas.

Workflow d’exécution silencieuse de l’assistant de configuration

Les étapes de base pour la configuration silencieuse des serveurs de la batterie sont les suivantes :

  • Créez un fichier ConfigWizard.ans depuis un serveur Provisioning Server configuré dans la batterie ou créez le fichier manuellement. Pour créer le fichier manuellement, consultez la section Créer le fichier ConfigWizard.ans manuellement.
  • Copiez le fichier ConfigWizard.ans sur les autres serveurs de la batterie et modifiez l’adresse IP dans le fichier ConfigWizard.ans pour qu’elle corresponde à chaque serveur de la batterie.
  • Exécutez ConfigWizard.exe à l’aide du paramètre /a sur chaque serveur.

Sécurité renforcée pour le fichier de réponses de l’assistant de configuration

Les fichiers de réponses de l’assistant de configuration contiennent des champs sensibles tels que les mots de passe des comptes de base de données et de domaine. À partir de la version 2303 de Citrix Provisioning, ces mots de passe sont protégés par une sécurité renforcée. Par conséquent, lorsque vous créez un nouveau fichier de réponses à l’aide de l’assistant de configuration, fournissez une phrase secrète pour chiffrer les mots de passe. Vous devez utiliser la même phrase secrète lorsque vous utilisez le fichier de réponses. Vous pouvez également continuer à utiliser vos fichiers de réponses créés par l’assistant de configuration avant la version 2303 de Citrix Provisioning.

Créer le fichier ConfigWizard.ans à l’aide de l’assistant de configuration

  1. Exécutez ConfigWizard.exe avec le paramètre /s et /p sur un serveur configuré. Veuillez utiliser :

    • /P pour être invité à saisir une phrase secrète
    • /P:phrase pour fournir la phrase secrète sur la ligne de commande
  2. Sur la page Farm Configuration, choisissez l’option Join existing farm.
  3. Sur la page Citrix Cloud, sélectionnez Join Citrix Cloud ou Do not join Citrix Cloud.
  4. Poursuivez la sélection des paramètres de configuration sur les pages restantes de l’assistant, puis sélectionnez Finish.
  5. Copiez le fichier ConfigWizard.ans depuis le répertoire Citrix Provisioning Application Data dans \\ProgramData\\Citrix\\Provisioning Services.

Copier et modifier le fichier ConfigWizard.ans

  1. Pour chaque serveur, copiez le fichier ConfigWizard.ans dans le répertoire Citrix Provisioning Application Data.
  2. Modifiez la valeur StreamNetworkAdapterIP= afin que cette dernière corresponde à l’IP du serveur en cours de configuration. Si plusieurs IP sont utilisées pour Citrix Provisioning sur le serveur, ajoutez une virgule entre chaque adresse IP.

Exécuter silencieusement ConfigWizard.exe

Pour configurer les serveurs, procédez comme suit :

Exécutez ConfigWizard.exe à l’aide du paramètre /a /p sur chaque serveur. Le paramètre /p garantit un chiffrement avancé à l’aide d’une phrase secrète. La phrase secrète doit être identique à celle que vous avez fournie lors de la création du fichier de réponses. Par exemple, veuillez utiliser :

  • /P pour être invité à saisir une phrase secrète
  • /P:phrase pour fournir la phrase secrète sur la ligne de commande

Remarque :

Si vous utilisez un fichier de réponses créé avec Citrix Provisioning version 2212 ou antérieure, vous pouvez omettre /P.

Si vous souhaitez joindre votre batterie à Citrix Cloud, vous devez fournir les informations d’identification de l’administrateur Citrix Cloud à l’assistant de configuration lorsque vous utilisez l’option /a. Ces informations d’identification sont nécessaires pour enregistrer ou réenregistrer les serveurs Citrix Provisioning de la batterie auprès de Citrix Cloud. Pour fournir les informations d’identification de manière non interactive, procédez comme suit :

  1. Créez un client sécurisé pour votre compte administrateur Citrix Cloud et téléchargez le fichier secureclient.csv sur votre serveur Citrix Provisioning.
  2. Sur le serveur Citrix Provisioning, appliquez le client sécurisé à l’aide de la commande PowerShell Set-XdCredentials en choisissant le profil par défaut. Par exemple :

    Set-XDCredentials -SecureClientFile secureclient.csv -CustomerId xxxxxxx -ProfileType CloudApi -StoreAs default
    <!--NeedCopy-->
    

Pour obtenir des instructions sur la création de clients sécurisés, consultez la section Get started with Citrix Cloud APIs dans la documentation Citrix Developer https://developer.cloud.com/citrix-cloud/citrix-cloud-api-overview/docs/get-started-with-citrix-cloud-apis/.

Pour plus d’information sur le kit SDK PowerShell à distance Citrix DaaS, consultez https://docs.citrix.com/en-us/citrix-daas/sdk-api.html/.

Pour obtenir la liste des paramètres ConfigWizard valides :

  1. Exécutez ConfigWizard.exe avec le paramètre /?.
  2. Dans le répertoire Citrix Provisioning Application Data, ouvrez le fichier ConfigWizard.out.
  3. Défilez jusqu’en bas du fichier pour afficher tous les paramètres valides.

Pour obtenir une liste des commandes et leurs descriptions, utilisez le paramètre / c.

Créer le fichier ConfigWizard.ans manuellement

Si vous souhaitez créer le fichier ConfigWizard.ans à partir de zéro, à l’aide d’un éditeur de texte qui vous permet d’enregistrer le fichier sous Unicode, créez un fichier nommé ConfigWizard.ans et enregistrez-le sous Unicode. Entrez les paramètres affichés dans le tableau. Incluez tous les paramètres pertinents à votre configuration.

Écran Option d’interface utilisateur Paramètre manuel
DHCP Services Service s’exécutant sur cet ordinateur : Microsoft DHCP IPServiceType=0
  Service BOOTP de Citrix Provisioning IPServiceType=1
  Autre service BOOTP ou DHCP IPServiceType=2
  Service s’exécutant sur un autre ordinateur Non inclus
PXE Services Microsoft DHCP sur cet ordinateur PXEServiceType=0
  Service PXE Citrix Provisioning sur cet ordinateur PXEServiceType=1
  Service s’exécutant sur un autre ordinateur PXEServiceType=0
Farm Configuration Farm is already configured FarmConfiguration=0
  Create farm FarmConfiguration=1
  Join existing farm FarmConfiguration=2
Serveur de base de données DatabaseAdminAuthentication DatabaseAdminAuthentication= < ActiveDirectoryIntegrated ou SqlPassword>
  DatabaseAdminUsername DatabaseAdminUserName=<Connexion SQL> (Utilisé uniquement si DatabaseAdminAuthentication a pour valeur SqlPassword)
  DatabaseAdminPassword DatabaseAdminPassword=<mot de passe> (Utilisé uniquement si DatabaseAdminAuthentication a pour valeur SqlPassword)
Database Server (après Create Farm ou Join existing farm) DatabaseAuthentication DatabaseAuthentication=<ActiveDirectoryIntegrated ou SqlPassword>
  DatabaseUsername DatabaseUsername=<connexion SQL> (Utilisé uniquement si DatabaseAuthentication a pour valeur SqlPassword)
  DatabasePassword DatabasePassword=<mot de passe> (Utilisé uniquement si DatabaseAdminAuthentication a pour valeur SqlPassword)
  Server name DatabaseServer=<dBName>,<NonDefaultSQLPort> (s’il s’agit du port par défaut, omettez la valeur de port)
  Instance name DatabaseInstance=<InstanceName>
  Database name DatabaseNew=<DbName>
  Enable MultiSubnetFailover for SQL Server Always On MultiSubnetFailover=<0 ou 1>
  Database Mirror Failover Partner Server Name FailoverDatabaseServer=<dBName>,<NonDefaultSQLPort> (si aucun partenaire de basculement de miroir de base de données n’est utilisé, cette valeur est omise ou a une valeur vide)
Database Mirror Failover Partner Instance Name
New Farm (lorsque la batterie est créée) Farm name FarmNew=<FarmName>
  Site name SiteNew=<SiteName>
  Collection name CollectionNew=<CollectionName>
  Farm Administrator group: PVS server is in Active Directory ADGroup=<chemin d’accès au groupe AD> Ex: test.local/Users/Domain Users
  PVS server is in Workgroup Group=<chemin d’accès au groupe local> Ex: PVS-Server-1/Administrators
New Store (lorsque la batterie est créée) Store name Store=<StoreName>
  Default path DefaultPath=<chemin d’accès au magasin>
Existing Farm (lors de l’association à une batterie existante) Farm name FarmExisting=<nom de base de données>
Site (lors de l’association à une batterie existante) Existing site ; Site name ExistingSite=<nom du site>
  New site ; Site name Site=<nom du site>
  Collection name Collection=<nom de la collection>
Store (lors de l’association à une batterie existante) Existing store ; Store name ExistingStore=<nom du magasin>
  New store ; Store name Store=<nom du magasin>
  Default path DefaultPath=<chemin d’accès au magasin>
Serveur de licences License server name LicenseServer=<IP, nom d’hôte, nom de domaine complet du serveur de licences Citrix>
  License server port LicenseServerPort=<LicenseServerPort> (27000 est le port par défaut)
  On-premises (type de licence) licenseSKU=0
  Use Datacenter licenses for desktops if no Desktop licenses are available LicenseTradeup=<0 ou 1>
  Cloud (type de licence) licenseSKU=1
User account compte de service réseau ; Network=1
  Specified user account ; User name/Domain <domaine\nom d’utilisateur>
  Mot de passe UserName2=<Password>
Active Directory Computer Account Password Days between password updates PasswordManagementInterval=<#ofDays> (l’inclusion de ce paramètre active l’option Automate computer account password updates)
Network Communications Streaming network cards StreamNetworkAdapterIP=<IPofStreamingNIC1,IPofStreamingNIC2,…> (liste d’adresses IP séparées par des virgules)
  Management network card ManagementNetworkAdapterIP=<IPofManagementNIC> (une seule adresse IP)
  Remarque : les cartes réseau peuvent utiliser le service de streaming et de gestion.  
  First communications port IpcPortBase=6890
  Nombre total de ports utilisés pour la communication sur le serveur IpcPortCount=20
  Console port SoapPort=54321
Stream Servers Boot List Specify boot servers (maximum de 4, LS1–LS4) LS#=<IP,Default Subnet Mask,Device Gateway,Server Port>
    Pour Default Subnet Mask et Device Gateway, utilisez 0.0.0.0 si les informations sont fournies par DHCP.
    LS1=1.1.1.57,255.255.254.0,10.192.176.1,6910
    LS2=2.2.2.92,0.0.0.0,0.0.0.0,6910
Advanced Stream Servers Boot List Verbose mode (affiche les informations de diagnostic) AdvancedVerbose=<0 ou 1>
  Interrupt safe mode (sélectionnez cette option si la machine cible se bloque pendant le démarrage) AdvancedInterruptSafeMode=<0 ou 1>
  Advanced Memory Support AdvancedMemorySupport=<0 ou 1>
  Network Recovery Method AdvancedRebootFromHD=<0 pour Restore Network Connection, 1 pour Reboot from hard disk>
  Recovery time in seconds AdvancedRecoverSeconds=<temps en secondes>
  Login Polling Timeout AdvancedLoginPolling=<temps en millisecondes>
  Login General Timeout AdvancedLoginGeneral=<temps en millisecondes>
Soap SSL Configuration SSL port SSLPort=54323
  SSL certificate SSLCert=<jeton>
Problem Report Configuration My Citrix Username CisUserName=<nom d’utilisateur>
  Mot de passe CisPassword=<mot de passe>