Helm Chart

Edit online

SevOne Data Insight Helm chart deploys the application stack on a Kubernetes cluster using the Helm Package Manager. Please refer to References below for the relevant links.

The Helm chart is configured with a base set of configuration options that can be overridden as needed.

Configure GraphQL

Edit online

Configure Session Idle Timeout

Edit online

To allow users to remain logged into SevOne Data Insight for more than an hour, execute the steps below.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.
```
graphql:
  env:
    AUTH_TIMEOUT: 3600
```
Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Enable GraphiQL

Edit online

To enable GraphiQL, execute the steps below. GraphiQL is an in-browser tool for writing, validating, and testing GraphQL queries.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.
```
graphql:
  enableGraphiql: true
  contentSecurityPolicy: null
  env:
    ALLOW_UNAUTHENTICATED_INTROSPECTION: true
```
Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Bypass Report Migration Checks

Edit online

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.
```
graphql:
  env:
    SKIP_REPORT_MIGRATIONS_DRY_RUN: true
```
Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Enable Shortcuts

Edit online

Shortcuts are available by default from SevOne Data Insight > under Configure in left navigation bar.

Enable Shortcuts to allow you to save resource selection as shortcuts to be reused across widgets in SevOne Data Insight without having to create groups in SevOne NMS.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.
```
ui:
  env:
    FF_ALIASES: true
```
Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Enable Report Versioning

Edit online

Enable report versioning to allow user to view saved versions of a report.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.
```
reportVersionsEnabled: true
```
Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Disable Datasource Operator

Edit online

In SevOne Data Insight 3.12 and above, requests to SOA are going to round robin to any peer in SevOne NMS clusters that SevOne Data Insight is connected to. This feature can be disabled in SevOne Data Insight to stop providing HA communicating with SevOne NMS and instead, sent requests to the specifically configured NMS peer.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.

Disable datasource operator.

operator:
  datasource:
    enabled: false

Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Disable MySQL Metrics Server

Edit online

MySQL ships with a metrics server that fails to start up if your environment has IPv6 enabled.

Important: Until SevOne Data Insight supports IPv4 / IPv6 dual stack environments, MySQL metrics server must be disabled.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.
Disable MySQL Metrics Server.
```
mysql:
  metrics:
    enabled: false
```
Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Change Prometheus Password

Edit online

To change the password for prometheus, execute the steps below.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to change the password using the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.
```
prometheus:
  auth:
    username: datainsight
    password: datainsight
```
Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Cron Schedules

Edit online

SevOne Data Insight has a number of cron jobs to perform tasks such as API key rotation, syncing users from SevOne NMS to SevOne Data Insight, and sweeping temporary assets from the object store.

The following table contains the default schedules for each job.

Job	Cron Schedule	Description
apikey-rotation	`0 5 10 * *`	At 05:00 on every 10th day-of-every-month.
asset-sweeper	`/5 * * *`	At every 5th minute.
user-sync	`/5 * * *`	At every 5th minute.

Custom schedule can be set via /opt/SevOne/chartconfs/di_custom.yaml file.

Example

crontab:
  apikey-rotation:
    schedule: "0 5 10 * *"
  asset-sweeper:
    schedule: "*/5 * * * *"
  user-sync:
    schedule: "*/5 * * * *"

Resource Requests & Limits

Edit online

Warning: for Advanced Users Only
Please refer to Kubernetes Resource Requests & Limits link in References section for additional information on configuring resource requests and limits.

Many of the deployments within SevOne Data Insight have resource requests and limits configured by default. Please refer to the example below containing the defaults for each deployment.

These have been generally configured with wide enough parameters to accommodate heavy usage of SevOne Data Insight.

However, should your usage be atypical and you find that a deployment lacks sufficient resources, or perhaps if you find that a deployment's usage is not very high and would like to scale it back to leave more room for other deployments/processes, you can apply custom requests and limits for a deployment in /opt/SevOne/chartconfs/di_limits.yaml file.

Example: Custom Requests & Limits

# /opt/SevOne/chartconfs/di_limits.yaml
graphql:
  resources:
    requests:
      cpu: 500m
      memory: 4000Mi
    limits:
      cpu: 2000m
      memory: 4000Mi
mysql:
  primary:
    resources:
      requests:
        cpu: 2000m
        memory: 4000Mi
      limits:
        cpu: 3500m
        memory: 8000Mi
printer:
  resources:
    requests:
      cpu: 500m
      memory: 4000Mi
    limits:
      cpu: 2000m
      memory: 4000Mi
scheduler:
  resources:
    requests:
      cpu: 50m
      memory: 100Mi
    limits:
      cpu: 200m
      memory: 250Mi
ui:
  resources:
    requests:
      cpu: 50m
      memory: 100Mi
    limits:
      cpu: 100m
      memory: 200Mi
prometheus:
  server:
    resources:
      requests:
        cpu: 500m
        memory: 4000Mi
      limits:
        cpu: 1000m
        memory: 8000Mi
nodeExporter:
  resources:
    requests:
      cpu: 100m
      memory: 100Mi
    limits:
      cpu: 200m
      memory: 100Mi
kubeStateMetrics:
  resources:
    requests:
      cpu: 50m
      memory: 100Mi
    limits:
      cpu: 100m
      memory: 100Mi
rabbitmq:
  resources:
    requests:
      cpu: 400m
      memory: 250Mi
    limits:
      cpu: 800m
      memory: 750Mi
wdkserver:
  resources:
    requests:
      cpu: 50m
      memory: 1000Mi
    limits:
      cpu: 100m
      memory: 2000Mi
redis:
  master:
    resources:
      requests:
        cpu: 100m
        memory: 300Mi
      limits:
        cpu: 250m
        memory: 1000Mi
