Scroll

Amazon S3 File Storage

A new feature of v2016.3 is the ability to store reports, temp files, config, and other Exago files on an Amazon S3 Cloud server.

In order to connect to your cloud server, you'll need to obtain your access key and secret key. See Getting Your Access Key ID and Secret Access Key for more information.

Additionally, you'll need to take down the region code for the location of your cloud server. See Regions and Availability Zones for more information.

Once you have your information, you'll need to create a formatted connection string in the following format. You'll use this string in various areas of Exago in order to access your cloud server.

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

  • region - Indicates the region of the cloud server.
  • accesskey - Amazon access key credential.
  • secretkey - Amazon secret key credential.
  • bucketname - The storage directory.

You can use your Amazon cloud storage for three purposes: Config Storage, Report Storage, and Temp Files Storage (which includes themes and templates).

(v2016.3.4+) To use EC2 instance credentials, set accesskey='ec2'

Config Storage

An Exago installation contains a configuration file, usually called WebReports.xml, which tells the application where to store Reports and Temp files.

There are two ways which you can specify a cloud location for the config file:

  1. A file in the Exago install directory called appSettings.config.
  2. If you're using the .NET API, a parameter in the API constructor method.

appSettings.config

Exago contains an xml file called appSettings.config in the root folder of the install directory. If it does not exist, create it as a text file with the following content:

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

This file is used for custom app settings which are automatically imported into Web.config during runtime. For more information, see appSettings.config / app.config.

NOTE. Do not edit the Web.config file directly. It is automatically generated by Exago, and any changes to it will be overridden.

To set the config file location, place your connection string in the appSettings.config file:

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

API

Exago 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 host application's web.config or app.config.
  2. Or pass the connection string in the API constructor method:
Api myApi = new Api("/exago/virtual/path", "WebReports.xml","pathtype=s3;region='region'accesskey='accesskey';secretkey='secretkey'bucketname='bucketname'");

Reports Storage

To use Amazon for report and folder management, enter your connection string in the Report Path field in your config file.

Main Settings Report Path) <reportpath>

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

Temporary Files Storage

To use Amazon for temp file storage, enter your connection string in the Temp Cloud Service field in your config file.

( Main Settings Temp Cloud Service) <tempcloudservice>

type=s3;region='region'accesskey='accesskey';secretkey='secretkey'bucketname='bucketname'
NOTE. You still need to maintain a local temp directory (Temp Path field).

Hidden Article Information

Article Author
Exago Development
created 2016-12-01 20:29:45 UTC
updated 2017-04-04 17:29:37 UTC

Labels
cloud, report management, Installation, Installing Exago, How Do I, AppSettings.config, Install, WebReports.xml, config file, configuration file, config, report path, cloud service, amazon, Amazon S3, S3,
Have more questions? Submit a request