SevOne Data Insight Pre-Installation Guide

About

Warning:
New installation of SevOne Data Insight can be performed by only using .iso / .ova that is the matching version of SevOne Data Insight. Using an older version of the .iso / .ova file to provision a newer version of SevOne Data Insight is not supported due to minimum platform dependencies requirements.

This document describes the steps to deploy SevOne Data Insight. There are four options to provision SevOne Data Insight.

  • Deploy Appliance
  • Deploy OVA
  • Deploy on AWS
  • Deploy on Azure
Important:
Please refer to the details in Pre-Deployment Checklist before proceeding with the initial provisioning or upgrade of SevOne Data Insight.

Dependencies

The following table lists the minimum versions required for third-party packages prior to the deployment of SevOne Data Insight 7.0.

Third-party Packages Version (for Upgrades / New Provisioning) Commands to check version
Helm 3.13.1 $ helm version
Kubernetes 1.28.2 $ kubectl version
Terraform 1.5.5 $ terraform version

Private IP Address Ranges

The table below contains the default IP ranges used by SevOne Data Insight for standard deployment. If there is a conflict with the flannel CNI (Container Network Interface) IP Range, you will need to customize your deployment.

Note:
If the SevOne Data Insight Virtual Machine or Appliance that you are provisioning conflicts with any of the IP ranges listed below, you will need to customize your deployment. For IP range conflicts, please refer to SevOne Data Insight Administration Guide > section Deployment > subsection Handle IP Conflicts for both fresh provisioning and existing clusters.
Flag Description IP Address IP Range
--cluster-cidr Pod IP addresses 192.168.80.0/20 192.168.80.0.0 - 192.168.95.255
--service-cidr Service IP addresses 192.168.96.0/20 192.168.96.0 - 192.168.111.255
--cluster-dns Cluster DNS (must be in Service's range) 192.168.96.10 n/a

Please refer to SevOne Data Insight User Guide for information on using SevOne Data Insight and the SevOne Data Insight Administration Guide for information about administrative features.

SevOne NMS Requirements

  • An NMS cluster or appliance running version 7.x.
  • (Optional) A SevOne NMS User Role created for SevOne Data Insight users. You can set up a user role if you would like to specify which users have access to SevOne Data Insight. If this is not done then, all SevOne NMS users will have access to SevOne Data Insight as report consumers. For more information on creating user roles and assigning users to user roles, please refer to topic User Role Manager in SevOne NMS System Administration Guide. Role ID can be obtained from REST API's swaggerUI. For additional details, please refer to SevOne Data Insight User Guide > Administer > Tenants > User Role / Role ID in SevOne NMS > section Obtain User Role ID.

Overview

The appliance-based installation is very similar to the installation based on deploying an .ova to your own Linux machine. The following is an overview of each approach as well as the upgrade process.

Deploy OVA

Note: Save OVA
  • The SevOne Data Insight .ova file can be downloaded from IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_download_software.html) via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact SevOne Support Team for the file.
  • Save the .ova to a folder on your server.

To deploy SevOne Data Insight .ova, deploy it on each Linux machine you plan to install Data Insight on. For details, please refer to Deploy an OVF or OVA Template (docs.vmware.com). After successful deployment of each virtual machine, please execute the following steps.

  1. SSH into your SevOne Data Insight machine and log in as sevone and at the Password prompt, enter sevone.

    Log in to SevOne Data Insight machine for the 'first' time

    $ ssh sevone@<virtual machine IP address or hostname>

    Example

    $ ssh sevone@10.128.9.176

    At the password prompt, enter the default password sevone.

  2. After logging in for the first time, you are required to change the password. You will get the following 3 prompts.
    1. (current) UNIX password - password when you enter SevOne Data Insight virtual machine for the first time. Password is sevone.
    2. New password - new password must be 8 characters or longer.
    3. Retype new password - retype the new password.

    Required: Change password after logging in for the 'first' time

    
    $ ssh sevone@<virtual machine IP address or hostname>
    
    sevone@<virtual machine's IP address or hostname> password: <enter 'sevone'>
    You are required to change your password immediately (root enforced)
    WARNING: Your password has expired.
    You must change your password now and login again!
    Changing password for user sevone.
    Changing password for sevone.
    (current) UNIX password: <enter 'sevone'>
    New password: <enter 'new' password>
    Retype new password: <re-enter 'new' password>
    passwd: all authentication tokens updated successfully.
    Connection to <virtual machine's IP address or hostname> closed.
    

    Example

    Enter the following values in the prompts below.
    • (current) UNIX password: sevone
    • New password: testing123
    • Retype new password: testing123
    
    $ ssh sevone@10.128.9.176
     
    sevone@10.128.9.176's password: sevone
    You are required to change your password immediately (root enforced)
    WARNING: Your password has expired.
    You must change your password now and login again!
    Changing password for user sevone.
    Changing password for sevone.
    (current) UNIX password: sevone
    New password: testing123
    Retype new password: testing123
    passwd: all authentication tokens updated successfully.
    Connection to 10.128.9.176 closed.
    
  3. (optional) You may change the host name of your SevOne Data Insight virtual machine by executing the following steps.
    $ ssh sevone@<virtual machine IP address or hostname>
    
    $ sudo hostnamectl set-hostname "<enter hostname>"

    Example

    $ ssh sevone@10.128.9.176
    
    $ sudo hostnamectl set-hostname "sdi-node01"

    After resetting the hostname, log out and log back in. For the hostname to take effect, reboot.

    
    $ ssh sevone@<virtual machine IP address or hostname>
    
    $ sudo reboot

    Example

    
    $ ssh sevone@10.128.9.176
    
    $ sudo reboot
    
  4. To configure the network settings, please proceed to section Configure Network Settings.

