Instalación, configuración, actualización de versiones y desinstalación

Antes de instalar y configurar

Para instalar y configurar StoreFront, siga estos pasos en el orden indicado.

1. Si quiere utilizar StoreFront para entregar recursos de Citrix Virtual Apps and Desktops a los usuarios, compruebe que el servidor de StoreFront está unido al dominio de Microsoft Active Directory que contiene las cuentas de los usuarios o a un dominio que tiene una relación de confianza con el dominio de las cuentas de usuario.

   Importante:

   • En implementaciones de servidor único, puede instalar StoreFront en un servidor que no esté unido a ningún dominio.
   • StoreFront no se puede instalar en un controlador de dominio.

2. Si aún no está instalado, StoreFront necesita Microsoft .NET Framework, que se puede descargar desde Microsoft. Microsoft .NET debe estar instalado antes de instalar StoreFront.

3. Si, además, piensa configurar una implementación de StoreFront con varios servidores, configure un entorno de equilibrio de carga para los servidores de StoreFront.

   Para utilizar Citrix ADC para el equilibrio de carga, defina un servidor virtual como proxy de los servidores de StoreFront. Para obtener más información sobre cómo configurar Citrix ADC para el equilibrio de carga, consulte Equilibrio de carga con Citrix ADC.

   1. Compruebe que el equilibrio de carga esté habilitado en el dispositivo Citrix ADC.

   2. Para cada servidor de StoreFront, cree servicios de equilibrio de carga HTTP o SSL individuales, según sea adecuado, con el tipo de supervisión de StoreFront.

   3. Configure los servicios para insertar la dirección IP del cliente en el encabezado X-Forwarded-For HTTP de solicitudes reenviadas a StoreFront, sobrescribiendo todas las directivas globales.

      StoreFront requiere direcciones IP de los usuarios para establecer conexiones con sus recursos.

   4. Cree un servidor virtual y enlace los servicios al servidor virtual.

   5. En el servidor virtual, configure la persistencia con el método IP del cliente o inserción de cookies. Asegúrese de que el tiempo de vida (TTL) es suficiente para permitir que los usuarios permanezcan conectados al servidor tanto tiempo como sea necesario.

      La persistencia garantiza que solo se realiza el equilibrio de carga en la conexión de usuario inicial y posteriormente se dirigen las solicitudes subsiguientes de ese usuario al mismo servidor de StoreFront.

4. De manera opcional, puede habilitar las siguientes funciones.

   • Características de .NET Framework > .NET Framework, ASP.NET

   Si lo quiere, puede habilitar los siguientes roles y sus dependencias en el servidor de StoreFront.

   • Servidor web (IIS) > Servidor web > Características HTTP comunes > Documento predeterminado, Errores HTTP, Contenido estático, Redirección HTTP

   • Servidor web (IIS) > Servidor web > Estado y diagnóstico > Registro HTTP

   • Servidor web (IIS) > Servidor web > Seguridad > Filtro de solicitudes, Autenticación de Windows

     El instalador de StoreFront comprueba que todas las funciones y los roles de servidor precedentes están habilitados.

5. Instale StoreFront.

   Si quiere que el servidor forme parte de un grupo de servidores, la ubicación de la instalación de StoreFront y los parámetros del sitio web de IIS, la ruta física y los ID del sitio deben ser idénticos en todos los servidores del grupo.

6. De manera opcional, configure Microsoft Internet Information Services (IIS) para HTTPS si planea utilizar HTTPS para proteger la comunicación entre StoreFront y los dispositivos de los usuarios.

   Se necesita HTTPS para la autenticación con tarjeta inteligente. De forma predeterminada, la aplicación Citrix Workspace requiere conexiones HTTPS a los almacenes. Para configurar IIS de modo que se pueda usar un hostbaseURL HTTPS en StoreFront, cree un enlace HTTPS al sitio web predeterminado y vincúlelo al certificado del servidor de StoreFront. Para obtener más información sobre cómo agregar un enlace HTTPS a un sitio IIS, consulte Proteger la implementación de StoreFront.

7. Asegúrese de que los firewalls y otros dispositivos de red permiten el acceso a los puertos TCP 80 o 443, según corresponda, desde dentro y fuera de la red corporativa. Además, asegúrese de que ni los firewalls ni otros dispositivos de la red interna bloqueen el tráfico a los puertos TCP no asignados.

   Al instalar StoreFront, se configura una regla del Firewall de Windows. Esta regla habilita el acceso al archivo ejecutable de StoreFront a través de un puerto TCP aleatorio seleccionado de los puertos no reservados. Este puerto se utiliza para comunicaciones entre los servidores de StoreFront en un grupo de servidores.

8. Si va a usar varios sitios web de Internet Information Services (IIS), después de crear los sitios en IIS, use el SDK de PowerShell para crear una implementación de StoreFront en cada uno de ellos. Para obtener más información, consulte Varios sitios web de Internet Information Services (IIS).

   Nota:

   StoreFront inhabilita la consola de administración cuando detecta varios sitios y muestra un mensaje a tal efecto.

9. Utilice la consola de administración de Citrix StoreFront para configurar el servidor.

Instalar StoreFront

Importante

Para evitar posibles errores y la pérdida de datos durante la instalación de StoreFront, asegúrese de que todas las aplicaciones están cerradas y de que no hay otras tareas u operaciones ejecutándose en el sistema de destino.

1. Descargue el programa de instalación desde la página de descarga.

2. Inicie sesión en el servidor de StoreFront con una cuenta con permisos de administrador local.

