> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/best-practices/copystorm-directory-structure.md).

# CopyStorm Directory Structure

Upgrading CopyStorm can be a simple 30 second task if installed using a specific directory configuration.

The directory structure we recommend for a CopyStorm installation looks like the following:

* *CopyStorm*
  * Created by unzipping the CopyStorm download (see the Installation Instructions).
* *CapstormConfig*
  * *CapstormCustomerKey.txt*
    * Capstorm Customer Key file used for licensing.
  * *ProductionA*
    * *ProductionA.copyStorm*
      * CopyStorm configuration file for backing up the ProductionA Salesforce.
    * *ProductionALessFrequent.copyStorm*
      * CopyStorm configuration file for backing up the ProductionA Salesforce. This configuration file may backup Salesforce tables that are more expensive to backup (examples: Attachment, ContentVersion).
    * *ProductionA.copyStormMedic*
      * CopyStorm/Medic configuration file for maintaining the ProductionA Salesforce backup.
    * *config*
      * XML configuration files used by CopyStorm when backing up the ProductionA Salesforce.
  * *ProductionB*
    * *ProductionB.copyStorm*
      * CopyStorm configuration file for backing up the ProductionB Salesforce.
    * *config*
      * XML configuration files used by CopyStorm when backing up the ProductionB Salesforce.

In other words:

* Create a directory next to the CopyStorm installation called CopyStormConfig to hold all of your site specific configurations and customizations.
* Create a separate subdirectory under CopyStormConfig for each SalesForce instance to be backed up.

If you are managing your own job scheduling rather than using CopyStorm/Director then the BAT or sh files used to run your scheduled jobs should be stored with their respective CopyStorm configuration files. If you are using CopyStorm/Director the CopyStormConfig directory works perfectly for configuring CopyStorm/Director.

## Upgrading CopyStorm to a new version

If CopyStorm is installed using the directory structure detailed above, this process will upgrade the installation to a new version:

1. Remove or rename the CopyStorm directory.
2. Unzip the new CopyStorm release in the same location as the old CopyStorm directory.

This process should end with a replacement CopyStorm directory containing an upgraded version of the CopyStorm software.