Uninstall Swarm

This section covers the steps required to uninstall Swarm.

Background

The bulk of Swarm's metadata (activity, comments, review records, followers) is stored in p4 keys under swarm-*. If you are using a 2012.1+ server, Swarm also defines user groups for each project that you define. The names of these groups correspond 1-to-1 with projects, for example swarm-project-fantastico. Swarm manages a pool of client workspaces that it uses to shelve and commit files. These clients are named swarm-{uuid}, for example swarm-5ad4a9c0-06e7-20eb-897f-cbd4cc934295.

Uninstall steps

  1. Uninstall the Swarm triggers

  2. Remove your web server's virtual host configuration for Swarm.

  3. Restart your web server.

  4. Delete groups/clients/keys that are prefixed with swarm-*.

    Note

    The clients could contain shelved files for reviews. Determine how you want to handle those files prior to deleting the clients.

  5. Remove the database file db.ixtext: 

    $ rm perforce_root/db.ixtext

    Warning

    This step removes all generic and job index records from the Perforce service, not just those used by Swarm. If you need to selectively remove only the Swarm indexes, contact Perforce support .

  6. Rebuild the job index. The best approach is to run: 

    $ p4 jobs -R

    which rebuilds the db.ixtext table. There are two caveats that likely require discussion with :

    1. If you make use of the unsupported p4 index command, you cannot use this approach, as it would remove all of your indexes.

    2. If you have indexing turned on for the domain table, you must also run: 

      $ p4d -xf index.domain.owner