Skip to content

Commit

Permalink
docs: (IAC-1462) remove references to multi-tenancy documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
riragh committed May 20, 2024
1 parent 2a1c859 commit 7a727c0
Show file tree
Hide file tree
Showing 4 changed files with 0 additions and 245 deletions.
3 changes: 0 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,6 @@ This project contains Ansible code that creates a baseline cluster in an existin
- Manage SAS Viya Platform Deployments
- Organize and persist configuration for any number of SAS Viya platform deployments across namespaces, clusters, or cloud providers.

- SAS Viya Multi-tenant Deployment
- Multi-tenancy in the SAS Viya platform creates and manages separate and secure cloud-computing units. See [SAS Viya Multi-Tenancy Documentation](./docs/user/Multi-Tenancy.md) for details.

- SAS Viya with SingleStore Deployment
- SingleStore is a cloud-native database designed for data-intensive applications. See the [SAS Viya with SingleStore Documentation](./docs/user/SingleStore.md) for details.

Expand Down
54 changes: 0 additions & 54 deletions docs/CONFIG-VARS.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,6 @@ Supported configuration variables are listed in the table below. All variables
- [Metrics Server](#metrics-server)
- [NFS Client](#nfs-client)
- [Postgres NFS Client](#postgres-nfs-client)
- [Multi-tenancy](#multi-tenancy)

## BASE

Expand Down Expand Up @@ -452,56 +451,3 @@ The Postgres NFS client is currently supported by the nfs-subdir-external-provis
| PG_NFS_CLIENT_CHART_NAME | nfs-subdir-external-provisioner Helm chart name | string | nfs-subdir-external-provisioner | false | | baseline |
| PG_NFS_CLIENT_CHART_VERSION | nfs-subdir-external-provisioner Helm chart version | string | 4.0.18| false | | baseline |
| PG_NFS_CLIENT_CONFIG | nfs-subdir-external-provisioner Helm values | string | See [this file](../roles/baseline/defaults/main.yml) for more information. | false | | baseline |


## Multi-tenancy

| Name | Description | Type | Default | Required | Notes | Tasks |
| :--- | ---: | ---: | ---: | ---: | ---: | ---: |
| V4MT_ENABLE | Enables multi-tenancy in the SAS Viya platform deployment | bool | false | false || viya, multi-tenancy |
| V4MT_MODE | Set V4MT_MODE to either schema or database | string | schema | false | Two modes of data isolation (schemaPerApplicationTenant, databasePerTenant) are supported for tenant data. The default is schemaPerApplicationTenant. | viya, multi-tenancy |
| V4MT_TENANT_IDS | Maps to SAS_TENANT_IDS. One or more tenant IDs to onboard or offboard | string | | false | Example: Single tenant ID: "acme" or Multiple tenant IDs: "acme, cyberdyne, intech". Tenant IDs have a few naming restrictions, See the details [here](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=caltenants&docsetTarget=p0emzq13c0zbhxn1hktsdlmig934.htm#n1fptbibrh96r8n1jy317onpjd8r) | viya, multi-tenancy |
| V4MT_PROVIDER_PASSWORD | Optional: The password that is applied to the tenant administrator on each onboarded tenant | string | | false | Maps to SAS_PROVIDER_PASSWORD. When V4MT_PROVIDER_PASSWORD is specified, V4MT_PROVIDER_PASSWORD_{{TENANT-ID}} cannot be used. See details [here](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=caltenants&docsetTarget=p0emzq13c0zbhxn1hktsdlmig934.htm#p1ghvmezrb3cvxn1h7vg4uguqct6). | multi-tenancy |
| V4MT_PROVIDER_PASSWORD_{{TENANT-ID}} | Optional: Unique sasprovider password for each tenant being onboarded. {{TENANT-ID}} must be in uppercase. | string | | false | Maps to SAS_PROVIDER_PASSWORD_{{TENANT-ID}}. When V4MT_PROVIDER_PASSWORD_{{TENANT-ID}} is specified, V4MT_PROVIDER_PASSWORD cannot be used. See details [here](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=caltenants&docsetTarget=p0emzq13c0zbhxn1hktsdlmig934.htm#p1ghvmezrb3cvxn1h7vg4uguqct6). | multi-tenancy |
| V4MT_TENANT_CAS_CUSTOMIZATION | Map of objects with all tenant CAS customization variables. See the format below. | | | false | | multi-tenancy |

### Tenant CAS Customization

Some of the tenant CAS customizations can be defined with the V4MT_TENANT_CAS_CUSTOMIZATION variable, which is a map of objects. The variable has the following format:

```bash
V4MT_TENANT_CAS_CUSTOMIZATION:
<tenant-id1>:
...
<tenant-id2>:
...
...
```
Below is the list of parameters each element can contain.

| Name | Description | Type | Default | Required | Notes | Tasks |
| :--- | ---: | ---: | ---: | ---: | ---: | ---: |
| memory | Amount of RAM to allocate to per CAS node | string | | false | Numeric value followed by the units, such as 32Gi for 32 gibibytes. In Kubernetes, the unit is Gi. | multi-tenancy |
| cpus | Number of CPU cores to allocate per CAS node | string | | false | Either a whole number, representing that number of cores, or a number followed by m, indicating that number of milli-cores. | multi-tenancy |
| loadbalancer_enabled | Set up LoadBalancer to access CAS binary ports | bool | false | false | | multi-tenancy |
| loadbalancer_source_ranges | LoadBalancer source ranges specific to the tenant | list | false | false | | multi-tenancy |
| worker_count | The number of CAS worker nodes for tenants. Default is 0 (SMP) | int | 0 | false | | multi-tenancy |
| backup_controller_enabled | Enable backup CAS controller | bool | false | false | | multi-tenancy |

Example:

```bash
V4MT_TENANT_CAS_CUSTOMIZATION:
acme:
memory: 3Gi
cpus: 300m
loadbalancer_enabled: true
loadbalancer_source_ranges: ['0.0.0.0/0']
worker_count: 0
backup_controller_enabled: false
intech:
memory: 2Gi
cpus: 250m
worker_count: 1
backup_controller_enabled: true
```
16 changes: 0 additions & 16 deletions docs/Troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@
- [Ansible Variables with Special Jinja2 Characters](#ansible-variables-with-special-jinja2-characters)
- [Ingress-Nginx - use-forwarded-headers disabled](#ingress-nginx---use-forwarded-headers-disabled)
- [Deploying with the SAS Orchestration Tool using a Provider Based Kubernetes Configuration File](#deploying-with-the-sas-orchestration-tool-using-a-provider-based-kubernetes-configuration-file)
- [SAS Risk Cirrus Solutions Multi-tenancy onboard failure](#sas-risk-cirrus-solutions-multi-tenancy-onboard-failure)
- [Applying a New License for your SAS Viya Platform Deployment](#applying-a-new-license-for-your-sas-viya-platform-deployment)
- [Tagging the AWS EC2 Load Balancers](#tagging-the-aws-ec2-load-balancers)

Expand Down Expand Up @@ -346,21 +345,6 @@ You have a couple of options:
* See [Kubernetes documentation](https://kubernetes.io/docs/concepts/security/service-accounts/)
* Note: this is what the option above setting `create_static_kubeconfig=true` and running `terraform apply` would do for you automatically.
## SAS Risk Cirrus Solutions Multi-tenancy onboard failure
### Symptom:
For SAS Viya Platform cadence v2023.07, Multi-tenancy onboard task fails for orders with SAS Risk Cirrus Solutions product.
### Diagnosis:
In the current multi-tenancy design of viya4-deployment the required tenant kubernetes resources or podtemplates are applied alongside cas-onboard task. However, SAS Risk Cirrus Solutions pods expect the podtemplates to be present at the time of onboarding. In SAS Viya Platform cadence v2023.07 the sas-tenant-job was modified to wait for all deployment services to start and return success or error code on exit for any services failures. This change causes the onboard task to fail as the SAS Risk Cirrus Solutions pods aren't able to start.

### Solution:

This is a known issue at the moment and will be fixed in future release of viya4-deployment. Meanwhile as a workaround users with SAS Risk Cirrus Solutions product please follow the manual steps to apply the required podtemplates and onboard tenants.

After the initial provider deployment stabilizes follow the steps in `$deploy/sas-bases/examples/sas-tenant-job/README.md` to onboard tenants manually.

## Applying a New License for your SAS Viya Platform Deployment
### Symptom:
Expand Down
172 changes: 0 additions & 172 deletions docs/user/Multi-Tenancy.md

This file was deleted.

0 comments on commit 7a727c0

Please sign in to comment.