docs.datacontroller.io/docs/dci-evaluation.md

# Data Controller for SAS® - Evaluation Version

## Overview
A free version of Data Controller is available for evaluation purposes. Compiled into a single SPK, it is very easy to install and configure.  However it must not be used in production environments for all the reasons mentioned in the [caveats](#caveats) section.

<iframe src="https://player.vimeo.com/video/328175910" width="640" height="360" frameborder="0" allowfullscreen></iframe>

## Installation

### Deployment

#### Import
Simply import the SPK (using SAS Management Console or Data Integration Studio) to the desired location in the metadata tree.  During the import (step 5 of the wizard), be sure to change the location of the library (BASE engine) to a **directory folder** to which the Stored Process system account (eg `sassrv`) has **write access**.

#### Permissions
Be sure that the user account you will use in the [configuration(#Configuration) step below has WRITE METADATA (WM) on the `/DataController/Admin` and `/DataController/Data` folders, and that anyone who will use the app has READ.

### Configuration

Navigate to the web application (eg `https://[YOURHOST]/SASStoredProcess?_action=1063`) and find the location where the app was imported.  Then run the `/DataController/Admin/configurator` stored process.

!!! note
    Use the same user account as you used to import the SPK, to avoid metadata permissions issues!  This may mean logging out / logging back in to the web application.

![evaltree](img/dci_evaltree.png)

This displays a screen with a choice of SAS Metadata Groups (to which your account belongs) can be chosen. Selecting any of these groups will build / rebuild all the configuration tables (placing logs in a subfolder of the previously configured library location) and provide the chosen group with **unrestricted** access to the tool.

![evaltree](img/dci_evalconfig.png)

!!! note
    "Unrestricted access" is provided by code logic.  Once installed, Data Controller does not ever update or modify metadata.  During installation, the services in the `/Admin` folder are updated (configuration) or removed (to prevent accidental reinstall).  Also the tables are registered in the `/Data` folder using `proc metalib`.

## Usage

Simply navigate to the imported location from the Stored Process Web App, right click on the 'clickme' stored process, and open in new window!

![evaltree](img/dci_evallaunch.png)


## Caveats

The demo version has been optimised for a rapid install, and should not be considered for production / commercial use, or for use by more than 2-5 people, for the following reasons:

1) Static content is compiled into SAS web services, which is inefficient (not scalable)

2) Requires BASE engine for config tables, with high risk of table locks

3) Not licenced for commercial (or production) use, and not supported

4) The embedded HandsOnTable library is not licenced for commercial use without a licence key

Contact Macro People support for a full-featured, fully licenced, scalable and supported deployment of Data Controller at your earliest convenience!
docs: adding evaluation version 2019-03-25 09:19:29 +00:00			`# Data Controller for SAS® - Evaluation Version`

			`## Overview`
docs: eval version 2019-05-02 00:01:17 +00:00			`A free version of Data Controller is available for evaluation purposes. Compiled into a single SPK, it is very easy to install and configure. However it must not be used in production environments for all the reasons mentioned in the [caveats](#caveats) section.`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
docs: licence updates 2020-01-25 19:42:02 +00:00			`<iframe src="https://player.vimeo.com/video/328175910" width="640" height="360" frameborder="0" allowfullscreen></iframe>`

docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00			`## Installation`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00			`### Deployment`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
docs: licence updates 2020-01-25 19:42:02 +00:00			`#### Import`
			Simply import the SPK (using SAS Management Console or Data Integration Studio) to the desired location in the metadata tree. During the import (step 5 of the wizard), be sure to change the location of the library (BASE engine) to a directory folder to which the Stored Process system account (eg `sassrv`) has write access.

			`#### Permissions`
			Be sure that the user account you will use in the [configuration(#Configuration) step below has WRITE METADATA (WM) on the `/DataController/Admin` and `/DataController/Data` folders, and that anyone who will use the app has READ.
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00			`### Configuration`

docs: licence updates 2020-01-25 19:42:02 +00:00			Navigate to the web application (eg `https://[YOURHOST]/SASStoredProcess?_action=1063`) and find the location where the app was imported. Then run the `/DataController/Admin/configurator` stored process.

			`!!! note`
			`Use the same user account as you used to import the SPK, to avoid metadata permissions issues! This may mean logging out / logging back in to the web application.`
docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00
eval version update 2019-05-29 19:17:52 +00:00			`![evaltree](img/dci_evaltree.png)`
docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00
docs: licence updates 2020-01-25 19:42:02 +00:00			`This displays a screen with a choice of SAS Metadata Groups (to which your account belongs) can be chosen. Selecting any of these groups will build / rebuild all the configuration tables (placing logs in a subfolder of the previously configured library location) and provide the chosen group with unrestricted access to the tool.`
docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00
eval version update 2019-05-29 19:17:52 +00:00			`![evaltree](img/dci_evalconfig.png)`
docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00
			`!!! note`
docs: licence updates 2020-01-25 19:42:02 +00:00			"Unrestricted access" is provided by code logic. Once installed, Data Controller does not ever update or modify metadata. During installation, the services in the `/Admin` folder are updated (configuration) or removed (to prevent accidental reinstall). Also the tables are registered in the `/Data` folder using `proc metalib`.
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
			`## Usage`

docs: evaluation & emails docs 2019-04-19 10:59:57 +00:00			`Simply navigate to the imported location from the Stored Process Web App, right click on the 'clickme' stored process, and open in new window!`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
eval version update 2019-05-29 19:17:52 +00:00			`![evaltree](img/dci_evallaunch.png)`
docs: eval version 2019-05-02 00:01:17 +00:00
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
			`## Caveats`

eval version update 2019-05-29 19:17:52 +00:00			`The demo version has been optimised for a rapid install, and should not be considered for production / commercial use, or for use by more than 2-5 people, for the following reasons:`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
eval version update 2019-05-29 19:17:52 +00:00			`1) Static content is compiled into SAS web services, which is inefficient (not scalable)`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
eval version update 2019-05-29 19:17:52 +00:00			`2) Requires BASE engine for config tables, with high risk of table locks`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
eval version update 2019-05-29 19:17:52 +00:00			`3) Not licenced for commercial (or production) use, and not supported`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
eval version update 2019-05-29 19:17:52 +00:00			`4) The embedded HandsOnTable library is not licenced for commercial use without a licence key`
docs: adding evaluation version 2019-03-25 09:19:29 +00:00
			`Contact Macro People support for a full-featured, fully licenced, scalable and supported deployment of Data Controller at your earliest convenience!`