db migrate

Prev Next

iagctl db migrate

Migrate between etcd and local file database storage options

Synopsis

The migrate-db command allows a user to move data between local and etcd databases. To use this command, your configured GATEWAY_STORE_BACKEND must be set to either local or etcd.

This command is useful when changing the architecture of a gateway installation from requiring or not requiring a distributed etcd data store.

  • Let's say you start with an "all-in-one" gateway installation where a local file database located at GATEWAY_APPLICATION_WORKING_DIR/gateway.db is sufficient.
  • Eventually, the gateway operator needs to move to a distributed core/runner gateway architecture where a distributed etcd database would be required.
  • In this scenario, the gateway operator would ensure there is a proper configuration for both the etcd database as well as the local database and then run iagctl db migrate local-to-etcd.

For a list of all configured store configuration variables, run iagctl version --show-config.

The API keys that are used for gateway server logins will not be copied over.

Options

  -h, --help   help for migrate

Options Inherited from Parent Commands

--config string   Path to the configuration file
--raw             Displays the result of the command in its raw format
--verbose         Enable verbose output

CLI References

See related db commands: