Transcript
  • SmartCloud Analytics - Predictive Insights 1.2Document Revision R2E1

    Installation Guide

  • NoteBefore using this information and the product it supports, read the information in Notices on page 57.

    Copyright IBM Corporation 2011, 2013.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

  • ContentsPreface . . . . . . . . . . . . . . . vAudience . . . . . . . . . . . . . . . vComponents . . . . . . . . . . . . . . v

    Chapter 1. Introduction . . . . . . . . 1Supported configurations . . . . . . . . . . 1Topology examples . . . . . . . . . . . . 2

    Chapter 2. Installation and setup ofrequirements . . . . . . . . . . . . 5Add the required users . . . . . . . . . . . 5KSH and required libraries . . . . . . . . . 6DB2 . . . . . . . . . . . . . . . . . 7

    Information required for SmartCloud Analytics -Predictive Insights installation . . . . . . . 8Installing DB2 as non-root . . . . . . . . . 8Installing DB2 as root . . . . . . . . . . 12

    InfoSphere Streams . . . . . . . . . . . . 13Information required for SmartCloud Analytics -Predictive Insights installation . . . . . . . 13Installing InfoSphere Streams software . . . . 14

    Netcool/OMNIbus . . . . . . . . . . . . 15Information required for SmartCloud Analytics -Predictive Insights installation . . . . . . . 16Installing the OMNIbus ObjectServer . . . . . 17Configuring the OMNIbus ObjectServer . . . . 17Starting the OMNIbus ObjectServer . . . . . 18Installing OMNIbus WebGUI . . . . . . . 18Configuring OMNIbus WebGUI users . . . . 19

    Chapter 3. Distributed installation ofSmartCloud Analytics - PredictiveInsights . . . . . . . . . . . . . . 21User accounts . . . . . . . . . . . . . 21Install the IBM Installation Manager . . . . . . 22Installing the database . . . . . . . . . . . 24Installing the Analytics component . . . . . . 25Installing the UI component . . . . . . . . . 27Installing the Mediation tool. . . . . . . . . 28Post-installation - System status . . . . . . . 30

    What to do next . . . . . . . . . . . . . 30

    Chapter 4. Installation of SmartCloudAnalytics - Predictive Insights to asingle server . . . . . . . . . . . . 33User accounts . . . . . . . . . . . . . 33Install the IBM Installation Manager . . . . . . 34Installing all components on one server . . . . . 35Post-installation - System status . . . . . . . 37What to do next . . . . . . . . . . . . . 37

    Chapter 5. Installation of SmartCloudAnalytics - Predictive Insights inconsole mode. . . . . . . . . . . . 39User accounts . . . . . . . . . . . . . 39Install the IBM Installation Manager . . . . . . 40Installing the database . . . . . . . . . . . 41Installing the Analytics component . . . . . . 43Installing the UI component . . . . . . . . . 44Installing the Mediation tool. . . . . . . . . 46Post-installation - System status . . . . . . . 47What to do next . . . . . . . . . . . . . 48Modifying the installation in console mode . . . . 48

    Chapter 6. Installing the Mediation toolon Windows . . . . . . . . . . . . 51

    Chapter 7. Uninstalling SmartCloudAnalytics - Predictive Insights. . . . . 53Uninstalling SmartCloud Analytics - PredictiveInsights. . . . . . . . . . . . . . . . 53

    Chapter 8. Installation log files . . . . 55

    Notices . . . . . . . . . . . . . . 57

    Trademarks. . . . . . . . . . . . . 61

    Copyright IBM Corp. 2011, 2013 iii

  • iv IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • PrefaceThe purpose of this guide is to help you install SmartCloud Analytics - PredictiveInsights.

    After completing all steps documented in this guide, you will have a set ofrunning SmartCloud Analytics - Predictive Insights components ready to configureinto a fully functional system.

    AudienceThe audience for this manual is the network administrator or operations specialistresponsible for installing SmartCloud Analytics - Predictive Insights.

    To install SmartCloud Analytics - Predictive Insights successfully, a basicknowledge of the following is required:v Administration of the Linux operating system.v Administration of IBM InfoSphere Streams.v Administration of the DB2 database management system.v Administration of OMNIbus and OMNIbus WebGUI.v SmartCloud Analytics - Predictive Insights

    ComponentsIBM SmartCloud Analytics - Predictive Insights consists of four main components.

    The IBM SmartCloud Analytics - Predictive Insights components are:v The Database component: is used to store configuration data, metadata and

    metric data.v The Analytic component: performs data mediation and processes incoming data

    to discover any anomalies that are present.v The Visualization component: presents any discovered anomalies through the

    IBM Tivoli Integrated Portal application.v The Mediation tool: is used to configure a data source and the data model that

    SmartCloud Analytics - Predictive Insights will monitor.

    SmartCloud Analytics - Predictive Insights documentation includes the followingguides:v Release notesv Installation Guidev Administration Guidev User Guide

    Copyright IBM Corp. 2011, 2013 v

  • vi IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Chapter 1. IntroductionSmartCloud Analytics - Predictive Insights is real-time performance analysissoftware for business services.

    SmartCloud Analytics - Predictive Insights eliminates manual threshold andbaseline configuration by providing a self-learning capability.

    By analyzing data from various sources and integrating with existing monitoringproducts, SmartCloud Analytics - Predictive Insights learns the normal behavior ofa business service and creates a performance model. When SmartCloud Analytics -Predictive Insights detects or forecasts anomalous behavior, an alarm is generated.SmartCloud Analytics - Predictive Insights offers out-of-the-box integration withNetcool OMNIbus.

    The SmartCloud Analytics - Predictive Insights system has four main components:v The Database component: is used to store configuration data, metadata and

    metric data.v The Analytic component: performs data mediation and processes incoming data

    to discover any anomalies that are present.v The Visualization component: presents any discovered anomalies through the

    IBM Tivoli Integrated Portal application.v The Mediation tool: is used to configure a data source and the data model that

    SmartCloud Analytics - Predictive Insights will monitor.

    Supported configurationsThe installation topology of SmartCloud Analytics - Predictive Insights mustconform to the following supported configurations.

    Configuration rules

    SmartCloud Analytics - Predictive Insights can be installed on a single server.

    The following distributed configuration requirements must be followed if theSmartCloud Analytics - Predictive Insights components are to be distributed acrossa number of servers:v SmartCloud Analytics - Predictive Insights Database component: The server

    hosting this component must also host: IBM DB2 Workgroup Server Edition 10.1 FP2

    v SmartCloud Analytics - Predictive Insights UI component: The server hostingthis component must also host: IBM Netcool/OMNIbus WebGUI 7.4

    - IBM Tivoli Integrated Portal 2.2, IBM Tivoli Integrated Portal 2.1. This isbundled with OMNIbus WebGUI.

    IBM Java SDK 6.0 SR10 FP1v SmartCloud Analytics - Predictive Insights Analytic component: The Analytics

    component can exist on its own server, but must be accompanied by: IBM InfoSphere Streams 3.1

    Copyright IBM Corp. 2011, 2013 1

  • IBM Java SDK 6.0 SR13 FP1

    With the following restrictions:v The upper limit of hosts within a SmartCloud Analytics - Predictive Insights

    environment is four, that is, four servers with one component on each.v Omnibus is the only component that supports a remote installation. All other

    components must be installed locally. For all components other than Omnibus,installation media must be made available on the server to which the componentis being installed, and the installation run locally for that component.

    Topology examplesThe installation topology of SmartCloud Analytics - Predictive Insights mustconform to the following supported configurations.

    The following is an example of a single server SmartCloud Analytics - PredictiveInsights topology.

    Table 1. Small topologyServer name Components Notes

    Server1 v SmartCloud Analytics -Predictive InsightsDatabase component

    v SmartCloud Analytics -Predictive Insights UIcomponent

    v SmartCloud Analytics -Predictive InsightsAnalytic component

    v IBM DB2 WorkgroupServer Edition 10.1 FP2

    v IBM Tivoli IntegratedPortal 2.2

    v IBM Java SDK 6.0 SR10FP1

    v IBM Netcool/OMNIbusCore 7.4

    v IBM Netcool/OMNIbusWebGUI 7.4

    v IBM InfoSphere Streams3.1

    The installation of IBMNetcool/OMNIbus Core 7.4and IBM Netcool/OMNIbusWebGUI 7.4 is optional.

    The following is an example of a medium SmartCloud Analytics - PredictiveInsights topology spread across three servers.

    2 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Table 2. Medium topologyServer name Components Notes

    Server1 v SmartCloud Analytics -Predictive InsightsDatabase component

    v IBM DB2 WorkgroupServer Edition 10.1 FP2

    v IBM Java SDK 6.0 SR13FP1

    DB2 is installed as part ofthe DataStage install, sothey generally share a server.

    Server2 v SmartCloud Analytics -Predictive InsightsAnalytic component

    v IBM InfoSphere Streams3.1

    v IBM Java SDK 6.0 SR13FP1

    Server3 v SmartCloud Analytics -Predictive Insights UIcomponent

    v IBM Tivoli IntegratedPortal 2.2

    v IBM Netcool/OMNIbusCore 7.4

    v IBM Netcool/OMNIbusWebGUI 7.4

    The installation of IBMNetcool/OMNIbus Core 7.4and IBM Netcool/OMNIbusWebGUI 7.4 is optional.

    The following is an example of a large SmartCloud Analytics - Predictive Insightstopology spread across four servers.

    Table 3. Large topologyServer name Components Notes

    Server1 v SmartCloud Analytics -Predictive InsightsDatabase component

    v IBM DB2 WorkgroupServer Edition 10.1 FP2

    Server2 v SmartCloud Analytics -Predictive Insights UIcomponent

    v IBM Tivoli IntegratedPortal 2.2

    v IBM Netcool/OMNIbusWebGUI 7.4

    v IBM Java SDK 6.0 SR10FP1

    Chapter 1. Introduction 3

  • Table 3. Large topology (continued)Server name Components Notes

    Server3 v SmartCloud Analytics -Predictive InsightsAnalytic component

    v IBM InfoSphere Streams3.1

    v IBM Java SDK 6.0 SR13FP1

    Server4 v IBM Netcool/OMNIbusCore 7.4

    The installation of IBMNetcool/OMNIbus Core 7.4and IBM Netcool/OMNIbusWebGUI 7.4 is optional.

    4 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Chapter 2. Installation and setup of requirementsThe set of software requirements for SmartCloud Analytics - Predictive Insightsand the order in which they must be installed.

    System requirements

    The system requirements for SmartCloud Analytics - Predictive Insights are listedon the Service Management Connect wiki for SmartCloud Analytics - PredictiveInsights under the section: IBM SmartCloud Analytics - Predictive InsightsRequirements.

    Installation order

    You must install the SmartCloud Analytics - Predictive Insights requirements inthis order:1. IBM DB2 Workgroup Server Edition 10.1 FP22. IBM InfoSphere Streams 3.13. IBM Netcool/OMNIbus Core 7.44. IBM Netcool/OMNIbus WebGUI 7.4

    The order of installation is the same for a single server installation as it is for adistributed, or multiserver, installation.

    Note: If Netcool/OMNIbus is installed, we recommend that you create a newinstance for SmartCloud Analytics - Predictive Insights. If you do not have itinstalled, the OMNIbus software can be provided.

    Add the required usersThere are two users that must be created to facilitate the installation of SmartCloudAnalytics - Predictive Insights and its requirements.

    About this task

    The two users that you must create are:v scadminv db2inst1

    The db2inst1 user must be created on the server on which you install DB2. Thescadmin user must be created on the server on which analytics is installed, and alsoon the database server.

    Procedure1. As root user on the database server and on the analytics server, add the user

    account scadmin.The following are the commands that are required to create this user:groupadd scadminuseradd -g scadmin -d /home/scadmin -s /bin/bash scadminpasswd scadmin

    Copyright IBM Corp. 2011, 2013 5

  • 2. As user root on the database server, create an OS user within the relevantgroup.groupadd db2iadm1useradd -g db2iadm1 -d /home/db2inst1 -s /bin/bash db2inst1passwd db2inst1

    3. As root user on the database server, add the existing scadmin user to the sameprimary group as the DB2 instance owner, by default this user is db2inst1.For example, add the user scadmin to the group db2iadm1.usermod -G scadmin,db2iadm1 scadmin

    4. On the database server, add the following source command into the~scadmin/.bashrc file:if [ -f /home/db2inst1/sqllib/db2profile ]; then. /home/db2inst1/sqllib/db2profilefi

    The commands assume two things:v db2inst1 is the DB2 instance owner.v /home/db2inst1 is the home area of the DB2 instance owner

    KSH and required librariesSmartCloud Analytics - Predictive Insights requires the installation of KSH andsome libraries.

    Before you begin

    Note: This is not a statement of the libraries required by the SmartCloud Analytics- Predictive Insights pre-requirements, that is, DB2, InfoSphere Streams, andNetcool/OMNIbus. To find the required libraries for these products, you must runthe product-specific dependency checker scripting or check the product-specificdocumentation.

    About this task

    The Analytics server requires the following packages:v 64-bit packages:

    atlas compat-libgfortran-41 lapack blas

    The Database server requires the following packages:v 64-bit packages:

    dapl sg3_utils

    The following are the required on all servers in the topology:v 32-bit packages:

    /usr/lib/libstdc++.so.6 /usr/lib/libstdc++.so.5

    v 64-bit packages: compat-libstdc++-33

    6 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • KSH is also a software requirement.

    Procedure1. For each required library enter the command, yum install, followed by the

    name of that library.2. If you see this error from yum when installing the 32-bit libstdc++ libraries:

    Error: Protected multilib versions: libstdc++

    Then run yum update libstdc++ and re-try the install.3. If KSH is not on your system, install it as follows:

    yum install ksh

    DB2DB2 is a requirement of SmartCloud Analytics - Predictive Insights.

    Document caveat

    This installation guide provides a shortened version of the DB2 installationprocess.

    Note: It must be noted the installation process prescribed in this documentation isnot meant to replace the product-specific documentation. The installation processhere contained for DB2 has been provided for the convenience of the end-user andshould only be used if:v You are performing a basic install of DB2, accepting all the default options.v You are performing a trial installation of the SmartCloud Analytics - Predictive

    Insights product.

    You must consult the official DB2 documentation if:v You intend to use extra options or steps that are not the default as described in

    this document.v You intend to install multiple instances of the required product

    The official and complete IBM DB2 Installation instructions and release notes areavailable in the IBM DB2 Database for Linux, UNIX, and Windows InformationCenter: http://pic.dhe.ibm.com/infocenter/db2luw/v10r1/index.jsp.

    Install processes

    The following are the two options for DB2 installation covered in this document:v Install DB2 as non-rootv Install DB2 as root

    Both of these options are covered in the following sections, only one of theseoptions is to be pursued.

    Chapter 2. Installation and setup of requirements 7

  • Information required for SmartCloud Analytics - PredictiveInsights installation

    The installation process for SmartCloud Analytics - Predictive Insights requires thatyou have your DB2 installation information at the ready.

    The following table lists the DB2 information items that the SmartCloud Analytics -Predictive Insights installer requests as you pursue the installation process. It is agood practice to make note of all listed items as you install the DB2 database.

    Table 4. DB2 details required by SmartCloud Analytics - Predictive InsightsInformation item Default

    DB2 instance user name db2inst1

    SmartCloud Analytics - Predictive InsightsDatabase name

    SCAPIDB

    SmartCloud Analytics - Predictive InsightsDatabase server port number

    50000

    SmartCloud Analytics - Predictive InsightsDatabase host

    Current host

    SmartCloud Analytics - Predictive InsightsDatabase user

    scadmin

    SmartCloud Analytics - Predictive InsightsDatabase user password

    Installing DB2 as non-rootDB2 is a requirement of SmartCloud Analytics - Predictive Insights.

    About this task

    The DB2 installer automatically creates and configures a non-root instance during anon-root installation. As a non-root user, you can customize the configuration ofthe non-root instance during the installation. You can also use and maintain theinstalled DB2 database product without root privileges. The non-root installation ofa DB2 database product has one DB2 instance with most features enabled bydefault.

    A non-root installation can be attractive for many groups, such as:v Enterprises that have thousands of workstations and users who want to install a

    DB2 database product without consuming a system administrator's timev Application developers who are not typically system administrators but use DB2

    database products to develop applicationsv Independent Software Vendors (ISVs) who develop software that does not

    require root user authority yet embeds a DB2 database product

    Although non-root installations have most of the function of root installations,there are some differences and limitations. You can lift some of the limitations byhaving a root user run the db2rfe command.

    Before you install any DB2 database product as a non-root user, be aware of thedifferences between root installations and non-root installations, and the limitationsof non-root installations. For more information on non-root installation, seeInstalling DB2 database servers as a non-root user in the DB2 Information Center.

    8 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • The following tasks are described in order to allow you install DB2 as a non-rootuser:

    Procedure1. Prepare for DB2 installation by installing the required libraries.2. Install DB2 using the non-root user account.3. Enabling root-based features in non-root installations with db2rfe4. If your DB2 installation connection has problems, runs some checks to verify

    your installation.

    Prepare for DB2 installation as non-rootYou must create the non-root user to carry out the installation of DB2 and add therequired files.

    About this task

    DB2 can be installed as a non-root user. The ongoing management of DB2 is doneas the DB2 instance owner. Typically the DB2 instance owner is db2inst1.

    For more information on DB2 installation prerequisites, see Operating system userlimit requirements (Linux and UNIX) in the DB2 Information Center.

    Procedure1. As db2inst1, copy the DB2 installation software to the directory in which you

    want to extract it.2. Change the permissions on the folder, if necessary, to be owned by db2inst1.3. As db2inst1, extract the DB2 installation software.

    For example:tar zxvf v10.1fp2_linuxx64_wser.tar.gz

    Note: The package filename is correct for DB2 installation version IBM DB2Workgroup Server Edition 10.1 FP2

    4. As db2inst1, change to the wser directory and run the DB2 prerequisiteschecker script.For example:./db2prereqcheck -v 10.1.0.2

    You can ignore alerts in relation to the following:v /lib/libpam.so*v rdmav InfiniBandv modprobe.confv OpenSSH

    5. As root, install any packages that are called out as problems by thedb2prereqcheck script.For example:yum install daplyum install sg3_utils

    6. Check if SELINUX is enabled, and if so disable it.For example:vi /etc/selinux/configSELINUX=disabled

    Chapter 2. Installation and setup of requirements 9

  • 7. Restart the server if the SELINUX setting was changed.

    DB2 installation as non-rootInstall DB2 as the non-root user db2inst1.

    Before you begin

    Verify your operating system user process resource limits (ulimits). If the minimumulimit values are not met, the DB2 engine can encounter unexpected operatingresource shortage errors. These errors can lead to a DB2 database system outage.See the section Recommended ulimit values for non-root installations in the DB2Information Center for details of the recommended ulimit values.

    Procedure1. Log in as the non-root user db2inst1.2. Change to the directory containing the installation software.

    For example:# cd /home/db2inst1/db2/wser

    3. As db2inst1, run the db2setup script:# ./db2_install

    4. Select WSE and click Enter.5. Follow the installation wizard to complete the installation.

    Enable root-based features in non-root installations with db2rfeThere are several features and abilities in non-root installations that are initiallyunavailable but which can be enabled by running a the db2rfe command.

    About this task

    There are further limitations on non-root installations that can be overcome byrunning the db2rfe command. The following features and abilities are initiallyunavailable in non-root installations:v Operating system-based authenticationv The ability to reserve service names in the /etc/services file

    They will be enabled using db2rfe_config_file.cfg available in the unpackedPredictiveInsights.tgz

    Procedure

    To enable the features and abilities that are initially unavailable in non-rootinstallations:1. Navigate to the predictiveInsightsInstaller1.2 directory, that is within the

    directory in which you unpacked PredictiveInsights.tgz.2. Copy the sample configuration file, db2rfe_config_file.cfg, to a different

    location, for example, /home/db2inst1.3. Update the copied configuration file as needed. This configuration file is input

    to the db2rfe command. Our Example enables:v Operating system-based authenticationv The ability to reserve service names in the /etc/services file

    Note: Consult DB2 documentation and update as preferred

    10 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • 4. Stop DB2. As db2inst1, run:# db2stop

    5. End the server to client process: As db2inst1, run:# db2 terminate

    6. Log in with root user authority.7. Navigate to the $HOME/sqllib/instance directory, where $HOME represent's the

    non-root user's home directory.8. Run the db2rfe command referring to the updated configuration file. For

    example:./db2rfe -f /home/db2inst1/db2rfe_config_file.cfg

    Where:v db2rfe_config_file.cfg is the configuration file provided in

    PredictiveInsights.tgz.v /home/db2inst1 is the directory to which you copied

    db2rfe_config_file.cfg. If you copied this to another directory, pleaseupdate the command syntax to refer to your chosen directory.

    DB2 post installation tasksConfigure your DB2 installation so that it is running correctly.

    Procedure1. Stop DB2. As db2inst1, run:

    # db2stop

    2. End the server to client process: As db2inst1, run:# db2 terminate

    3. If the port is closed you may need to disable iptables on the DB2 server.As root, run the following commands:service iptables stop/sbin/chkconfig --del iptables

    4. Check DB config to ensure SVCENAME is correct.Run the following command as db2inst1:# db2 get dbm cfg | grep SVCENAME

    If SVCENAME does not match "db2c_db2inst1" then update using thefollowing command:# db2 update dbm cfg using SVCENAME db2c_db2inst1

    5. Verify SVCENAME, as seen in step 4, exists for correct port in /etc/services file. Ifnot then append it to /etc/services file.db2c_db2inst1 50000/tcp

    6. Ensure the communication protocols for DB2 instance uses TCPIP.As db2inst1, run:# db2set DB2COMM=tcpip

    7. Start DB2:As DB2inst1 run command:# db2start

    What to do next

    See the section Verifying the installation using the command line processor (CLP) in theDB2 Information Center to confirm that DB2 was installed correctly.

    Chapter 2. Installation and setup of requirements 11

  • Installing DB2 as rootDB2 is a requirement of SmartCloud Analytics - Predictive Insights.

    Before you begin

    Verify your operating system user process resource limits (ulimits). If the minimumulimit values are not met, the DB2 engine can encounter unexpected operatingresource shortage errors. These errors can lead to a DB2 database system outage.See the section Recommended ulimit values for non-root installations in the DB2Information Center for details of the recommended ulimit values.

    About this task

    DB2 can be installed as root. The ongoing management of DB2 is done as the DB2instance owner. Typically the DB2 instance owner is db2inst1.

    Procedure1. Copy the DB2 installation software to the directory in which you want to

    extract it.2. Extract the DB2 installation software.

    For example:tar zxvf v10.1fp2_linuxx64_server.tar.gz

    Note: The package filename is correct for DB2 installation version IBM DB2Workgroup Server Edition 10.1 FP2

    3. Change to the wser directory and run the DB2 prerequisites checker script.For example:./db2prereqcheck -v 10.1.0.2

    You can ignore alerts in relation to the following:v /lib/libpam.so*v rdmav InfiniBandv modprobe.conf

    4. Install any packages that are called out as problems by the db2prereqcheckscript.For example:yum install daplyum install sg3_utils

    5. Check if SELINUX is enabled, and if so disable it.For example:vi /etc/selinux/configSELINUX=disabled

    6. Restart if the SELINUX setting was changed.7. Change to the directory containing the installation software.

    For example:# cd /opt/install/wser

    8. Run the db2setup script:# ./db2setup

    12 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Note: This command opens the DB2 installation wizard and therefore must berun from a suitable XTERM or VNC window.

    9. Click Install a product from the set of options displayed.10. Click Install New > DB2 Workgroup Server Edition version 10.1 Fix Pack 2.11. Follow the installation wizard to complete the installation.

    Make note of any users and passwords that you specified.

    InfoSphere StreamsInfoSphere Streams is a requirement of SmartCloud Analytics - Predictive Insights.

    Document caveat

    This installation guide provides a shortened version of the InfoSphere Streamsinstallation process.

    Note: It must be noted the installation process prescribed in this documentation isnot meant to replace the product-specific documentation. The installation processhere contained for InfoSphere Streams has been provided for the convenience ofthe end-user and should only be used if:v You are performing a basic install of InfoSphere Streams, accepting all the

    default options.v You are performing a trial installation of the SmartCloud Analytics - Predictive

    Insights product.

    You must consult the official DB2 documentation if:v You intend to use extra options or steps that are not the default as described in

    this document.v You intend to install multiple instances of the required product

    The official and complete Installation and administration information for IBMInfoSphere Streams can be found in the IBM InfoSphere Streams Information Center:http://pic.dhe.ibm.com/infocenter/streams/v3r0/index.jsp

    Information required for SmartCloud Analytics - PredictiveInsights installation

    The installation process for SmartCloud Analytics - Predictive Insights requires thatyou have your InfoSphere Streams install information at the ready.

    The following table lists the InfoSphere Streams information items that theSmartCloud Analytics - Predictive Insights installer requests as you pursue theinstallation process. It is a good practice to make note of the required InfoSphereStreams installation information.

    Table 5. InfoSphere Streams details required by the SmartCloud Analytics - PredictiveInsights installerInformation item Default

    InfoSphere Streams user scadmin

    InfoSphere Streams user password

    InfoSphere Streams installation location /home/scadmin/InfoSphereStreams

    Chapter 2. Installation and setup of requirements 13

  • Installing InfoSphere Streams softwareInstalling InfoSphere Streams software for SmartCloud Analytics - PredictiveInsights.

    Before you begin1. As root, edit the /etc/selinux/config file to set SELinux to disabled.

    A change to this policy requires a restart of the Linux VM/ServerSee the section "Security-Enhanced Linux (SELinux) for IBM InfoSphereStreams" contained in the IBM InfoSphere Streams information center:http://pic.dhe.ibm.com/infocenter/streams/v3r0/index.jsp.

    2. Ensure the user that is being used to install InfoSphere Streams has executablepermissions on the /tmp, /opt, and /home file systems.

    3. Ensure that su from the root user does not require that you enter a password.4. Check the /etc/hosts file to make sure that the server name is not on the same

    line as the loop back address.For example, if you have an address that looks like:127.0.0.1 localhost.localdomain localhost

    Then, remove the server name so that it looks like:127.0.0.1 localhost.localdomain localhost

    The loopback address must not be removed.5. Make sure the created user (scadmin in our example) has full permissions on

    the InfoSphere Streams installation software.6. Change to the scadmin user, for example:

    su - scadmin

    7. Extract the InfoSphere Streams installation software, for example:tar zxvf Streams-3.1.0.0-x86_64-el6.tar.gz

    8. Change to the and as scadmin use theInfoSphere Streams dependency checker:cd ./dependency_checker.sh

    The standard streams installation folder is ~scadmin/InfoSphereStreams.You may receive alerts that the following file is missing:v perl-XML-SimpleThe files are installed manually and can be found in the directory /rpm.To install a missing rpm, run the following command:yum install .rpm

    Note: If root user permissions are required to install missing files, make surethat you switch back to your InfoSphere Streams user, scadmin, after youcomplete the installation.

    Procedure1. Run the installer as scadmin:

    cd ./InfoSphereStreamsSetup.bin

    When the installation is complete the Postinstallation Tasks dialog isdisplayed, which lists the set of initial configuration tasks for InfoSphereStreams.

    14 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • 2. Run the following tasks only from the First Steps:v Configure the SSH environmentv Generate public and private keysv Verify the InstallationIf the dialog does not open or must be reopened change to the directory and run FirstSteps.sh, for example:cd /home/scadmin/InfoSphereStreams./FirstSteps.sh

    3. Add the following line to the .bashrc file for scadmin:. /home/scadmin/InfoSphereStreams/bin/streamsprofile.sh

    4. Save and source the file:. ~/.bashrc

    What to do next

    To ensure the version of Java that comes with InfoSphere Streams is the one that isused at run time.1. Update the JAVA_HOME and PATH to match the new Java.

    An example path is:/home/scadmin/InfoSphereStreams/java

    Note: Adjust path to match the InfoSphere Streams location.This must be carried out in the current shell and also in:v ~scadmin/.bashrcv ~scadmin/.bash_profile

    Netcool/OMNIbusNetcool/OMNIbus is a required integration item for SmartCloud Analytics -Predictive Insights.

    The official and complete Installation and administration information forNetcool/OMNIbus can be found in the IBM Tivoli Netcool/OMNIbus informationcenter:http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp?topic=%2Fcom.ibm.netcool_OMNIbus.doc_7.4.0%2Fomnibus%2Fwip%2Fwelcome.htm

    Document caveat

    This installation guide provides a shortened version of the Netcool/OMNIbusinstallation process.

    Note: It must be noted the installation process prescribed in this documentation isnot meant to replace the product-specific documentation. The installation processhere contained for Netcool/OMNIbus has been provided for the convenience ofthe end-user and should only be used if:v You are performing a basic install of Netcool/OMNIbus, accepting all the

    default options.v You are performing a trial installation of the SmartCloud Analytics - Predictive

    Insights product.

    You must consult the official DB2 documentation if:

    Chapter 2. Installation and setup of requirements 15

  • v You intend to use extra options or steps that are not the default as described inthis document.

    v You intend to install multiple instances of the required product

    The official and complete Installation and administration information forNetcool/OMNIbus can be found in the IBM Tivoli Netcool/OMNIbus informationcenter:http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp?topic=%2Fcom.ibm.netcool_OMNIbus.doc_7.4.0%2Fomnibus%2Fwip%2Fwelcome.htm

    Information required for SmartCloud Analytics - PredictiveInsights installation

    The installation process for SmartCloud Analytics - Predictive Insights requires thatyou have certain your Netcool/OMNIbus and Netcool/OMNIbus WebGUIinstallation information at the ready.

    The following table lists the Netcool/OMNIbus and Netcool/OMNIbus WebGUIinformation items that the SmartCloud Analytics - Predictive Insights installer willrequest as you pursue the installation process. It is a good practice to make note ofall information items as you install Netcool/OMNIbus and Netcool/OMNIbusWebGUI.

    Table 6. Netcool/OMNIbus and Netcool/OMNIbus WebGUI details required by theSmartCloud Analytics - Predictive Insights installerInformation item Default

    OMNIbus server host name Current host

    OMNIbus server port number 4100

    OMNIbus Object Server name NCOMS

    OMNIbus admin user name root

    OMNIbus admin user password Note: It is possible to leave this password asan empty string. Entering this passwordincorrectly is not flagged immediately withinthe SmartCloud Analytics - PredictiveInsights installer, but results in certaincomponents not installing correctly.

    Directory where WAAPI is installed /opt/IBM/tivoli/netcool/omnibus_webgui/waapi

    Table 7. Tivoli Integrated Portal details required by the SmartCloud Analytics - PredictiveInsights installerInformation item Default

    Directory where Tivoli Integrated Portal isinstalled

    /opt/IBM/tivoli/tipv2

    Tivoli Integrated Portal user name tipadmin

    Tivoli Integrated Portal user password

    16 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Installing the OMNIbus ObjectServerThe OMNIbus ObjectServer is the standard event management system thatSmartCloud Analytics - Predictive Insights can use.

    Before you begin

    Download and install the OMNIbus prerequisite scanner to make sure you have allthe OMNIbus requirements in place before you begin the installation. Theprerequisite scanner can be downloaded from, http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/topic/com.ibm.netcool_OMNIbus.doc_7.4.0/omnibus/wip/install/reference/omn_ref_prscanner.html

    About this task

    OMNIbus ObjectServer can be installed by either a root or non-root user. Forsimplicity root can be used to install the OMNIbus ObjectServer. If you choose toinstall as non-root, ensure the appropriate permissions on the install software andtarget location are given to the chosen non-root user. The ongoing management ofOMNIbus must be done as root if you install as root.

    Procedure1. Copy the OMNIbus ObjectServer installation software to the directory in which

    you want to extract it.2. Extract the OMNIbus ObjectServer installation software.

    For example:tar xvf NC_OMNI_CORE_74_LIN.tar

    Note: The package filename is correct for OMNIbus ObjectServer installationversion IBM Netcool/OMNIbus Core 7.4.

    3. Start the graphical user interface installation wizard:./launchpad.sh

    4. Click Install product from the set of options displayed.5. Click Start Tivoli/ Netcool/OMNIBus Installation.6. Follow the installation wizard to complete the installation, selecting the default

    options.

    Configuring the OMNIbus ObjectServerWhen the Omnibus initial installation is complete and before you install OMNIbusWebGUI, you must configure the ObjectServer.

    Procedure1. Change to the directory /opt/IBM/tivoli/netcool/etc.2. Make a copy of the omni.dat file.

    For example, run the commendmv omni.dat omni.dat.ORIG

    3. Run the command:sed s/omnihost//g omni.dat.ORIG > omni.dat

    4. Change to the directory /opt/IBM/tivoli/netcool/bin.5. Run the command:

    ./nco_igen -out /opt/IBM/tivoli/netcool/etc/interfaces

    6. Change to the directory /opt/IBM/tivoli/netcool/omnibus/bin.

    Chapter 2. Installation and setup of requirements 17

  • 7. Run the following commands:./nco_dbinit

    Results

    Configuration of the OMNIbus ObjectServer is now complete and it is ready to bestarted

    Starting the OMNIbus ObjectServerWhen the Omnibus initial installation is complete and before you install OMNIbusWebGUI, you must start the ObjectServer.

    Procedure1. Change to the directory /opt/IBM/tivoli/netcool/omnibus/bin.2. Run the following commands:

    nohup ./nco_objserv &

    3. Confirm the ObjectServer is running:./nco_sql -user root

    Note: If your OMNIbus root user password is blank, press return after enteringroot.

    4. If the login worked OK, then this is enough to validate the Objectserver isrunning. Enter 'quit' to exit.

    Installing OMNIbus WebGUIOMNIbus WebGUI is a set of visualization tools for OMNIbus to allow for themonitoring and management of events. The installation of WebGUI includes theinstallation of Tivoli Integrated Portal into which the SmartCloud Analytics -Predictive Insights UI can be installed.

    About this task

    OMNIbus WebGUI can be installed by either a root or non-root user. For simplicityinstall OMNIbus WebGUI as root. If you choose to install as non-root, ensure theappropriate permissions on the install software and target location are given to thechosen non-root user. The ongoing management of OMNIbus must be done as rootif you install as root.

    Procedure1. Ensure the OMNIbus ObjectServer that you installed is started2. Copy the OMNIbus WebGUI installation software to the directory in which you

    want to extract it.3. Extract the OMNIbus WebGUI installation software.

    For example:tar xvf NC_OMNI_WEB_GUI_74_64_LIN.tar

    Note: The package filename is correct for OMNIbus WebGUI installationversion IBM Netcool/OMNIbus WebGUI 7.4.

    4. Move to the CD Image directory and start the graphical user interfaceinstallation wizard:cd cdimage./install.sh

    18 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • 5. Follow the installation wizard to complete the installation, selecting the defaultoptions, and recording any users and their passwords that you enter.

    Configuring OMNIbus WebGUI usersIn order for users to be able to use the Active Event List to monitor events, theymust be given permissions to access the WebGUI tools.

    Procedurev Follow these steps to assign WebGUI permissions to tipadmin:

    1. Log in to Tivoli Integrated Portal as tipadmin.You can access Tivoli Integrated Portal using your browser, for example:http://:16310/ibm/console

    The port in the example is 16310, as it is generally for http. For https the portis normally 16311.

    2. Click Users and Groups > User Roles .3. Click Search and select tipadmin.4. Select the following options and click Save:

    ncw_admin netcool_rw

    5. Click Logout.6. Log back in as tipadmin.7. In the navigation pane on the left, you can see extra entries that include

    Administration and Availability.8. SmartCloud Analytics - Predictive Insights sends events to the Active Event

    List, which can be found at Availability > Events > Active Event List (AEL).v Follow these steps to assign WebGUI permissions to all users that are not

    tipadmin:1. Log in to Tivoli Integrated Portal as tipadmin.2. Change to Users and Groups > Manage Users.3. Enter the relevant user ID and click Search.4. Click the user that is displayed in the table.5. Click the Groups tab.6. Click Add.7. Click Search to see the list of groups.8. Assign the following groups as appropriate.

    Administrative Users: Netcool_OMNIbus_Admin Ordinary Users: Netcool_OMNIbus_User

    9. Click the General tab.10. Click OK.

    Note: To make the SmartCloud Analytics - Predictive Insights action scriptavailable you must have a user with Netcool_OMNIbus_Admin.

    Chapter 2. Installation and setup of requirements 19

  • 20 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Chapter 3. Distributed installation of SmartCloud Analytics -Predictive Insights

    How to install SmartCloud Analytics - Predictive Insights.

    You can install all SmartCloud Analytics - Predictive Insights components on asingle server. You can also install the SmartCloud Analytics - Predictive Insightscomponents in a distributed configuration.

    Note: This chapter covers the distributed installation of SmartCloud Analytics -Predictive Insights components. If you want to perform a single server or proof ofconcept installation, skip this chapter and go straight to Installation of SmartCloudAnalytics - Predictive Insights on a single server

    If you choose to install SmartCloud Analytics - Predictive Insights as a distributedsystem, the component combinations you install must be based on the installationconfigurations that are described in this document. For more information about thepossible installation configurations, see Supported configurations on page 1.

    The installation of SmartCloud Analytics - Predictive Insights components can onlybe performed on the server on which you are running the IBM InstallationManager. Remote installation of SmartCloud Analytics - Predictive Insightscomponents is not supported, you must install each component on its host server.

    Make sure that you have copied the installation package to each server on whichyou are installing a component

    User accountsThe installation topology of SmartCloud Analytics - Predictive Insights can involvea number of different user accounts. It is important to login as the correct userwhen you pursue the installation of each component.

    The User accounts that must be employed to install components

    The following table lists the user accounts that must be used to install eachSmartCloud Analytics - Predictive Insights component.

    Copyright IBM Corp. 2011, 2013 21

  • Table 8. . The user accounts required to install componentsComponent User Notes

    Single server installation, that is,all SmartCloud Analytics -Predictive Insights componentsare installed by the same user.

    Root or non-root (specialconditions apply fornon-root, see the Notes)

    You can install allSmartCloud Analytics -Predictive Insightscomponents as a non-rootuser, through one instanceof the IBM InstallationManager, if either of thefollowing are true:

    v That non-root useraccount was used toinstall all prerequisites.

    Otherwise, only the rootuser can be used to pursuethe installation of allcomponents through oneinstance of the IBMInstallation Manager.

    SmartCloud Analytics -Predictive Insights AnalyticsInstallation

    Root or the user accountthat is used to installInfoSphere Streams

    The user account that isused to install InfoSphereStreams. The user specifiedin this documentation isscadmin.

    SmartCloud Analytics -Predictive Insights User InterfaceInstallation

    The user account that isused to install TivoliIntegrated Portal

    The SmartCloud Analytics -Predictive Insights UI hasthe limitation that the userwho installed TivoliIntegrated Portal (whichmay have occurred as partof the OMNIbus WebGUIinstallation) must installthe SmartCloud Analytics -Predictive Insights UI.

    SmartCloud Analytics -Predictive Insights Database

    Root, the database owner,or a non-root user that ispart of the same group asthe database owner.

    The DB owner is notnecessarily the DB2instance owner. The userspecified in thisdocumentation is scadmin.

    Note: SmartCloud Analytics - Predictive Insights requires that you use a BASHshell for the scadmin user.

    Install the IBM Installation ManagerIBM Installation Manager is the tool that you use to install your software packages.

    Before you begin

    Create the directory /opt/IBM/scanalytics on each server to which you areinstalling a SmartCloud Analytics - Predictive Insights component. Create thedirectory in such a way that each user that will be used to install SmartCloudAnalytics - Predictive Insights on that server has read, write and executepermissions on this directory.

    22 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • About this task

    The IBM Installation Manager must be installed once for each user you intend touse to install the individual SmartCloud Analytics - Predictive Insightscomponents. The IBM Installation Manager can be installed only once for each useron a server.

    If you are performing a single server installation, that is, all components are beinginstalled on the one server, you must install the IBM Installation Manager once onthat server for each user you intend to use for the installation of each component.

    If you are performing a multi server installation, that is, a distributed installation,you must install the IBM Installation Manager on each server you intend to installa component. The installation of each IBM Installation manager must be carriedout by the user you intend to use to install the SmartCloud Analytics - PredictiveInsights component on that server.

    Procedure1. Extract the SmartCloud Analytics - Predictive Insights package from the media.2. Change to the new installer directory.3. Start the installer by running the command:

    ./install.sh

    4. On the Licenses page, read the license agreements for IBM InstallationManager. If you agree to the terms of all the license agreements, click I acceptthe terms in the license agreements and then click Next.

    5. On the location page, in the Installation Manager Directory field, type the pathfor the directory where you want to install Installation Manager or accept thedefault path and then click Next.

    6. On the Summary page, review your choices before starting the installationprocess. If you want to change your selections, click Back to return to theprevious pages. When you are satisfied with your selections, click Install. TheIBM Installation Manager is installed.

    7. Click Finish.

    Results

    The IBM Installation Manager is restarted and the IBM Installation Manager homescreen is displayed.

    What to do next

    If upon restart of your IBM Installation Manager, you are not presented with theset of SmartCloud Analytics - Predictive Insights packages for installation, do thefollowing:1. Click Exit, to close the IBM Installation Manager.2. Restart the IBM Installation Manager by running the command:

    ./install.sh

    Chapter 3. Distributed installation of SmartCloud Analytics - Predictive Insights 23

  • Installing the databaseInstalling the database for SmartCloud Analytics - Predictive Insights.

    Before you begin

    The SmartCloud Analytics - Predictive Insights database component can beinstalled by the database owner that is created in section Adding a new DB2 useror by the root user.

    Note: The installation script can install components only to the server on which itis running.

    Make sure that you have copied the installation package to the server on whichyou are installing the component.

    About this task

    To install the database, you are required to complete the following steps:

    Procedure1. As the database owner, as root, or as s user that is part of the same group as

    the database owner, for example, scadmin, do the following:a. Open a terminal window on the server on which you are installing

    SmartCloud Analytics - Predictive Insights.b. Navigate to the directory that contains the extracted SmartCloud Analytics -

    Predictive Insights installation package.c. Enter the command ./install.sh.

    The IBM Installation Manager is opened.d. Click the Install option.

    The IBM Installation Manager displays the local installation packages.e. Select Predictive Insights install option and click Next.f. On the Licenses page, read the license agreements for SmartCloud Analytics

    - Predictive Insights. If you agree to the terms of all the license agreements,click I accept the terms in the license agreements and then click Next.

    g. On the Location page, in the Shared Resources Directory field, type thepath for the shared directory. The suggested default directory is/opt/IBM/scanalytics/install_/shared.The IBM Installation Manager provides the ability to share componentsacross products. SmartCloud Analytics - Predictive Insights does not sharecomponents with any other product. It is a requirement of the IBMInstallation Manager that a shared directory be provided when you installit. The shared directory must be unique for each user who installs the IBMInstallation Manager on the same server.

    h. Click Next.i. On the Location page, Create a new package group is the only available

    option for SmartCloud Analytics - Predictive Insights.In the Installation Directory field, type the path for the installation files. Wesuggest using default directory of /opt/IBM/scanalytics/install_/installer and then click Next.

    24 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • If you choose to change Installation Directory from default directory pleasetake into account that the Installation Directory must be unique for eachuser who installs the IBM Installation Manager on the same server.The IBM Installation Manager displays all SmartCloud Analytics - PredictiveInsights components that can be installed.

    2. Select Database and click Next. Make sure you have deselected anycomponents that you do not wish to install as the current user. The IBMInstallation Manager displays each distinct set of required information under aheading. All headings can be selected within the pane on the left side.

    3. Click Database creation configuration in the left pane and enter the requiredinformation.Please note the following points:v Update to create DB on a specific location: Optional setting by which you

    can specify an install location for the database that is not the default DB2location. The directory must exist and be owned by the DB2 instance user.

    4. Click Validate to confirm all settings are correct.5. Click Next. The IBM Installation Manager displays the installation summary

    information.6. Click Install.

    Installing the Analytics componentInstalling the analytics component for SmartCloud Analytics - Predictive Insights.

    About this task

    The SmartCloud Analytics - Predictive Insights analytics component can beinstalled by the InfoSphere Streams administrator, which was set to be scadminduring the InfoSphere Streams install, or by the root user.

    Note: The installation script can install components only to the server on which itis running.

    Make sure that you have copied the installation package to the server on whichyou are installing the component.

    A SmartCloud Analytics - Predictive Insights database must exist before theSmartCloud Analytics - Predictive Insights Analytics component can be installed,therefore, you must install the Database component before you install the Analyticscomponent. If you are installing the Database and Analytics components together,the installer will require that the database installation is completed first.

    It is advised that you install the Mediation tool using the same user as you use toinstall the Analytics component, that is, the InfoSphere Streams administrator.

    To install the analytics component, you are required to complete the followingsteps.

    Procedure1. As the scadmin or root user do the following:

    a. Open a terminal window on the server on which you are installingSmartCloud Analytics - Predictive Insights.

    Chapter 3. Distributed installation of SmartCloud Analytics - Predictive Insights 25

  • b. Navigate to the directory that contains the extracted SmartCloud Analytics- Predictive Insights installation package.

    c. Enter the command ./install.sh.The IBM Installation Manager is opened.

    d. Click the Install option.The IBM Installation Manager displays the local installation packages.

    e. Select Predictive Insights install option and click Next.f. On the Licenses page, read the license agreements for SmartCloud

    Analytics - Predictive Insights. If you agree to the terms of all the licenseagreements, click I accept the terms in the license agreements and thenclick Next.

    g. On the Location page, in the Shared Resources Directory field, type thepath for the shared directory. The suggested default directory is/opt/IBM/scanalytics/install_/shared.The IBM Installation Manager provides the ability to share componentsacross products. SmartCloud Analytics - Predictive Insights does not sharecomponents with any other product. It is a requirement of the IBMInstallation Manager that a shared directory be provided when you installit. The shared directory must be unique for each user who installs the IBMInstallation Manager on the same server.

    h. Click Next.i. On the Location page, Create a new package group is the only available

    option for SmartCloud Analytics - Predictive Insights.In the Installation Directory field, type the path for the installation files.We suggest using default directory of /opt/IBM/scanalytics/install_/installer and then click Next.If you choose to change Installation Directory from default directoryplease take into account that the Installation Directory must be unique foreach user who installs the IBM Installation Manager on the same server.The IBM Installation Manager displays all SmartCloud Analytics -Predictive Insights components that can be installed.

    2. Select Analytics and click Next. Make sure you have deselected anycomponents that you do not wish to install as the current user. The IBMInstallation Manager displays each distinct set of required information under aheading. All headings can be selected within the pane on the left side.

    3. Click Database connection configuration in the left pane and enter therequired information.

    4. Click Validate to confirm all settings are correct.5. Click Analytics configuration in the left pane and enter the required

    information.6. Click Validate to confirm all settings are correct.7. If you wish to integrate SmartCloud Analytics - Predictive Insights with

    OMNIbus, click Omnibus connection configuration in the left pane and enterthe required information.

    8. Click Validate to confirm all settings are correct.9. Click Next. The IBM Installation Manager displays the installation summary

    information.10. Click Install.

    26 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Installing the UI componentInstalling the UI component for SmartCloud Analytics - Predictive Insights.

    Before you begin

    The SmartCloud Analytics - Predictive Insights UI component is installed by thesame user that installed Tivoli Integrated Portal.

    Note: The install script can only install components to the machine on which it isrunning.

    Make sure you have copied the installation package to the server on which youinstalling the component.

    Tivoli Integrated Portal must be running before installing the SmartCloud Analytics- Predictive Insights UI. The UI installation process will perform a restart of TivoliIntegrated Portal.

    About this task

    A SmartCloud Analytics - Predictive Insights database must exist before theSmartCloud Analytics - Predictive Insights UI component can be installed,therefore, you must install the Database component before you install the UIcomponent. If you are installing the Database and UI components together, theinstaller will require that the database installation is completed first.

    Procedure1. Start the IBM Installation Manager and begin the SmartCloud Analytics -

    Predictive Insights UI component installation. As the user that installed TivoliIntegrated Portal. do the following:a. Open a terminal window on the server on which you are installing

    SmartCloud Analytics - Predictive Insights.b. Navigate to the directory that contains the extracted SmartCloud Analytics -

    Predictive Insights installation package.c. Enter the command ./install.sh.

    The IBM Installation Manager is opened.d. Click the Install option.

    The IBM Installation Manager displays the local installation packages.e. Select Predictive Insights install option and click Next.f. On the Licenses page, read the license agreements for SmartCloud Analytics

    - Predictive Insights. If you agree to the terms of all the license agreements,click I accept the terms in the license agreements and then click Next.

    g. On the Location page, in the Shared Resources Directory field, type thepath for the shared directory. The suggested default directory is/opt/IBM/scanalytics/install_/shared.The IBM Installation Manager provides the ability to share componentsacross products. SmartCloud Analytics - Predictive Insights does not sharecomponents with any other product. It is a requirement of the IBMInstallation Manager that a shared directory be provided when you installit. The shared directory must be unique for each user who installs the IBMInstallation Manager on the same server.

    h. Click Next.

    Chapter 3. Distributed installation of SmartCloud Analytics - Predictive Insights 27

  • i. On the Location page, Create a new package group is the only availableoption for SmartCloud Analytics - Predictive Insights.In the Installation Directory field, type the path for the installation files. Wesuggest using default directory of /opt/IBM/scanalytics/install_/installer and then click Next.If you choose to change Installation Directory from default directory pleasetake into account that the Installation Directory must be unique for eachuser who installs the IBM Installation Manager on the same server.The IBM Installation Manager displays all SmartCloud Analytics - PredictiveInsights components that can be installed.

    2. Select UI and click Next. The IBM Installation Manager displays each distinctset of required information under a heading. All headings can be selectedwithin the pane on the left side.

    3. Click Database connection configuration in the left pane and enter therequired information.

    4. Click Validate to confirm all settings are correct.5. Click UI configuration in the left pane and enter the required information.6. Click Validate to confirm all settings are correct.7. Click Next. The IBM Installation Manager displays the installation summary

    information.8. Click Install.

    Installing the Mediation toolThe SmartCloud Analytics - Predictive Insights Mediation tool is used to configurethe data presentation to SmartCloud Analytics - Predictive Insights. The toolingcan be installed on Windows or Linux systems.

    Before you begin

    Note: The installation script can install components only to the server on which itis running.

    Make sure that you have copied the installation package to the server on whichyou are installing the component.

    It is best to install the Mediation tool on the same server to which you installed theAnalytics component.

    Note: If you are unable to gain access to a graphical display on the server hostingthe Analytics component, you can install the Mediation tool on a Linux desktopsystem, or on a Windows desktop system. For details on install the Mediation toolon a Windows system, see Chapter 6, Installing the Mediation tool on Windows,on page 51. Installing to a Linux desktop system is performed in the same way asdescribed in the following procedure.

    About this task

    To install the Mediation tool, you are required to complete the following steps:

    Procedure1. As the InfoSphere Streams administrator or root user do the following:

    28 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • a. Open a terminal window on the server on which you are installingSmartCloud Analytics - Predictive Insights.

    b. Navigate to the directory that contains the extracted SmartCloud Analytics -Predictive Insights installation package.

    c. Enter the command ./install.sh.The IBM Installation Manager is opened.

    d. Click the Install option.The IBM Installation Manager displays the local installation packages.

    e. Select Predictive Insights install option and click Next.f. On the Licenses page, read the license agreements for SmartCloud Analytics

    - Predictive Insights. If you agree to the terms of all the license agreements,click I accept the terms in the license agreements and then click Next.

    g. On the Location page, in the Shared Resources Directory field, type thepath for the shared directory. The suggested default directory is/opt/IBM/scanalytics/install_/shared.The IBM Installation Manager provides the ability to share componentsacross products. SmartCloud Analytics - Predictive Insights does not sharecomponents with any other product. It is a requirement of the IBMInstallation Manager that a shared directory be provided when you installit. The shared directory must be unique for each user who installs the IBMInstallation Manager on the same server.

    h. Click Next.i. On the Location page, Create a new package group is the only available

    option for SmartCloud Analytics - Predictive Insights.In the Installation Directory field, type the path for the installation files. Wesuggest using default directory of /opt/IBM/scanalytics/install_/installer and then click Next.If you choose to change Installation Directory from default directory pleasetake into account that the Installation Directory must be unique for eachuser who installs the IBM Installation Manager on the same server.The IBM Installation Manager displays all SmartCloud Analytics - PredictiveInsights components that can be installed.

    2. Select Mediation tool and click Next. The IBM Installation Manager displayseach distinct set of required information under a heading. All headings can beselected within the pane on the left side.

    3. Click Mediation tool configuration in the left pane and enter the requiredinformation.

    4. Click Validate to confirm all settings are correct.5. Click Next. The IBM Installation Manager displays the installation summary

    information.6. Click Install.

    Chapter 3. Distributed installation of SmartCloud Analytics - Predictive Insights 29

  • Post-installation - System statusAfter installation, SmartCloud Analytics - Predictive Insights is ready to configureinto a working system.

    The following elements are in place and ready to use when SmartCloud Analytics -Predictive Insights installation is complete:v Two default user roles (predictiveInsightsAdmin and predictiveInsightsUser)

    are created in Tivoli Integrated Portal.v The Tivoli Integrated Portal administrator (usually tipadmin) is given both roles.v The administration CLI is directly usable by the Linux user account that

    installed SmartCloud Analytics - Predictive Insights, that is, the SmartCloudAnalytics - Predictive Insights account, which is by default scadmin.

    v If OMNIbus integration is enabled during installation: OMNIbus columns are created in the Object Server. An OMNIbus mini-distribution is installed transparently as part of

    SmartCloud Analytics - Predictive Insights. The probe configuration files are updated to configure the connection to the

    Object Server. A default set of probe rules file is installed. The rules file stores all relevant

    attributes in the Object Server database. The right-click menu is configured in OMNIbus WebGUI during the UI

    component installation.

    What to do nextThe SmartCloud Analytics - Predictive Insights installation is now complete, sowhat do you do next?

    About this task1. After the installation is complete, all required configuration steps must be

    completed:a. To add the launch script to the AEL: Log in to Tivoli Integrated Portal, as

    the administrator, click Administration > Event management Tools > MenuConfiguration, select Alerts and click Modify.

    b. Move the ViewChildAlarms... and ServiceDiagnosis... scripts to yourpreferred menu position, and click Save.

    c. Click Users & Groups > Manage Groups, select the users to which youwant to give SmartCloud Analytics - Predictive Insights access, and assignthe group predictiveInsightsUsers to the selected user.

    2. Start SmartCloud Analytics - Predictive Insights consuming data anddiscovering anomalies:a. Launch the Mediation tool by navigating to /opt/IBM/scanalytics/

    mediationtool/eclipse and running ./eclipse.b. Create a new project, and add a data source to the project, setting the data

    source to be of type Database.c. Update the fields within the Connection Details tab to setup the connection

    to your source database.d. Select the Model Design tab, synchronize with the database, and then select

    the tables or groups that you want to form part of your model.

    30 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • e. For each group you selected, update the Group Definition, Attributes, andMetrics.

    f. Preview, validate and then deploy the resulting model.g. Use the ./admin.sh set_property command to set the

    aggregation.interval and ui.granularity.default.min properties.h. Start SmartCloud Analytics - Predictive Insights by navigating to the

    $TASP_HOME/bin directory, and running .i. Run the extractor using the command ./admin.sh run_extractor_instance

    -m EXTRACT -s -n

    j. Wait for the training period to complete at which point SmartCloudAnalytics - Predictive Insights produces alarms.

    Chapter 3. Distributed installation of SmartCloud Analytics - Predictive Insights 31

  • 32 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Chapter 4. Installation of SmartCloud Analytics - PredictiveInsights to a single server

    How to install SmartCloud Analytics - Predictive Insights on a single server.

    You can install all SmartCloud Analytics - Predictive Insights components on asingle server. This section contains the steps required to perform a single serverinstallation.

    The installation of SmartCloud Analytics - Predictive Insights components can onlybe performed on the server on which you are running the IBM InstallationManager. Remote installation of SmartCloud Analytics - Predictive Insightscomponents is not supported, you must install each component on its host server.

    Make sure that you have copied the installation package to each server on whichyou are installing a component

    User accountsThe installation topology of SmartCloud Analytics - Predictive Insights can involvea number of different user accounts. It is important to login as the correct userwhen you pursue the installation of each component.

    The User accounts that must be employed to install components

    The following table lists the user accounts that must be used to install eachSmartCloud Analytics - Predictive Insights component.

    Table 9. . The user accounts required to install componentsComponent User Notes

    Single server installation, that is,all SmartCloud Analytics -Predictive Insights componentsare installed by the same user.

    Root or non-root (specialconditions apply fornon-root, see the Notes)

    You can install allSmartCloud Analytics -Predictive Insightscomponents as a non-rootuser, through one instanceof the IBM InstallationManager, if either of thefollowing are true:

    v That non-root useraccount was used toinstall all prerequisites.

    Otherwise, only the rootuser can be used to pursuethe installation of allcomponents through oneinstance of the IBMInstallation Manager.

    SmartCloud Analytics -Predictive Insights AnalyticsInstallation

    Root or the user accountthat is used to installInfoSphere Streams

    The user account that isused to install InfoSphereStreams. The user specifiedin this documentation isscadmin.

    Copyright IBM Corp. 2011, 2013 33

  • Table 9. (continued). The user accounts required to install componentsComponent User Notes

    SmartCloud Analytics -Predictive Insights User InterfaceInstallation

    The user account that isused to install TivoliIntegrated Portal

    The SmartCloud Analytics -Predictive Insights UI hasthe limitation that the userwho installed TivoliIntegrated Portal (whichmay have occurred as partof the OMNIbus WebGUIinstallation) must installthe SmartCloud Analytics -Predictive Insights UI.

    SmartCloud Analytics -Predictive Insights Database

    Root, the database owner,or a non-root user that ispart of the same group asthe database owner.

    The DB owner is notnecessarily the DB2instance owner. The userspecified in thisdocumentation is scadmin.

    Note: SmartCloud Analytics - Predictive Insights requires that you use a BASHshell for the scadmin user.

    Install the IBM Installation ManagerIBM Installation Manager is the tool that you use to install your software packages.

    Before you begin

    Create the directory /opt/IBM/scanalytics on each server to which you areinstalling a SmartCloud Analytics - Predictive Insights component. Create thedirectory in such a way that each user that will be used to install SmartCloudAnalytics - Predictive Insights on that server has read, write and executepermissions on this directory.

    About this task

    The IBM Installation Manager must be installed once for each user you intend touse to install the individual SmartCloud Analytics - Predictive Insightscomponents. The IBM Installation Manager can be installed only once for each useron a server.

    If you are performing a single server installation, that is, all components are beinginstalled on the one server, you must install the IBM Installation Manager once onthat server for each user you intend to use for the installation of each component.

    If you are performing a multi server installation, that is, a distributed installation,you must install the IBM Installation Manager on each server you intend to installa component. The installation of each IBM Installation manager must be carriedout by the user you intend to use to install the SmartCloud Analytics - PredictiveInsights component on that server.

    Procedure1. Extract the SmartCloud Analytics - Predictive Insights package from the media.2. Change to the new installer directory.3. Start the installer by running the command:

    34 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • ./install.sh

    4. On the Licenses page, read the license agreements for IBM InstallationManager. If you agree to the terms of all the license agreements, click I acceptthe terms in the license agreements and then click Next.

    5. On the location page, in the Installation Manager Directory field, type the pathfor the directory where you want to install Installation Manager or accept thedefault path and then click Next.

    6. On the Summary page, review your choices before starting the installationprocess. If you want to change your selections, click Back to return to theprevious pages. When you are satisfied with your selections, click Install. TheIBM Installation Manager is installed.

    7. Click Finish.

    Results

    The IBM Installation Manager is restarted and the IBM Installation Manager homescreen is displayed.

    What to do next

    If upon restart of your IBM Installation Manager, you are not presented with theset of SmartCloud Analytics - Predictive Insights packages for installation, do thefollowing:1. Click Exit, to close the IBM Installation Manager.2. Restart the IBM Installation Manager by running the command:

    ./install.sh

    Installing all components on one serverInstalling all the SmartCloud Analytics - Predictive Insights components on oneserver.

    Before you begin

    You can install all SmartCloud Analytics - Predictive Insights components as anon-root user, through one instance of the IBM Installation Manager, if either of thefollowing are true:v That non-root user account was used to install all prerequisites.v That non-root user account is configured to be a member of the same groups as

    the users that were used to install each prerequisite.

    Otherwise, only the root user can be used to pursue the installation of allcomponents through one instance of the IBM Installation Manager.

    Note: The installation script can install components only to the server on which itis running.

    Make sure that you have copied the installation package to the server on whichyou are installing the component.

    About this task

    The following instructions will install all components to the one server:

    Chapter 4. Installation of SmartCloud Analytics - Predictive Insights to a single server 35

  • Procedure1. As root, or a qualified non-root user, for example, scadmin, do the following:

    a. Open a terminal window on the server on which you are installingSmartCloud Analytics - Predictive Insights.

    b. Navigate to the directory that contains the extracted SmartCloud Analytics- Predictive Insights installation package.

    c. Enter the command ./install.sh.The IBM Installation Manager is opened.

    d. Click the Install option.The IBM Installation Manager displays the local installation packages.

    e. Select Predictive Insights install option and click Next.f. On the Licenses page, read the license agreements for SmartCloud

    Analytics - Predictive Insights. If you agree to the terms of all the licenseagreements, click I accept the terms in the license agreements and thenclick Next.

    g. On the Location page, in the Shared Resources Directory field, type thepath for the shared directory. The suggested default directory is/opt/IBM/scanalytics/install_/shared.The IBM Installation Manager provides the ability to share componentsacross products. SmartCloud Analytics - Predictive Insights does not sharecomponents with any other product. It is a requirement of the IBMInstallation Manager that a shared directory be provided when you installit. The shared directory must be unique for each user who installs the IBMInstallation Manager on the same server.

    h. Click Next.i. On the Location page, Create a new package group is the only available

    option for SmartCloud Analytics - Predictive Insights.In the Installation Directory field, type the path for the installation files.We suggest using default directory of /opt/IBM/scanalytics/install_/installer and then click Next.If you choose to change Installation Directory from default directoryplease take into account that the Installation Directory must be unique foreach user who installs the IBM Installation Manager on the same server.The IBM Installation Manager displays all SmartCloud Analytics -Predictive Insights components that can be installed.

    2. Select Database, Analytics, UI, and Mediation tool and click Next. The IBMInstallation Manager displays each distinct set of required information under aheading. All headings can be selected within the pane on the left side.

    3. Click Database creation configuration in the left pane and enter the requiredinformation.Please note the following points:v Update to create DB on a specific location: Optional setting by which you

    can specify an install location for the database that is not the default DB2location. The directory must exist and be owned by the DB2 instance user.

    4. Click Validate to confirm all settings are correct.5. Click Analytics configuration in the left pane and enter the required

    information.6. Click Validate to confirm all settings are correct.

    36 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • 7. If you wish to integrate SmartCloud Analytics - Predictive Insights withOMNIbus, click Omnibus connection configuration in the left pane and enterthe required information.

    8. Click Validate to confirm all settings are correct.9. Click UI configuration in the left pane and enter the required information.

    10. Click Validate to confirm all settings are correct.11. Click Mediation tool configuration in the left pane and enter the required

    information.12. Click Validate to confirm all settings are correct.13. Click Next. The IBM Installation Manager displays the installation summary

    information.14. Click Install.

    Post-installation - System statusAfter installation, SmartCloud Analytics - Predictive Insights is ready to configureinto a working system.

    The following elements are in place and ready to use when SmartCloud Analytics -Predictive Insights installation is complete:v Two default user roles (predictiveInsightsAdmin and predictiveInsightsUser)

    are created in Tivoli Integrated Portal.v The Tivoli Integrated Portal administrator (usually tipadmin) is given both roles.v The administration CLI is directly usable by the Linux user account that

    installed SmartCloud Analytics - Predictive Insights, that is, the SmartCloudAnalytics - Predictive Insights account, which is by default scadmin.

    v If OMNIbus integration is enabled during installation: OMNIbus columns are created in the Object Server. An OMNIbus mini-distribution is installed transparently as part of

    SmartCloud Analytics - Predictive Insights. The probe configuration files are updated to configure the connection to the

    Object Server. A default set of probe rules file is installed. The rules file stores all relevant

    attributes in the Object Server database. The right-click menu is configured in OMNIbus WebGUI during the UI

    component installation.

    What to do nextThe SmartCloud Analytics - Predictive Insights installation is now complete, sowhat do you do next?

    About this task1. After the installation is complete, all required configuration steps must be

    completed:a. To add the launch script to the AEL: Log in to Tivoli Integrated Portal, as

    the administrator, click Administration > Event management Tools > MenuConfiguration, select Alerts and click Modify.

    b. Move the ViewChildAlarms... and ServiceDiagnosis... scripts to yourpreferred menu position, and click Save.

    Chapter 4. Installation of SmartCloud Analytics - Predictive Insights to a single server 37

  • c. Click Users & Groups > Manage Groups, select the users to which youwant to give SmartCloud Analytics - Predictive Insights access, and assignthe group predictiveInsightsUsers to the selected user.

    2. Start SmartCloud Analytics - Predictive Insights consuming data anddiscovering anomalies:a. Launch the Mediation tool by navigating to /opt/IBM/scanalytics/

    mediationtool/eclipse and running ./eclipse.b. Create a new project, and add a data source to the project, setting the data

    source to be of type Database.c. Update the fields within the Connection Details tab to setup the connection

    to your source database.d. Select the Model Design tab, synchronize with the database, and then select

    the tables or groups that you want to form part of your model.e. For each group you selected, update the Group Definition, Attributes, and

    Metrics.f. Preview, validate and then deploy the resulting model.g. Use the ./admin.sh set_property command to set the

    aggregation.interval and ui.granularity.default.min properties.h. Start SmartCloud Analytics - Predictive Insights by navigating to the

    $TASP_HOME/bin directory, and running .i. Run the extractor using the command ./admin.sh run_extractor_instance

    -m EXTRACT -s -n

    j. Wait for the training period to complete at which point SmartCloudAnalytics - Predictive Insights produces alarms.

    38 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Chapter 5. Installation of SmartCloud Analytics - PredictiveInsights in console mode

    SmartCloud Analytics - Predictive Insights can be installed in console mode forthose who cannot access a graphical display.

    You can install all SmartCloud Analytics - Predictive Insights components on asingle server. You can also install the SmartCloud Analytics - Predictive Insightscomponents in a distributed configuration.

    Note: This chapter covers the distributed installation of SmartCloud Analytics -Predictive Insights components in console mode. Console mode should only beused if you are unable to access or use a graphical interface. If you can access agraphical interface it is recommended that you pursue the installation using theIBM Installation Manager in graphical mode, which is covered in Chapter 3,Distributed installation of SmartCloud Analytics - Predictive Insights, on page 21

    If you choose to install SmartCloud Analytics - Predictive Insights as a distributedsystem, the component combinations you install must be based on the installationconfigurations that are described in this document. For more information about thepossible installation configurations, see Supported configurations on page 1.

    The installation of SmartCloud Analytics - Predictive Insights components can onlybe performed on the server on which you are running in console mode. Remoteinstallation of SmartCloud Analytics - Predictive Insights components is notsupported, you must install each component on its host server.

    Make sure that you have copied the installation package to each server on whichyou are installing a component

    User accountsThe installation topology of SmartCloud Analytics - Predictive Insights can involvea number of different user accounts. It is important to login as the correct userwhen you pursue the installation of each component.

    The User accounts that must be employed to install components

    The following table lists the user accounts that must be used to install eachSmartCloud Analytics - Predictive Insights component.

    Copyright IBM Corp. 2011, 2013 39

  • Table 10. . The user accounts required to install componentsComponent User Notes

    Single server installation, that is,all SmartCloud Analytics -Predictive Insights componentsare installed by the same user.

    Root or non-root (specialconditions apply fornon-root, see the Notes)

    You can install allSmartCloud Analytics -Predictive Insightscomponents as a non-rootuser, through one instanceof the IBM InstallationManager, if either of thefollowing are true:

    v That non-root useraccount was used toinstall all prerequisites.

    Otherwise, only the rootuser can be used to pursuethe installation of allcomponents through oneinstance of the IBMInstallation Manager.

    SmartCloud Analytics -Predictive Insights AnalyticsInstallation

    Root or the user accountthat is used to installInfoSphere Streams

    The user account that isused to install InfoSphereStreams. The user specifiedin this documentation isscadmin.

    SmartCloud Analytics -Predictive Insights User InterfaceInstallation

    The user account that isused to install TivoliIntegrated Portal

    The SmartCloud Analytics -Predictive Insights UI hasthe limitation that the userwho installed TivoliIntegrated Portal (whichmay have occurred as partof the OMNIbus WebGUIinstallation) must installthe SmartCloud Analytics -Predictive Insights UI.

    SmartCloud Analytics -Predictive Insights Database

    Root, the database owner,or a non-root user that ispart of the same group asthe database owner.

    The DB owner is notnecessarily the DB2instance owner. The userspecified in thisdocumentation is scadmin.

    Note: SmartCloud Analytics - Predictive Insights requires that you use a BASHshell for the scadmin user.

    Install the IBM Installation ManagerThe IBM Installation Manager can be installed in console mode for those whocannot access or use a graphical interface. IBM Installation Manager is the tool thatyou use to install your software packages.

    Before you begin

    Create the directory /opt/IBM/scanalytics on each server to which you areinstalling a SmartCloud Analytics - Predictive Insights component. Create thedirectory in such a way that each user that will be used to install SmartCloud

    40 IBM SmartCloud Analytics - Predictive Insights: Installation Guide

  • Analytics - Predictive Insights on that server has read, write and executepermissions on this directory.

    About this task

    The IBM Installation Manager must be installed once for each user you intend touse to install the individual SmartCloud Analytics - Predictive Insightscomponents. The IBM Installation Manager can be installed only once for each useron a server.

    If you are performing a single server installation, that is, all components are beinginstalled on the one server, you must install the IBM Installation Manager once onthat server for each user you intend to use for the installation of each component.

    If you are performing a multi server installation, that is, a distributed installation,you must install the IBM Installation Manager on each server you intend to installa component. The installation of each IBM Installation manager must be carriedout by the user you intend to use to install the SmartCloud Analytics - PredictiveInsights component on that server.

    Procedure1. Extract the SmartCloud Analytics - Predictive Insights package from the media.2. Change to the new installer directory.3. Start the installer in console mode by running the command:

    ./install.sh -c

    Note: The console accepts both upper and lower case.4. Ensure IBM Installation Manager is selected, type 'n' and press Enter.5. Type 'a' to accept the Licence Agreement, type 'n' and press Enter.6. To change location type 'l', or else type 'n' to accept the default location and

    press Enter.7. Type 'i' to install.8. Type 'r' to restart.

    What to do next

    If upon restart of your IBM Installation Manager, you are not presented with theset of SmartCloud Analytics - Predictive Insights packages for installation, run./install.sh -c once more.

    Installing the databaseInstalling the database for SmartCloud Analytics - Predictive Insights in consolemode.

    Before you begin

    The SmartCloud Analytics - Predictive Insights database component can beinstalled by the database owner that is created in section Adding a new DB2 useror by the root user.

    Note: The installation script can install components only to the server on which itis running.

    Chapter 5. Installation of SmartCloud Analytics - Predictive Insights in console mode 41

  • Make sure that you have copied the installation package to the server on whichyou are installing the component.

    About this task

    To install the database, you are required to complete the following steps:

    Procedure1. As the database owner, as root, or as s user that is part of the same group as

    the database owner, for example, scadmin, open a terminal session on theserver on which you want to install the database component.

    2. Navigate to the directory that contains the extracted SmartCloud Analytics -Predictive Insights installation package.

    3. Run the command:./install.sh -c

    Note: The console accepts both upper and lower