SevOne Data Insight Pre-Installation Guide
About
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
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 6.8.
Third-party Packages | Version (for Upgrades / New Provisioning) | Commands to check version |
---|---|---|
Helm | 3.13.1 | $ helm version |
Kubernetes | 1.28.2 | $ kubectl 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.
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 6.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 Appliance
For appliance-based installation, please follow the instructions in SevOne Data Insight Appliance Insert guide to deploy each Data Insight appliance. After successful deployment, change the default password, and then proceed to section Configure Network Settings.
Deploy 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.
- 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.
- After logging in for the first time, you are required to change the password. You will get the
following 3 prompts.
- (current) UNIX password - password when you enter SevOne Data Insight virtual machine for the first time. Password is sevone.
- New password - new password must be 8 characters or longer.
- 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.
- (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> $ reboot
Example
$ ssh sevone@10.128.9.176 $ reboot
- 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 |
|
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<6.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.
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<6.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.
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
It is important to change the default password as failure to do so presents a significant security risk.
Perform the following steps to configure the network settings manually.
- 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
- At the prompt [sudo] password for sevone:, enter the password for the sevone user.
- Select Edit a connection.
- Select the Ethernet interface (not the Docker Bridge).
- Select <Edit...>.
- Go to IPv4 CONFIGURATION and change <Automatic> to <Manual>.
- Select <Show> for IPv4 CONFIGURATION.
- Configure the following settings for IPv4 CONFIGURATION as well as any other settings relevant
to your network.
- Addresses
- Gateway
- DNS servers
- Search domains
- Confirm that the following options are selected.
- Automatically connect
- Available to all users
- Click OK.
Set Chrony (NTP Servers) and SNMP
- Change directory to
/opt/SevOne/upgrade/ansible/playbooks/.
$ cd /opt/SevOne/upgrade/ansible/playbooks/
- 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
- Using a text editor of your choice, edit /etc/chrony.conf and/or /etc/snmp/snmpd.conf files to customize your configuration settings.
- 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
SevOne recommends you to discover each new appliance from SevOne NMS using the SNMP community strings.
Now that you have deployed SevOne Data Insight .ova, 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 6.8.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-v6.8.0-build.<###>.tgz or sdi-v6.8.0-build.<###>.tgz.sha256.txt files; replace <###> with the latest build version. Installer file
Checksum file
Note: Checksum applies to upgrades only.
For example, if upgrading from SevOne Data Insight <= 3.4.1 to SevOne Data Insight 6.8, 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. |