adding deploy steps
This commit is contained in:
parent
11a3f14df0
commit
5182a3775e
33
docs/dci-backend.md
Normal file
33
docs/dci-backend.md
Normal file
@ -0,0 +1,33 @@
|
||||
#Data Controller for SAS® - Backend Deployment
|
||||
|
||||
## Overview
|
||||
The backend for data controller consists of a set of Stored Processes, a macro library, and a database. The database can be SAS Base library if desired, however this can cause contention (eg table locks) if end users are able to connect to the datasets directly, eg via Enterprise Guide or Base SAS.
|
||||
|
||||
## Details
|
||||
|
||||
1 - Unzip dcbackend.zip and copy the files to a preferred location on the application server (eg SASApp). This contains the SAS source code and ddl files.
|
||||
|
||||
2 - Import datacontroller.spk using SAS Management Console. The location in which this is deployed should be added to the `metadataRoot` value in the `h54s.config` file as per [frontend](dci-frontend.md#details) deployment.
|
||||
|
||||
3 - Create a staging directory. This will contain the data submitted by editors and awaiting approval. The Stored Process system account (eg `sassrv`) will need write access to this location.
|
||||
|
||||
4 - Register a library in metadata for your preferred database. The libref should be `DATACTRL`. If this is not possible, then an alternative libref can be used, simply specify it in the configuration in step 6.
|
||||
|
||||
5 - Make the `mpeinit.sas` macro available. This "initialisation" macro needs to be available to a fresh Stored Process session. There are several ways to do this, such as to `%include` from the `/Lev1/StoredProcessServer/StoredProcessServer_usermods.sas` file or to create a symlink from the `sasautos` directory.
|
||||
|
||||
6 - Configure the `mpeinit.sas` file. This is where all your site specific locations are stored. The following macro variables should be modified:
|
||||
|
||||
* `mperepo` - location of the files uploaded in step 1
|
||||
* `mpmetaroot` - location where the STPs were deployed in step 2
|
||||
* `mpelocapprovals` - location of staging directory as per step 3
|
||||
* `mpelib` - if you were unable to use the `DATACTRL` libref in step 4, then use the updated libref here
|
||||
* `mpeadmins` - enter the name of a metadata group (eg SASAdministrators) that should be given unrestricted access to the tool
|
||||
|
||||
7 - Deploy the data model. For this, simply run the following code:
|
||||
```
|
||||
%mpeinit()
|
||||
options insert=(sasautos="&mperepo/build");
|
||||
%mpe_build()
|
||||
```
|
||||
|
||||
The next step is to deploy the [frontend](dci-frontend.md).
|
15
docs/dci-frontend.md
Normal file
15
docs/dci-frontend.md
Normal file
@ -0,0 +1,15 @@
|
||||
# Data Controller for SAS® - Frontend Deployment
|
||||
|
||||
## Overview
|
||||
The Data Controller front end was built on the Angular seed app from Boemska AppFactory®. As such it comes bundled with standard features such as log handling and SASLogon redirects. It is deployed the the root of the SAS Web Server (mid-tier), typically `htdocs`.
|
||||
|
||||
## Instructions
|
||||
|
||||
1 - Unzip dcfrontend.zip and upload the entire `datacontroller` directory to the static content server
|
||||
|
||||
2 - Open the `h54s.config` file and update the `metadataRoot` value to the location of the Stored Processes as per [backend](dci-backend.md) deployment.
|
||||
|
||||
It should now be possible to use the application - simpliy navigate to YO
|
||||
URSASWEBLOC.domain/yourRoot/datacontroller and sign in!
|
||||
|
||||
The next step is to [configure](dcc-tables.md) the tables.
|
@ -8,6 +8,9 @@ pages:
|
||||
- Tables: dcc-tables.md
|
||||
- Security: dcc-security.md
|
||||
- Selectboxes: dcc-selectbox.md
|
||||
- Installing Data Controller:
|
||||
- Backend: dci-backend.md
|
||||
- Frontend: dci-frontend.md
|
||||
|
||||
markdown_extensions:
|
||||
- admonition
|
||||
|
Loading…
Reference in New Issue
Block a user