

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# `pcluster`
<a name="pcluster"></a>

`pcluster`ist der primäre AWS ParallelCluster CLI-Befehl. Sie verwenden`pcluster`, um HPC-Cluster in der zu starten und zu verwalten. AWS Cloud

```
pcluster [ -h ] ( create | update | delete | start | stop | status | list |
                  instances | ssh | dcv | createami | configure | version ) ...
```

## Argumente
<a name="pcluster.arguments"></a>

**`pcluster command`**  
Mögliche Optionen: [`configure`](pcluster.configure.md), [`create`](pluster.create.md), [`createami`](pcluster.createami.md), [`dcv`](pcluster.dcv.md), [`delete`](pcluster.delete.md), [`instances`](pcluster.instances.md), [`list`](pcluster.list.md), [`ssh`](pcluster.ssh.md), [`start`](pcluster.start.md), [`status`](pcluster.status.md), [`stop`](pcluster.stop.md), [`update`](pcluster.update.md), [`version`](pcluster.version.md)

## Unterbefehle:
<a name="pcluster.subcommands"></a>

**Topics**
+ [Argumente](#pcluster.arguments)
+ [Unterbefehle:](#pcluster.subcommands)
+ [`pcluster configure`](pcluster.configure.md)
+ [`pcluster create`](pluster.create.md)
+ [`pcluster createami`](pcluster.createami.md)
+ [`pcluster dcv`](pcluster.dcv.md)
+ [`pcluster delete`](pcluster.delete.md)
+ [`pcluster instances`](pcluster.instances.md)
+ [`pcluster list`](pcluster.list.md)
+ [`pcluster ssh`](pcluster.ssh.md)
+ [`pcluster start`](pcluster.start.md)
+ [`pcluster status`](pcluster.status.md)
+ [`pcluster stop`](pcluster.stop.md)
+ [`pcluster update`](pcluster.update.md)
+ [`pcluster version`](pcluster.version.md)

# `pcluster configure`
<a name="pcluster.configure"></a>

Beginnt mit einer AWS ParallelCluster Konfiguration. Weitere Informationen finden Sie unter [Konfiguration AWS ParallelCluster](getting-started-configuring-parallelcluster.md).

```
pcluster configure [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```

## Benannte Argumente
<a name="pcluster.configure.namedargs"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster configure`.

**-c * CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt den vollständigen Pfad der zu verwendenden alternativen Konfigurationsdatei an.  
Standardeinstellung: `~/.parallelcluster/config`.  
Weitere Informationen finden Sie unter [Konfiguration AWS ParallelCluster](getting-started-configuring-parallelcluster.md).

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Wenn dies angegeben ist, überspringt die Konfiguration die AWS-Region Erkennung.

Um die Netzwerkressourcen in der VPC zu löschen, können Sie den CloudFormation Netzwerkstapel löschen. Der Stack-Name beginnt mit“parallelclusternetworking-"und enthält die Erstellungszeit im Format „YYYYMMDDHHMMSS“. [Sie können die Stapel mit dem Befehl list-stacks auflisten.](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks)

```
$ aws --region us-east-1 cloudformation list-stacks \
   --stack-status-filter "CREATE_COMPLETE" \
   --query "StackSummaries[].StackName" | \
   grep -e "parallelclusternetworking-"
    "parallelclusternetworking-pubpriv-20191029205804"
```

[Der Stapel kann mit dem Befehl delete-stack gelöscht werden.](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack)

```
$ aws --region us-east-1 cloudformation delete-stack \
   --stack-name parallelclusternetworking-pubpriv-20191029205804
```

Die VPC, die für Sie [`pcluster configure`](#pcluster.configure) erstellt, wird nicht im CloudFormation Netzwerk-Stack erstellt. Sie können diese VPC manuell in der Konsole oder mithilfe von löschen. AWS CLI

```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```

# `pcluster create`
<a name="pluster.create"></a>

Erstellt einen neuen Cluster.

```
pcluster create [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] [ -nr ]
                [ -u TEMPLATE_URL ] [ -t CLUSTER_TEMPLATE ]
                [ -p EXTRA_PARAMETERS ] [ -g TAGS ]
                cluster_name
```

## Positionale Argumente
<a name="pluster.create.arg"></a>

***cluster\$1name***  
Definiert den Namen des Clusters. Der AWS CloudFormation Stack-Name lautet`parallelcluster-cluster_name`.

## Benannte Argumente
<a name="pluster.create.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster create`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Die Prioritätsreihenfolge, die AWS-Region für die Auswahl von für einen neuen Cluster verwendet wird, lautet wie folgt:  

1. `-r`oder `--region` Parameter für[`pcluster create`](#pluster.create).

1. `AWS_DEFAULT_REGION`-Umgebungsvariable.

1. `aws_region_name`Einstellung im `[aws]` Abschnitt der AWS ParallelCluster Konfigurationsdatei (der Standardspeicherort ist`~/.parallelcluster/config`.) Dies ist der Speicherort, der durch den [`pcluster configure`](pcluster.configure.md) Befehl aktualisiert wurde.

1. `region`Einstellung im `[default]` Abschnitt der AWS CLI Konfigurationsdatei (`~/.aws/config`.)

**-nw, --nowait**  
Zeigt an, dass nach der Ausführung eines Stack-Befehls nicht auf Stack-Ereignisse gewartet werden soll.  
Standardeinstellung: `False`.

**-nr, --norollback**  
Deaktiviert -Stack-Rollback bei Fehler.  
Standardeinstellung: `False`.

**-u *TEMPLATE\$1URL*, --template-url *TEMPLATE\$1URL***  
Gibt eine URL für die benutzerdefinierte AWS CloudFormation Vorlage an, falls sie bei der Erstellung verwendet wurde.

**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***  
Zeigt an, welche Cluster-Vorlage verwendet werden soll.

**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***  
Fügt zusätzliche Parameter zur Stack-Erstellung hinzu.

**-g *TAGS*, --tags *TAGS***  
Gibt zusätzliche Tags an, die dem Stack hinzugefügt werden sollen.

Wenn der Befehl aufgerufen wird und mit der Abfrage des Status dieses Aufrufs beginnt, können Sie den Vorgang problemlos mit „Strg-C“ beenden. Sie können den aktuellen Status wieder anzeigen, indem Sie „`pcluster status mycluster`“ aufrufen.

**Beispiele mit Version 2.11.7 AWS ParallelCluster :**

```
$ pcluster create mycluster
    Beginning cluster creation for cluster: mycluster
Info: There is a newer version 3.1.4 of AWS ParallelCluster available.
Creating stack named: parallelcluster-mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
$ pcluster create mycluster --tags '{ "Key1" : "Value1" , "Key2" : "Value2" }'
```

# `pcluster createami`
<a name="pcluster.createami"></a>

(Linux/macOS) Erstellt ein benutzerdefiniertes AMI zur Verwendung mit. AWS ParallelCluster

```
pcluster createami [ -h ] -ai BASE_AMI_ID -os BASE_AMI_OS
                   [ -i INSTANCE_TYPE ] [ -ap CUSTOM_AMI_NAME_PREFIX ]
                   [ -cc CUSTOM_AMI_COOKBOOK ] [--no-public-ip]
                   [ -post-install POST_INSTALL_SCRIPT ]
                   [ -c CONFIG_FILE ] [-t CLUSTER_TEMPLATE]
                   [--vpc-id VPC_ID] [--subnet-id SUBNET_ID]
                   [ -r REGION ]
```

## Erforderliche Abhängigkeiten
<a name="pcluster.createami.required-dependencies"></a>

Zusätzlich zur AWS ParallelCluster CLI ist für die Ausführung die folgende Abhängigkeit erforderlich`pcluster createami`:
+ **Packer**: Laden Sie die neueste Version von [https://developer.hashicorp.com/packer/downloads](https://developer.hashicorp.com/packer/downloads) herunter.

**Anmerkung**  
Vor AWS ParallelCluster Version 2.8.0 musste [Berkshelf](https://github.com/berkshelf/berkshelf) (installiert mit`gem install berkshelf`) verwendet werden. `pcluster createami`

## Benannte Argumente
<a name="pcluster.createami.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster createami`.

**-ai *BASE\$1AMI\$1ID*, --ami-id *BASE\$1AMI\$1ID***  
Gibt das Basis-AMI an, das für die Erstellung des AWS ParallelCluster AMI verwendet werden soll.

**-os *BASE\$1AMI\$1OS*, --os *BASE\$1AMI\$1OS***  
Gibt das Betriebssystem des Basis-AMI an. Gültige Optionen sind `alinux2`, `ubuntu1804`, `ubuntu2004` und `centos7`.  
Änderungen der Betriebssystemunterstützung in verschiedenen AWS ParallelCluster Versionen:  
+ Die Support für `centos8` wurde in AWS ParallelCluster Version 2.10.4 entfernt.
+ Support für `centos8` wurde hinzugefügt und Unterstützung für `centos6` wurde in AWS ParallelCluster Version 2.10.0 entfernt.
+ Support für alinux2 wurde in AWS ParallelCluster Version 2.6.0 hinzugefügt.
+ Support für ubuntu1804 wurde in AWS ParallelCluster Version 2.5.0 hinzugefügt.

**-i *INSTANCE\$1TYPE*, --instance-type *INSTANCE\$1TYPE***  
Gibt den Instance-Typ an, der zur Erstellung des AMI verwendet werden soll.  
Standardeinstellung: `t2.xlarge`.  
Support für das `--instance-type` Argument wurde in AWS ParallelCluster Version 2.4.1 hinzugefügt.

**-ap *CUSTOM\$1AMI\$1NAME\$1PREFIX*, --ami-name-prefix *CUSTOM\$1AMI\$1NAME\$1PREFIX***  
Gibt den Präfixnamen des resultierenden AWS ParallelCluster AMI an.  
Standardeinstellung: `custom-ami-`.

**-cc *CUSTOM\$1AMI\$1COOKBOOK*, --custom-cookbook *CUSTOM\$1AMI\$1COOKBOOK***  
Gibt das Kochbuch an, das zum Erstellen des AWS ParallelCluster AMI verwendet werden soll.

**--post-install *POST\$1INSTALL\$1SCRIPT***  
Gibt den Pfad zum Post-Installationsskript an. Pfade müssen ein `s3://``https://`, oder `file://` URL-Schema verwenden. Beispiele sind unter anderem:  
+ `https://bucket-name.s3.region.amazonaws.com/path/post_install.sh`
+ `s3://bucket-name/post_install.sh`
+ `file:///opt/project/post_install.sh`
Support für das `--post-install` Argument wurde in AWS ParallelCluster Version 2.10.0 hinzugefügt.

**--no-public-ip**  
Ordnen Sie der Instance, die zur Erstellung des AMI verwendet wurde, keine öffentliche IP-Adresse zu. Standardmäßig ist der Instance eine öffentliche IP-Adresse zugeordnet.  
Support für das `--no-public-ip` Argument wurde in AWS ParallelCluster Version 2.5.0 hinzugefügt.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***  
Gibt den [Abschnitt [`cluster`]](cluster-definition.md) von an*CONFIG\$1FILE*, der zum Abrufen der VPC- und Subnetzeinstellungen verwendet werden soll.  
Support für das `--cluster-template` Argument wurde in AWS ParallelCluster Version 2.4.0 hinzugefügt.

**--vpc-id *VPC\$1ID***  
Gibt die ID der VPC an, die zum Erstellen des AWS ParallelCluster AMI verwendet werden soll.  
Support für das `--vpc-id` Argument wurde in AWS ParallelCluster Version 2.5.0 hinzugefügt.

**--subnet-id *SUBNET\$1ID***  
Gibt die ID des Subnetzes an, das zum Erstellen des AWS ParallelCluster AMI verwendet werden soll.  
Support für das `--vpc-id` Argument wurde in AWS ParallelCluster Version 2.5.0 hinzugefügt.

**-r *REGION*, --region** *REGION*  
Gibt an, was verwendet AWS-Region werden soll. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

# `pcluster dcv`
<a name="pcluster.dcv"></a>

Interagiert mit dem Amazon DCV-Server, der auf dem Hauptknoten ausgeführt wird.

```
pcluster dcv [ -h ] ( connect )
```

**`pcluster dcv command`**  
Mögliche Optionen: [`connect`](#pcluster-dcv-connect)

**Anmerkung**  
Änderungen der Betriebssystemunterstützung für den `pcluster dcv` Befehl in verschiedenen AWS ParallelCluster Versionen:  
Support für den `pcluster dcv` Befehl on `centos8` wurde in AWS ParallelCluster Version 2.10.0 hinzugefügt.
Support für den `pcluster dcv` Befehl auf AWS Graviton-basierten Instanzen wurde in AWS ParallelCluster Version 2.9.0 hinzugefügt.
Support für den `pcluster dcv` Befehl on `ubuntu1804` wurde in AWS ParallelCluster Version 2.6.0 hinzugefügt.
Support für den `pcluster dcv` Befehl on `centos7` wurde in AWS ParallelCluster Version 2.5.0 hinzugefügt.

## Benannte Argumente
<a name="pcluster.dcv.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster dcv`.

## Unterbefehle:
<a name="pcluster-dcv-subcommands"></a>

### `pcluster dcv connect`
<a name="pcluster-dcv-connect"></a>

```
pcluster dcv connect [ -h ] [ -k SSH_KEY_PATH ] [ -r REGION ] cluster_name
```

**Wichtig**  
Die URL läuft 30 Sekunden nach ihrer Ausgabe ab. Wenn die Verbindung nicht hergestellt wird, bevor die URL abläuft, führen Sie den Vorgang `pcluster dcv connect` erneut aus, um eine neue URL zu generieren.

#### Positionale Argumente
<a name="pcluster.dcv.connect.arg"></a>

***cluster\$1name***  
Gibt den Namen des Clusters an, mit dem eine Verbindung hergestellt werden soll.

#### Benannte Argumente
<a name="pcluster.dcv.connect.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster dcv connect`.

**-k *SSH\$1KEY\$1PATH*, --key-path *SSH\$1KEY\$1PATH***  
Schlüsselpfad des SSH-Schlüssels, der für die Verbindung verwendet werden soll.  
Der Schlüssel muss der zum Zeitpunkt der Cluster-Erstellung im [`key_name`](cluster-definition.md#key-name)-Konfigurationsparameter angegebene sein. Dieses Argument ist optional, aber wenn es nicht angegeben ist, muss der Schlüssel standardmäßig für den SSH-Client verfügbar sein. Fügen Sie es beispielsweise dem `ssh-agent` mit `ssh-add` hinzu.

**-r *REGION*, --region** *REGION*  
Gibt an, was verwendet AWS-Region werden soll. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

**-s, --show-url**  
Zeigt eine einmalige URL für die Verbindung mit der Amazon DCV-Sitzung an. Der Standardbrowser wird nicht geöffnet, wenn diese Option angegeben ist.  
Support für das `--show-url` Argument wurde in AWS ParallelCluster Version 2.5.1 hinzugefügt.

**Beispiel mit AWS ParallelCluster Version 2.11.7:**

```
$ pcluster dcv connect -k ~/.ssh/id_rsa mycluster
```

Öffnet den Standardbrowser, um eine Verbindung zu der Amazon DCV-Sitzung herzustellen, die auf dem Hauptknoten ausgeführt wird.

Eine neue Amazon DCV-Sitzung wird erstellt, falls noch keine gestartet wurde.

 ![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/de_de/parallelcluster/v2/ug/images/Dcv-image.png) 

# `pcluster delete`
<a name="pcluster.delete"></a>

Löscht einen Cluster.

```
pcluster delete [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```

## Positionale Argumente
<a name="pcluster.delete.arg"></a>

***cluster\$1name***  
Gibt den Namen des Clusters an, der gelöscht werden soll.

## Benannte Argumente
<a name="pcluster.delete.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster delete`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**--keep-logs**  
Behalten Sie die CloudWatch Protokolldaten nach dem Löschen des Clusters bei. Die Protokollgruppe bleibt bestehen, bis Sie sie manuell löschen, aber die Protokollereignisse laufen je nach [`retention_days`](cw-log-section.md#cw-log-section-retention-days) Einstellung ab. Standardmäßig ist die Einstellung auf 14 Tage festgelegt.  
Support für das **--keep-logs** Argument wurde in AWS ParallelCluster Version 2.6.0 hinzugefügt.

**-r *REGION*, --region *REGION***  
Gibt an, was verwendet AWS-Region werden soll. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

Wenn der Befehl aufgerufen wird und mit der Abfrage des Status dieses Aufrufs beginnt, können Sie den Vorgang mit „Strg-C“ beenden. Sie können den aktuellen Status wieder anzeigen, indem Sie „`pcluster status mycluster`“ aufrufen.

**Beispiel mit Version 2.11.7 AWS ParallelCluster :**

```
$ pcluster delete -c path/to/config -r us-east-1 mycluster
Deleting: mycluster
Status: RootRole - DELETE_COMPLETE                                              
Cluster deleted successfully.
```

Um die Netzwerkressourcen in der VPC zu löschen, können Sie den CloudFormation Netzwerkstapel löschen. Der Stack-Name beginnt mit“parallelclusternetworking-"und enthält die Erstellungszeit im Format „YYYYMMDDHHMMSS“. [Sie können die Stapel mit dem Befehl list-stacks auflisten.](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks)

```
$ aws --region us-east-1 cloudformation list-stacks \
   --stack-status-filter "CREATE_COMPLETE" \
   --query "StackSummaries[].StackName" | \
   grep -e "parallelclusternetworking-"
    "parallelclusternetworking-pubpriv-20191029205804"
```

[Der Stapel kann mit dem Befehl delete-stack gelöscht werden.](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack)

```
$ aws --region us-east-1 cloudformation delete-stack \
   --stack-name parallelclusternetworking-pubpriv-20191029205804
```

Die VPC, die für Sie [`pcluster configure`](pcluster.configure.md) erstellt, wird nicht im CloudFormation Netzwerk-Stack erstellt. Sie können diese VPC manuell in der Konsole oder mithilfe von löschen. AWS CLI

```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```

# `pcluster instances`
<a name="pcluster.instances"></a>

Zeigt eine Liste aller Instances in einem Cluster an.

```
pcluster instances [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```

## Positionale Argumente
<a name="pcluster.instances.arg"></a>

***cluster\$1name***  
Zeigt die Instances für den Cluster mit dem angegebenen Namen an.

## Benannte Argumente
<a name="pcluster.instances.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster instances`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

**Beispiel mit AWS ParallelCluster Version 2.11.7:**

```
$ pcluster instances -c path/to/config -r us-east-1 mycluster
MasterServer         i-1234567890abcdef0
ComputeFleet         i-abcdef01234567890
```

# `pcluster list`
<a name="pcluster.list"></a>

Zeigt eine Liste der Stapel an, die verknüpft sind mit. AWS ParallelCluster

```
pcluster list [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```

## Benannte Argumente
<a name="pcluster.list.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster list`.

**--color**  
Zeigt den Cluster-Status in Farbe an.  
Standardeinstellung: `False`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `c`.

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

Listet die Namen aller benannten AWS CloudFormation Stapel auf. `parallelcluster-*`

**Beispiel mit AWS ParallelCluster Version 2.11.7:**

```
$ pcluster list -c path/to/config -r us-east-1
mycluster            CREATE_IN_PROGRESS  2.11.7
myothercluster       CREATE_IN_PROGRESS  2.11.7
```

# `pcluster ssh`
<a name="pcluster.ssh"></a>

Führt einen `ssh`-Befehl mit dem bereits ausgefüllten Benutzernamen und der IP-Adresse des Clusters aus. Beliebige Argumente werden am Ende des `ssh`-Befehls angefügt. Dieser Befehl kann im Aliasnamen-Abschnitt der Konfigurationsdatei angepasst werden.

```
pcluster ssh [ -h ] [ -d ] [ -r REGION ] cluster_name
```

## Positionale Argumente
<a name="pcluster.ssh.arg"></a>

***cluster\$1name***  
Gibt den Namen des Clusters an, mit dem eine Verbindung hergestellt werden soll.

## Benannte Argumente
<a name="pcluster.ssh.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster ssh`.

**-d, --dryrun**  
Drucken Sie den Befehl aus, der ausgeführt werden würde, und beenden Sie den Vorgang.  
Standardeinstellung: `False`.

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Standardmäßig wird die Region verwendet, die mit dem Befehl [`pcluster configure`](pcluster.configure.md) angegeben wird.

**Beispiele mit AWS ParallelCluster Version 2.11.7:**

```
$ pcluster ssh -d mycluster -i ~/.ssh/id_rsa
SSH command: ssh ec2-user@1.1.1.1 -i /home/user/.ssh/id_rsa
```

```
$ pcluster ssh mycluster -i ~/.ssh/id_rsa
```

Führt den `ssh` Befehl aus, wobei der Benutzername und die IP-Adresse des Clusters vorausgefüllt sind:

```
ssh ec2-user@1.1.1.1 -i ~/.ssh/id_rsa
```

Der `ssh`-Befehl wird in der globalen Konfigurationsdatei unter [`[aliases]` Abschnitt](aliases.md) definiert. Er kann wie folgt angepasst werden.

```
[ aliases ]
ssh = ssh {CFN_USER}@{MASTER_IP} {ARGS}
```

Ersetzte Variablen:

`CFN_USER`  
Der Benutzername für das [`base_os`](cluster-definition.md#base-os), das ausgewählt ist.

`MASTER_IP`  
Die IP-Adresse des Hauptknotens.

`ARGS`  
Optionale Argumente, die an den `ssh`-Befehl übergeben werden sollen.

# `pcluster start`
<a name="pcluster.start"></a>

Startet die Datenverarbeitungsflotte für einen Cluster, der gestoppt wurde.

```
pcluster start [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```

## Positionale Argumente
<a name="pcluster.start.arg"></a>

***cluster\$1name***  
Startet die Datenverarbeitungsflotte des angegebenen Cluster-Namens

## Benannte Argumente
<a name="pcluster.start.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster start`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

**Beispiel mit AWS ParallelCluster Version 2.11.7:**

```
$ pcluster start mycluster
Compute fleet status is: RUNNING. Submitting status change request.
Request submitted successfully. It might take a while for the transition to complete.
Please run 'pcluster status' if you need to check compute fleet status
```

Mit diesem Befehl wird für die Parameter der Auto Scaling-Gruppe einer der folgenden Werte festgelegt: 
+ Die anfänglichen Konfigurationswerte (`max_queue_size` und `initial_queue_size`) aus der Vorlage, die zum Erstellen des Clusters verwendet wurde
+ Die Konfigurationswerte, die zum Aktualisieren des Clusters verwendet wurden, seit er erstellt wurde.

# `pcluster status`
<a name="pcluster.status"></a>

Fragt den aktuellen Status des Clusters ab.

```
pcluster status [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```

## Positionale Argumente
<a name="pcluster.status.posarg"></a>

**cluster\$1name**  
Zeigt den Status des Clusters mit dem angegebenen Namen an.

## Benannte Argumente
<a name="pcluster.status.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster status`.

**-c *CONFIG\$1FILE*, `--config` *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

**-nw, --nowait**  
Zeigt an, dass nach der Verarbeitung eines Stack-Befehls nicht auf Stack-Ereignisse gewartet werden soll.  
Standardeinstellung: `False`.

**Beispiel mit AWS ParallelCluster Version 2.11.7:**

```
$ pcluster status -c path/to/config -r us-east-1 mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
```

# `pcluster stop`
<a name="pcluster.stop"></a>

Stoppt die Rechenflotte und lässt den Hauptknoten laufen.

```
pcluster stop [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```

## Positionale Argumente
<a name="pcluster.stop.posarg"></a>

***cluster\$1name***  
Stoppt die Datenverarbeitungsflotte des angegebenen Cluster-Namens.

**Beispiel mit AWS ParallelCluster Version 2.11.7:**

## Benannte Argumente
<a name="pcluster.stop.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster stop`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Gibt den AWS-Region zu verwendenden an. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

```
$ pcluster stop mycluster
Compute fleet status is: STOPPED. Submitting status change request.
Request submitted successfully. It might take a while for the transition to complete.
Please run 'pcluster status' if you need to check compute fleet status
```

Setzt die Auto Scaling Scaling-Gruppenparameter auf min/max/desired = 0/0/0 und beendet die Rechenflotte. Der Kopf läuft weiter. Um alle EC2 Ressourcen zu beenden und EC2 Gebühren zu vermeiden, sollten Sie erwägen, den Cluster zu löschen.

# `pcluster update`
<a name="pcluster.update"></a>

Analysiert die Konfigurationsdatei, um festzustellen, ob der Cluster sicher aktualisiert werden kann. Wenn die Analyse ergibt, dass der Cluster aktualisiert werden kann, werden Sie aufgefordert, die Änderung zu bestätigen. Wenn die Analyse ergibt, dass der Cluster nicht aktualisiert werden kann, werden die Konfigurationseinstellungen, die die Ursache der Konflikte sind, mit Details aufgelistet. Weitere Informationen finden Sie unter [Verwenden von `pcluster update`](using-pcluster-update.md).

```
pcluster update [ -h ] [ -c CONFIG_FILE ] [ --force ] [ -r REGION ] [ -nr ]
                [ -nw ] [ -t CLUSTER_TEMPLATE ] [ -p EXTRA_PARAMETERS ] [ -rd ]
                [ --yes ] cluster_name
```

## Positionale Argumente
<a name="pcluster.update.arg"></a>

***cluster\$1name***  
Gibt den Namen des Clusters an, der aktualisiert werden soll.

## Benannte Argumente
<a name="pcluster.update.namedarg"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster update`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Gibt die alternative Konfigurationsdatei an, die verwendet werden soll.  
Standardeinstellung: `~/.parallelcluster/config`.

**--force**  
Aktiviert ein Update auch dann, wenn eine oder mehrere Einstellungen eine blockierende Änderung enthalten oder wenn eine ausstehende Aktion erforderlich ist (z. B. das Stoppen der Rechenflotte), bevor das Update fortgesetzt werden kann. Dies sollte nicht mit dem `--yes` Argument kombiniert werden.

**-r *REGION*, --region *REGION***  
Gibt an AWS-Region , was verwendet werden soll. Standardmäßig wird der mit dem [`pcluster configure`](pcluster.configure.md) Befehl AWS-Region angegebene Wert verwendet.

**-nr, --norollback**  
Deaktiviert das AWS CloudFormation Stack-Rollback bei einem Fehler.  
Standardeinstellung: `False`.

**-nw, --nowait**  
Zeigt an, dass nach der Verarbeitung eines Stack-Befehls nicht auf Stack-Ereignisse gewartet werden soll.  
Standardeinstellung: `False`.

**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***  
Gibt den Abschnitt der Cluster-Vorlage an, der verwendet werden soll.

**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***  
Fügt einer Stack-Aktualisierung zusätzliche Parameter hinzu.

**-rd, --reset-desired**  
Setzt die aktuelle Kapazität einer Auto Scaling-Gruppe auf die anfängliche Konfigurationswerte zurück.  
Standardeinstellung: `False`.

**--yes**  
Geht automatisch davon aus, dass die Antwort auf alle Eingabeaufforderungen Ja lautet. Dies sollte nicht mit dem `--force` Argument kombiniert werden.

```
$ pcluster update -c path/to/config mycluster
Retrieving configuration from CloudFormation for cluster mycluster...
Validating configuration file .parallelcluster/config...
Found Configuration Changes:

#    parameter                   old value    new value
---  --------------------------  -----------  -----------
     [compute_resource default]
01   min_count                   1            2
02   max_count                   5            12

Validating configuration update...
Congratulations! The new configuration can be safely applied to your cluster.
Do you want to proceed with the update? - Y/N: Y
Updating: mycluster
Calling update_stack
Status: parallelcluster-mycluster - UPDATE_COMPLETE
```

Wenn der Befehl aufgerufen wird und mit der Abfrage des Status dieses Aufrufs beginnt, können Sie den Vorgang mit „Strg-C“ beenden. Sie können den aktuellen Status wieder anzeigen, indem Sie „`pcluster status mycluster`“ aufrufen.

# `pcluster version`
<a name="pcluster.version"></a>

Zeigt die Version an. AWS ParallelCluster 

```
pcluster version [ -h ]
```

Für befehlsspezifische Flags führen Sie Folgendes aus: „`pcluster [command] –-help`“

## Benannte Argumente
<a name="pcluster.version.named.arguments"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster version`.

Wenn der Befehl aufgerufen wird und mit der Abfrage des Status dieses Aufrufs beginnt, können Sie den Vorgang mit „Strg-C“ beenden. Sie können den aktuellen Status wieder anzeigen, indem Sie „`pcluster status mycluster`“ aufrufen.

```
$ pcluster version
2.11.7
```