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

Depending on how you have configured your Helix Core Server events, do one of the following:
- Uninstall the Swarm Helix Core Server extension. To do this, run the following command on your Helix Core Server:
  
  p4 extension --delete Perforce::helix-swarm --yes
- Uninstall the Swarm triggers. As a super user, run the p4 triggers command from your Helix Core Server and manually remove all the Swarm trigger code lines.
Remove your web server's virtual host configuration for Swarm by disabling the Swarm site (perforce-swarm-site). If you have made any non-standard changes for Swarm such as SSL configuration or if an alternate web server is used, you must remove these changes for Swarm.

Depending on your OS distribution, do one of the following:
- Ubuntu (run the following command as root):
  1. Disable the Swarm site:
    
    a2dissite perforce-swarm-site
  2. Delete the Swarm site:
    
    Delete /etc/apache2/sites-available/perforce-swarm-site.conf
- CentOS/RHEL/Amazon Linux 2 (run the following command as root):
  
  Delete the Swarm site:
  
  Delete /etc/httpd/conf.d/perforce-swarm-site.conf
Restart your web server.
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.
Additional indexed information is stored in the database file db.ixtext. Unfortunately, indexed jobs and other generic indexed information would be lost if this table was simply removed, and modifying the database file can be a dangerous operation in a number of Helix Core Server deployment scenarios.

Important
Contact Perforce support for assistance if you feel the need to remove Swarm's indexed information: [email protected].
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 [email protected]:
- If you make use of the unsupported p4 index command, you cannot use this approach, as it would remove all of your indexes.
- If you have indexing turned on for the domain table, you must also run:
```
$ p4d -xf index.domain.owner
```
If the P4.Swarm.URL or P4.Swarm.CommitURL properties were set (for details, see Client integration and Commit-edge deployment respectively), they should be unset to prevent P4V (and potentially other clients) from attempting Swarm operations. We recommend you view all the properties and delete them all.

To delete each Swarm property:
```
$ p4 property -d -n <P4.Swarm property> -s <sequence>
```
The sequence is provided in the property list. A property with #none is sequence 0.

To discover all of the definitions of the P4.Swarm.* properties and their sequence numbers, as a Perforce super user run the following command:
```
$ p4 property -Al P4.Swarm
```
For example, the following property values are returned that apply to all users and groups:
```
$ p4 property -Al P4.Swarm
P4.Swarm.CommitURL = https://myswarm.url/ (any) #none
P4.Swarm.CommitURL = https://myswarm1.url/ (any) #1
P4.Swarm.URL = https://myswarm.url/ (any) #none
P4.Swarm.URL = https://myswarm3.url/ (any) #3
P4.Swarm.URL = https://myswarm2.url/ (any) #2
P4.Swarm.URL = https://myswarm1.url/ (any) #1
```
To delete all of these property definitions, you would run the following commands:
```
$ p4 property -d -n P4.Swarm.CommitURL -s0
$ p4 property -d -n P4.Swarm.CommitURL -s1
$ p4 property -d -n P4.Swarm.URL -s0
$ p4 property -d -n P4.Swarm.URL -s3
$ p4 property -d -n P4.Swarm.URL -s2
$ p4 property -d -n P4.Swarm.URL -s1
```
To verify if all the properties have been deleted, run the following command as a Perforce super user:
```
$ p4 property -Al P4.Swarm
```