Administración de granjas de servidores y nodos
Los cmdlets descritos en esta sección sirven para crear y eliminar las granjas de servidores y sus nodos.
Crear una granja de servidores Service Bus para Windows Server
El cmdlet New-SBFarm crea una granja de servidores de nodos de Service Bus para Windows Server. Para crear una granja de servidores con certificados generados automáticamente, use el siguiente formato:
New-SBFarm [-AdminGroup <String>] [-GatewayDBConnectionString <String>] [-HttpsPort <Int32>]
[-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>] [-MessageContainerDBConnectionString <String>]
[-RunAsAccount <String>] [-TcpPort <Int32>] -CertificateAutoGenerationKey <SecureString> -SBFarmDBConnectionString <String>
Para crear una granja de servidores con certificados personalizados, use el siguiente formato:
New-SBFarm [-AdminGroup <String>] [-EncryptionCertificateThumbprint <String>] [-GatewayDBConnectionString
<String>] [-HttpsPort <Int32>] [-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>]
[-MessageContainerDBConnectionString <String>] [-RunAsAccount <String>] [-TcpPort <Int32>]
-FarmCertificateThumbprint <String> -SBFarmDBConnectionString <String>
Si se produce un error o si fuera necesario reiniciar el sistema durante la creación de la granja de servidores, la base de datos de administración de granjas de servidores creada puede quedar dañada. En este caso, al intentar unir una granja de servidores, es posible que el proceso muestre un error que indica que el equipo que intenta agregar a la granja de servidores no forma parte de ninguna granja. Si se produce este tipo de error, deberá descartar la base de datos de administración de granjas de servidores y volver a crearla antes de poder unir nodos nuevos a la granja de servidores.
En la siguiente tabla, se describen las opciones de este cmdlet.
| Opción | Efecto |
|---|---|
– SBFarmDBConnectionString <connectionstring> |
Representa una cadena de conexión de la base de datos de configuración. |
-Admingroup <adgroup> |
Especifica el grupo de usuarios cuyos miembros reciben el acceso administrativo a las bases de datos de la granja de servidores. El valor predeterminado es el grupo BuiltIn\Administrators del equipo. |
-CertificateAutoGenerationKey <SecureString>] |
Representa la clave que el instalador usa para generar el nuevo certificado SSL de servicios para proteger las comunicaciones entre los servicios y sus clientes. |
-MessageContainerDBConnectionString <connstring> |
Especifica la cadena de conexión para la instancia de base de datos utilizada como base de datos de contenedor. |
-MessageBrokerPort <portno> |
Especifica el puerto que se usará para la comunicación del agente de mensajería. El valor predeterminado es 9356. |
-HttpsPort <portno> |
Especifica el puerto que se usará para la comunicación https. El valor predeterminado es 9355. |
-InternalPortRangeStart <portrange> |
Especifica el intervalo de puertos que los nodos de Service Bus para Windows Server de Windows Fabric utilizan para comunicarse entre sí. El parámetro portrange es un único número de puerto que representa el primero de un intervalo de seis puertos consecutivos. |
-GatewayDBConnectionString <connstring> |
Especifica la cadena de conexión para la instancia de base de datos utilizada como base de datos de puerta de enlace. La base de datos de puerta de enlace administra y equilibra la carga de las solicitudes entrantes. |
-TCPPort <portno> |
Especifica el puerto que los nodos de Service Bus para Windows Server utilizan para comunicarse entre sí. El valor predeterminado es 9354. |
-EncryptionCertificateThumbprint <string> |
Certificado que se usa para la seguridad de las cadenas de conexión SQL. Si no se proporciona, obtendrá el valor de SslCertificate. Representa el certificado de cifrado. |
-FarmCertificateThumbprint <string> |
Certificado que se usa para la seguridad del certificado. No proporcione este certificado si proporciona el valor CertificateAutoGenerationKey para la generación automática de certificados. |
Agregar un nuevo nodo a una granja de servidores
El cmdlet Add-SBHost agrega un nodo a una granja de servidores existente. El cmdlet Add-SBHost tiene el siguiente formato:
Add-SBHost [-CertificateAutogenerationKey <SecureString>] [-ExternalBrokerPort <Int32>] [-ExternalBrokerUrl <Uri>] -EnableFirewallRules <Boolean> -RunAsPassword <SecureString> -SBFarmDBConnectionString <String>
En la siguiente tabla, se describen las opciones de este cmdlet.
| Opción | Efecto |
|---|---|
– SBFarmDBConnectionString <connectionstring> |
Especifica la cadena de conexión para la instancia de SQL Server que se agrega como base de datos de administración de la granja de servidores. |
-RunAsPassword <SecureString> |
Especifica la contraseña de la cuenta de usuario bajo la que se ejecutan servicios en la granja de servidores. Si todos los equipos de una granja de servidores comparten la misma cuenta de servicio y la directiva de seguridad requiere que la contraseña de la cuenta de servicio cambie en intervalos periódicos, deberá realizar acciones específicas en cada equipo de la granja con el fin de poder seguir agregando y quitando nodos en ella. Consulte la sección Gestionar los cambios de contraseña de la granja de servidores para este procedimiento. |
-CertificateAutoGenerationKey <SecureString>] |
Especifica la clave que la granja de servidores usa para proteger los certificados generados automáticamente. |
-EnableFirewallRules <Boolean> |
Si true, las reglas de firewall se habilitarán en el host. |
-ExternalBrokerPort <Int32> |
Representa el puerto que Service Bus para Windows Server usa para la comunicación ExternalBroker. |
-ExternalBrokerUrl <Uri> |
Especifica un URI de ExternalBroker que distingue entre mayúsculas y minúsculas. |
El programa de instalación genera automáticamente el siguiente certificado basado en sus selecciones cuando agrega el nodo a la granja de servidores:
| Tipo de certificado | Nombre | Emisor |
|---|---|---|
CA |
AppServerGeneratedSBCA |
|
FarmCertificate |
AppServerGeneratedSBCA |
AppServerGeneratedSBCA |
Quitar un nodo de una granja de servidores
El cmdlet Remove-SBHost quita un nodo de una granja de servidores existente. Si la granja de servidores se encuentra en estado detenido cuando se ejecuta este cmdlet, pueden producirse errores o advertencias. Puede omitir los errores y las advertencias y ejecutar Start-SBFarm después de Remove-SBHost para que los cambios surtan efecto. Si la granja de servidores se encuentra en estado de ejecución, no es necesario ejecutar Start-SBFarm.
El cmdlet tiene el siguiente formato:
Remove-SBHost [-SBFarmDBConnectionString <string>] [-HostName <string>] [<CommonParameters>]
En la siguiente tabla, se describen las opciones de este cmdlet.
| Opción | Efecto |
|---|---|
– SBFarmDBConnectionString <connectionstring> |
Especifica la cadena de conexión para la instancia de SQL Server que se quita de la granja de servidores. Si no proporciona este parámetro, el cmdlet encontrará la cadena de conexión en el registro. |
-HostName<String> |
Nombre del host que se va a quitar. Si no proporciona este parámetro el host en el que se ejecuta el cmdlet se quitará. Nota Debe proporcionar un HostName en el caso de que el host ya no esté disponible y que desee borrar la configuración de la granja de servidores. |
Si desea cambiar el nombre de un equipo que pertenece a una granja de servidores, debe usar este cmdlet para quitar el equipo de la granja de servidores antes de cambiarle el nombre. A continuación, agréguelo de nuevo mediante el cmdlet Add-SBHost. Si el cmdlet se encuentra con un error de tiempo de espera, puede ejecutar el cmdlet Add-SBHost para intentar agregarlo de nuevo a la granja de servidores. Si Add-SBHost se ejecuta correctamente, puede omitir el error de tiempo de espera.
Cuando salga de una granja de servidores, el desinstalador mantendrá los certificados que haya instalado en el equipo. Si desea eliminar dichos certificados, tendrá que hacerlo manualmente.
Cuando reduzca la granja de servidores a una granja de un solo equipo, debe eliminar todos los equipos de la granja de servidores. Después debe volver a agregar el equipo que desea que forme parte de la granja de servidores.
Fecha de compilación:
2013-07-25