3. Compruebe que Microsoft .NET Framework, requisito necesario, esté instalado en el servidor.

4. Busque CitrixStoreFront-x64.exe y ejecute el archivo como administrador.

5. Lea y acepte el contrato de licencia. A continuación, haga clic en Siguiente.

6. Si aparece la página Revisar requisitos previos, haga clic en Siguiente.

7. En la página Listo para instalar, consulte los requisitos previos y los componentes de StoreFront que se van a instalar y haga clic en Instalar.

   Antes de la instalación de los componentes, se habilitan los siguientes roles, si no están ya configurados en el servidor.

   • Servidor web (IIS) > Servidor web > Características HTTP comunes > Documento predeterminado, Errores HTTP, Contenido estático, Redirección HTTP

   • Servidor web (IIS) > Servidor web > Estado y diagnóstico > Registro HTTP

   • Servidor web (IIS) > Servidor web > Seguridad > Filtro de solicitudes, Autenticación de Windows

   • Servidor web (IIS) > Herramientas de administración > Consola de administración de IIS, Scripts y herramientas de administración de IIS

   Si no están ya configuradas, también se habilitan las siguientes funciones.

   • Características de .NET Framework > .NET Framework, ASP.NET

8. Cuando termine la instalación, haga clic en Finalizar. La consola de administración de Citrix StoreFront se inicia automáticamente. También puede abrir StoreFront desde la pantalla Inicio.

   

9. En la consola de administración de Citrix StoreFront, haga clic en Crear una nueva implementación.

   1. Especifique la URL del servidor de StoreFront en el cuadro URL base.
   2. En la página Nombre del almacén, especifique un nombre para el almacén y haga clic en Siguiente.

En la página Delivery Controllers, indique datos de las implementaciones de Citrix Virtual Apps and Desktops que proporcionan los recursos que quiere ofrecer en el almacén.

1. Establezca el Tipo de transporte y el Puerto, por ejemplo, HTTP y puerto 80 o HTTPS y puerto 443. A continuación, haga clic en Aceptar.

2. En la página Acceso remoto, seccione Ninguno. Si utiliza Citrix Gateway, seleccione Sin túnel VPN e indique datos de su puerta de enlace.

3. En la página Acceso remoto, seccione Crear. Después de haber creado el almacén, haga clic en Finalizar.

Ahora, el almacén está disponible para que los usuarios accedan a él mediante el sitio de Citrix Receiver para Web, lo que permite que los usuarios accedan a sus escritorios y aplicaciones a través de una página web.

Aparecerá la dirección URL para que los usuarios accedan a un sitio de Citrix Receiver para Web para el nuevo almacén. Por ejemplo: example.net/Citrix/StoreWeb/. Inicie sesión y accederá a la nueva interfaz de usuario en la aplicación Citrix Workspace.

Para instalar StoreFront desde un símbolo del sistema

1. Inicie sesión en el servidor de StoreFront con una cuenta con permisos de administrador local.

2. Asegúrese de que se cumplan los requisitos para la instalación de StoreFront antes de instalar StoreFront. Para obtener información más detallada, consulte Antes de instalar y configurar.

3. En los medios de instalación o el paquete de descarga, busque CitrixStoreFront-x64.exe y copie el archivo a una ubicación temporal en el servidor.

4. En un símbolo del sistema, vaya a la carpeta que contiene el archivo de instalación y escriba el siguiente comando.

   CitrixStoreFront-x64.exe [-silent] [-INSTALLDIR installationlocation] [-WINDOWS_CLIENT filelocation\filename.exe] [-MAC_CLIENT filelocation\filename.dmg]
   <!--NeedCopy-->
   

   Utilice el argumento -silent para realizar una instalación silenciosa de StoreFront y todos los requisitos previos. De forma predeterminada, StoreFront se instala en C:\Archivos de programa\Citrix\Receiver StoreFront. No obstante, puede especificar otra ubicación de instalación con el argumento -INSTALLDIR, donde installationlocation es el directorio en el que se instalará StoreFront. Si quiere que el servidor forme parte de un grupo de servidores, la ubicación de la instalación de StoreFront y los parámetros del sitio web de IIS, la ruta física y los ID del sitio deben ser idénticos en todos los servidores del grupo.

   De forma predeterminada, si un sitio de Citrix Receiver para Web no puede detectar la aplicación Citrix Workspace en un dispositivo Windows o Mac OS X, se solicitará al usuario que descargue e instale la aplicación Citrix Workspace correspondiente a su plataforma desde el sitio web de Citrix. Puede modificar este comportamiento para que los usuarios puedan descargarse los archivos de instalación de la aplicación Citrix Workspace desde el servidor de StoreFront. Para obtener más información, consulte Configurar cómo se muestran los recursos a los usuarios.

   Si va a cambiar esta configuración, especifique los argumentos -WINDOWS_CLIENT y -MAC_CLIENT para copiar los archivos de instalación de Citrix Receiver para Windows o la aplicación Citrix Workspace para Windows y Citrix Receiver para Mac o la aplicación Citrix Workspace para Mac, respectivamente, a la ubicación adecuada en la implementación de StoreFront. Reemplace filelocation por el directorio que contiene el archivo de instalación a copiar y filename por el nombre del archivo de instalación. Los archivos de instalación de Citrix Receiver para Windows o la aplicación Citrix Workspace para Windows y Citrix Receiver para Mac o la aplicación Citrix Workspace para Mac se incluyen en los medios de instalación de Citrix Virtual Apps and Desktops.

CEIP

