Mit der Esri arcgis-enterprise-allinone-upgrade.template.json Amazon Web Services (AWS) CloudFormation-Vorlage wird ein Upgrade einer ArcGIS Enterprise-Basisbereitstellung der Version 10.9 oder 10.9.1 auf einer Amazon Elastic Compute Cloud (EC2)-Instanz und einer EC2-Instanz für einen Dateiserver durchgeführt, die unter Verwendung der Vorlage erstellt wurde, die unter Bereitstellen einer ArcGIS Enterprise-Basisbereitstellung auf einem Computer unter Verwendung von CloudFormation beschrieben ist.
Mit der Vorlage arcgis-enterprise-allinone-upgrade.template.json wird ein Upgrade für die folgenden Komponenten auf einem einzelnen Computer auf AWS durchgeführt:
- Portal for ArcGIS
- ArcGIS Server
- ArcGIS Web Adaptor
- ArcGIS Data Store
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.
- Esri-Lizenzen. Lizenzdateien für Portal for ArcGIS und ArcGIS GIS Server sowie alle ArcGIS Server-Lizenzierungsrollen, über die Sie zusätzlich zur Basisbereitstellung verfügen. Alle Lizenzdateien müssen für die gleiche ArcGIS-Version gelten.
- Eine SSL-Zertifikatdatei oder Zertifikate (im .pfx-Format) und entsprechende Kennwörter. Die Zertifikate müssen von einer Zertifizierungsstelle stammen.
- Eine vorhandene ArcGIS Enterprise-Basisbereitstellung, die Sie mithilfe der Esri Amazon Web Services CloudFormation-Vorlage arcgis-enterprise-allinone.template.json erstellt haben.
- Die CloudFormation-Upgradevorlage arcgis-enterprise-allinone-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:
- Bereiten Sie einen Amazon Simple Storage Service (S3)-Bereitstellungs-Bucket in Ihrem AWS-Konto vor. Den Bucket-Namen geben Sie in der Vorlage an, wenn Sie den Stack starten.
- Erstellen Sie einen Bucket oder verwenden Sie einen vorhandenen S3-Bucket. Sie müssen der Besitzer des Bucket sein.
- Laden Sie Ihre ArcGIS-Softwareautorisierungsdateien an den Bucket hoch.
- Laden Sie Ihre SSL-Zertifikatdatei an den Bereitstellungs-Bucket hoch.
- 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
In der folgenden Tabelle sind die in dieser Vorlage verwendeten Parameter sowie eine Beschreibung der einzelnen Parameter aufgeführt.
ArcGIS Enterprise Configuration
| Parametername | Erforderlich? | Parameterbeschreibung |
|---|---|---|
Platform Type | Erforderlich | Wählen Sie den Plattformtyp Ihrer vorhandenen ArcGIS Enterprise-Bereitstellung aus.
|
ArcGIS Enterprise EC2 Instance ID | Erforderlich | Wählen Sie die ID der EC2-Instanz in Ihrer vorhandenen ArcGIS Enterprise-Bereitstellung aus. Wenn Sie die vorhandene Bereitstellung mit einer Esri CloudFormation-Vorlage oder mit ArcGIS Enterprise Cloud Builder for AWS erstellt haben, finden Sie die Instanz-ID in der AWS Management Console im Abschnitt Ressourcen des vorhandenen CloudFormation-Stacks. Die logische ID der Ressource lautet AllInOneEC2Instance. |
Deployment Bucket Name | Erforderlich | Geben Sie den Namen des Amazon S3-Bucket an, in dem Ihre Softwarelizenzdateien und SSL-Zertifikate enthalten sind. Dieser Bucket muss bereits vorhanden sein und die Lizenzdatei und das SSL-Zertifikat für Ihre Bereitstellung enthalten. Sie müssen der Besitzer des Bucket sein, und er muss sich in demselben AWS-Konto wie Ihre Bereitstellung befinden. |
Portal License File Name | Erforderlich | Geben Sie den Objektschlüsselnamen der Portal for ArcGIS-Autorisierungsdatei an. Bevor Sie diesen Stack starten, müssen Sie die Lizenzdatei (.json-Datei) in den Bucket der Bereitstellung hochladen. Den Objektschlüsselnamen der Datei können Sie abrufen, indem Sie zur Datei im Bucket der Bereitstellung in der AWS S3-Konsole navigieren, zum Beispiel portal.json oder resources/licenses/portal/portal.json. Bei den Namen von Lizenzdateien wird die Groß-/Kleinschreibung beachtet. Achten Sie darauf, dass Sie den richtigen Namen in der richtigen Schreibweise eingeben. |
Server License File Name | Erforderlich | Geben Sie den Objektschlüsselnamen der ArcGIS Server-Autorisierungsdatei an. Bevor Sie diesen Stack starten, müssen Sie die Lizenzdatei (.ecp oder .prvc) in den Bucket der Bereitstellung hochladen. Um den Objektschlüsselnamen der Datei abzurufen, navigieren Sie zur Datei im Bucket der Bereitstellung in der Amazon S3-Konsole, zum Beispiel server.prvc oder resources/licenses/server/server.prvc. Sie müssen eine ArcGIS GIS Server-Lizenz verwenden, da sie zum Lizenzieren des Hosting-Servers benötigt wird. Bei den Namen von Lizenzdateien wird die Groß-/Kleinschreibung beachtet. Achten Sie darauf, dass Sie den Namen richtig eingeben. |
Portal and Server Administrator User Name | Erforderlich | Geben Sie einen Benutzernamen für den initialen Portal-Administrator und den primären ArcGIS Server-Site-Administrator Ihrer vorhandenen Bereitstellung an. |
Portal and Server Administrator User Password | Erforderlich | Geben Sie ein Kennwort für den initialen Portal-Administrator und den primären ArcGIS Server-Site-Administrator Ihrer vorhandenen Bereitstellung an. Sie können entweder ein Kennwort in Klartext oder den ARN Ihrer Secret-ID in AWS Secrets Manager eingeben. |
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. |
Domain Name | Erforderlich | Geben Sie den vollständig qualifizierten Domänennamen Ihrer vorhandenen ArcGIS Enterprise-Bereitstellung an. |
Portal Web Adaptor Name | Erforderlich | Geben Sie den Portal for ArcGIS Web Adaptor-Namen Ihrer vorhandenen ArcGIS Enterprise-Bereitstellung an. |
Server Web Adaptor Name | Erforderlich | Geben Sie den ArcGIS Server Web Adaptor-Namen Ihrer vorhandenen ArcGIS Enterprise-Bereitstellung an. |
SSL Certificate File Name | Erforderlich | Geben Sie ein SSL-Zertifikat von einer Zertifizierungsstelle an (.pfx-Datei). Verwenden Sie dasselbe (oder das verlängerte) SSL-Zertifikat, das Sie beim Erstellen Ihrer vorhandenen Bereitstellung verwendet haben. Bevor Sie diesen Stack starten, müssen Sie das Zertifikat in den Bucket der Bereitstellung hochladen. Den Objektschlüsselnamen der Datei können Sie abrufen, indem Sie zur Datei im Bucket der Bereitstellung in der AWS S3-Konsole navigieren, zum Beispiel domainname.pfx oder resources/sslcerts/domainname.pfx. |
SSL Certificate Password | Erforderlich | Geben Sie dass Kennwort für das SSL-Zertifikat an. Sie können entweder ein Kennwort in Klartext oder den ARN Ihrer Secret-ID in AWS Secrets Manager eingeben. Informationen zum Erstellen eines Amazon-Ressourcennamens für Kennwörter finden Sie unter AWS CloudFormation und ArcGIS. |
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 |
|---|---|
PortalHomeAppURL | Die URL für den Zugriff auf das Portal. |
ServerManagerDirURL | Die ArcGIS Server Manager-URL |
ServerRestDirURL | Die ArcGIS Server-REST-Services-URL. |
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 Enterprise-Bereitstellung ein Upgrade durchgeführt wurde. Sie können dies überprüfen, indem Sie sich bei der Portal-Website und ArcGIS Server Manager oder beim REST-Services-Verzeichnis anmelden.
- 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 Enterprise-Bereitstellung ein Upgrade durchzuführen.
- Falls Sie eine Benachrichtigung zu Lizenzen erhalten, wenn Sie sich nach einem Upgrade beim Portal anmelden, haben Sie möglicherweise keine Lizenzdatei importiert, die die aktuellen Anforderungen der Lizenzierungskonfiguration erfüllt, oder den Benutzern wurde ein temporärer Benutzertyp zugewiesen. Informationen hierzu finden Sie unter Überlegungen nach dem Upgrade von Portal for ArcGIS in der Installationsanweisung zu Portal for ArcGIS.
Problembehandlung
Wenn Sie beim Erstellen dieses CloudFormation-Stacks Fehler feststellen, dann finden Sie entsprechende Informationen unter Problembehandlung bei ArcGIS-Bereitstellungen unter AWS.