This document covers several versions of the application. Use the Viewing content for dropdown to see only the content relevant to a specific application version.

Amazon Cloud Storage can be used for:

• Config Storage
• Report Storage
• Temp Files Storage (which includes themes and templates).

In order to connect to your cloud server:

1. Obtain the access key and secret key. See Getting Your Access Key ID and Secret Access Key for more information.
2. Locate the region code for the location of the cloud server. See Regions and Availability Zones for more information.
3. Create a formatted connection string in the following format. This string will be used in various places in the application to connect to the cloud storage repository.

region='region';accesskey='accesskey';secretkey='secretkey';bucketname='bucketname'

• region — the region of the cloud server from step 2.
• accesskey: Amazon access key credential from step 1.
• secretkey: Amazon secret key credential from step 1.
• bucketname: The storage directory.

EC2 v2016.3.4+

To enable EC2 instances access to S3 buckets, an IAM role needs to be created and tied to the instances with a policy allowing that level of access.

To use instance credentials, set every instance of accesskey to ec2.

The Config, Reports, and Temp files can all reside in a single S3 bucket, and will be placed automatically into separate Config, Reports, and Temp folders, which should not need to be created ahead of time.

 

Config Storage

An Exago installation contains a minimum of one base configuration file, typically named WebReports.xml.

There are three ways to specify a cloud location for this config file:

1. A file in the Web Application install directory called appSettings.config.
2. When using the .NET API, an argument in the API constructor method.
3. When using the REST Web Service API, a connection string needs to be placed in both appSettings.config files in the WebServiceApi folder and the Web Application install directory.

Method 1: appSettings.config

Exago utilizes the appSettings.config file in the root folder of the install directory to load certain settings with the start of the web server. For more information, see Application Settings.

If it does not exist, create it as a text file with the following content:

<?xml version="1.0"?>
<appSettings>
</appSettings>

To set the config file location, place or change this ExagoConfigPath node in the appSettings.config file as follows:

<add key="ExagoConfigPath" value="pathtype=s3;region='region';accesskey='accesskey';secretkey='secretkey';bucketname='bucketname';storagekey=config"/>

Change the bucketname and region values to match the environment along with the accesskey and secretkey from the beginning of this article:

• • bucketname — the S3 bucket used for config, report, and temporary file storage
  • region — the AWS region where the S3 bucket is located

• storagekey — must always be config

To allow S3 access for EC2 instances, add the following line to the config after configuring the EC2 instances:

<add key="ExagoConfigPath" value="pathtype=s3;region='region';accesskey='ec2';bucketname='bucketname';storagekey=config"/>

Method 2: .NET API

Exago .NET API apps cannot access the appSettings.config file. Instead, you must use one of the following two methods to specify a config file location:

1. Place the config key within the embeddting host application‘s web.config or app.config.
2. Pass the connection string to the API constructor:

Api myApi = new Api("/exago/virtual/path", "WebReports.xml", "pathtype=s3;region='region';accesskey='accesskey';secretkey='secretkey';bucketname='bucketname'");

api.ReportManagement.AddFolder("<parent folder>", "<child folder>");

Method 3: REST Web Service API

The REST Web Service API requires the following connection string to be placed in both appSettings.config files, located in the WebServiceApi folder and Exago’s install directory.

<add key="ExagoConfigPath" value="pathtype=s3;region='us-east-1';accesskey='accesskey';bucketname='bucketname';secretkey='secretkey';storagekey=config"/>

pathtype=s3;region='region';accesskey='accesskey';secretkey='secretkey';bucketname='bucketname'

pathtype=s3;region='region';accesskey='ec2';bucketname='bucketname'

Temporary File Storage

Note

Log files will still be written to the Admin Console > General > Main Settings > Temp Path even when a Temp Cloud Path is defined.

To use Amazon for temporary file storage, enter your connection string in the Temp Cloud Service field of the configuration.

Admin Console > General > Main Settings > Temp Cloud Service

type=s3;region='region';accesskey='accesskey';secretkey='secretkey';bucketname='bucketname'

For EC2, the Temp Path should be defined as:

pathtype=s3;region='region';accesskey='ec2';bucketname='bucketname'