Troubleshooting
If you recently added the bucket or upgraded the stack, if search volume is high, or if the bucket is under rapid modification, wait a few minutes and try again.
- 1.Open the bucket in the Quilt catalog
- 2.Click the gear icon (upper right), or navigate to Users and buckets > Buckets and open the bucket in question
- 3.Under "Indexing and notifications", click "Re-index and Repair". Optional: if and only if bucket notifications were deleted or are not working, check "Repair S3 notifications".
- 4.Wait a few minutes while bucket statistics and packages repopulate
- 1.Go to CloudFormation > Stacks > YourQuiltStack > Resources
- 2.Search for "domain"
- 3.Click on the link for "Search" under "Physical ID"
- 4.You are now under ElasticSearch > Dashboards
- 5.Set the time range to include the period before and after when you noticed any issues
- 6.Screenshot the dashboard stats for your domain
- 7.Click into your domain and then navigate to "Cluster health"
- 8.Screenshot Summary, Overall Health, and Key Performance Indicator sections
- 9.
- 10.It is not recommended that you adjust ElasticSearch via Edit domain, as these changes will be lost the next time that you update Quilt
Package.set_dir()
on the package root (".") overrides package-level metadata. If you do not provideset_dir(".", foo, meta=baz)
with a value formeta=
,set_dir
will set package-level metadata toNone
.
A common pattern is to
Package.browse()
to get the most recent version of a package, and then Package.push()
updates. You can preserve package-level metadata when calling set_dir(".", ...)
as follows:import quilt3
p = quilt3.Package.browse(
"user-packages/geodata",
registry="s3://bucket_1"
)
p.set_dir(
".",
"s3://bucket_2/path/to/new/geofiles",
meta=p.meta
)
# Push changes to the S3 registry
p.push(
"user-packages/geodata",
registry="s3://bucket_1",
message="Updating package geodata source data"
)
There are two reasons for encountering the "Session expired" notice after clicking the
RELOAD
button in the Quilt Catalog.- 1.Your browser cache is out of date, in which case you need to:
- 1.Delete session storage
- 2.Delete local storage
- 3.Delete cookies
- 2.Your Quilt user Role has been corrupted. You will need a Quilt Admin user to reset your Quilt user Role to a default (and valid) Role.
If you accidentally broke the Role for your only Quilt Admin user, then you (or your AWS Cloud Administrator) need to:
- 1.Log in to your AWS account Console.
- 2.Go to the CloudFormation service and select your Quilt stack.
- 3.Click the
Update
button (top-right) to access the "Update stack" page - 4.In "Prerequisite - Prepare template" select "Use current template". Click "Next".
- 5.In the "Specify stack details > Parameters > Administrator web credentials" section:
- 1.Change the
AdminUsername
field to a new value that has never been used before. - 2.Change the
AdminEmail
field to a new email address that has never been used before. It may be helpful to use the+
sign in the new email address, followed by any text - it will successfully deliver to your inbox. For example,[email protected]
will still be sent to[email protected]
. - 3.Click "Next".
- 6.(Optional & preferred) In the "Configure stack options > Stack failure options" section, specify
Roll back all stack resources
. Click "Next". - 7.In the "Review > Change set preview" section, verify that any changes are not disruptive. For each resource the "Action" field value will be
Modify
and the "Logical ID" field value will beMigration
for approximately four resources. Click the "Submit" button.
After the deployment update is successfully completed, login to the Catalog with the new administrator credentials. Create other Admin users as needed.
To have your Quilt stack changeset reviewed by a Quilt support agent, or if you have further questions, please email [email protected] with the subject line "Quilt Admin user Role issue" and the body containing screenshots of the proposed changeset.
On rare occasions, Quilt stack deployment updates might fail. This can happen for several reasons. To expedite resolution of stack deployment issues, it's helpful to have the following data and output from the following AWS CLI commands when contacting [email protected]
- 1.Installed Quilt stack template metadata: This is located in the CloudFormation Quilt stack Outputs tab with the Key
TemplateBuildMetadata
and is a JSON object generated by the Quilt build system.

TemplateBuildMetadata Screenshot
- 2.Quilt stack drift:
$ aws cloudformation describe-stack-resource-drifts --stack-name QUILT_STACK_NAME
- 3.Recent events for the Quilt stack:
$ aws cloudformation describe-stack-events --stack-name QUILT_STACK_NAME
To expedite the resolution of any errors encountered while using Quilt, please capture the following logs and share them with Quilt support:
- 1.Go to the affected page in your Quilt Catalog.
- 2.Open the browser Developer tools:
- Google Chrome: Press F12, Ctrl+Shift+I or from the Chrome menu select More tools > Developer tools.
- 3.Select the Network tab.
- 1.Ensure the session is recorded:
- Google Chrome: Check the red button in the upper left corner is set to Record.
- 2.Ensure Preserve Log is enabled.
- 3.Perform the action that triggers the error (e.g. clicking the
Download package
button). - 4.Export the logs as HAR format.
- Google Chrome: Ctrl + Click anywhere on the grid of network requests and select Save all as HAR with content.
- 5.Save the HAR-formatted file to your localhost.Save browser Network error logs as HAR content
- 4.Select the Console tab.
- 1.Perform the action that triggers the error (e.g. clicking the
Download package
button). - 2.Export the logs.
- Google Chrome: Ctrl + Click anywhere on the grid of network requests and select Save as....
- 3.Save the log file to your localhost.
- 1.Find the name of your Quilt stack from querying all deployed stacks (in your default region, which is listed in your
~/.aws/config
file):aws cloudformation list-stacks - 2.Run the
aws logs
command to filter all Quilt ECS containers log entries for the last 30 minutes:aws logs filter-log-events \--log-group-name YOUR_QUILT_STACK_NAME \--start-time "$(( ($(date +%s) - 1800) * 1000 ))" \--end-time "$(( $(date +%s) * 1000 ))" > log-quilt-ecs-events.json
Last modified 2d ago