The CapStorm/Container stores configuration and scheduling data in a CopyStorm/Director Database. The database is initialized when the CapStorm/Container first connects.

You can configure the database connection by either:

1. Providing environment variables with connection information.

2. Setting the connection information on the Initial Server Configuration tab.

After the connection information is provided, the container will alter the database to match by creating tables and columns as defined in the Director Database schema. All tables, including those denoted (Platform Only), are a part of the CopyStorm/Container backing database.

To install the CapStorm/Container, you will need to have a container host ready to run the container.

This installation guide provides an example installation path using the Docker Desktop application.

1: Launch the container

1. Pull the latest image from the capstorm/capstorm docker repository.

2. Configure port forwarding to enable web access. CapStorm/Container web services are hosted via Apache Tomcat, which consumes the following ports:

   1. Container port 8080 provides HTTP access.

   2. Container port 8443 provides self-signed HTTPS access.

3. Start the container.

4. Navigate to the container’s web URL ().

If the image has successfully launched, you will see a screen that looks like this:

Once the container is launched, log in with the following credentials:

• Username: capstorm

• Password: capstorm

To configure initial container parameters, click on the Click Here for Initial Configuration link:

After Clicking the Click Here for Initial Configuration link, you will see a screen that looks like this:

When initialization parameters have been provided, click Validate Configuration to validate the provided customer key & database connection.

After a successful save you’ll see the following dialog:

Refer to the comprehensive for in-depth insights into various components of the web application.

To install the CapStorm/Container, you will need to have a container host ready to run the container.

This installation guide provides an example installation path using the Docker Desktop application.

Note: To install the container using Docker Compose (CLI), please refer to CapStorm’s docker hub for an example.

Prerequisites

• A Host For the Docker Container

• A CapStorm Customer Key GUID

  • The CapStorm team will provide you with a unique Customer Key associated with your account. This key provides access to your entitled features. The CapStorm customer key will take the following form:

    • XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

• Valid database connection details to a MySQL, PostgreSQL, or SQL Server database

  • The CapStorm Platform database user is expected to have the following Database Permissions

    • CONNECT

      • Used to establish remote connections to the target database

If your organization wishes to use Salesforce as an Authenticator for CapStorm/Container, be sure to follow our guide for

Pull the latest image from the docker repository

• This can be accomplished by searching for the image in Docker Desktop and clicking Pull. Note that the latest GA release of the CapStorm/Container will have the tag latest.

1. In Docker Desktop, navigate to Images

2. Click the Play Icon to queue up the container launch

3. Before clicking the Run button, expand optional settings. You’ll see the following screen:

   • Use this screen to provide:

After providing all previously mentioned environment variables, the image is ready to launch. Click the Run button to start the container.

The screenshot below is an example of an image launch:

Note: The container bootstrapping process is completed once you see the following message in the Container Logs:

CopyStormDirector is waiting for 0 jobs to complete.

Note: The following message will be displayed in the Container Logs if there are issues establishing a connection with the Database:

Exception in thread “main” java.lang.Exception: Cannot connect to database.

at com.capstorm.platform.configuration.webconfig.a.b(SourceFile:260) at com.capstorm.platform.environmentinitializer.EnvironmentInitializer.c(SourceFile:175) at com.capstorm.platform.environmentinitializer.EnvironmentInitializer.b(SourceFile:415) at com.capstorm.platform.environmentinitializer.EnvironmentInitializer.main(SourceFile:441)

Note: The following message will be displayed if there were any issues bootstrapping the CapStorm/Container:

Error running scheduled CopyStorm/Director jobs

1. In a Web Browser, navigate to or

2. You will see the following screen:

3. If you did NOT provide initialization environment variables: log in with the temporary bootstrap credentials capstorm / capstorm, then click “Click Here for Initial Configuration” and complete the setup wizard (Customer Key, Admin Password, database connection, etc.).

Please refer to the Reference Documentation for the CapStorm/Container and core CapStorm Applications:

• • Backup Salesforce to a Relational Database