Si se participa en el programa CEIP de mejora de la experiencia del usuario (Customer Experience Improvement Program), se envían estadísticas e información de uso anónimos a Citrix para mejorar la calidad y el rendimiento de sus productos.

De forma predeterminada, se inscribe automáticamente en el programa CEIP cuando instala StoreFront. La primera carga de datos tiene lugar aproximadamente siete días después de instalar StoreFront. Puede cambiar esta opción predeterminada en el parámetro de Registro del sistema. Si cambia el parámetro de Registro del sistema antes de instalar StoreFront, se usará ese valor. Si cambia el parámetro de Registro del sistema antes de actualizar la versión de StoreFront, se usará ese valor.

Advertencia:

Si se modifica el Registro de forma incorrecta, pueden producirse problemas graves que obliguen a reinstalar el sistema operativo. Citrix no puede garantizar que los problemas derivados de la utilización inadecuada del Editor del Registro puedan resolverse. Si utiliza el Editor del Registro, será bajo su propia responsabilidad. Haga una copia de seguridad del Registro antes de modificarlo.

El parámetro de Registro que controla la carga automática de los datos de análisis (predeterminado = 1):

Location: HKLM:\Software\Citrix\Telemetry\CEIP
Name: Enabled
Type: REG_DWORD
Value: 0 = disabled, 1 = enabled
<!--NeedCopy-->

De forma predeterminada, la propiedad Enabled está oculta en el registro. Si no se especifica, significa que la funcionalidad de carga automática está habilitada.

Con PowerShell, el cmdlet siguiente inhabilita la inscripción en el programa CEIP:

New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0

Nota:

El parámetro de Registro controla la carga automática de información anónima de uso y estadísticas para todos los componentes en el mismo servidor. Por ejemplo, si ha instalado StoreFront en el mismo servidor que el Delivery Controller y decide no participar en el programa CEIP mediante el parámetro de Registro, la ausencia de participación se aplicará a ambos componentes.

Datos de CEIP recopilados desde StoreFront

La siguiente tabla ofrece ejemplos del tipo de información anónima que se recopila. Los datos no contienen detalles que lo identifiquen a usted como cliente.

Citrix Analytics Service

Si es cliente de Citrix Cloud y tiene una implementación local de StoreFront, puede configurar StoreFront para que los datos se envíen a Citrix Analytics Service en Citrix Cloud. Cuando se configura, la aplicación Citrix Workspace y los sitios Citrix Receiver para web a los que se accede desde exploradores compatibles con HTML5 envían eventos de usuario a Citrix Analytics para su procesamiento. Citrix Analytics recoge y agrupa métricas de usuarios, aplicaciones, dispositivos de punto final, redes y datos para proporcionar información completa sobre el comportamiento de los usuarios. Para obtener información sobre esta función en la documentación de Citrix Analytics, consulte Incorporar sitios de Virtual Apps and Desktops mediante StoreFront.

Para configurar este comportamiento:

• Descargue un archivo de configuración de Citrix Analytics.
• Importe datos de Citrix Analytics en la implementación local de StoreFront mediante PowerShell.

Una vez configurado StoreFront, la aplicación Citrix Workspace puede enviar datos desde almacenes StoreFront cuando Citrix Analytics Service lo solicite.

Importante:

La implementación de StoreFront debe poder ponerse en contacto con las siguientes direcciones en el puerto 443 para que esta función se ejecute correctamente y consuma los servicios de Citrix Cloud:

• https://*.cloud.com
• https://*.citrixdata.com

Descargue el archivo de configuración de Citrix Analytics

Importante:

Se requiere un archivo de configuración que contiene información confidencial para la configuración inicial. Mantenga el archivo seguro después de la descarga. No comparta este archivo con nadie fuera de su organización. Después de la configuración, puede eliminar este archivo. Si necesita volver a aplicar la configuración en otro equipo, puede descargar el archivo de nuevo desde la consola de administración de Citrix Analytics Service.

