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

53 lines
3.0 KiB
Markdown
Raw Normal View History

2019-03-25 09:19:29 +00:00
# Data Controller for SAS® - Evaluation Version
## Overview
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.
2019-03-25 09:19:29 +00:00
2020-01-25 19:42:02 +00:00
<iframe src="https://player.vimeo.com/video/328175910" width="640" height="360" frameborder="0" allowfullscreen></iframe>
2019-04-19 10:59:57 +00:00
## Installation
2019-03-25 09:19:29 +00:00
2019-04-19 10:59:57 +00:00
### Deployment
2019-03-25 09:19:29 +00:00
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.
2019-03-25 09:19:29 +00:00
2019-04-19 10:59:57 +00:00
### Configuration
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.
2019-04-19 10:59:57 +00:00
2019-05-29 19:17:52 +00:00
![evaltree](img/dci_evaltree.png)
2019-04-19 10:59:57 +00:00
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.
2019-04-19 10:59:57 +00:00
2019-05-29 19:17:52 +00:00
![evaltree](img/dci_evalconfig.png)
2019-04-19 10:59:57 +00:00
!!! note
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`.
2019-03-25 09:19:29 +00:00
## Usage
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!
2019-03-25 09:19:29 +00:00
2019-05-29 19:17:52 +00:00
![evaltree](img/dci_evallaunch.png)
2019-05-02 00:01:17 +00:00
2019-03-25 09:19:29 +00:00
## Caveats
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:
2019-03-25 09:19:29 +00:00
2019-05-29 19:17:52 +00:00
1) Static content is compiled into SAS web services, which is inefficient (not scalable)
2019-03-25 09:19:29 +00:00
2019-05-29 19:17:52 +00:00
2) Requires BASE engine for config tables, with high risk of table locks
2019-03-25 09:19:29 +00:00
2019-05-29 19:17:52 +00:00
3) Not licenced for commercial (or production) use, and not supported
2019-03-25 09:19:29 +00:00
2019-05-29 19:17:52 +00:00
4) The embedded HandsOnTable library is not licenced for commercial use without a licence key
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!