Mit der Esri arcgis-datastore-cluster-upgrade.template.json Amazon Web Services (AWS) CloudFormation-Vorlage wird ein Upgrade eines ArcGIS Data Store der Version 10.9 oder 10.9.1 vom Typ "Kachel-Cache" oder "spatiotemporal" auf mehreren Amazon Elastic Compute Cloud (EC2)-Instanzen durchgeführt, die Sie unter Verwendung der Vorlage erstellt haben, die unter Bereitstellen eines ArcGIS Data Store im Cluster-Modus unter Verwendung von CloudFormation beschrieben ist.
Mit der Vorlage arcgis-datastore-cluster-upgrade.template.json wird ein Upgrade für ArcGIS Data Store auf mehreren EC2-Instanzen durchgeführt.
Voraussetzungen
Die Voraussetzungen können nach den Elementen (zum Beispiel Dateien und Konten), die Sie abrufen müssen, und den Tasks, die Sie ausführen müssen, bevor die CloudFormation-Vorlage ausgeführt wird, gruppiert werden.
Erforderliche Elemente
Bevor diese Vorlage ausgeführt wird, benötigen Sie die folgenden Elemente:
- Ein Amazon Web Services-Konto mit Zugriff auf die Bereitstellung, für die ein Upgrade durchgeführt werden soll.
- Eine vorhandene ArcGIS Data Store-Bereitstellung im Cluster-Modus, die Sie mithilfe der Esri Amazon Web Services CloudFormation-Vorlage arcgis-datastore-cluster.template.json erstellt haben.
- Die CloudFormation-Upgradevorlage arcgis-datastore-cluster-upgrade.template.json.
Hinweis:
Wenn Sie für Ihre Bereitstellung ein Upgrade durchführen möchten, führen Sie diese UpgradeCloudFormation-Vorlage aus, mit der ein neuer CloudFormation-Stack erstellt wird. Aktualisieren Sie den CloudFormation-Stack der vorhandenen 10.9- oder 10.9.1-Bereitstellung nicht mithilfe dieser Vorlage.
Erforderliche Tasks
Bevor diese Vorlage ausgeführt wird, müssen Sie die folgenden Schritte durchführen:
- Sie müssen das Upgrade der ArcGIS GIS Server-Site (des Hosting-Servers), bei der dieser Data Store registriert ist, vor dem Upgrade von ArcGIS Data Store durchführen.
- Konfigurieren Sie Kennwörter in AWS Secrets Manager (optional, aber empfohlen).
Die Kennwörter für Konten, wie zum Beispiel den Benutzernamen des Site-Administrators und das Windows-Kennwort für den arcgis-Benutzer, können Sie in AWS Secrets Manager konfigurieren. Damit wird Ihnen ein geheimer Amazon-Ressourcenname (ARN) bereitgestellt. Verwenden Sie den ARN anstelle eines Kennworts in den Vorlagenparametern, wenn Sie einen Stack starten. Wenn Sie AWS Secrets Manager nicht zum Speichern von Kennwörtern verwenden, dann müssen Sie in den Vorlagenparametern die Kennwörter in Klartext eingeben, wenn Sie den Stack starten.
Hinweis:
Beim Erstellen eines geheimen ARN in AWS Secrets Manager für ein Kennwort zur Verwendung mit Esri CloudFormation-Vorlagen müssen Sie Other types of secrets als Secret-Typ und die Option Plaintext verwenden. Weitere Informationen zum Erstellen eines Amazon-Ressourcennamens für Kennwörter finden Sie unter AWS CloudFormation und ArcGIS.
Tipp:
Standardmäßig löscht CloudFormation bei einer fehlgeschlagenen Stack-Erstellung die teilweise erstellten Ressourcen. Dies ist hilfreich, da dabei in Ihrem Konto unbrauchbare Bereitstellungen entfernt werden, kann aber auch die Problembehandlung erschweren. Wenn der Stack in seinem fehlerhaften Zustand erhalten bleiben soll, dann deaktivieren Sie die Option Rollback bei Fehler für die Erstellung eines CloudFormation-Stacks, bevor Sie den Stack starten. Weitere Informationen finden Sie unter Festlegen von AWS CloudFormation-Optionen in der AWS-Hilfe.
Parameter
Die folgenden Tabellen enthalten Beschreibungen der Parameter, die in dieser CloudFormation-Vorlage verwendet werden. Die Tabellen sind nach Parametertyp gruppiert.
ArcGIS Data Store Configuration
| Parametername | Erforderlich? | Parameterbeschreibung |
|---|---|---|
Platform Type | Erforderlich | Wählen Sie den Plattformtyp Ihrer vorhandenen ArcGIS Data Store-Bereitstellung aus.
|
Name der Auto Scaling-Gruppe | Erforderlich | Geben Sie den Namen der Auto Scaling-Gruppe an, in der der vorhandene ArcGIS Data Store-Cluster konfiguriert ist. Wenn Sie die vorhandene Bereitstellung mit einer Esri CloudFormation-Vorlage oder mit Cloud Builder erstellt haben, finden Sie den Namen der Auto Scaling-Gruppe in der AWS Management Console im Abschnitt Ressourcen des vorhandenen CloudFormation-Stacks. Die logische ID der Ressource lautet AutoScalingGroup. |
Type | Erforderlich | Wählen Sie den Data-Store-Typ Ihrer vorhandenen ArcGIS Data Store-Bereitstellung aus. Gültige Werte sind tileCache oder spatiotemporal. |
Windows arcgis user password | Bedingt | Dieses Kennwort ist nur dann erforderlich, wenn Sie unter Windows bereitgestellt haben. Geben Sie das Kennwort für den ArcGIS-Benutzer Ihrer vorhandenen Bereitstellung an. Sie können entweder ein Kennwort in Klartext oder den ARN Ihrer Secret-ID in AWS Secrets Manager eingeben. Es ist eine Empfehlung, Ihre Kennwörter in AWS Secrets Manager zu verwalten. Informationen zum Erstellen eines Amazon-Ressourcennamens für Kennwörter finden Sie unter AWS CloudFormation und ArcGIS. |
ArcGIS Server Configuration
| Parametername | Erforderlich? | Parameterbeschreibung |
|---|---|---|
Site Administrator User Name | Erforderlich | Geben Sie den Benutzernamen für den primären ArcGIS Server-Site-Administrator Ihrer vorhandenen Site an. |
Site Administrator User Password | Erforderlich | Geben Sie ein Kennwort für den primären ArcGIS Server Site-Administrator an. Sie können entweder ein Kennwort in Klartext oder den ARN Ihrer Secret-ID in AWS Secrets Manager eingeben. Weitere Informationen zum Erstellen eines Amazon-Ressourcennamens für Kennwörter finden Sie unter AWS CloudFormation und ArcGIS. Das Kennwort (bzw. die ID des geheimen Schlüssels), das Sie angeben, muss mit dem Kennwort (bzw. der Secret-ID) des vorhandenen primären Site-Administrators übereinstimmen. |
ArcGIS Server EC2 Instance ID | Erforderlich | Wählen Sie eine EC2-Instanz-ID in der ArcGIS Server-Site aus, mit der der Data Store konfiguriert wurde. Hinweis:Wenn der Data Store bei einer ArcGIS Server-Site mit mehreren Computern registriert wird, können Sie die ID der einzelnen EC2-Instanzen in der ArcGIS Server-Site auswählen. Wählen Sie keine EC2-Dateiserverinstanz aus. |
Ausgaben
Wenn Ihr Stack erfolgreich erstellt wurde, werden die folgenden Ausgabeparameter auf der Registerkarte Outputs des CloudFormation-Stacks in AWS Management Console angezeigt.
| Ausgabename | Ausgabebeschreibung |
|---|---|
DeploymentLogsURL | Dies ist die URL für die Amazon CloudWatch-Protokolle, in der alle Bereitstellungsprotokolle gespeichert werden. In diesen Protokollen finden Sie Informationen zur Problembehebung, wenn Ihre Bereitstellung fehlgeschlagen ist. |
Überlegungen
Nach dem Erstellen eines CloudFormation-Stacks, der ArcGIS-Bereitstellungen enthält, sind die folgenden wichtigen Punkte zu beachten:
- Nachdem der Stack erstellt wurde (d. h, wenn der Stack-Status CREATE_COMPLETE lautet), bedeutet das, dass für die ArcGIS Data Store-Bereitstellung ein Upgrade durchgeführt wurde. Sie können dies überprüfen, indem Sie sich bei ArcGIS Server Manager anmelden und den Data Store überprüfen.
- Wenn beim Erstellen des CloudFormation-Stacks Fehler auftreten (d. h., wenn der Stack-Status CREATE_FAILED lautet), können Sie den Fehler beheben, wie auf der Seite beschrieben, auf die im Abschnitt "Fehlerbehebung" weiter unten verwiesen wird. Nachdem Sie die Fehlerursache ermittelt und die erforderlichen Maßnahmen ergriffen haben, können Sie den Stack, bei dem der Fehler aufgetreten ist, löschen und einen neuen Stack erstellen, um für die vorhandene ArcGIS Data Store-Bereitstellung ein Upgrade durchzuführen.
Problembehandlung
Wenn Sie beim Erstellen dieses CloudFormation-Stacks Fehler feststellen, dann finden Sie entsprechende Informationen unter Problembehandlung bei ArcGIS-Bereitstellungen unter AWS.