You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

On this page:

Teamwork Cloud (TWCloud) is equipped with Data Manager for an administrative process. 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.

Downloading the datamanager tool.


Running the Data Manager

To run Data Manager


  1. Stop the TWCloud server.
  2. Make sure Cassandra is up and running.

    The ports through which Data Manager is connected to Cassandra are 9160 and 9042.

  3. Download DataManager.zip.
  4. Extract the zip file to the machine where you installed Cassandra.
  5. On the command line, change directory to DataManager folder. Type the command, datamanager -help, to display available commands like the following.

    $ datamanager -help
  6. Run your desired command to show the list of users like the following:
    datamanager -lu
  7. Once Data Manager closes, run a major compaction on the esi keyspace using the nodetool utility.
    $ nodetool compact -s esi

    Find detailed information about the nodetool utility and compact command at the following links:

    http://cassandra.apache.org/doc/latest/tools/nodetool/nodetool.html

    http://cassandra.apache.org/doc/latest/tools/nodetool/compact.html

The log file of Data Manager appears in the following directory:

<user folder>/.twcloud/19.0/datamanager.log

Data Manager commands

The following table outlines the commands you can use in Data Manager to manage your data. 

Server tool commandFunction
-lr,--list-resources  
Lists all available resources.
-lrd,--list-marked-deleted-resources
Lists all resources that were marked for deletion.
-lu,--list-users <--no-info>
Lists all usernames and their information, sorted by name. You can add --no-info to show only the usernames.
-help 
Display help information
-version
Display Data Manager version
-dr,--delete-resource <resource ID> <resource ID> ...

Deletes the given resource(s) and all of its related information.

  • Specify multiple resource ID using space as separator.
-drd,--delete-marked-deleted resources 
Deletes all resources that were marked as deleted.
-du,--delete-user <username> <username> ...

Deletes a given username(s) and all of its related information.

  • If a 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:
--delete-user "dan smith" 

or

-du "dan smith"
  • Specify multiple usernames using space as separator.

The delete command to delete resources and users works as follows.

Deleting selected resource

delete --mark-deleted resources
delete resource <resource ID>[,<resource ID>]...

These commands delete a selected resource and all of the following resource-related information:

  • Tags information of the resource. 
  • Category information (the resource will be removed from all categories). 
  • Branch information. 
  • Commit information. 
  • Role assignment information (role assignment information related to the resource will be removed). 
  • Locking information.

Deleting selected user

delete user <username>[ <username>]...


This command deletes a selected user and all of the following user-related information:

  • Role assignment information (all role assignment information belonging to the user will be removed).
  • Session (the existing user session will be removed).
  • Lock information (model elements in projects locked by the user will be unlocked).
  • User group information (the user will be removed from all user groups).


In the modeling tool's history panels, next to the deleted users, the word deleted will appear in brackets.