1. Inicie sesión en Citrix Cloud (https://citrix.cloud.com/) con una cuenta de administrador.
2. Seleccione un cliente de Citrix Cloud.

3. Para abrir la consola de administración de servicios de Citrix Analytics, haga clic en Administrar.

   

4. En la consola de administración de servicios de Citrix Analytics, seleccione Settings > Data Sources.
5. En la tarjeta Virtual Apps and Desktops, seleccione el icono de menú (⋮) y, luego, Connect StoreFront deployment.
6. En la página Connect StoreFront Deployment, seleccione Download File para descargar el archivo StoreFrontConfigurationFile.json.

Archivo de configuración de ejemplo

{
  "customerId": "<yourcloudcustomer>",
  "enablementService": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/<yourcloudcustomer>/XenDesktop/<deviceid>/dsconfigdata",
  "cwsServiceKey": "PFJTPn…….. T4=",
  "enablementServiceStatus": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/storefront/config",
  "instanceId": "d98f21d0-56e0-11e9-ba52-5136d90862fe",
  "name": "CASSingleTenant"
}
<!--NeedCopy-->

donde

customerId es el identificador único del cliente actual de Citrix Cloud.

cwsServiceKey es una clave única que identifica la cuenta de cliente actual de Citrix Cloud.

instanceID es un ID generado que se utiliza para firmar (proteger) las solicitudes realizadas desde la aplicación Citrix Workspace para Citrix Analytics. Si registra varios servidores o grupos de servidores de StoreFront con Citrix Cloud, cada uno tiene un instanceID único.

Importar datos de Citrix Analytics en su implementación de StoreFront

1. Copie el archivo StoreFrontConfigurationFile.json en una carpeta adecuada del servidor local de StoreFront (o en un servidor de un grupo de servidores de StoreFront). Los siguientes comandos dan por supuesto que el archivo se guarda en el escritorio.
2. Abra PowerShell ISE y seleccione Ejecutar como administrador.

3. Ejecute los comandos siguientes:

   Import-STFCasConfiguration -Path "$Env:UserProfile\Desktop\StoreFrontConfigurationFile.json"
   Get-STFCasConfiguration
   <!--NeedCopy-->
   

4. Este comando devuelve una copia de los datos importados y los muestra en la consola de PowerShell.

   

Nota:

Los servidores locales de StoreFront, que están instalados en Windows Server 2012 R2, pueden requerir que los componentes de software del runtime de C++ se instalen manualmente para que puedan registrarse con el servicio CAS. Si StoreFront se instala durante la instalación de Citrix Virtual Apps and Desktops, este paso no es necesario porque el metainstalador de CVAD ya instala los componentes del runtime de C++. Si StoreFront se instala solamente con el metainstalador CitrixStoreFront-x64.exe y sin el runtime de C++, es posible que no se registre con Citrix Cloud después de importar el archivo de configuración del servicio CAS.

Propagar datos de Citrix Analytics en un grupo de servidores de StoreFront

Si realiza estas acciones en un grupo de servidores de StoreFront, debe propagar los datos importados de Citrix Analytics en todos los miembros del grupo de servidores. Este paso no es necesario en implementaciones con un solo servidor de StoreFront.

Para propagar los datos, utilice uno de los siguientes métodos:

• Utilice la consola de administración de StoreFront.
• Utilice el cmdlet de PowerShell Publish-STFServerGroupConfiguration.

Comprobar el ID del grupo de servidores de StoreFront

Para comprobar si la implementación se ha registrado correctamente en Citrix Analytics Service, puede usar PowerShell para detectar ServerGroupID en la implementación.

1. Inicie sesión en el servidor de StoreFront o en un servidor de StoreFront del grupo de servidores.
2. Abra PowerShell ISE y seleccione Ejecutar como administrador.

3. Ejecute los comandos siguientes:

   $WebConfigPath = "C:\Program Files\Citrix\Receiver StoreFront\Framework\FrameworkData\Framework.xml"
   $XMLObject = (Get-Content $WebConfigPath) -as [Xml]
   $XMLObject.framework.properties.property
   <!--NeedCopy-->
   

   Por ejemplo, estos comandos generan resultados como los siguientes:

   name value
   ---- -----
   ClusterId 8b8ff5c8-44ba-46e4-87f0-2df8cff31432
   HostBaseUrl https://storefront.example.com/
   SelectedIISWebSiteId 1
   AdminConsoleOperationMode Full
   <!--NeedCopy-->
   

Dejar de enviar datos a Citrix Analytics desde StoreFront

1. Abra PowerShell ISE y seleccione Ejecutar como administrador.

2. Ejecute los comandos siguientes:

   Remove-STFCasConfiguration

   Get-STFCasConfiguration

   Get-STFCasConfiguration no devuelve nada si los datos importados anteriormente de Citrix Analytics se han eliminado correctamente.

3. Si realiza estas acciones en un grupo de servidores de StoreFront, propague el cambio y elimine los datos importados de Citrix Analytics de todos los miembros del grupo de servidores. En un servidor del grupo de servidores, ejecute el siguiente comando:

   Publish-STFServerGroupConfiguration

4. En cualquier otro miembro del grupo de servidores, ejecute el siguiente comando para confirmar que la configuración de Citrix Analytics se ha eliminado correctamente de todos los servidores del grupo:

   Get-STFCasConfiguration

5. Inicie sesión en Citrix Cloud (https://citrix.cloud.com/) con una cuenta de administrador.
6. Seleccione un cliente de Citrix Cloud.
7. Para abrir la consola de administración de servicios de Citrix Analytics, haga clic en Administrar.
8. En la consola de administración de servicios de Citrix Analytics, seleccione Settings > Data Sources.

9. En la tarjeta Virtual Apps and Desktops, seleccione el recuento de implementaciones de StoreFront.

   

10. Para identificar la implementación de StoreFront que quiere eliminar, haga referencia a la URL base de su host y a ServerGroupID.

11. En el menú (⋮), seleccione Remove StoreFront deployment from Analytics.

    

Nota:

Si quita la configuración del servidor, pero no de Citrix Analytics, la entrada de la implementación de StoreFront permanece en Citrix Analytics, pero no recibe datos de StoreFront. Si quita la configuración solamente de Citrix Analytics, la entrada de la implementación de StoreFront se vuelve a agregar en el siguiente reciclaje del grupo de aplicaciones (tiene lugar al restablecer IIS o automáticamente cada 24 horas).

Configurar StoreFront para que use un proxy web para ponerse en contacto con Citrix Cloud y registrarse con Citrix Analytics

Si StoreFront se coloca en un servidor web host detrás de un proxy web, ocurrirá un error en el registro con Citrix Analytics. Si los administradores de StoreFront utilizan un proxy HTTP en su implementación de Citrix, el tráfico de StoreFront asociado a Internet debe pasar a través del proxy web antes de que llegue a Citrix Analytics en la nube. StoreFront no utiliza automáticamente la configuración de proxy del SO de alojamiento; se requiere una configuración adicional para indicar al almacén que envíe el tráfico saliente a través del proxy web. Puede establecer una configuración de proxy <system.net> agregando una nueva sección al archivo web.config del almacén. Haga esto para cada almacén del servidor de StoreFront que se utilice para enviar datos a Citrix Analytics.

Método 1: Establecer la configuración del proxy del almacén a través de PowerShell para uno o varios almacenes (recomendado)

La ejecución del script de PowerShell Config-StoreProxy.ps1 automatiza este proceso para uno o varios almacenes e inserta automáticamente XML válido para configurar <system.net>. El script también realiza una copia de seguridad del archivo web.config del almacén en el escritorio del usuario actual, para permitir restaurar el archivo web.config no modificado si es necesario.

Nota:

Ejecutar el script más de una vez puede dar lugar a que se agreguen varias copias del código XML de <system.net. Cada almacén solo debe tener una entrada para <system.net>. Agregar varias copias impide que la configuración del proxy de almacén funcione correctamente.

1. Abra PowerShell ISE y seleccione Ejecutar como administrador.

2. Configure $Stores = @("Store","Store2") para que incluya los almacenes que quiere configurar con un proxy web.

3. Especifique:

   • Una dirección IP
   • O un nombre de dominio completo (FQDN) para el proxy web

4. Ejecute el siguiente comando de PowerShell:

   $Stores = @("Store","Store2")
   $ProxyIP = "10.0.0.1"
   $ProxyFQDN = "proxyserver.example.com"
   $ProxyPort = 8888
   
   # Set this for every Store using Stores array
   function Set-StoreProxyServer() # Tested with both IP and FQDN
   {
       [CmdletBinding()]
       param([Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][array]$Stores,
           [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][string]$ProxyIP,
           [Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][string]$ProxyFQDN,
           [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][int]$ProxyPort)
   
       foreach($Store in $Stores)
       {
           Write-Host "Backing up the Store web.config file for store $Store before making changes..." -ForegroundColor "Yellow"
           Write-Host "`n"
   
           if(!(Test-Path "$env:UserProfile\desktop$Store"))
           {
               Write-Host "Creating $env:UserProfile\desktop$Store\ directory for backup..." -ForegroundColor "Yellow"
               New-Item -Path "$env:UserProfile\desktop$Store" -ItemType "Directory" | Out-Null
               Write-Host "`n"
           }
   
           Write-Host "Copying c:\inetpub\wwwroot\Citrix$Store\web.config to $env:UserProfile\desktop$Store..." -ForegroundColor "Yellow"
           Copy-Item -Path "c:\inetpub\wwwroot\Citrix$Store\web.config" -Destination "$env:UserProfile\desktop$Store" -Force | Out-Null
   
           if(Test-Path "$env:UserProfile\desktop$Store\web.config")
           {
               Write-Host "$env:UserProfile\desktop$Store\web.config file backed up" -ForegroundColor "Green"
           }
           else
           {
               Write-Host "$env:UserProfile\desktop$Store\web.config file NOT found!" -ForegroundColor "Red"
           }
           Write-Host "`n"
   
           Write-Host "Setting the proxy server to $ProxyAddress for Store $Store..." -ForegroundColor "Yellow"
           Write-Host "`n"
   
           $StoreConfigPath = "c:\inetpub\wwwroot\Citrix$Store\web.config"
           $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]
   
           if([string]::IsNullOrEmpty($ProxyFQDN))
           {
               $ProxyServer = ("HTTP://$ProxyIP"+":"+$ProxyPort)
           }
           else
           {
               $ProxyServer = ("HTTP://$ProxyFQDN"+":"+$ProxyPort)
           }
   
           $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]
   
           # Create 3 elements
           $SystemNet = $XMLObject.CreateNode("element","system.net","")
           $DefaultProxy = $XMLObject.CreateNode("element","defaultProxy","")
           $Proxy = $XMLObject.CreateNode("element","proxy","")
           $Proxy.SetAttribute("proxyaddress","$ProxyServer")
           $Proxy.SetAttribute("bypassonlocal","true")
   
           # Move back up the XML tree appending new child items in reverse order
           $DefaultProxy.AppendChild($Proxy)
           $SystemNet.AppendChild($DefaultProxy)
           $XMLObject.configuration.AppendChild($SystemNet)
   
           # Save the modified XML document to disk
           $XMLObject.Save($StoreConfigPath)
   
           Write-Host "Getting the proxy configuration for c:\inetpub\wwwroot\Citrix$Store..." -ForegroundColor "Yellow"
           $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]
           $ConfiguredProxyServer = $XMLObject.configuration.'system.net'.defaultProxy.proxy.proxyaddress | Out-Null
           Write-Host ("Configured proxy server for Store $Store"+": "+ $ConfiguredProxyServer) -ForegroundColor "Green"
           Write-Host "`n"
       }
       Write-Host "Restarting IIS..." -ForegroundColor "Yellow"
       IISReset /RESTART
   }
   
   Set-StoreProxyServer -Stores $Stores -ProxyFQDN $ProxyFQDN -ProxyPort $ProxyPort
   # OR
   Set-StoreProxyServer -Stores $Stores -ProxyIP $ProxyIP -ProxyPort $ProxyPort
   <!--NeedCopy-->
   

