SevOne Data Insight Pre-Installation Guide

Edit online

About

Edit online
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.

Important:

Please refer to the details in Pre-Deployment Checklist before proceeding with the initial provisioning or upgrade of SevOne Data Insight.

Contains the following topics.

Private IP Address Ranges

Edit online

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 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

Edit online
  • An NMS cluster or appliance running version 8.0.
  • (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 User Role Manager. 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

Edit online

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.

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

Deploy OVA

Edit online

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 NMS .ova, you will go through the following steps from vSphere Client.
  1. Right-click on the folder where you want to create your virtual machine and select Deploy OVF Template... from the list.
  2. Select an OVF template - specify the location of the source OVF or OVA template and click Next.
  3. Select a name and folder - enter a unique name for the virtual machine, select deployment location, and click Next. The default name of the virtual machine is the same as the name of the selected OVF or OVA template.
  4. Select a compute resource - select a resource where to run the deployed VM template, and click Next.
  5. Review details - verify the OVF or OVA template details and click Next.
  6. Select storage - define where and how to store the files for the deployed OVF or OVA template. Select the disk format for the virtual machine virtual disks. Format can be of Thick or Thin provision type.
  7. Ready to complete - review the page and click Finish.
For additional details, please refer to Deploy an OVF or OVA Template (docs.vmware.com).
Important: Deployment Recommendation

A single OVA image size (of 8 vCPU cores / 32 GB RAM / 250 GB HDD) is used for all production deployments where the environments are maintained for a long period of time or upgraded.

NOTE: Active users are individuals actually logged in to Data Insight. Concurrent Users are users currently running reports.

#Concurrent Users # Active Users # Production Nodes
up to 80 800 1 Tested & Supported
up to 160 1600 2 or more Supported
up to 250 2500 3 or more Tested & Supported

(Tested with up to 400 concurrent users)

NOTE: These numbers may vary based on your environment. You can always add more nodes to suit your needs.

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>

Please respond to the following prompts:
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

Please respond to the following prompts:
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 hostname of your SevOne Data Insight virtual machine. For details, please refer to section Change Hostnames.
  4. To configure the network settings, please proceed to section Configure Network Settings.

Deploy on AWS

Edit online

AWS Instance Types for SevOne Data Insight

Edit online
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<8.0.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

Edit online

Azure Instance Types for SevOne Data Insight

Edit online
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<8.0.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.

Deploy on Google Cloud Platform (GCP)

Edit online

GCP Instance Types for SevOne Data Insight

Edit online
License GCP Instance Type Primary Disk (GiB) Data Disk (GiB)
SevOne Data Insight n2-standard-8 250 n/a

Download the OVA image (for example, sdi-v<8.0.x>-build.<xx>.ova) 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 Google Cloud Platform guide for details on how to perform the deployment.

Important:

The root disk should be 250 GiB for SevOne Data Insight as shown in GCP 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

Edit online
Contains the following topic.
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

Configure URL
IP Networking with NMTUI https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/networking_guide/sec-configuring_ip_networking_with_nmtui
NTP/Chrony https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/ch-configuring_ntp_using_the_chrony_suite/
Time & Date https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/chap-configuring_the_date_and_time

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

Edit online
  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
clienttest-fail-qjr87                                   0/1     Completed                    0              24d
clienttest-success-xvs2b                                0/1     Completed                    0              24d
di-asset-sweeper-29179840-s4nhq                         0/1     Completed                    0              24d
di-asset-sweeper-29179845-gghh4                         0/1     Completed                    0              24d
di-asset-sweeper-29179850-fc4kt                         0/1     Completed                    0              24d
di-asset-sweeper-29179855-rqdbw                         0/1     CreateContainerConfigError   0              24d
di-assetserver-6f6df775dc-x6c7k                         1/1     Running                      0              7d
di-djinn-84f798c55c-q5zgw                               1/1     Running                      0              19m
di-graphql-5bfb5c546-hltpp                              0/1     CrashLoopBackOff             8 (103s ago)   18m
di-graphql-75b4fd96d8-46rjr                             1/1     Running                      0              6d22h
di-jaeger-collector-86b756f8c4-qhqbm                    1/1     Running                      2 (7d1h ago)   24d
di-migrator-77fbb5fcbc-m6fbl                            1/1     Running                      0              7d
di-mysql-0                                              2/2     Running                      0              7d
di-nms-apikey-rotation-29202060-5xj56                   0/1     Completed                    0              8d
di-otel-collector-collector-5f94df85f4-lp8pl            1/1     Running                      0              19m
di-printer-95cb9f7d9-7rqcv                              2/2     Running                      0              7d
di-prometheus-kube-state-metrics-59f8fdf4f4-w4k4x       1/1     Running                      3 (7d1h ago)   24d
di-prometheus-prometheus-node-exporter-kbgqt            1/1     Running                      3 (7d1h ago)   24d
di-prometheus-prometheus-node-exporter-txq8h            1/1     Running                      3 (7d1h ago)   24d
di-prometheus-server-6d7c54c4c5-8jpxq                   2/2     Running                      4 (7d1h ago)   24d
di-redis-6d6c4966cc-csssp                               2/2     Running                      0              7d
di-registry-54db8b7bb5-vbxbw                            1/1     Running                      0              7d
di-report-tombstone-sweeper-29211600-jrbqw              0/1     Completed                    0              2d
di-report-tombstone-sweeper-29213040-hftmf              0/1     Completed                    0              24h
di-report-tombstone-sweeper-29214480-msp7t              0/1     Completed                    0              29m
di-report-version-sweeper-29211000-lnqtx                0/1     Completed                    0              2d10h
di-report-version-sweeper-29212440-ft6fb                0/1     Completed                    0              34h
di-report-version-sweeper-29213880-2f67c                0/1     Completed                    0              10h
di-sch-report-sweeper-29214495-8pgc8                    0/1     Completed                    0              14m
di-sch-report-sweeper-29214500-lzsc4                    0/1     Completed                    0              9m49s
di-sch-report-sweeper-29214505-zltqm                    0/1     Completed                    0              4m49s
di-scheduler-794897fbbd-gpzc8                           1/1     Running                      0              7d
di-ui-558ffbc8d8-jwsfl                                  1/1     Running                      0              7d
di-user-sync-29214495-jtpsg                             0/1     Completed                    0              14m
di-user-sync-29214500-2tkgq                             0/1     Completed                    0              9m49s
di-user-sync-29214505-m6prp                             0/1     Completed                    0              4m49s
di-wdkserver-6557bcf8d6-vjz45                           1/1     Running                      0              7d
ingress-ingress-nginx-controller-c784dfc5d-r2mq7        1/1     Running                      2 (7d1h ago)   24d
ingress-ingress-nginx-defaultbackend-77568c485c-949p7   1/1     Running                      3 (7d1h ago)   24d
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

Edit online

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. Are there any IP conflicts? Please refer to Private IP Address Ranges section for details on IP-ranges.
2. What are the deployment recommendations for production and non-production environments? Please refer to Release Notes SevOne Data Insight 8.0.0 > section Deployment Recommendation for details.
3. 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-v8.0.0-build.<###>.tgz or sdi-v8.0.0-build.<###>.tgz.sha256.txt files; replace <###> with the latest build version.

Installer file


ls -l /opt/SevOne/upgrade/sdi-v8.0.0-build.<###>.tgz

md5sum /opt/SevOne/upgrade/sdi-v8.0.0-build.<###>.tgz

Checksum file


ls -l /opt/SevOne/upgrade/sdi-v8.0.0-build.<###>.tgz.sha256.txt

md5sum /opt/SevOne/upgrade/sdi-v8.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 8.0, the checksum file will be available from /opt/SevOne/upgrade.
4. 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.