Update a Workspace

Workspace updates will be released by e6data to provide new features, improvements, optimization, and bug fixes.

Workspace updates are necessary under the following circumstances:

• When Terraform values have been modified and permissions are updated.

• Upon version release.

Cluster Connectivity will not be automatically enabled after a Workspace update due to the dynamic nature of hostnames/IP addresses.

Cluster connectivity can be restored by enabling it from the e6data console. Click here for instructions.

All external connectors or internal services connecting to Clusters in an updated Workspace will need to be updated to use the newly generated hostname.

When Terraform values have been modified and permissions are updated

1. Obtain the latest Terraform files from the e6x-labs/terraform repo from Github.

2. Navigate to the directory containing the Terraform files. To execute successfully, it is essential to be in the correct directory for the Terraform commands.

3. Configure the terraform.tfvars & provider.tf files, to match the same details filled out during the initial Workspace installation.

4. Initialize Terraform:

   terraform init

5. Generate a Terraform plan and save it to a file (e.g., e6.plan):

   terraform plan -var-file="terraform.tfvars" --out="e6.plan"

   The -var-file flag specifies the input variable file (terraform.tfvars) that contains the necessary configuration values for the deployment.

6. Review the generated plan.

7. Apply the changes using the generated plan file:

   terraform apply "e6.plan"

   This command applies the changes specified in the plan file (e6.plan) to deploy the e6data workspace in your environment.

8. Make a note of the values returned by the script.

9. Navigate to Workspaces in the e6data Console

10. Click the name of the Workspace being updated or click on the kebab menu and select the Update option from the dropdown.

11. Click Update Workspace

12. Enter the new values returned in step 8.

13. Click Update

Please note that this action applies only to workspaces in the ACTIVE state.

Upon version release

You can update the workspace in two ways:

1. Click on the kebab menu (three dots) for the desired workspace, then proceed to confirm and complete the process.

2. To update the workspace, first click on the desired workspace, then click on the "Update" button. Confirm the update and proceed to complete the process.