diff --git a/doc/user-guide/section_cli_trove.xml b/doc/user-guide/section_cli_trove.xml index 82bed19480..f436fbe5a2 100644 --- a/doc/user-guide/section_cli_trove.xml +++ b/doc/user-guide/section_cli_trove.xml @@ -282,7 +282,10 @@ command. In this example, the backup is called backup1. In this example, replace INSTANCE_ID with 97b4b853-80f6-414f-ba6f-c6f455a79ae6: - $ trove backup-create backup1 INSTANCE_ID + + This command syntax pertains only to python-troveclient version 1.0.6 and later. Earlier versions require you to pass in the backup name as the first argument. + + $ trove backup-create INSTANCE_ID backup1 +-------------+--------------------------------------+ | Property | Value | +-------------+--------------------------------------+ @@ -463,22 +466,22 @@ Create your first incremental backup Use the trove backup-create command and specify: - - The name of the incremental backup you are creating: - backup1.1 - The INSTANCE_ID of the database instance you are doing the incremental backup for (in this example, 792a6a56-278f-4a01-9997-d997fa126370) + + The name of the incremental backup you are creating: + backup1.1 + The BACKUP_ID of the parent backup. In this case, the parent is the regular backup, with an ID of 6dc3a9b7-1f3e-4954-8582-3f2e4942cddd - $ trove backup-create backup1.1 INSTANCE_ID --parent BACKUP_ID + $ trove backup-create INSTANCE_ID backup1.1 --parent BACKUP_ID +-------------+--------------------------------------+ | Property | Value | +-------------+--------------------------------------+ @@ -503,7 +506,7 @@ when you specify the parent, pass in the ID of the incremental backup you just created in the previous step (backup1.1). In this example, it is 1d474981-a006-4f62-b25f-43d7b8a7097e. - $ trove backup-create backup1.2 INSTANCE_ID --parent BACKUP_ID + $ trove backup-create INSTANCE_ID backup1.2 --parent BACKUP_ID +-------------+--------------------------------------+ | Property | Value | +-------------+--------------------------------------+ @@ -675,15 +678,7 @@ Change the database configuration using a configuration group You can change a database's configuration by attaching a configuration group to a database instance. You do this by using the trove configuration-attach - command and passing in the ID of the configuration group and the ID of the database - instance. - Get the ID of the configuration group: - $ trove configuration-list -+--------------------------------------+--------+-------------+--------------------------------------+ -| id | name | description | datastore_version_id | -+--------------------------------------+--------+-------------+--------------------------------------+ -| 9a9ef3bc-079b-476a-9cbf-85aa64f898a5 | group1 | None | eeb574ce-f49a-48b6-820d-b2959fcd38bb | -+--------------------------------------+--------+-------------+--------------------------------------+ + command and passing in the ID of the database instance and the ID of the configuration group. Get the ID of the database instance: $ trove list +--------------------------------------+------------------+-----------+-------------------+--------+-----------+------+ @@ -691,8 +686,18 @@ +--------------------------------------+------------------+-----------+-------------------+--------+-----------+------+ | 26a265dd-1c88-4333-b3ed-6b4e9e87ffbb | mysql_instance_7 | mysql | mysql-5.5 | ACTIVE | 6 | 5 | +--------------------------------------+------------------+-----------+-------------------+--------+-----------+------+ + Get the ID of the configuration group: + $ trove configuration-list ++--------------------------------------+--------+-------------+--------------------------------------+ +| id | name | description | datastore_version_id | ++--------------------------------------+--------+-------------+--------------------------------------+ +| 9a9ef3bc-079b-476a-9cbf-85aa64f898a5 | group1 | None | eeb574ce-f49a-48b6-820d-b2959fcd38bb | ++--------------------------------------+--------+-------------+--------------------------------------+ Attach the configuration group to the database instance: - $ trove configuration-attach CONFIG_GROUP_ID DB_INSTANCE_ID + + This command syntax pertains only to python-troveclient version 1.0.6 and later. Earlier versions require you to pass in the configuration group ID as the first argument. + + $ trove configuration-attach DB_INSTANCE_ID CONFIG_GROUP_ID Re-examine the database configuration