5. Compruebe que C:\inetpub\wwwroot\Citrix\web.config contiene ahora una nueva sección `` al final del archivo web.config.

           </dependentAssembly>
       </assemblyBinding>
   </runtime>
   <system.net>
       <defaultProxy>
       <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
       </defaultProxy>
   </system.net>
   </configuration>
   <!--NeedCopy-->
   

6. Importe los datos de Citrix Analytics como se describe en Importar datos de Citrix Analytics en su implementación de StoreFront.

Método 2: Agregar manualmente una sección <system.net> al archivo web.config del almacén

Esto se debe hacer para cada almacén del servidor de StoreFront que se utilice para enviar datos a Citrix Analytics.

1. Haga una copia de seguridad del archivo web.config del almacén y cópielo en otra ubicación, fuera de C:\inetpub\wwwroot\Citrix\web.config.

2. Modifique el siguiente XML con su configuración de proxy mediante una combinación de FQDN y puerto o mediante una combinación de IP y puerto.

   Por ejemplo, mediante una combinación de FQDN y puerto, utilice el siguiente elemento <system.net>:

   <system.net>
       <defaultProxy>
       <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
       </defaultProxy>
   </system.net>
   <!--NeedCopy-->
   

   Por ejemplo, mediante una combinación de IP y puerto, utilice el siguiente elemento <system.net>:

   <system.net>
       <defaultProxy>
       <proxy proxyaddress="HTTP://10.0.0.1:8888" bypassonlocal="true" />
       </defaultProxy>
   </system.net>
   <!--NeedCopy-->
   

3. Al final del archivo web.config del almacén, inserte el elemento <system.net> apropiado donde se indica aquí:

   <runtime>
   <gcServer enabled="true" />
   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
       <dependentAssembly>
       <assemblyIdentity name="System.Web.MVC" publicKeyToken="31BF3856AD364E35" culture="neutral" />
       <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
       </dependentAssembly>
       <dependentAssembly>
       <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
       <bindingRedirect oldVersion="0.0.0.0-9.0.0.0" newVersion="9.0.0.0" />
       </dependentAssembly>
   </assemblyBinding>
   </runtime>
   
   Insert the <system.net> element here
   
   </configuration>
   <!--NeedCopy-->
   

4. Importe los datos de Citrix Analytics como se describe en Importar datos de Citrix Analytics en su implementación de StoreFront.

Actualizar la versión de StoreFront

Advertencia:

Al actualizar la versión de StoreFront a 1912, todos los sitios de Desktop Appliance de la implementación se quitan automáticamente. Si necesita conservar los sitios de Desktop Appliance, no procese la actualización de la versión. Como alternativa, Citrix recomienda usar Desktop Lock de la aplicación Citrix Workspace para todos los casos de uso no asociados a un dominio.

La actualización de versiones conserva la configuración de StoreFront y deja los datos de suscripción a aplicaciones de los usuarios intactos, de modo que los usuarios no tengan que volver a suscribirse a todas sus aplicaciones. Por el contrario, desinstalar StoreFront quita StoreFront y los servicios, sitios, datos de suscripción de aplicaciones (en servidores independientes) y la configuración asociados.

Información útil

• No se admite la actualización de versiones de los sistemas operativos en un servidor con StoreFront. Citrix recomienda instalar StoreFront en una instalación limpia del sistema operativo.
• No se admite la actualización a la versión más reciente de StoreFront desde una versión antigua que esté en el ciclo Fin de vida. Para obtener más información, consulte CTX200356.
• StoreFront no admite implementaciones de varios servidores que contengan versiones diferentes del producto, por lo que todos los servidores de un grupo de servidores deben actualizarse a la misma versión antes de conceder el acceso a la implementación.
• StoreFront no admite implementaciones de varios servidores con sistemas operativos de servidor diferentes, por lo que todos los servidores de un grupo de servidores deben tener el mismo sistema operativo de servidor de Windows.
• No se admite la actualización de versión simultánea para las implementaciones con varios servidores; los servidores deben actualizarse de forma secuencial.
• Todos los almacenes que utilicen la experiencia de usuario clásica se actualizan para utilizar la experiencia unificada cuando se actualiza a esta versión de StoreFront. Se recomienda informar a los usuarios de la nueva experiencia que introduce la actualización, descritos en Experiencia de usuario unificada. Si ha personalizado la experiencia unificada, las personalizaciones se conservan al actualizar StoreFront a esta versión. Compruebe que la apariencia de las personalizaciones sigue siendo la adecuada con la nueva experiencia unificada.
• Antes de que se ejecute la actualización de la versión de StoreFront, se realizan algunas comprobaciones previas a la actualización. Si falla alguna comprobación previa a la actualización de versiones, la actualización no se inicia y se le notifica de los errores. Su instalación de StoreFront no cambia. Tras haber corregido la causa de los fallos, vuelva a ejecutar la actualización de versiones.
• Si se produce un error en la propia actualización de versiones de StoreFront, es posible que la instalación existente de StoreFront pierda su configuración inicial. Restaure la instalación de StoreFront a un estado funcional y vuelva a ejecutar la actualización de versiones. Para restaurar StoreFront a un estado funcional, tenga en cuenta los siguientes enfoques:
  • Restaurar la instantánea de VM que creó antes de la actualización de versiones
  • Importar la configuración de StoreFront que exportó antes de la actualización de la versión (consulte Exportar e importar la configuración de StoreFront)
  • Seguir los consejos para solucionar problemas en Solucionar problemas de actualización de versiones de StoreFront.
• Cualquier error de actualización de versiones de StoreFront que se produzca desde el metainstalador de Citrix Virtual Apps and Desktops queda notificado en un cuadro de diálogo, con un enlace al registro de errores correspondiente.

Prepararse para la actualización de versiones

Antes de iniciar la actualización de la versión, se recomienda seguir estos pasos para evitar errores en la actualización:

• Planifique su estrategia de seguridad antes de actualizar la versión.
• Si ha hecho modificaciones en los archivos de C:\inetpub\wwwroot\Citrix\<StoreName>\App_Data, como default.ica y usernamepassword.tfrm, realice una copia de seguridad de ellos para cada almacén. Después de la actualización de la versión, puede restaurarlos para restablecer las modificaciones.
• Cierre todas las demás aplicaciones del servidor de StoreFront.
• Cierre la consola de administración de StoreFront.
• Cierre todas las ventanas de línea de comandos y de PowerShell.
• Cierre todas las carpetas relacionadas con StoreFront, como C:\inetpub\wwwroot\Citrix\Store y C:\inetpub\wwwroot\Citrix\StoreWeb. Esto evita que el Explorador de Windows las bloquee de forma exclusiva.
• Antes de actualizar la versión de un servidor, reinícielo para asegurarse de que no haya bloqueos exclusivos en los archivos o carpetas de StoreFront (el hecho de reiniciar el proceso explorer, por ejemplo, al cerrar todas las instancias del Explorador de Windows, no es suficiente).
• Ejecute la actualización de la versión inmediatamente sin iniciar ningún otro programa en el servidor.
• Actualice la versión del servidor con una cuenta de administrador, sin ninguna instalación en curso y con el mínimo de aplicaciones.

Actualizar la versión de un servidor de StoreFront independiente

1. Desconecte a los usuarios de la implementación de StoreFront para impedir que accedan a los servidores mientras la actualización de versiones tiene lugar. De esta manera, el instalador puede acceder a todos los archivos de StoreFront durante la actualización de versiones. Si el instalador no puede acceder a los archivos, estos no se reemplazan y la actualización de versiones no se produce, lo que provoca la eliminación de la configuración existente de StoreFront.

2. Haga una copia de seguridad del servidor mediante la creación de una instantánea de VM.

3. Exporte la configuración existente de StoreFront (recomendado).

4. Ejecute el archivo de instalación de esta versión de StoreFront.

Para actualizar la versión de un grupo de servidores de StoreFront

La actualización de versiones de grupos de servidores de StoreFront conlleva el uso de uno de los servidores para quitar los demás servidores del grupo. Los servidores eliminados conservan la configuración relacionada con el grupo, lo que puede impedir que se unan a un nuevo grupo de servidores. Antes de que puedan volver a utilizarse para crear grupos de servidores o como servidores de StoreFront independientes, deben restablecerse a los valores predeterminados de fábrica o reinstalar StoreFront en ellos.

Antes de actualizar la versión de un grupo de servidores:

• Haga copias de seguridad de todos los servidores del grupo mediante la creación de instantáneas de VM. Esto le permite volver rápidamente a un grupo de servidores funcional de tres nodos si la actualización de versiones no se realiza según lo planeado.
• Exporte la configuración existente de StoreFront (recomendado). Exporte solamente la configuración del grupo de servidores desde un servidor. Siempre que haya propagado todos los cambios entre ellos, todos los servidores de un grupo de servidores conservan copias idénticas de la configuración. Esta copia de seguridad le permite crear fácilmente otro grupo de servidores.

Ejemplo 1: Actualizar la versión de un grupo de servidores de StoreFront de tres nodos durante el tiempo de inactividad programado por mantenimiento

Esto describe la actualización de la versión de un grupo de servidores de StoreFront de tres servidores, A, B y C, durante el tiempo de inactividad programado.

1. Para inhabilitar el acceso de los usuarios al grupo de servidores, inhabilite la URL de equilibrio de carga. Esto impide que los usuarios se conecten a la implementación durante la actualización de versiones.

2. Utilice el servidor A para quitar los servidores B y C del grupo.

   Los servidores B y C se quedan “huérfanos” del grupo de servidores.

3. Para actualizar la versión del servidor A, ejecute el archivo de instalación de esta versión de StoreFront.
4. Compruebe que la versión del servidor A se haya actualizado correctamente.
5. En los servidores B y C, desinstale la versión actualmente instalada de StoreFront y, luego, instale la nueva versión de StoreFront.

6. Una los servidores B y C al servidor actualizado A para crear un grupo de servidores actualizado. Este grupo de servidores consta de un servidor actualizado (A) y dos servidores recién instalados (B y C).

   El proceso Incorporarse a un grupo de servidores existente propaga automáticamente todos los datos de configuración y de suscripción a los nuevos servidores B y C.

7. Compruebe que todos los servidores funcionan correctamente.
8. Para habilitar el acceso de los usuarios al grupo de servidores actualizado, habilite la URL de equilibrio de carga.

Ejemplo 2: Actualizar la versión de un grupo de servidores de StoreFront de tres nodos sin tiempo de inactividad programado

Esto describe la actualización de la versión de un grupo de servidores de StoreFront de tres servidores, A, B y C, sin tiempo de inactividad programado.

Antes de actualizar la versión de un grupo de servidores:

1. Exporte los datos de suscripción del servidor A mediante Export-STFStoreSubscriptions. Esta copia de seguridad es necesaria porque los servidores se restablecen a sus valores de fábrica más adelante en el proceso, lo que elimina los datos de suscripción y de configuración. Consulte Administrar datos de suscripción a un almacén.