Deploy on AWS

AWS Instance Types for SevOne Data Insight

License AWS Instance Type Primary Disk (GiB) Data Disk (GiB)
SevOne Data Insight
  • m5.2xlarge
  • m6i.2xlarge
250 n/a

Download the OVA image from IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_download_software.html) via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact SevOne Support.

From sdi-v<7.x.x>-build.<xx>.ova, you may create your own AMI.

Please refer to SevOne Data Platform Deployment on Amazon Web Services guide for details on how to perform the deployment.

Important: The root disk should be 250 GiB for SevOne Data Insight as shown in AWS Instance Types for SevOne Data Insight table above.

Please refer to SevOne Data Insight Installation Guide for details to access the new instance via SSH.

Deploy on Azure

Azure Instance Types for SevOne Data Insight

License Azure Instance Type Primary Disk (GiB) Data Disk (GiB)
SevOne Data Insight Standard_D8s_v3 250 n/a

Download the VHD image (for example, sdi-v<7.x.x>-build.<xx>.vhd.gz) from IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_download_software.html) via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact SevOne Support.

Please refer to SevOne Data Platform Deployment on Microsoft Azure guide for details on how to perform the deployment.

Important:
The root disk should be 250 GiB for SevOne Data Insight as shown in Azure Instance Types for SevOne Data Insight table above.

Please refer to SevOne Data Insight Installation Guide for details to access the new instance via SSH.

Configure Network Settings

Important: If you see the following when deploying SevOne Data Insight .ova file on your Linux machine, login as sevone and password, sevone.
vmWebConsole
Important:
It is important to change the default password as failure to do so presents a significant security risk.

Useful Links


Perform the following steps to configure the network settings manually.

  1. Execute the following commands to display the NetworkManager TUI.
    Important:
    A working DNS configuration is a requirement for any SevOne Data Insight deployment. Otherwise, SevOne Data Insight will not work.

    Please refer to SevOne Data Insight Troubleshooting / Debug / Tools Guide > Troubleshooting > General Issues > section Domain Name Resolution (DNS) not working for details.
    
    $ sudo -i
    
    $ nmtui
    
  2. At the prompt [sudo] password for sevone:, enter the password for the sevone user.
    nmtui
  3. Select Edit a connection.
    nmtui_selectInterface
  4. Select the Ethernet interface (not the Docker Bridge).
  5. Select <Edit...>.
    nmtui_editConnection
  6. Go to IPv4 CONFIGURATION and change <Automatic> to <Manual>.
  7. Select <Show> for IPv4 CONFIGURATION.
    nmtui_editConnection_showIPv4
  8. Configure the following settings for IPv4 CONFIGURATION as well as any other settings relevant to your network.
    • Addresses
    • Gateway
    • DNS servers
    • Search domains
  9. Confirm that the following options are selected.
    • Automatically connect
    • Available to all users
  10. Click OK.