minio:
  resources:
    requests:
      cpu: 100m
      memory: 2500Mi
    limits:
      cpu: 250m
      memory: 4000Mi
cron:
  resources:
    requests:
      cpu: 750m
      memory: 500Mi
    limits:
      cpu: 1000m
      memory: 1000Mi

Example: Disable Limits

# /opt/SevOne/chartconfs/di_limits.yaml
graphql:
  resources: null

mysql:
  primary:
    resources: null

printer:
  resources: null

scheduler:
  resources: null

ui:
  resources: null

prometheus:
  server:
    resources: null
  nodeExporter:
    resources: null
  kubeStateMetrics:
    resources: null

rabbitmq:
  resources: null

wdkserver:
  resources: null

redis:
  master:
    resources: null

minio:
  resources: null

cron:
  resources: null

Configure HELM

Edit online

CAUTION:

This applies for Advanced Users Only.

By default, SevOne Data Insight does not ship with helm configured so that users can apply the changes via sevone-cli. This ensures that any misconfigurations or issues with the deployment will be automatically rolled back.

This can take some time to complete since helm waits for all pods to successfully start up before finishing. If you are an advanced user and know what you are doing, you may apply the changes directly using helm.

To configure helm, execute the following steps.

$ helm repo add --force-update --insecure-skip-tls-verify \
local https://localhost:6443/static/charts

$ helm repo update

Apply the changes directly via helm.

$ helm upgrade di local/di --insecure-skip-tls-verify \
--install --devel -f /opt/SevOne/chartconfs/di_custom.yaml

Configure Maps

Edit online

Important: IMPORTANT: Missing / misconfigured tile server for Map mode
The tile server for Map (geospatial) mode is missing or misconfigured in SevOne Data Insight 3.13.0 - 3.13.9, 6.5.0 - 6.5.4, and 6.6.0. To resolve this or if you are installing SevOne Data Insight 6.8.0 or above, you are required to perform additional configuration to obtain the proper tiles for the maps.

if using Command Line Interface,
- you are required to execute the commands below to configure variables tileserver and attribution under maps and apply the changes.
- you must perform an upgrade to SevOne Data Insight 6.7.0 or above. For details on how to upgrade using the command line interface, please refer to SevOne Data Insight Upgrade Process Guide > section using Command Line Interface.
if using Graphical User Interface,
- you must perform an upgrade to SevOne Data Insight 6.7.0 or above. Please refer to SevOne Data Insight Upgrade Process Guide > section using Graphical User Interface > at step Configure, configure variables Tileserver and Attribution under Maps and successfully complete the upgrade.

Important: NOTICE
Failure to set variable maps.tileserver while performing an upgrade from SevOne Data Insight 3.13.0 - 3.13.9, 6.5.0 - 6.5.4, and 6.6.0 to 6.7.0 or above, will convert your current map in Maps mode to Canvas mode without the ability to switch back to Map mode until the tile server is provided.

If the owner of the selected tile server requires to be given credit for the tiles being used, set variable maps.attribution. Text entered in variable maps.attribution will appear in the bottom right corner of each map.

For further assistance, please contact SevOne Support Team or your Technical Account Manager to configure this properly.

Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set the following environment variable and then, save it.
Important: If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.

Configure the maps variable.

Note: To create the tile server URL with the Access Token, please refer to section Create Tile Server URL below.

maps:
  tileserver: "<enter tileserver URL containing the token>"
  attribution: "<enter attribution for a given tileserver if required by the tile's owner>"

Example: Dark mode

maps:
  tileserver: "https://api.mapbox.com/styles/v1/sevone/cllfjv99c01mp01ql9neoau07/tiles/256/{z}/{x}/{y}@2x?access_token=<ACCESS_TOKEN>"
  attribution: "Some attribution; props to stamen for providing tiles, etc."

Example: Light mode

maps:
  tileserver: "https://api.mapbox.com/styles/v1/sevone/cllfl73f101qb01qnc7wh22i5/tiles/256/{z}/{x}/{y}@2x?access_token=<ACCESS_TOKEN>"
  attribution: "Some attribution; props to stamen for providing tiles, etc."

Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.
```
$ sevone-cli playbook up --tags apps
```

Create Tile Server URL

Edit online

To create the Access Token, use may use mapbox (recommended) or any other tool of your preference. The steps below show how to create the Access Token using mapbox - this is only an example.

Create a mapbox account. Enter the following URL in a web browser of your choice.
```
https://mapbox.com
```
Important: You only need to create your mapbox account once. Please save your username / email address and password for future use.
Once the mapbox account is created, sign in.
Click button.
In Create an access token page, enter the token name in field Name. For example, IBM Sevone Data Insight.
Click button to create the mapbox Access Token.
Important:
- You will be prompted to confirm your password. Enter your mapbox account password.
- Click Submit.
Your Access Token for token name IBM SevOne Data Insight is created. For security reasons, the token has been obscured in the screenshot below.
For SevOne Data Insight, you have dark and light modes. Based on the mode, your tile server URL is created.

for Dark mode,
In the URL, replace <ACCESS_TOKEN> with the Access Token generated above for your token name, IBM SevOne Data Insight.
Tile Server URL for Dark mode
```
https://api.mapbox.com/styles/v1/sevone/cllfjv99c01mp01ql9neoau07/tiles/256/{z}/{x}/{y}@2x?access_token=<ACCESS_TOKEN>
```
for Light mode, in the URL, replace <ACCESS_TOKEN> with the Access Token generated above for your token name, IBM SevOne Data Insight. Tile Server URL for Light mode
```
https://api.mapbox.com/styles/v1/sevone/cllfl73f101qb01qnc7wh22i5/tiles/256/{z}/{x}/{y}@2x?access_token=<ACCESS_TOKEN>
```