Skip to content

Deploying a database

Deploying a database allocates compute and storage for data in a database. Once a database has been deployed, the database will exist in your install. Tearing down the database will not delete any of the data that is stored within the database. To delete the data backing a database, you must clean up the database.

Deploying YAML

This guide walks through deploying a database using the kdb Insights Enterprise UI. If you are using a YAML configuration, see the kdb Insights CLI deployment guide.

Deploying a database

To deploy a database, click on the Database name in the left hand menu and click Deploy in the database editor screen.

The Resource Summary dialog opens. If you are happy with resources click Deploy to proceed. If you want to adjust the resources you can do so on the Resources tab.

Resource Summary on Deploy

To see the status of a deployment, hover over the status icon for the database in the Overview screen.

Deployment status

Once the database has been deployed and is ready for data and queries, the status icon shows a green checkbox. Hovering over the icon shows that the state of each component has also been deployed.

Deployment complete

Errors in deployments

If a component in a database fails to start, an error is shown in the deployment status tooltip. If there is an error in your deployment, open the logs for the assembly by clicking View Logs. This opens the diagnostics logs for the database.

Tearing down a database

To stop a running database click Other Actions and then click Teardown.

Teardown button

This stops any running database components, without deleting any resources. When you click Teardown, a dialog gives you an option to clean up the database which deletes all user data associated with the database.

Teardown database

Cleaning up a database

To delete all data associated with a database, first teardown the database, then click Other Actions and Clean Up. This deletes all resources associated with the database.

Clean up button

You will be asked to confirm the clean up. Click Clean Up again to confirm.

Clean up warning

Data loss

Performing a database clean up is a permanent operation. This operation cannot be undone.