How Do I Install, Configure, and Use IBM Network Performance Insight, V1.2.1 Table of Contents How Do I Install, Configure, and Use IBM Network Performance Insight, V1.2.1 ........................................ 1 Table of Contents .......................................................................................................................................... 1 Introduction .................................................................................................................................................. 2 Compatibility with Netcool Operations Insight: ........................................................................................... 4 Before you begin ........................................................................................................................................... 4 Part numbers for the required software ...................................................................................................... 5 Install the prerequisite software................................................................................................................... 6 Installation and configuration of ITNM............................................................................................ 6 Prepare to install NPI and related software ................................................................................................. 7 Download IOP packages................................................................................................................... 7 Download and extract NPI software ................................................................................................ 7 Set up SSH Passwordless login ......................................................................................................... 8 Prepare to run prerequisite scanner................................................................................................ 8 Set Kernel parameters ..................................................................................................................... 8 Install NPI ...................................................................................................................................................... 9 Set up NPI cluster on Ambari ........................................................................................................................ 9 Set up integration with JazzSM ................................................................................................................... 18 Generate the certificate and keystore files ................................................................................... 19 Enable integration with JazzSM ..................................................................................................... 19 Setting up communication with JazzSM on Ambari ...................................................................... 21 Configure SSL communication for integration ............................................................................... 22 Configure SSL settings on WebSphere Application Server ............................................... 22 Add the signer certificate to your browser ....................................................................... 23 Post installation tasks ................................................................................................................................. 24 Verify NPI installation .................................................................................................................... 25 Install and configure Device Dashboard ..................................................................................................... 26 Configure Apache Storm Spout in Network Manager ................................................................... 27 Configure NPI system .................................................................................................................................. 27 Troubleshooting .......................................................................................................................................... 28 Introduction Use this fast path check lists to track the tasks to prepare your environment, install, configure, and use IBM Network Performance Insight (NPI), V1.2.1 from your NOI solution. You can print out this check list. Attention: Network Performance Insight is available as part of IBM® Netcool® Operations Insight (NOI) solution only. Note: This information complements the official documents that are available on IBM Knowledge Center here: https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/npi_kc_welcome.html See the videos for installing and configuring NPI 1.2.1 from here: https://tnpmsupport.persistentsys.com/all-videos-npi Download the PDF versions of NPI documentation from here: https://tnpmsupport.persistentsys.com/documentation-npi The infographic below shows a bird's-eye-view of the tasks that are needed for installation, configuration, and integration of Network Performance Insight with IBM Tivoli Network Manager, and OMNIbus components of NOI. All these steps are needed for visualization of traffic data from Tivoli Netcool/OMNIbus Web GUI and Device dashboard. For system requirements, see here: https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/requirements/ctnpm_requirements.ht ml Compatibility with Netcool Operations Insight: Network Performance Insight Version Netcool Operations Insight version Integrated Product Versions 1.2.1 1.4.1 Tivoli Network Manager 4.2.0.3 Tivoli Netcool/OMNIbus Core 8.1.0.11 Tivoli Netcool/OMNIbus Web GUI 8.1.0.9 Device Dashboard 1.1.0.2 Network Health Dashboard 4.2.0.3 Before you begin Keep the following information ready before you start the installation: o The fully qualified domain name (FQDN) for each host in your system, and the components that you want to set up on different hosts. The Ambari installation wizard does not support IP addresses. Use hostname -f to check for the FQDN. An example for FQDN: <myserver.ibm.com> For more information about the supported host name values on WebSphere Application Server, see: https://www.ibm.com/support/knowledgecenter/SSEQTP_8.5.5/com.ibm.websphere.base. doc/ae/rins_hostname.html o The base directories for the following components: Parameter NameNode DataNodes MapReduce ZooKeeper Your value Various log, pid, and database files according to your installation type o Users for Network Performance Insight: Parameter Description root Installs NPI and deploys the clusters. netcool The netcool user is created during Network Performance Insight installation and all Network Performance Insight services are run as netcool user. Admin user to login to JazzSM smadmin o Default ports to be opened for a typical installation o Some URLs you can use to troubleshoot NPI and Ambari components Component URL Ambari http://<myserver.ibm.com>:8080 Hadoop hdfs:// <myserver.ibm.com>:9000 Hadoop Applications http:// <myserver.ibm.com>:8088/cluster Hadoop UI http:// <myserver.ibm.com>:50070 Part numbers for the required software Component description Part no. Netcool Operations Insight - Performance Management V1.2.1 Linux Multilingual CNK2QML Netcool Operations Insight - Performance Management Quick Start Guide V1.2.1 Multilingual CNK2RML IBM Tivoli Network Manager IP Edition v4.2.0.3 CJ1J5EN IBM Tivoli Netcool/OMNIbus v8.1 for Netcool Operations Insight v1.4 CRYX7EN Component description Part no. Jazz for Service Management v1.1.3 for Tivoli Netcool/OMNIbus, Network Manager, and Netcool Configuration Manager with Cumulative Patch 1 CJ0R8ML WebSphere Application Server V8.5.5.9, or later CNC1ZML Network Health Dashboard v4.2.0.3 for Netcool Operations Insight CJ0S2EN Device Dashboard v1.1.0.2 for Netcool Operations Insight CJ1U2EN For part numbers of other NOI components, see Download IBM Netcool Operations Insight V1.4.1. Install the prerequisite software Important: These steps are not required if you have already installed JazzSM and ITNM as a part of your NOI solution. You require the following components from IBM Tivoli Netcool Operations Insight to solution to work with NPI: IBM Tivoli Network Manager IBM Tivoli Netcool/OMNIbus IBM Tivoli Netcool Operations Insight Device Dashboard Follow these steps to install the prerequisite software from NOI solution to work with NPI: Installation and configuration of ITNM Install the following ITNM components that you are entitled to as part of NOI solution. As a best practice, install the components one by one in the order that is specified here: Install and configure IBM Installation Manager Install and configure Tivoli Netcool/OMNIbus Install Dashboard Application Services Hub Note: Tivoli Common Reporting is not required for working with Network Performance Insight. JazzSM 1.1.3.0 component versions: DASH: 3.1.3.0 WebSphere Application Server: 8.5.5.9 a. Perform a full installation or upgrade installation. Note: Security Services are required for integration with ITNM. It is installed automatically when you install the Device Dashboard. Install Tivoli Netcool/OMNIbus Web GUI Prepare the database for ITNM. o Install supported database (DB2/Oracle) for ITNM o Install and run the database scripts to configure the topology database for use by Network Manager. Install the Network Manager core components Install Network Manager GUI components Install Network Health Dashboard For more information about these steps, see Quick Reference to Installing in NOI documentation from IBM Knowledge Center. o o Configure your ITNM environment. Activate the SLA agent if you want to discover the SNMP data from Cisco IP SLA enabled devices. Prepare to install NPI and related software Perform these tasks before you install NPI Download IOP packages o IBM Open Platform with Apache Spark and Apache Hadoop packages: o o o ambari-2.2.0.el7.x86_64.tar.gz iop-4.2.0.el7.x86_64.tar.gz iop-utils-1.2.1.0.el7.x86_64.tar.gz Download and extract NPI software Task Description Check Download the eImage for NPI. Download from Passport Advantage web site to a location of your choice. For example: ☐ /opt/IBM/Installers/NPI Let us refer to this directory as <DIST_DIR>. Extract the media. Use the following commands: tar -zxvf CNK2QML.tgz tar -zxvf NPI-.2.1.0.tgz ☐ Set up SSH Passwordless login Task Description Check On the Ambari server, generate the public and private SSH keys. Run the following commands: ☐ Enter the required details of the Ambari agent host at the prompts Always give fully qualified domain names. ☐ Repeat this for all the agents in your cluster This is to make sure that the Ambari server can connect to each Ambari agent without specific passwords. ☐ cd <DIST_DIR>/NPI-1.2.1.0/bin ./setup_cluster_ssh.sh https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_setup_ssh_password_less_ login.html Prepare to run prerequisite scanner For more information about these tasks, see “Preparing your environment” in BigInsights documentation on IBM Knowledge Center from here. Note: /NPI-1.2.1.0/bin/prereq_check.sh script is automatically run when the NPI installer script is called. Set Kernel parameters Task Description Check Edit the /etc/sysctl.conf file and the lines. As root user, add the following lines: ☐ net.core.rmem_default = 33554432 net.core.rmem_max = 33554432 net.core.netdev_max_backlog = 10000 Change /etc/sysctl.conf to ensure that the values are set on a system start. Run sysctl –p as root user. This will refresh the new configuration in the current environment. ☐ Edit the netcool hard nofile 20000 netcool soft nofile 20000 ☐ /etc/security/limits.conf file to add or modify the hard and soft limit. Log out and log in to the session again as root user for the changes to take effect. ☐ Repeat these steps on all the servers where Network Performance Insight services are installed. ☐ https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_ulimit_settings.html Install NPI Use these steps to install and configure NPI services and IOP components. Check the tasks that you have completed. https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_installing.html Before you begin: o o o Ensure that Jazz™ for Service Management is installed. Ensure that the necessary user permissions are in place for all the installation directories. Ensure that all the hosts in your cluster are in the same time zone. Task Description Run the installer as root user. The default installation directory is cd <DIST_DIR>/NPI_1.2.1.0/bin ./install.sh <DIST_DIR> Check ☐ /opt/IBM/npi. Check installation output in the following log files that are located in: install_<timestamp>.log prereq_check_<timestamp>.log ☐ /<DIST_DIR>/NPI_1.2.1.0 https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_performing_installation.ht ml Set up NPI cluster on Ambari You can set up NPI clusters on Ambari web interface, configure the IOP components, NPI services, and NOI components. Use the Ambari installation wizard in your browser to complete your installation, configuration, and deployment of Network Performance Insight components and Hadoop components in your cluster. Task Description Check Login to the Ambari server web interface. Use admin/admin credentials. For example: ☐ http://<myserver.ibm.com>:8080 ☐ Click Launch Install Wizard on the Ambari Welcome page. Enter the name of the cluster on “Get Started” page. It can be any meaningful name of your choice. Select BigInsights 4.2 NPI on “Select Stack” page and Next. The name cannot contain blank spaces or special characters. ☐ ☐ Complete the steps on the “Install Options” page: o ☐ List all the nodes in your cluster in the Target Hosts field. Specify FQDN, one node per line. o Select Provide your SSH Private Key to automatically register hosts. Browse to the <root>/.ssh/id_ rsa file to see the file contents updated. Or, copy the contents of the <root>/ .ssh/id _rsa file and paste o the contents in the SSH key field Click Register and Confirm. Verify the hosts in “Confirm Hosts” page. You can see the progress. ☐ Check the services to install in your cluster and click Next on the “Choose Services” page. ☐ Assign the master services to hosts in your cluster on the “Assign Masters” page and click Next. ☐ Assign the slave and client components to hosts in your cluster on the “Assign Masters” page and click Next. ☐ Update the configuration settings on the “Customize Services” page. Yarn settings: ☐ YARN > Settings Note: Default values are completed automatically when available and they are the recommended values. HDFS settings: HDFS > Settings ☐ Zookeeper settings: Zookeeper > Zookeeper Server Note: Do not set the ZooKeeper directory in /tmp directory. Kafka settings: Kafka > Kafka Broker ☐ NPI services settings: ☐ NPI > NPI Settings Typically, you do not need to change the defult settings that are auto-populated for need to change for NPI Common, NPI Manager, NPI DNS Service, and NPI Web Services settings. Optionally, you can set the collector.flow.exporter.blacklist as shown below to provide a comma-separated list of IP addresses in square brackets. The flow data from these exporters in the list is blocked from further processing. Also, make sure to open the UDP port, 4379 on all the flow-enabled devices that are sending data to the NPI Collector. ITNM settings: NPI > NOI Core Settings > NOI Components > NOI SNMP Collector Change as per your database. ☐ OMNIbus settings: Typically, no need to change. The default settings are autopopulated. Make sure that the following tasks are done: Configure the host name resolution to resolve omnihost to the actual host name where Tivoli® ☐ Netcool/OMNIbus is installed. Add an alias entry in the /etc/hosts file in your NPI server as follows: <IP_Address> <OMNIbus_server_fully_qualified_host_name> <OMNIbus_server_short_host_name> omnihost For example: 10.55.237.105 omnihost myserver.ibm.com myserver Ensure that you have the following 32-bit RHEL operating system libraries: o o o o zlib ncurses bzip2 libstdc++ Review and deploy. ☐ 1. Review the completed tasks on the “Summary” page and click Complete. ☐ https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_installing_clusters.html Set up integration with JazzSM Use this information to set up the federation between Jazz™ for Service Management and Network Performance Insight to work correctly and to access the web-based visualizations. Generate the certificate and keystore files Task Description Check Generate ca.crt key store file by using the following command in a single line as root user: cd /opt/IBM/npi/npi-installer-tools/dashintegration <DASH_INTEGRATION_PATH>/securityKeyTool.sh default=<DASH_INTEGRATION_PATH>/default.cfg -custom=<DASH_INTEGRATION_PATH>/custom.cfg ☐ Check these log files in the /tmp directory for any errors: /opt/IBM/npi/npi-installer-tools/dashintegration/securityKeyTool.sh default=/opt/IBM/npi/npi-installertools/dash-integration/default.cfg custom=/opt/IBM/npi/npi-installertools/dash-integration/custom.cfg ambari_npi_key_startup.log securityKeyTool.<timestamp>.log genSecurityKey.log For example: ☐ https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/configure/tnpi_configure_jazzsm_after _npi_installation.html Enable integration with JazzSM Task Description Check ☐ Make sure that Tivoli® Netcool/OMNIbus Objec t Server is up and running. Update these fields in the file custom.cfg file that are specific to the Dashboard Application Services Hub instance that you want to use for integration. #-- Ambari Server Port, default 8080--# By default, the custom.cfg file is DASH_CONNECTION=root@<myserver.ibm.com> AMBARI_SERVER_PORT=8080 # Directory where npi-installer-tools are installed. NPI_INSTALLER_TOOLS_DIR=/opt/IBM/npi/npiinstaller-tools DASH_ENABLE_OPTION=TRUE ☐ located in /opt/IBM/npi/npi -installertools/dashintegration folder. DASH_SSH_PORT=22 WEBSPHERE_APP_SERVER_PATH=/opt/IBM/WebSphe re/AppServer/ JAZZSM_PATH=/opt/IBM/JazzSM DASH_USERNAME=smadmin DASH_PASSWORD=netcool KEYSTORE_OPTION=USE_DEFAULT_KEY EXIST_KEYSTORE_FILEPATH=/tmp/security.keys tore EXIST_CA_FILEPATH=/tmp/ca.crt KEYSTORE_PASSWORD=changeit KEY_PASSWORD=changeit ALIAS=npi DOMAIN_NAME=*.persistent.co.in ORG_NAME=PSL LOCALITY=UT STATE=SL COUNTRY=MY Run the integration script that is located in /opt/IBM/npi/npi -installertools/dashintegration folder. as root user. # <DASH_INTEGRATION_PATH>/npiDashIntegration .sh default=<DASH_INTEGRATION_PATH>/default.cf g custom=<DASH_INTEGRATION_PATH>/custom.cfg ☐ For example: cd /opt/IBM/npi/npi-installer-tools/dashintegration /opt/IBM/npi/npi-installer-tools/dashintegration/npiDashIntegration.sh default=/opt/IBM/npi/npi-installertools/dash-integration/default.cfg custom=/opt/IBM/npi/npi-installertools/dash-integration/custom.cfg https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_enable_integration_with_j azzsm.html Setting up communication with JazzSM on Ambari Task Description Check Login to the Ambari server web interface. Use admin/admin credentials. For example: ☐ Update the NOI Services settings Services > NPI > Configs > NOI Core Settings > NOI Services http://<myserver.ibm.com>:8080 ☐ Update the NPI Advanced settings Services > NPI > Configs > Advanced > Advanced npiauth ☐ https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_customize_npi_settings.ht ml Configure SSL communication for integration To establish secure communications, a certificate and an SSL configuration must be specified for the endpoint. You must configure the SSL one time only. If you are reinstalling or upgrading Network Performance Insight, back up the security.keystore and priv_key.key, which are the private keys, and ca.crt, which is the public key if you plan to reuse them. Perform the following tasks to achieve this: Configure SSL settings on WebSphere Application Server Add the signer certificate to your browser Configure SSL settings on WebSphere Application Server Task Description Check Log in to JazzSM as administrator user. ☐ Click Console Settings > Websphere Administrative Console and click Launch Websphere administrative console ☐ Click Security > SSL certificate and key management. ☐ Click SSL configurations > NodeDefaultSSLSettings from the list of Secure Socket Layer (SSL) configurations and change the alias to netcool. ☐ Click OK and save. Restart the WebSphere Application Server. The signer certificate information is displayed. ☐ ☐ Press y in the SSL Signer Prompt window. https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/configure/tnpi_setting_ssl_configurati ons.html Add the signer certificate to your browser The ca.crt file that is extracted from Jazz™ for Service Management must be imported to browser’s Trusted CA Certificate store. This task must be done on all computers that access Network Performance Insight data for visualization. These steps differ on different browsers. Instructions are provided for Internet Explorer and Firefox. Task Description Check Go to NPI installation directory. /opt/IBM/npi/installertools ☐ Copy the ca.crt signer certificate that was generated earlier to your local machine. ☐ Import the certificate to the browser on your local machine. For Firefox: ☐ A. Click Tools > Options B. Click Advanced > Certificates > View Certificates C. Click Authorities > Import D. Browse to the location of the exported ca.crt file and click Open. E. Select all the check boxes on the Downloading Certificate page and click OK. F. Click OK to close the window. For IE: A. Click Tools > Internet Options. B. Click Content > Certificates > Trusted Root Certification Authorities. C. Click Import. D. Browse to the location of the exported ca.crt file. E. Click Next. F. Select to place the certificates in Trusted Root Certification G. Authorities option and click Finish. https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/configure/tnpi_add_root_certificate_t o_browser.html Post installation tasks Perform these post installation tasks after the installation of Network Performance Insight is complete. To make sure that all the services start automatically when the Ambari server host is restarted, run the following command as root user on the Ambari server host: unlink /etc/rc.d/init.d/ambari-server cp -a /usr/sbin/ambari-server /etc/rc.d/init.d/ambari-server && systemctl daemon-reload Copy the conf.key file from Tivoli® Network Manager ($NCHOME/etc/security/keys directory) to Network Performance Insight (/opt/IBM/npi/npi-itnm-collector/resources/itnm/security/keys directory). cd /opt/IBM/npi/npi-itnm-collector/ mkdir -p resources/itnm/security/keys If you have previously disabled firewall, enable the firewall on all nodes in your cluster. Use these commands: systemctl start firewalld.service systemctl enable firewalld https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/cnpi_post_installation_task s.html Verify NPI installation Task Description Check Verify the installation logs that are available at /tmp directory. List all the logs using the following command: ☐ ls -lrt /tmp/*.log You can see the following log files: install_201607121342.log test_install_main.log apr_install.log apr_util_install.log httpd_install.log iop_http_repos.log iop_utils_http_repos.log ambari_http_repos.log npi_http_repos.log setupRepoServer.log ambari_repo_baseurl.log postgresql_libs_install.log postgresql_core_install.log postgresql_server_install.log ambari_server_install.log ambari_server_setup.log ambari_server_start.log setupAmbari.log ambari_npi_startup.log setupNpiServiceStack.log dashkey.log npiDashIntegration.log setupGenKeyTool.log ambari_npi_key_startup.log DASH integration script execution log file is located here: <DASH_Host>/tmp/enableDash.log On Ambari Server: /tmp/npiDashIntegration.log Logs for all services can be seen as follows: Parameter Description Ambari services You can find the Ambari service directories in /usr/iop/current The logs for each service can be found in /var/log/<service> NPI services You can find the NPI services in /opt/IBM/npi/<NPI_Service> The logs for each service can be found in: /opt/IBM/npi/logs/<NPI_Service> https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/install/tnpi_verifying_installation.html Install and configure Device Dashboard Perform the following task: Task Description Check Install and configure Device Dashboard To integrate with Network Performance Insight and use the Device Dashboard to view performance information about your network, you need to configure the dashboard. For more information, see here. ☐ https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/noi_integ/tnpi_noi_integ_configure_n pi_console_integrationon_jsm.html Configure Apache Storm Spout in Network Manager Configure integration with Network Performance Insight to enable Network Manager to share poll data with Network Performance Insight. For more information, see here Configure Storm Spout in Tivoli Network Manager to work with Network Performance Insight. Ensure that the Ambari host that has Kafka Broker installed is up and running. Configure NPI system Important: Ensure that you have installed the Device Dashboard before proceeding to configure your NPI system. Only after you install and configure the Device Dashboard, you can see the Console Integration (Snowflake) icon. Configure your Network Performance Insight system that is integrated with Dashboard Application Services Hub from the graphical user interface. You can configure the following items from system configuration for Flow-specific data: Interfaces Thresholds Domain names Retention profiles Task Description ☐ Login to JazzSM as npiadmin/netcool and navigate to Console Integration. Enabling flow interfaces Check Click Console Integration icon > Interfaces under System configuration. ☐ Select an interface and click Edit to enable or disable an interface. Configure domain names Click Console Integration icon > Domain Names under System configuration. Click the New icon and enter the domain name to resolve. ☐ You can also delete an existing domain name. Configure the retention profiles Click Console Integration icon > Retention Profiles under System configuration. ☐ Select an interface and click Edit to configure the retention profile period for an Interface. https://www.ibm.com/support/knowledgecenter/SSCVHB_1.2.1/traffic_overview/cnpi_configuration_tr affic_overview.html Troubleshooting Use this information to troubleshoot a problem with Network Performance Insight. A list of known problems and their solutions for NPI 1.2.1 and NOI 1.4.1: Known problems and solutions in NPI 1.2.1 Known problems in NOI 1.4.1 Use the forums for any queries you might have and out team will respond ASAP: https://www.ibm.com/developerworks/community/groups/service/html/communityoverview?com munityUuid=eaa9489e-3122-440a-93a3ee5cd204c603#fullpageWidgetId=W4c848ec1a7b8_4c41_80dd_0e4ddf24975c
© Copyright 2026 Paperzz