Reset Atlan Stack

A step-by-step guide on how to reset an Atlan stack for a fresh new setup.

๐Ÿ“œ Prerequisites

  • Kubectl access to the stack. Refer to this document for preliminary instructions.

  • Admin console access of stack.

๐Ÿ› ๏ธ A Step-by-Step Guide to Restore the Stack

STEP 1: Log in to the release portal

Release Console Login Page

STEP 2: Go to the config section

In the configuration section, scroll down to the end and check the "Launch reset Atlan instance job" option.

Lunch reset atlan instance job

STEP 3: Deploy the job

Scroll down to the bottom of the page and save the config. Your new product version has now been created.

To implement the changes, click on the "Go to the new version" button.

New Version Window

Now the system will perform the preflight checks. Click on "Deploy", once successful without any error.

Preflight Checks Window

STEP 4: Track the progress

Once the job is deployed from the admin console, we can fetch its logs and track its progress. Here is how you can do it:

  • Get Kubectl access to the instance.

  • Get the name of the reset job pod. Run this command, and copy the name of the pod starting with reset-instance-job-. For example, reset-instance-job-fh24y5.

    $ kubectl get pods -n kots
  • Tailing the logs of the reset-job pod.

    $ kubectl logs reset-instance-job-fh24y5 -n kots -f
  • Wait for the job to finish.

๐Ÿ‘€ Note: The reset process can take up to 10-20 mins to finish completely.

STEP 5: Verify the product

Once you can job completion log from the pod, wait for sometime for all the pods to get up. Post that you can access the product and verify.

  • Check if all the pods are up using the command below:

$ kubectl get pods -A

  • Verify the product now.

STEP 6: Cleanup

Once everything is completed, follow these steps for cleanup.

  • Visit the release portal.

  • Go to the config section and uncheck the "Launch reset atlan instance job" option.

  • Save the config changes and deploy the newly created release.

If you face any issues in following these steps, you can always reach out to us at [email protected].