Deleting user IDs

Before you begin

Stop the Sametime server prior to running the Sametime database utility. Refer to Starting and stopping the Sametime server for the steps.

About this task

To remove specified individual contact names from contact lists and privacy lists, follow these steps:

Procedure

  1. Using a text editor, create a CSV file for only one type of change. You cannot mix name change types in the same CSV. Follow the syntax below. The file must be saved in UTF-8 format.
    Delete
    uid
    For example,
    DELETE
    uid=John Deere,ou=sametime,dc=hcl,dc=com
    uid=Marta Smith,ou=sametime,dc=hcl,dc=com
    cn=portaladminid,o=example.com 
  2. Copy the CSV file into an accessible read or writable location.
  3. Edit the .env file used to contain the environment variables. Follow the syntax below.
    MONGO_CONNECTION_URL=mongodb://sametimeUser:xxxxxxxx@192.168.1.1:27017/admin?authSource=admin&authMechanism=SCRAM-SHA-256&readPreference=primary&directConnection=true&ssl=false
    DELETE_CSV=/data/test_id.csv
    To delete the chat history of the affected IDs, add another line:
    DEEP_DELETE=1
    Note: When applicable, using the values indicated, add or insert a new line below the last line for every environment variable.
  4. Run the command below manually on a stand-alone community server or on a server in a cluster which replicates the change throughout the cluster. The CSV file is mounted in the container for the application to access and process.
    docker run -v <path-to-data-directory>:<path-to-data-directory>:rw --env-file default.env hclcr.io/st/sametime-db-utility

What to do next

Verify if the changes have been applied. For more information, refer to Sametime DB Utility reporting.