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'
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'
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:
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"/>
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:
Api myApi = new Api("/exago/virtual/path", "WebReports.xml","pathtype=s3;region='region'accesskey='accesskey';secretkey='secretkey'bucketname='bucketname'");
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'
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).