# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.capstorm.com/best-practices/copystorm-directory-structure.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.