Starting a Cluster

Start a cluster so Studio users can deploy projects to it.

Prerequisites

Set the ESP_HOME environment variable.

Task

A cluster must be running to deploy projects to it. To start a cluster, start manager nodes first, then controller-only nodes. For each node in the cluster, perform the following procedure where <node_name> represents the name of a manager node in the cluster.

From the command line for Windows systems, execute:
```
cd %ESP_HOME%\cluster\nodes\<node_name>
%ESP_HOME%\bin\esp_server.exe --cluster-node <node_name>.xml
```
And for Linux and Solaris systems, execute:
```
cd $ESP_HOME/cluster/nodes/<node_name>
$ESP_HOME/bin/esp_server --cluster-node <node_name>.xml
```
Note: The directory from which a node is started becomes the working directory for the node. The node looks for the cluster.log.properties file in the working directory.
Retrieve and start workspaces and projects:
esp_cluster_admin --uri=esps://<host>:<port> --username=<user> --password=<pass>
Provide the cluster URI and your credentials to complete the command and begin working with cluster administration commands.
Note: The URI protocol esps indicates that the cluster is SSL-enabled. URIs for clusters that are not SSL-enabled use the protocol esp.