Automatisierte Installation und Konfiguration (AppFabric 1.1-Cache)
In diesem Abschnitt werden die Schritte für die automatische Installation und Konfiguration der Microsoft AppFabric 1.1 für Windows Server-Cache-Funktionen erläutert. In einer unbeaufsichtigten Installation wird dem Benutzer keine Benutzeroberfläche angezeigt, da alle Optionen an der Befehlszeile angegeben werden. Für das Hinzufügen eines Cachehosts zu einem Cachecluster oder für das Entfernen eines Cachehosts aus einem Cachecluster ist eine bestimmte Reihenfolge von Befehlen erforderlich. In diesem Abschnitt werden die Befehle für beide Szenarien beschrieben. Beachten Sie, dass außerdem die Möglichkeit besteht, den AppFabric-Konfigurations-Assistenten zum Konfigurieren der Cachefunktionen mithilfe einer Benutzeroberfläche zu verwenden. Weitere Informationen zum AppFabric-Konfigurations-Assistenten finden Sie unter Konfigurieren von Windows Server AppFabric.
In diesem Abschnitt sind die Schritte für die automatische Installation in fünf Aufgaben unterteilt:
Installieren der Windows Server AppFabric-Cachefeatures
Erstellen eines neuen Cacheclusters
Hinzufügen eines Cachehosts
Entfernen eines Cachehosts
Entfernen eines Cacheclusters
PowerShell-Skripts zum Automatisieren dieser Schritte finden Sie in diesen Beispielen:
Tipp
Informationen über die Grundlagen zum Starten und Ausführen von Windows PowerShell-Befehlen finden Sie unter Verwenden von Windows PowerShell zum Verwalten der Cachefunktionen von Windows Server AppFabric. Beachten Sie, dass es vor dem Ausführen dieser Befehle ggf. erforderlich ist, Import-Module zum Importieren der Windows PowerShell-Module für die Verwaltung (DistributedCacheAdministration) oder die Konfiguration (DistributedCacheConfiguration) zu verwenden.
Tipp
Obwohl einige der folgenden Befehle lokal auf dem Zielcachehost ausgeführt werden müssen, unterstützt Windows PowerShell die Ausführung von Befehlen auf Remotecomputern. Weitere Informationen finden Sie unter Ausführen von Remotebefehlen
Installieren der Microsoft AppFabric 1.1 für Windows Server-Cache-Funktionen
Bevor Sie einen neuen Cachecluster erstellen oder AppFabric-Cache auf einem Cachehost konfigurieren, müssen Sie die Microsoft AppFabric 1.1 für Windows Server-Cache-Funktionen zuerst installieren. Weitere Informationen zur unbeaufsichtigten Installation von AppFabric finden Sie unter Automatische Installation. Zu den Cachefeatures zählen:
CachingService
CacheClient
CacheAdmin
Betrachten Sie beispielsweise ein Szenario, in dem die Installationsbinärdatei den Namen Setup.exe aufweist. Beachten Sie, dass der tatsächliche Name der Binärdatei sich je nach der gewählten Plattform unterscheidet. Das folgende Beispiel veranschaulicht eine unbeaufsichtigte Installation der AppFabric-Cache-Funktionen auf einem Server:
Setup.exe /install /i cachingservice,cacheclient,cacheadmin /l:c:\temp\setup.log
Beachten Sie, dass in diesem Beispiel außerdem die Protokolldatei unter C:\temp\setup.log gespeichert wird. Sie können diese Protokolldatei untersuchen, um das Ergebnis der Installation zu ermitteln. Microsoft AppFabric 1.1 für Windows Server beinhaltet außerdem eine neue Option p zum Angeben des Installationspfads für AppFabric.
Nachdem die AppFabric-Cache-Funktionen auf einem Computer installiert wurden, müssen sie konfiguriert werden. In den folgenden Abschnitten werden die Schritte zum Automatisieren dieses Vorgangs beschrieben.
Erstellen eines neuen Cacheclusters
Beim Erstellen eines neuen Cacheclusters muss zuerst der Befehl New-CacheCluster der Windows PowerShell aufgerufen werden. Beim Erstellen eines neuen Cacheclusters müssen Sie sich entscheiden, wo die Clusterkonfigurationseinstellungen gespeichert werden sollen. Sie können sich für die Verwendung des Anbieters System.Data.SqlClient, des Anbieters XML oder eines benutzerdefinierten Anbieters entscheiden. Weitere Informationen finden Sie unter Konfigurationsmodell.
Im folgenden Beispiel wird ein kleiner Cachecluster erstellt. Die Konfigurationseinstellungen werden hier auf einem SQL Server-Computer mit dem Namen SQLServer1 mit einer vorhandenen Datenbank mit dem Namen CacheClusterConfigurationDB gespeichert.
New-CacheCluster -Provider System.Data.SqlClient -ConnectionString "Data Source=SQLServer1;Initial Catalog=CacheClusterConfigurationDB;Integrated Security=True" -Size Small
Hinweis
Beachten Sie, dass beim Verwenden von SQL Server-Datenbankspiegelung zum Erhöhen der Verfügbarkeit des Cacheclusters der Failoverpartner in der Verbindungszeichenfolge angegeben werden muss. Weitere Informationen finden Sie unter SQL Server-basierte Clusterkonfiugration.
Im folgenden Beispiel wird ein großer Cachecluster erstellt. Hier werden die Konfigurationseinstellungen in einer XML-Datei auf einer Netzwerkfreigabe mit dem Namen \\Server1\CacheConfigShare gespeichert.
New-CacheCluster -Provider XML -ConnectionString "\\Server1\CacheConfigShare" -Size Large
In beiden Beispielen muss der Aufrufer über die passenden Berechtigungen für den Speicherort des Konfigurationsspeichers verfügen. Für System.Data.SqlClient muss der Aufrufer ein db_owner in der Zieldatenbank oder ein Mitglied der sysadmin-Rolle in der SQL Server-Instanz sein. Für XML muss der Aufrufer über Besitzerberechtigungen auf dem freigegebenen Ordner verfügen.
Hinzufügen eines Cachehosts
Zum Hinzufügen eines Cachehosts zu einem vorhandenen Cachecluster müssen die folgenden Schritte in der angegebenen Reihenfolge ausgeführt werden:
| Befehl/Schritt | Beschreibung |
|---|---|
Register-CacheHost |
Registrieren des Cachehosts beim Cachecluster. |
Add-CacheHost |
Konfigurieren des Cachehosts als Teil des Cacheclusters. |
Add-CacheAdmin |
Optionales Konfigurieren der Cacheverwaltung auf dem aktuellen Cachehost. |
Konfigurieren der Firewall |
Durchlassen des AppFabricCachingService-Dienstverkehrs durch die Firewall. Außerdem Zulassen der Remotedienstverwaltung. |
Start-CacheHost |
Starten des neuen Cachehosts. |
Register-CacheHost
Sie verwenden den Befehl Register-CacheHost, um einen Cachehost bei einem vorhandenen Cachecluster zu registrieren. Die umfasst auch das Angeben von Portnummern und des Windows-Kontos für den Cachedienst. Die Parameter Provider und ConnectionString geben den Zielcachecluster für den neuen Cachehost an.
Im folgenden Beispiel wird der Cachehostcomputer CacheServer1 einem Cachecluster hinzugefügt, dessen Konfigurationsspeicher sich in einer XML-Datei auf der Dateifreigabe \\Server1\CacheConfigShare befindet. Das integrierte Konto NT Authority\Network Service ist für die Identität des Cachediensts angegeben.
Register-CacheHost -Provider XML -ConnectionString "\\Server1\CacheConfigShare" -Account "NT Authority\Network Service" -CachePort 22233 -ClusterPort 22234 -ArbitrationPort 22235 -ReplicationPort 22236 -HostName CacheServer1
Beachten Sie, dass für den Anbieter XML der Aufrufer über Vollzugriff für die Ziel-Netzwerkfreigabe verfügen muss. Für den Anbieter System.Data.SqlClient muss der Aufrufer über die Berechtigungen zum Lesen, Schreiben und Erstellen von SQL-Anmeldungen sowie zum Hinzufügen von Berechtigungen zur Zieldatenbank verfügen.
Im Gegensatz zu vielen anderen Konfigurationsbefehlen akzeptiert der Befehl Register-CacheHost einen HostName-Parameter, sodass er remote ausgeführt werden kann.
Add-CacheHost
Der Befehl Add-CacheHost konfiguriert den Cachehost als Teil des vorhandenen Cacheclusters. Die Parameter Provider und ConnectionString geben den Zielcachecluster für den neuen Cachehost an.
Im folgenden Beispiel wird der Aufruf von Add-CacheHost beschrieben.
Add-CacheHost -Provider XML -ConnectionString "\\Server1\CacheConfigShare" -Account "NT Authority\Network Service"
Beachten Sie, dass dieser Befehl lokal auf dem zu konfigurierenden Cachehost ausgeführt werden muss. Ferner muss dieser Befehl mit Administratorberechtigungen in einer Windows PowerShell-Sitzung mit erhöhten Rechten ausgeführt werden.
Warnung
Sie müssen einen Wert für den Parameter Account für den Befehl Add-CacheHost angeben. Wenn Sie kein Konto angeben, werden die Berechtigungen für den Cachedienst nicht ordnungsgemäß konfiguriert. Beachten Sie, dass in einer Domänenumgebung mit aktivierter Sicherheit das Konto NT Autority\Network Service verwendet werden muss.
Add-CacheAdmin
Optional kann der Befehl Add-CacheAdmin zum Konfigurieren des Cacheverwaltungsfeatures auf einem Cachehost verwendet werden. Auf diese Weise besteht die Möglichkeit, den Cachecluster von diesem Computer aus mithilfe von Windows PowerShell-Befehlen zu verwalten. Die Cacheverwaltungsfunktion muss auf dem Computer installiert sein.
Im folgenden Beispiel wird der Aufruf von Add-CacheAdmin beschrieben.
Add-CacheAdmin -Provider XML -ConnectionString "\\Server1\CacheConfigShare"
Beachten Sie, dass dieser Befehl lokal auf dem zu konfigurierenden Cachehost ausgeführt werden muss. Ferner muss er mit Administratorberechtigungen in einer Windows PowerShell-Sitzung mit erhöhten Rechten ausgeführt werden.
Konfigurieren der Firewall
Damit die AppFabric-Cache-Funktionen erfolgreich verwendet werden können, müssen Sie die Firewall für den DistributedCacheService.exe-Dienst konfigurieren. Dieser Dienst wird standardmäßig im Verzeichnis C:\Programme\Windows Server AppFabric installiert.
Wenn Sie die Windows-Firewall verwenden, können Sie eine Firewall-Richtliniengruppe aktivieren, die automatisch zusammen mit AppFabric installiert wird. Mithilfe der folgenden Windows PowerShell-Befehle wird die Firewall-Richtliniengruppe mit dem Namen "Microsoft AppFabric 1.1 für Windows Server: AppFabric-Cache-Dienst" aktiviert. Darüber hinaus sollten Sie die Firewallregeln "Remotedienstverwaltung" aktivieren, um die Remotesteuerung durch den AppFabric-Cache-Dienst zu ermöglichen.
netsh advfirewall firewall set rule group="Windows Server AppFabric: AppFabric Caching Service" new enable=Yes
netsh advfirewall firewall set rule name="Remote Service Management (RPC)" profile=domain new enable=Yes
netsh advfirewall firewall set rule name="Remote Service Management (RPC-EPMAP)" profile=domain new enable=Yes
netsh advfirewall firewall set rule name="Remote Service Management (NP-In)" profile=domain new enable=Yes
Start-CacheHost
Wenn Sie den neuen Cachehost für die Mitwirkung beim Cachecluster aktivieren möchten, müssen Sie den Cachehost starten. Wenn der Cachecluster außer Betrieb ist, müssen Sie den gesamten Cachecluster starten. Der Cachecluster ist außer Betrieb, wenn alle ihm angehörenden Hosts außer Betrieb sind. Dies kann durch den Aufruf von Get-CacheHost ohne Parameter überprüft werden.
Get-CacheHost
Wenn alle Hosts den Dienststatus DOWN aufweisen, starten Sie den Cachecluster mit dem Befehl Start-CacheCluster.
Start-CacheCluster
Wenn jedoch mindestens ein Host den Dienststatus UP aufweist, wird der Cachecluster ausgeführt. Verwenden Sie in diesem Fall den Befehl Start-CacheHost.
Start-CacheHost -Hostname CacheServer2 -CachePort 22233
Beachten Sie, dass der Cachedienst nach dem Neustart eines Cachehostcomputers nicht automatisch gestartet wird. Je nach dem Status des Cacheclusters sollten Sie entweder Start-CacheHost oder Start-CacheCluster verwenden.
Ferner muss dieser Befehl mit Administratorberechtigungen in einer Windows PowerShell-Sitzung mit erhöhten Rechten ausgeführt werden.
Warnung
Verwenden Sie zum Starten und Beenden des Cachediensts immer die Windows PowerShell-Befehle. Starten oder beenden Sie den AppFabricCachingService-Dienst niemals direkt aus dem Programm Dienste in Verwaltung.
Entfernen eines Cachehosts
Zum Entfernen eines Cachehosts aus einem Cachecluster müssen die folgenden Schritte in der angegebenen Reihenfolge ausgeführt werden:
| Befehl/Schritt | Beschreibung |
|---|---|
Stop-CacheHost |
Beenden des Cachehosts, falls er ausgeführt wird. |
Unregister-CacheHost |
Aufheben der Registrierung des Cachehosts beim Cachecluster. |
Remove-CacheHost |
Entfernen der Cachehostkonfiguration vom Computer. |
Remove-CacheAdmin |
Optional Entfernen der Konfiguration des Cacheverwaltungsfunktionen. |
Konfigurieren der Firewall |
Entfernen aller Firewallausnahmen für den Cachedienst. |
Stop-CacheHost
Wenn Sie einen Cachehost aus einem vorhandenen Cluster entfernen möchten, müssen Sie den Cachehost zuerst beenden. Sie können bestimmen, ob der Cachehost ausgeführt wird, indem Sie den Befehl Get-CacheHost aufrufen. Im folgenden Beispiel wird verdeutlicht, wie die Cachehostinformationen für den lokalen Cachehost angezeigt werden können.
Get-CacheHost -HostName localhost -CachePort 22233
Obwohl Ihnen der vorhergehende Befehl Informationen zu einem bestimmten Cachehost gibt, sollten Sie immer den Status des gesamten Cacheclusters berücksichtigen, bevor Sie einen der Cachehosts beenden. Dies kann durch den Aufruf von Get-CacheHost ohne Parameter erfolgen.
Get-CacheHost
Das folgende Beispiel zeigt Musterausgaben dieses Befehls für einen aus zwei Servern bestehenden Cachecluster.
HostName : CachePort Service Name Service Status Version Info
-------------------- ------------ -------------- ------------
CacheServer1:22233 AppFabricCachingService UP 1 [1,1][1,1]
CacheServer2:22233 AppFabricCachingService UP 1 [1,1][1,1]
Im Beispiel werden sowohl CacheServer1 als auch CacheServer2 ausgeführt. Sie können versuchen, einen dieser Cachehosts zu beenden und den Betrieb des Cacheclusters mithilfe des anderen Cachehosts aufrecht zu erhalten. Im folgenden Beispiel wird das Beenden von CacheServer2 mit dem Befehl Stop-CacheHost gezeigt.
Stop-CacheHost -HostName CacheServer2 -CachePort 22233 -Graceful
Beachten Sie die Verwendung des Schalters Graceful. Dieser Schalter wurde für die Version v1.1 hinzugefügt, um Daten vor dem Herunterfahren vom Cacheserver auf andere Cachehosts zu verschieben. Ohne den Schalter Graceful gehen alle auf dem beendeten Cachehost zwischengespeicherten Daten verloren. Darüber hinaus tritt beim Versuch, den Cachehost zu beenden, ein Fehler auf, wenn er zum Verlust des Quorums für führende Hosts oder sekundäre Hosts führen würde. Weitere Informationen zu führenden Hosts finden Sie unter Führende Hosts und Clusterverwaltung. Weitere Informationen zu sekundären Hosts finden Sie unter Hohe Verfügbarkeit. In diesen Fällen müssen Sie den gesamten Cluster mithilfe des Befehls Stop-CacheCluster beenden.
Wenn das Beenden des Cachehosts zum Beenden des Cacheclusters führen würde, verwenden Sie stattdessen den Befehl Stop-CacheCluster. Untersuchen Sie z. B. die folgende Beispielausgabe des Befehls Get-CacheHost.
HostName : CachePort Service Name Service Status Version Info
-------------------- ------------ -------------- ------------
CacheServer1:22233 AppFabricCachingService DOWN 1 [1,1][1,1]
CacheServer2:22233 AppFabricCachingService UP 1 [1,1][1,1]
In diesem Beispiel wird CacheServer1 beendet und CacheServer2 ausgeführt. Das Beenden von CacheServer2 würde zum Beenden des Clusters führen. Verwenden Sie statt des Befehls Stop-CacheHost zum Beenden von CacheServer2 den Befehl Stop-CacheCluster.
Stop-CacheCluster
Dieser Befehl muss mit Administratorberechtigungen in einer Windows PowerShell-Sitzung mit erhöhten Rechten ausgeführt werden.
Unregister-CacheHost
Der Befehl Unregister-CacheHost entfernt den Cachehost aus dem Cachecluster.
Warnung
Stop-CacheHost muss aufgerufen werden, um einen Cachehost zu beenden, bevor dessen Registrierung aufgehoben wird. Geschieht dies nicht, besteht die Möglichkeit eines Dienstabsturzes.
Wenn der Befehl vor Remove-CacheHost ausgeführt wird, müssen Sie keine Werte für die Parameter Provider oder ConnectionString angeben. Wenn der Befehl lokal ausgeführt wird, müssen Sie für den Parameter HostName ebenfalls keinen Wert eingeben.
Unregister-CacheHost -RemoveServicePermissions
Im folgenden Beispiel wird die Registrierung eines Cachehosts durch Angeben des Anbieters, der Verbindungszeichenfolge und des Hostnamens aufgehoben. Hier wird ein Cachehost mit dem Namen CacheServer2 aus einem Cachecluster entfernt. Für diesen Cachecluster wird der Anbieter System.Data.SqlClient verwendet, daher ist die Verbindungszeichenfolge eine SQL Server-Verbindungszeichenfolge zu einem Datenbankserver mit dem Namen SQLServer1 und einer Konfigurationsdatenbank mit dem Namen CacheClusterConfigurationDB.
Unregister-CacheHost -Provider System.Data.SqlClient -ConnectionString "Data Source=SQLServer1;Initial Catalog=CacheClusterConfigurationDB;Integrated Security=True" + -HostName CacheServer2 -RemoveServicePermissions
Beachten Sie, dass für den Anbieter XML der Aufrufer über Vollzugriff für die Ziel-Netzwerkfreigabe verfügen muss. Für den Anbieter System.Data.SqlClient muss der Aufrufer über die Berechtigungen zum Lesen, Schreiben und Entfernen von SQL-Anmeldungen sowie zum Entfernen von Berechtigungen zur Zieldatenbank verfügen.
Im Gegensatz zu vielen anderen Konfigurationsbefehlen akzeptiert der Befehl Unregister-CacheHost einen HostName-Parameter, sodass er remote ausgeführt werden kann.
Remove-CacheHost
Der Befehl Remove-CacheHost entfernt die Cachehostkonfiguration vom Server.
Remove-CacheHost
Beachten Sie, dass dieser Befehl lokal auf dem zu konfigurierenden Cachehost ausgeführt werden muss. Ferner muss dieser Befehl mit Administratoranmeldeinformationen in einer Windows PowerShell-Sitzung mit erhöhten Rechten ausgeführt werden.
Remove-CacheAdmin
Wenn die Cacheverwaltungsfunktion auf dem Cachehost konfiguriert ist, können Sie diese mit dem Befehl Remove-CacheAdmin entfernen.
Remove-CacheAdmin
Beachten Sie, dass dieser Befehl lokal auf dem zu konfigurierenden Cachehost ausgeführt werden muss. Ferner muss dieser Befehl mit Administratoranmeldeinformationen in einer Windows PowerShell-Sitzung mit erhöhten Rechten ausgeführt werden.
Konfigurieren der Firewall
Alle Ausnahmen für den Cachedienst DistributedCacheService.exe in der Firewall sollten entfernt oder deaktiviert werden. Wenn Sie die Windows-Firewall verwenden, sollten Sie zuvor die installierte Firewallgruppe "Microsoft AppFabric 1.1 für Windows Server: AppFabric-Cache-Dienst" aktiviert haben. In diesem Fall können Sie diese Richtliniengruppe mithilfe der folgenden PowerShell-Befehle deaktivieren. Wenn Sie darüber hinaus die Regeln für die "Remotedienstverwaltung" aktiviert haben, können Sie auch diese Regeln deaktivieren. Allerdings können andere Dienste oder Anwendungen die Regeln für die "Remotedienstverwaltung" aktiviert haben. In diesem Szenario sollten Sie die Regeln für die "Remotedienstverwaltung" nicht deaktivieren.
netsh advfirewall firewall set rule group="Windows Server AppFabric: AppFabric Caching Service" new enable=No
netsh advfirewall firewall set rule name="Remote Service Management (RPC)" profile=domain new enable=No
netsh advfirewall firewall set rule name="Remote Service Management (RPC-EPMAP)" profile=domain new enable=No
netsh advfirewall firewall set rule name="Remote Service Management (NP-In)" profile=domain new enable=No
Entfernen eines Cacheclusters
Wenn Sie den letzten Cachehost aus dem Cluster entfernt haben, können Sie sich außerdem entscheiden, den Cachecluster-Konfigurationsspeicher zu entfernen. Verwenden Sie zu diesem Zweck den Befehl Remove-CacheCluster. Wenn der Cachecluster den Anbieter XML verwendet, löscht dieser Befehl die XML-Datei mit den Konfigurationseinstellungen. Wenn der Cachecluster den Anbieter System.Data.SqlClient verwendet, löscht dieser Befehl die Tabellen in der angegebenen Datenbank. Beachten Sie, dass die Dateifreigabe und die Datenbank nicht entfernt werden.
Remove_CacheCluster -Provider System.Data.SqlClient -ConnectionString "Data Source=SQLServer1;Initial Catalog=CacheClusterConfigurationDB;Integrated Security=True"
Siehe auch
Konzepte
Bereitstellen und Konfigurieren von AppFabric-Cachefunktionen (AppFabric 1.1-Cache)
2012-03-05