chronograf

History

Pavel Zavora b9b62c76bd feat(migrate): allow etcds URL, improve help		2021-03-04 07:36:42 +01:00
..
README.md	feat: add migrate command to chronoctl	2020-02-03 20:43:44 -07:00
add.go	chore: add a KV layer prior to adding an etcd implementation (#5349 )	2020-01-21 09:26:23 -07:00
genKey.go	feat: add ability to authenticate single superadmin user (#5400 )	2020-02-28 14:14:46 -07:00
list.go	chore: add a KV layer prior to adding an etcd implementation (#5349 )	2020-01-21 09:26:23 -07:00
main.go	Add chronoctl to Makefile	2018-02-09 10:30:02 -05:00
main_test.go	fix: token option issue	2020-04-20 18:36:41 -06:00
migrate.go	feat(migrate): allow etcds URL, improve help	2021-03-04 07:36:42 +01:00
token.go	fix: token option issue	2020-04-20 18:36:41 -06:00
util.go	chore: add a KV layer prior to adding an etcd implementation (#5349 )	2020-01-21 09:26:23 -07:00

README.md

Chronoctl

Chronoctl is a tool to interact with an instance of a chronograf's bolt database.

Available commands:
  add-superadmin  Creates a new superadmin user  (bolt specific)
  list-users      Lists users                    (bolt specific)
  migrate         Migrate db (beta)

Migrate

The migrate command allows you to migrate your chronograf configuration store. It is highly recommended that you make a backup of all databases involved before running a migration as there is no guarantee that there will be no data loss. When specifying an etcd endpoint, the URI must begin with etcd://. It is preferred that you prefix bolt:// to an absolute path when specifying a local bolt db file, but a lone relative path is also accepted without the prefix. If there is authentication on etcd, use the standard URI format to define a username/password: [scheme:][//[userinfo@]host][/]path. There is currently no cleanup for a failed migration, so keep that in mind before migrating to a db that contains other important data.

Usage

chronoctl migrate [OPTIONS]

OPTIONS
    -f, --from= Full path to boltDB file or etcd (e.g. 'bolt:///path/to/chronograf-v1.db' or 'etcd://user:pass@localhost:2379 (default: chronograf-v1.db)
    -t, --to=   Full path to boltDB file or etcd (e.g. 'bolt:///path/to/chronograf-v1.db' or 'etcd://user:pass@localhost:2379 (default: etcd://localhost:2379)

Example

$ chronoctl migrate -f etcd://localhost:2379 -t bolt:///tmp/chronograf.db
# Performing non-idempotent db migration from "etcd://localhost:2379" to "bolt:///tmp/chronograf.db"...
#   Saved 1 organizations.
#   Saved 1 organization configs.
#   Saved 1 dashboards.
#   Saved 3 mappings.
#   Saved 0 servers.
#   Saved 1 sources.
# Migration successful!

$ chronoctl migrate -f ./chronograf-v1.db -t etcd://localhost:2379
# Performing non-idempotent db migration from "./chronograf-v1.db" to "etcd://localhost:2379"...
#   Saved 1 organizations.
#   Saved 1 organization configs.
#   Saved 1 dashboards.
#   Saved 3 mappings.
#   Saved 0 servers.
#   Saved 1 sources.
# Migration successful!