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.
- ProductionA.copyStorm
- ProductionB
- ProductionB.copyStorm
- CopyStorm configuraiton file for backing up the ProductionB Salesforce.
- config
- XML configuration files used by CopyStorm when backing up the ProductionB Salesforce.
- ProductionB.copyStorm
- CapstormCustomerKey.txt
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:
- Remove or rename the CopyStorm directory.
- 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.