Teamwork Cloud (TWCloud) is equipped with a Data Manager for administrative processes. You need to download the data manager zip file and extract it to the machine where you installed Cassandra. Before using Data Manager, we recommend that you backup your database in the same manner as you do before using the migration tool. You can download the DataManager tool from the same location you download the migration tools for the Cassandra database and UML meta-model.
Running the Data Manager
To run Data Manager
Stop the TWCloud server.
Note
If the command-line migration tool is running, it needs to be stopped as well.
Make sure Cassandra is up and running.
Note
The ports through which Data Manager is connected to Cassandra are 9160 and 9042.
Download DataManager.zip.
Extract the zip file to the machine where you installed Cassandra.
On the command line, change the directory to the DataManager folder. Type the command, "datamanager -help", to display available commands like the following.
Code Block
$ datamanager -help
Run your desired command to show the list of users like the following:
Code Block
datamanager -lu
Note
Datamanager will connect to Cassandra on localhost using anonymous authentication. If your Cassandra node is configured to bind to a specific IP address (by default ports 9160 and 9042 bind to all interfaces), or if you have configured Cassandra to use an authenticator other than AllowAllAuthenticator, you will need to modify <installation_dir>/configuration/application.conf accordingly.
Info
The log file of Data Manager appears in the following directory:
<user folder>/.twcloud/2021x/datamanager.log
Data Manager commands
The following table outlines the commands you can use in Data Manager to manage your data.
Deletes the given revision(s) and all of its related information.
Specify multiple revisions using a comma as a separator.
Note
includeChildRevision has two values: true and false.
When the includeChildRevision value is set to false, and the revision is not the latest, it will not be deleted.
When the includeChildRevision value is set to true, the upward revisions and branches within it from the selected version will be deleted.
-du,--delete-user <username>
Deletes the given username(s) and all of its related information.
Specifies multiple usernames using space as a separator.
Note
If the username consists of two words (for example, dan smith) you must add double quotation marks (" ") before and after the username, as shown in the following example:
Lists all usernames and their information, sorted by name.
Note
You can add --no-info to show only the usernames.
-ram,--reset-administrator
Reset admin password, status, and permissions.
Note
If there is no Administrator account, it will be created.
If the Administrator account exists in the database:
If the account is for an external user, it will be reset to an internal user with a new password. This user will be shown in the TWCloud Admin console.
If the account is an internal user, only a new password will be generated, and the user will be shown in the TWCloud Admin console.
The default roles of the TWCloud Admin will be restored to make sure that this account can fully operate as the default administrator.
-rc,--recreate-cluster-id
Recreates a cluster ID.
-ri,--rebuild-index <data=value1,value2>
Rebuilds all indexes for the given data and uses the data=* option to rebuild all indexes of all available data.
-urd,--unmark-deleted-resources <resource ID>
Unmarks the given resource(s) previously marked as deleted.
Specify multiple resource ID IDs using space as a separator.