It is time to say goodbye: This version of Elastic Cloud Enterprise has reached end-of-life (EOL) and is no longer supported.

The documentation for this version is no longer being maintained. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Common issues Removing Elastic Cloud Enterprise »
Elastic Docs ›Elastic Cloud Enterprise Reference [2.3] ›Troubleshooting

Using the emergency roles token

edit

Using the emergency roles token

edit

During installation, an emergency token gets generated that enables you to install Elastic Cloud Enterprise on additional hosts with all roles already assigned, except the allocator role. The emergency token can save your installation if all coordinators fail or are removed and you can no longer use the Cloud UI or the RESTful API. As part of the installation instructions, we ask you to keep this token safe.

To use the emergency token:

  1. Install Elastic Cloud Enterprise on an additional host and specify the emergency token along with the original coordinator host. For example:

    bash <(curl -fsSL https://download.elastic.co/cloud/elastic-cloud-enterprise.sh) install --coordinator-host 192.168.50.10 --roles-token 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIyZGVlYjlkZS01MDkzLTQxNGItYmI5NS0zNmJhZTQxMWI0YzgiLCJyb2xlcyI6WyJjb29yZGluYXRvciIsInByb3h5IiwiZGlyZWN0b3IiXSwiaXNzIjoiY3VycmVudCIsInBlcnNpc3RlbnQiOnRydWV9.5tIVQxEluSjtJ7qiwE8OWzy5O4l1GJ0urTFs_l1x5bU'
  2. Log into the Cloud UI on the newly created coordinator. The URL you use is the IP address of the host that you installed Elastic Cloud Enterprise on in Step 1 (http://10.142.0.4:12400, for example).
  3. Verify that the Cloud UI works as expected.

  4. Optional: Prevent a recurrence of the issue by enabling high availability for the administration console:

    1. Repeat Step 1 to create two additional coordinators in two additional availability zones. Examples of the installation commands you need to run are available.
    2. Change the configuration for the admin-console-elasticsearch and logging-and-metrics deployments to use three availability zones and resize the nodes to use at least 4 GB of RAM. This change makes sure that the clusters used by the administration console are highly available and provisioned sufficiently.
« Common issues Removing Elastic Cloud Enterprise »