Set Chrony (NTP Servers) and SNMP

  1. Change directory to /opt/SevOne/upgrade/ansible/playbooks/.
    $ cd /opt/SevOne/upgrade/ansible/playbooks/
  2. Copy chrony.example.conf and snmpd.example.conf files.
    $ sudo cp /etc/chrony.example.conf /etc/chrony.conf
    
    $ sudo cp /etc/snmp/snmpd.example.conf /etc/snmp/snmpd.conf
  3. Using a text editor of your choice, edit /etc/chrony.conf and/or /etc/snmp/snmpd.conf files to customize your configuration settings.
  4. After all configuration changes are complete, run up.yaml for the configuration settings to take effect.
    $ sevone-cli playbook up

    Check pod status to ensure pods are completed / running

    $ kubectl get pods
    NAME                                                     READY   STATUS      RESTARTS        AGE
    di-prometheus-node-exporter-xhpqw                        1/1     Running     3 (4h19m ago)   22h
    di-prometheus-node-exporter-fnz7s                        1/1     Running     3 (4h27m ago)   22h
    di-report-tombstone-sweeper-28458480-xdppc               1/1     Running     0               4h32m
    ingress-ingress-nginx-defaultbackend-69f644c9dc-zcg8f    1/1     Running     1 (4h19m ago)   4h32m
    ingress-ingress-nginx-controller-fddc9cd4-krrzk          1/1     Running     3 (4h19m ago)   22h
    di-kube-state-metrics-6f4fbc67cb-p4tz4                   1/1     Running     0               4h32m
    di-mysql-0                                               2/2     Running     0               4h17m
    di-create-secrets-r27jf                                  0/1     Completed   0               4h1m
    di-upgrade-lp8b4                                         0/1     Completed   0               4h
    datasource-operator-controller-manager-cc766849f-qkmp7   2/2     Running     0               4h
    di-djinn-api-67b78d684f-wt8ss                            1/1     Running     0               4h
    di-assetserver-c9b5fdd5d-wkcrr                           1/1     Running     0               4h
    di-registry-85c9f98499-d4r62                             1/1     Running     0               4h
    di-scheduler-74774dbdb8-hjv5l                            1/1     Running     0               4h
    di-wdkserver-d598fc4f9-5r8qh                             1/1     Running     0               4h
    di-migrator-7d8cdddd9-5gbrs                              1/1     Running     0               4h
    di-printer-8574f88978-ps9rq                              2/2     Running     0               4h
    di-prometheus-server-6c75b49944-mmc7c                    2/2     Running     0               4h
    di-ui-56599488fc-48jdt                                   1/1     Running     0               4h
    di-redis-master-0                                        2/2     Running     0               4h
    di-graphql-6b7cf4f6b-bpcst                               1/1     Running     0               4h
    di-apikey-rotation-28459020-pnlwc                        0/1     Completed   0               38m
    di-asset-sweeper-28459045-72c4x                          0/1     Completed   0               13m
    di-user-sync-28459045-5dh8w                              0/1     Completed   0               13m
    di-asset-sweeper-28459050-sqfk6                          0/1     Completed   0               8m14s
    di-user-sync-28459050-zsstz                              0/1     Completed   0               8m14s
    di-asset-sweeper-28459055-7pm78                          0/1     Completed   0               3m14s
    di-user-sync-28459055-r8zx9                              0/1     Completed   0               3m14s
    
Important:
SevOne recommends you to discover each new appliance from SevOne NMS using the SNMP community strings.

Now that you have deployed SevOne Data Insight, you are ready to initialize Data Insight. Please refer to SevOne Data Insight Installation Guide.

Pre-Deployment Checklist

Please ensure that you have reviewed the pre-deployment checklist below before proceeding with SevOne Data Insight provisioning or upgrade.

SSH into your SevOne Data Insight machine and log in as sevone to execute the commands in the checklist.

$ ssh sevone@<IP address or hostname for SevOne Data Insight>
  Question Description / Commands
1. Verify the minimum version requirements for the third-party packages. Please refer to Dependencies section above.
2. Are there any IP conflicts? Please refer to Private IP Address Ranges section for details on IP-ranges.
3. What are the deployment recommendations for production and non-production environments? Please refer to Release Notes SevOne Data Insight 7.0.0 > section Deployment Recommendation for details.
4. What are the installer and checksum filenames? The latest file(s) can be downloaded from IBM Passport Advantage via Passport Advantage Online. However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact IBM SevOne Support for the file.

For example, sdi-v7.0.0-build.<###>.tgz or sdi-v7.0.0-build.<###>.tgz.sha256.txt files; replace <###> with the latest build version.

Installer file


$ ls -l /opt/SevOne/upgrade/sdi-v7.0.0-build.<###>.tgz
$ md5sum /opt/SevOne/upgrade/sdi-v7.0.0-build.<###>.tgz

Checksum file


$ ls -l /opt/SevOne/upgrade/sdi-v7.0.0-build.<###>.tgz.sha256.txt
$ md5sum /opt/SevOne/upgrade/sdi-v7.0.0-build.<###>.tgz.sha256.txt
Note: Checksum applies to upgrades only.

For example, if upgrading from SevOne Data Insight <= 3.4.1 to SevOne Data Insight 7.0, the checksum file will be available from /opt/SevOne/upgrade.
5. If you are performing an upgrade, are there Solutions widgets? If yes, please schedule a session with the Solutions Team to upgrade the Solutions widgets.