Dan HeathandRobin Beck
5ce6515156
* docs: IA reorganization * docs: Updates * docs: Updates * docs: Fix links * docs: Updates * docs: Fix a typo * docs: Fix client agent topic * docs: Update Client Agent nav * docs: Fix conflict * docs: Fix a typo in Client Agent docs (#5853) * docs: Fix client agent topic * docs: Updates * docs: Updates * docs: Updates * docs: Updates * docs: Fixes get started and operations links * docs: Update nav * docs: Partials * docs: Unix partials * docs: Worker partials * docs: Updates * docs: Update workers and targets * docs: Updates * docs: Updates * docs: Fixes link * docs: Updates after sync review * docs: Updates from review feedback * docs: Move worker filter examples * docs: Fix links * docs: Updates for filters based on working session * docs: Fixes broken links * docs: Add links to other filter topics * docs: Update list intro * docs: Adds link * docs: Fixes redirects * docs: Fixes redirects * docs: Deleted mysql page from TOC * docs: Add versioned redirect * docs: Adds versioned redirects * docs: Adds versioned redirects * docs: Update redirects * docs: Update redirects * docs: Redirect fixes * docs: Update redirect format * docs: Fix a typo * docs: Fixes redirects * docs: Fixes redirect * docs: Adds links out to client agent troubleshooting * uses /etc/boundary.d/ as recommended installation directory (#6003) * docs: Updates legacy io links * docs: Fixes redirects * docs: Fix redirect * docs: Restoring deleted file --------- Co-authored-by: Robin Beck <stellarsquall@users.noreply.github.com>
59 lines
2.1 KiB
Plaintext
59 lines
2.1 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: database migrate - Command
|
|
description: >-
|
|
The "database migrate" command migrates Boundary's database within an enclosing scope or resource.
|
|
---
|
|
|
|
# database migrate
|
|
|
|
Command: `boundary database migrate`
|
|
|
|
The `database migrate` command migrates the Boundary database within an enclosing scope or resource.
|
|
|
|
## Examples
|
|
|
|
The following example migrates Boundary's database to the database URL specified in the controller configuration file:
|
|
|
|
```shell-session
|
|
$ boundary database migrate -config=/etc/boundary.d/controller.hcl
|
|
```
|
|
|
|
## Usage
|
|
|
|
<CodeBlockConfig hideClipboard>
|
|
|
|
```shell-session
|
|
$ boundary database migrate [options]
|
|
```
|
|
|
|
</CodeBlockConfig>
|
|
|
|
|
|
### Command options
|
|
|
|
- `-config` `(string: "")` - The path to the configuration file.
|
|
- `-config-kms` `(string: "")` - The path to a configuration file containing a `kms` block marked for the `config` purpose.
|
|
The KMS block performs decryption of the main configuration file.
|
|
If you don't set a `kms` block, Boundary looks for such a block in the main configuration file, which has some drawbacks; see the help output for `boundary config encrypt -h` for details.
|
|
- `-log-format` `(string: "")` - The log format. Supported values are `standard` and `json`.
|
|
- `-log-level` `(string: "")` - The log verbosity level. Supported values include the following in order of more detail to less:
|
|
|
|
- `trace`
|
|
- `debug`
|
|
- `info`
|
|
- `warn`
|
|
- `err`
|
|
|
|
You can also specify a log level using the **BOUNDARY_LOG_LEVEL** environment variable.
|
|
|
|
### Migration options:
|
|
|
|
- `-migration-url` `(string: "")` - If set, this value overrides the migration URL set in the configuration file, and specifies the URL use to connect to the database for migration.
|
|
Configuring this option can allow different permissions for the user running initialization or migration vs. a standard operation.
|
|
This value can refer to a direct database URL, or it can refer to a file on disk (`file://`) or an environment variable (env://) from which Boundary reads the URL.
|
|
- `-repair` `(string: "")` - If set, runs the repair function for the provided migration
|
|
version.
|
|
|
|
|
|
@include 'cmd-option-note.mdx' |