Skip To Content

Ausführen des Befehls PREP

Mit dem Befehl PREP der ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services werden mehrere wichtige vorab erforderliche Aufgaben für eine ArcGIS Enterprise-Bereitstellung in Amazon Web Services (AWS) automatisiert. Bereiten Sie zunächst eine JSON-Datei vor, indem Sie Ihre Parameter angeben, und führen Sie dann den Befehl PREP aus, um folgende Aufgaben zu erledigen:

  • Erstellen eines Netzwerkstapels und Amazon Simple Storage Service (S3)-Buckets für die Bereitstellung
  • Erstellen einer VPC für die Bereitstellung
  • Hochladen aller erforderlichen Autorisierungsdateien und SSL-Zertifikate in den S3-Bucket
  • Importieren des SSL-Zertifikats in AWS Certificate Manager

Sie müssen den Befehl PREP nur unter folgenden Umständen erneut ausführen:

  • Sie möchten eine weitere Bereitstellung in einer anderen Region oder in einem separaten Netzwerk erstellen.
  • Sie verfügen über mehr als ein AWS-Konto und möchten Bereitstellungen für verschiedene Konten erstellen.
  • Sie müssen das SSL-Zertifikat für die Bereitstellung aktualisieren.
  • Die ArcGIS-Lizenzen sind abgelaufen und Sie müssen neue Lizenzdateien hochladen.

Vom Befehl PREP werden Informationen in eine Textdatei auf der lokalen Festplatte zurückgegeben.

  1. Laden Sie die Datei ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe von My EsriMy Esri herunter, und legen Sie sie auf der lokalen Festplatte ab.
  2. Doppelklicken Sie auf die Datei ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe, um den Inhalt zu extrahieren. Während der Extraktion können Sie einen Speicherort für die extrahierten Dateien angeben oder das Standardverzeichnis c:\Program Files\ArcGIS\CloudBuilder\AWS\CLI verwenden. Sie müssen Windows-Administrator sein, um in das Standardverzeichnis extrahieren zu können.

    Das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS und die zugehörigen Dateien und Beispiele werden in den angegebenen Speicherort extrahiert.

  3. Verschieben Sie das SSL-Zertifikat (.pfx) und die Lizenzdateien (.prvc oder .ecp) auf den Computer, auf dem Sie gerade das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS extrahiert haben.
  4. Wenn Sie die mit dem Dienstprogramm bereitgestellten .json-Beispieldateien ändern und verwenden möchten, erstellen Sie Kopien der Dateien im Ordner Configuration. Achten Sie darauf, die Kopien in einem Unterordner unter dem Ordner Configuration zu speichern.
  5. Bevor Sie den Befehl PREP mit dem Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS ausführen, ändern Sie eine der Beispielvorbereitungsdateien, oder erstellen Sie eine eigene .json-Datei.

    Um in einem Schritt eine VPC und einen S3-Bucket zu erstellen und das SSL-Zertifikat sowie die ArcGIS-Lizenzdateien hochzuladen, ändern Sie die Kopie der Beispieldatei allprep.json, oder erstellen Sie eine eigene .json-Datei, die die im folgenden Beispiel dargestellten Parameter enthält. Öffnen Sie die Datei in einem Texteditor, legen Sie die Informationen des Kontos und der Bereitstellung in den Parametern fest, und speichern Sie die Änderungen. Eine Beschreibung der einzelnen Parameter finden Sie unter Parameter im ArcGIS Enterprise Cloud Builder CLI for AWS.

    In diesem Beispiel stellt das Dienstprogramm die Verbindung mit dem AWS-Konto über den Zugriffsschlüssel und den geheimen Schlüssel des Kontos her. In der Region "ap-northeast-1" wird ein Amazon S3-Bucket mit dem Namen EnterpriseFiles erstellt. Die Lizenzdateien und ein SSL-Zertifikat werden aus den angegebenen lokalen Ordnern kopiert und im S3-Bucket gespeichert. Außerdem wird in den Verfügbarkeitszonen "ap-northeast-1b" und "ap-northeast-1a" eine VPC erstellt.

    {
    	"AWSCredentials": {
    		"AWSAccessKey": "ABCDEFGHIMI4YCPABC",
    	 "AWSSecretKey": "ABCDLZDYIzZuXHlWHOPhMqrTmABCD",
    		"AWSRegion": "ap-northeast-1"
    	},
    	"NetworkStack": {
    		"StackName": "EnterpriseVPC",
    		"AZs": "ap-northeast-1b,ap-northeast-1a",
    		"CreateFlag":true
    	},
    	"ArcGISEnterpriseFiles": {
    	 "DeploymentBucket": "enterprisefiles",
    		"PortalLicense": "D:\\ArcGISLicenses\\Your_Portal_License.prvc",
    		"ServerLicense": "D:\\ArcGISLicenses\\Your_Server_License.prvc",
    		"GeoAnalyticsLicense": "D:\\ArcGISLicenses\\Your_Server_GeoAnalytics_License.prvc",
    		"RasterAnalyticsLicense": "D:\\ArcGISLicenses\\Your_Server_Image_License.prvc",
    		"GeoEventLicense": "D:\\ArcGISLicenses\\Your_Server_GeoEvent_License.prvc",
    		"SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx",
    		"SSLCertPassword": "changeit"
    	}
    }
  6. Öffnen Sie eine Eingabeaufforderung, und wechseln Sie (cd) zu dem Ordner, in den Sie das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS und die zugehörigen Dateien extrahiert haben. Führen Sie das Dienstprogramm mit dem Befehl PREP aus: cloudbuilder.exe PREP -j <prepfilename.json>

    Um beispielsweise eine Datei mit dem Namen myallprep.json, die Sie unter dem Ordner Configuration der ArcGIS Enterprise Cloud Builder CLI for AWS in einem neuen Unterordner für die Vorbereitungsdatei abgelegt haben, zu verwenden, geben Sie Folgendes ein:

    cloudbuilder.exe PREP -j Configuration\MyPrepFiles\myallprep.json

  7. Navigieren Sie zur Ausgabedatei des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS (im Format PREP_<date><time>.json) im Ordner CloudBuilder\AWS\CLI\Output auf der lokalen Festplatte. Diese Datei enthält Informationen, die Sie benötigen, wenn Sie die Bereitstellung erstellen.

    Die Ausgabe, die beim Ausführen der Beispieldatei in Schritt 5 erstellt wird, enthält eine ID und zwei Subnet-IDs für eine neue VPC, den Namen des S3-Buckets und den eindeutigen Amazon-Ressourcennamen (ARN), der für das SSL-Zertifikat erstellt wurde.

    "NetworkStack": {
          "VPCId": "vpc-z9fb11ba",
          "subnet1": "subnet-z319acee",
          "subnet2": "subnet-f4fc658f"
       },
       "DeploymentDetails": {
          "DeploymentBucket": "enterprisefiles",
          "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
       }

    Beachten Sie, dass der Inhalt der Ausgabedatei abhängig von den Informationen, die Sie in der Konfigurationsdatei angegeben haben, unterschiedlich sein kann.

Sie können nun eine Bereitstellung mit der Befehlszeilenschnittstelle erstellen.