2. Para inhabilitar el acceso de los usuarios al servidor C, inhabilite el servicio del equilibrador de carga que representa el servidor C. Esto impide que los usuarios se conecten al servidor C durante la actualización de versiones. Mantenga habilitado el servicio del equilibrador de carga que representan los servidores A y B, de modo que los usuarios puedan seguir utilizándolos.
3. Utilice el servidor A para quitar el servidor C del grupo. Los servidores A y B siguen ofreciendo acceso a los recursos de sus usuarios. El servidor C se ha quedado huérfano del grupo de servidores, y se han restablecido sus valores de fábrica.
4. Restablezca el servidor huérfano C a sus valores predeterminados de fábrica mediante Clear-STFDeployment.
5. Importe la configuración de StoreFront que exportó antes al servidor C mediante Import-STFConfiguration. El servidor C ahora tiene una configuración idéntica a la del grupo de servidores anterior. No es necesario repetir este paso más adelante. Solamente un servidor necesita una copia de los datos de configuración para propagarlos a los demás servidores que se unan al grupo.
6. Para actualizar la versión del servidor C, ejecute el archivo de instalación de esta versión de StoreFront. Ahora el servidor C tiene una configuración idéntica a la del grupo de servidores anterior y se actualiza a una nueva versión de StoreFront.
7. Importe los datos de suscripción que exportó antes al servidor C. No es necesario repetir este paso más adelante. Solamente un servidor necesita una copia de los datos de suscripción para propagarlos a los demás servidores que se unan al grupo.
8. Repita los pasos 2, 3, 4 y 6 con el servidor B (no repita el paso 5). Durante este tiempo, solo el servidor A ofrece a los usuarios acceso a los recursos. Por lo tanto, se recomienda seguir este paso durante períodos de poca actividad, donde se espere que la carga en el grupo de servidores de StoreFront sea mínima.
9. Incorpore el servidor B al servidor C mediante el proceso Incorporarse a un grupo de servidores existente. Esto proporciona una implementación de un solo servidor en la versión actual de StoreFront (servidor A) y un nuevo grupo de servidores de dos nodos en la nueva versión de StoreFront (servidores B y C).
10. Habilite los servicios del equilibrador de carga para el servidor B y C de modo que puedan tomar el relevo del servidor A.
11. Inhabilite el servicio del equilibrador de carga para el servidor A de modo que los usuarios se dirijan a los servidores recién actualizados B y C.
12. Repita los pasos del 2 al 6 con el servidor A. El proceso de actualización de versiones del grupo de servidores se ha completado. Los servidores A, B y C tienen datos de configuración y de suscripción idénticos al del grupo original.

Nota:

Durante el breve período en que el servidor A es el único servidor accesible, se pueden perder suscripciones (paso 9). Esto puede provocar que el nuevo grupo de servidores tenga una copia ligeramente obsoleta de la base de datos de suscripción después de la actualización de versiones y que se pierdan los nuevos registros de suscripción.

Esto no tiene ningún impacto funcional porque los datos de suscripción no son esenciales para que los usuarios puedan iniciar sesión e iniciar recursos. Sin embargo, los usuarios tendrían que volver a suscribirse a un recurso después de que el servidor A se haya restablecido a sus valores de fábrica y se haya unido al grupo recién actualizado. Aunque es poco probable que se pierdan bastantes registros de suscripción, es una consecuencia posible de la actualización en vivo de la versión de un entorno de producción de StoreFront sin tiempo de inactividad.

Configurar StoreFront

Cuando la consola de administración de Citrix StoreFront se inicia por primera vez, existen dos opciones disponibles.

• Cree una implementación. Configure el primer servidor de una nueva implementación de StoreFront. Las implementaciones de un servidor único son idóneas para la evaluación de StoreFront o para implementaciones pequeñas de producción. Después de configurar el primer servidor de StoreFront, puede agregar más servidores al grupo en cualquier momento para aumentar la capacidad de la implementación.
• Incorporarse a un grupo existente de servidores. Agregue otro servidor a una implementación existente de StoreFront. Seleccione esta opción para aumentar rápidamente la capacidad de la implementación de StoreFront. Se necesita equilibrio de carga externo para las implementaciones con varios servidores. Para agregar un servidor, necesita acceso a un servidor existente de la implementación. Citrix no recomienda más de 6 servidores en cada grupo de servidores.

Desinstale StoreFront

Además del producto en sí, la desinstalación de StoreFront conlleva la eliminación del servicio de autenticación, los almacenes, los sitios de Citrix Receiver para Web, las direcciones URL de XenApp Services y sus configuraciones asociadas. El servicio de suscripción de almacenes que contiene los datos de suscripción a aplicaciones de los usuarios también se elimina. En implementaciones de un solo servidor, la información sobre suscripciones a aplicaciones de los usuarios se pierde. No obstante, en implementaciones de varios servidores, estos datos se conservan en otros servidores del grupo. Los requisitos previos habilitados por el instalador de StoreFront, como las funciones de .NET Framework y los servicios de rol de Servidor web (IIS), no se eliminarán del servidor cuando se desinstala StoreFront.

1. Inicie sesión en el servidor de StoreFront con una cuenta con permisos de administrador local.
2. Cierre la consola de administración de StoreFront si está abierta.
3. Cierre las sesiones de PowerShell que se hayan utilizado para administrar StoreFront a través de su SDK de PowerShell.
4. En la pantalla Inicio o Aplicaciones de Windows, busque el mosaico de Citrix StoreFront y haga clic en él. Haga clic con el botón secundario en el icono y haga clic en Desinstalar.
5. En el cuadro de diálogo Programas y características, seleccione Citrix StoreFront y haga clic en Desinstalar para eliminar todos los componentes de StoreFront del servidor.
6. En el cuadro de diálogo Desinstalar Citrix StoreFront, haga clic en Sí. Cuando termine la desinstalación, haga clic en Aceptar.