PDF Tasp Installguide 1201
PDF Tasp Installguide 1201
PDF Tasp Installguide 1201
2
Document Revision R2E1
Installation Guide
Note
Before using this information and the product it supports, read the information in Notices on page 57.
Contents
Preface . . . . . . . . . . . . . . . v
Audience .
Components
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. v
. v
Chapter 1. Introduction . . . . . . . . 1
Supported configurations .
Topology examples . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 1
. 2
. 5
. 6
. 7
. 8
. 8
. 12
. 13
. 13
. 14
. 15
.
.
.
.
.
.
16
17
17
18
18
19
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
21
22
24
25
27
28
30
What to do next .
. 30
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
33
34
35
37
37
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
mode .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
39
40
41
43
44
46
47
48
48
. 53
iii
iv
Preface
The purpose of this guide is to help you install SmartCloud Analytics - Predictive
Insights.
After completing all steps documented in this guide, you will have a set of
running SmartCloud Analytics - Predictive Insights components ready to configure
into a fully functional system.
Audience
The audience for this manual is the network administrator or operations specialist
responsible for installing SmartCloud Analytics - Predictive Insights.
To install SmartCloud Analytics - Predictive Insights successfully, a basic
knowledge 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
Components
IBM 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 following
guides:
v Release notes
v Installation Guide
v Administration Guide
v User Guide
vi
Chapter 1. Introduction
SmartCloud Analytics - Predictive Insights is real-time performance analysis
software for business services.
SmartCloud Analytics - Predictive Insights eliminates manual threshold and
baseline configuration by providing a self-learning capability.
By analyzing data from various sources and integrating with existing monitoring
products, SmartCloud Analytics - Predictive Insights learns the normal behavior of
a 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 with
Netcool 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 configurations
The installation topology of SmartCloud Analytics - Predictive Insights must
conform 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 the
SmartCloud Analytics - Predictive Insights components are to be distributed across
a 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 hosting
this component must also host:
IBM Netcool/OMNIbus WebGUI 7.4
- IBM Tivoli Integrated Portal 2.2, IBM Tivoli Integrated Portal 2.1. This is
bundled with OMNIbus WebGUI.
IBM Java SDK 6.0 SR10 FP1
v 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
Topology examples
The installation topology of SmartCloud Analytics - Predictive Insights must
conform to the following supported configurations.
The following is an example of a single server SmartCloud Analytics - Predictive
Insights topology.
Table 1. Small topology
Server name
Components
Notes
Server1
Components
Notes
Server1
Server3
v IBM Netcool/OMNIbus
Core 7.4
v IBM Netcool/OMNIbus
WebGUI 7.4
Components
Server1
Notes
Chapter 1. Introduction
Components
Server3
Notes
v IBM Netcool/OMNIbus
Core 7.4
System requirements
The system requirements for SmartCloud Analytics - Predictive Insights are listed
on the Service Management Connect wiki for SmartCloud Analytics - Predictive
Insights under the section: IBM SmartCloud Analytics - Predictive Insights
Requirements.
Installation order
You must install the SmartCloud Analytics - Predictive Insights requirements in
this order:
1.
2.
3.
4.
IBM
IBM
IBM
IBM
The order of installation is the same for a single server installation as it is for a
distributed, or multiserver, installation.
Note: If Netcool/OMNIbus is installed, we recommend that you create a new
instance for SmartCloud Analytics - Predictive Insights. If you do not have it
installed, the OMNIbus software can be provided.
Procedure
1. 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 scadmin
useradd -g scadmin -d /home/scadmin -s /bin/bash scadmin
passwd scadmin
2. As user root on the database server, create an OS user within the relevant
group.
groupadd db2iadm1
useradd -g db2iadm1 -d /home/db2inst1 -s /bin/bash db2inst1
passwd db2inst1
3. As root user on the database server, add the existing scadmin user to the same
primary 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/db2profile
fi
atlas
compat-libgfortran-41
lapack
blas
Procedure
1. 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++
DB2
DB2 is a requirement of SmartCloud Analytics - Predictive Insights.
Document caveat
This installation guide provides a shortened version of the DB2 installation
process.
Note: It must be noted the installation process prescribed in this documentation is
not meant to replace the product-specific documentation. The installation process
here contained for DB2 has been provided for the convenience of the end-user and
should 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 are
available in the IBM DB2 Database for Linux, UNIX, and Windows Information
Center: 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-root
v Install DB2 as root
Both of these options are covered in the following sections, only one of these
options is to be pursued.
Default
db2inst1
SCAPIDB
50000
Current host
scadmin
The following tasks are described in order to allow you install DB2 as a non-root
user:
Procedure
1.
2.
3.
4.
Procedure
1. 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 DB2
Workgroup Server Edition 10.1 FP2
4. As db2inst1, change to the wser directory and run the DB2 prerequisites
checker script.
For example:
./db2prereqcheck -v 10.1.0.2
Procedure
1. Log in as the non-root user db2inst1.
2. Change to the directory containing the installation software.
For example:
# cd /home/db2inst1/db2/wser
Procedure
To enable the features and abilities that are initially unavailable in non-root
installations:
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 authentication
v The ability to reserve service names in the /etc/services file
Note: Consult DB2 documentation and update as preferred
10
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, please
update the command syntax to refer to your chosen directory.
Procedure
1. Stop DB2. As db2inst1, run:
# db2stop
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
5. Verify SVCENAME, as seen in step 4, exists for correct port in /etc/services file. If
not then append it to /etc/services file.
db2c_db2inst1 50000/tcp
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 the
DB2 Information Center to confirm that DB2 was installed correctly.
Chapter 2. Installation and setup of requirements
11
Procedure
1. 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 DB2
Workgroup 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
12
Note: This command opens the DB2 installation wizard and therefore must be
run 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 Streams
InfoSphere Streams is a requirement of SmartCloud Analytics - Predictive Insights.
Document caveat
This installation guide provides a shortened version of the InfoSphere Streams
installation process.
Note: It must be noted the installation process prescribed in this documentation is
not meant to replace the product-specific documentation. The installation process
here contained for InfoSphere Streams has been provided for the convenience of
the 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 IBM
InfoSphere Streams can be found in the IBM InfoSphere Streams Information Center:
http://pic.dhe.ibm.com/infocenter/streams/v3r0/index.jsp
Default
scadmin
/home/scadmin/InfoSphereStreams
13
Note: If root user permissions are required to install missing files, make sure
that you switch back to your InfoSphere Streams user, scadmin, after you
complete the installation.
Procedure
1. Run the installer as scadmin:
cd <Streams installation folder>
./InfoSphereStreamsSetup.bin
14
What to do next
To ensure the version of Java that comes with InfoSphere Streams is the one that is
used at run time.
1. Update the JAVA_HOME and PATH to match the new Java.
An example path is:
/home/scadmin/InfoSphereStreams/java
Netcool/OMNIbus
Netcool/OMNIbus is a required integration item for SmartCloud Analytics Predictive Insights.
The official and complete Installation and administration information for
Netcool/OMNIbus can be found in the IBM Tivoli Netcool/OMNIbus information
center: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/OMNIbus
installation process.
Note: It must be noted the installation process prescribed in this documentation is
not meant to replace the product-specific documentation. The installation process
here contained for Netcool/OMNIbus has been provided for the convenience of
the 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:
15
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
Netcool/OMNIbus can be found in the IBM Tivoli Netcool/OMNIbus information
center:http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp?topic=
%2Fcom.ibm.netcool_OMNIbus.doc_7.4.0%2Fomnibus%2Fwip%2Fwelcome.htm
Default
Current host
4100
NCOMS
root
/opt/IBM/tivoli/netcool/omnibus_webgui/
waapi
Table 7. Tivoli Integrated Portal details required by the SmartCloud Analytics - Predictive
Insights installer
Information item
Default
/opt/IBM/tivoli/tipv2
tipadmin
16
Procedure
1. 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
Procedure
1. Change to the directory /opt/IBM/tivoli/netcool/etc.
2. Make a copy of the omni.dat file.
For example, run the commend
mv omni.dat omni.dat.ORIG
17
Results
Configuration of the OMNIbus ObjectServer is now complete and it is ready to be
started
Procedure
1. Change to the directory /opt/IBM/tivoli/netcool/omnibus/bin.
2. Run the following commands:
nohup ./nco_objserv &
Note: If your OMNIbus root user password is blank, press return after entering
root.
4. If the login worked OK, then this is enough to validate the Objectserver is
running. Enter 'quit' to exit.
Procedure
1. Ensure the OMNIbus ObjectServer that you installed is started
2. 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
18
5. Follow the installation wizard to complete the installation, selecting the default
options, and recording any users and their passwords that you enter.
Procedure
v 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://<hostname>:16310/ibm/console
The port in the example is 16310, as it is generally for http. For https the port
is 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 script
available you must have a user with Netcool_OMNIbus_Admin.
19
20
User accounts
The installation topology of SmartCloud Analytics - Predictive Insights can involve
a number of different user accounts. It is important to login as the correct user
when you pursue the installation of each component.
21
User
Notes
You can install all
SmartCloud Analytics Predictive Insights
components as a non-root
user, through one instance
of the IBM Installation
Manager, if either of the
following are true:
v That non-root user
account was used to
install all prerequisites.
Otherwise, only the root
user can be used to pursue
the installation of all
components through one
instance of the IBM
Installation Manager.
Note: SmartCloud Analytics - Predictive Insights requires that you use a BASH
shell for the scadmin user.
22
Procedure
1. 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 Installation
Manager. If you agree to the terms of all the license agreements, click I accept
the terms in the license agreements and then click Next.
5. On the location page, in the Installation Manager Directory field, type the path
for the directory where you want to install Installation Manager or accept the
default path and then click Next.
6. On the Summary page, review your choices before starting the installation
process. If you want to change your selections, click Back to return to the
previous pages. When you are satisfied with your selections, click Install. The
IBM Installation Manager is installed.
7. Click Finish.
Results
The IBM Installation Manager is restarted and the IBM Installation Manager home
screen is displayed.
What to do next
If upon restart of your IBM Installation Manager, you are not presented with the
set of SmartCloud Analytics - Predictive Insights packages for installation, do the
following:
1. Click Exit, to close the IBM Installation Manager.
2. Restart the IBM Installation Manager by running the command:
./install.sh
23
Procedure
1. 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 the
path for the shared directory. The suggested default directory is
/opt/IBM/scanalytics/install_<user>/shared.
The IBM Installation Manager provides the ability to share components
across products. SmartCloud Analytics - Predictive Insights does not share
components with any other product. It is a requirement of the IBM
Installation Manager that a shared directory be provided when you install
it. The shared directory must be unique for each user who installs the IBM
Installation 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_<user>/
installer and then click Next.
24
Procedure
1. As the scadmin or root user do the following:
a. Open a terminal window on the server on which you are installing
SmartCloud Analytics - Predictive Insights.
25
26
Procedure
1. Start the IBM Installation Manager and begin the SmartCloud Analytics Predictive Insights UI component installation. As the user that installed Tivoli
Integrated 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 the
path for the shared directory. The suggested default directory is
/opt/IBM/scanalytics/install_<user>/shared.
The IBM Installation Manager provides the ability to share components
across products. SmartCloud Analytics - Predictive Insights does not share
components with any other product. It is a requirement of the IBM
Installation Manager that a shared directory be provided when you install
it. The shared directory must be unique for each user who installs the IBM
Installation Manager on the same server.
h. Click Next.
Chapter 3. Distributed installation of SmartCloud Analytics - Predictive Insights
27
2.
3.
4.
5.
6.
7.
8.
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_<user>/
installer and then click Next.
If you choose to change Installation Directory from default directory please
take into account that the Installation Directory must be unique for each
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.
Select UI and click Next. The IBM Installation Manager displays each distinct
set of required information under a heading. All headings can be selected
within the pane on the left side.
Click Database connection configuration in the left pane and enter the
required information.
Click Validate to confirm all settings are correct.
Click UI configuration in the left pane and enter the required information.
Click Validate to confirm all settings are correct.
Click Next. The IBM Installation Manager displays the installation summary
information.
Click Install.
Procedure
1. As the InfoSphere Streams administrator or root user do the following:
28
29
What to do next
The SmartCloud Analytics - Predictive Insights installation is now complete, so
what do you do next?
30
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 <starttime> -n
j. Wait for the training period to complete at which point SmartCloud
Analytics - Predictive Insights produces alarms.
31
32
User accounts
The installation topology of SmartCloud Analytics - Predictive Insights can involve
a number of different user accounts. It is important to login as the correct user
when you pursue the installation of each component.
User
Notes
You can install all
SmartCloud Analytics Predictive Insights
components as a non-root
user, through one instance
of the IBM Installation
Manager, if either of the
following are true:
v That non-root user
account was used to
install all prerequisites.
Otherwise, only the root
user can be used to pursue
the installation of all
components through one
instance of the IBM
Installation Manager.
33
User
Notes
Note: SmartCloud Analytics - Predictive Insights requires that you use a BASH
shell for the scadmin user.
Procedure
1. 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
./install.sh
4. On the Licenses page, read the license agreements for IBM Installation
Manager. If you agree to the terms of all the license agreements, click I accept
the terms in the license agreements and then click Next.
5. On the location page, in the Installation Manager Directory field, type the path
for the directory where you want to install Installation Manager or accept the
default path and then click Next.
6. On the Summary page, review your choices before starting the installation
process. If you want to change your selections, click Back to return to the
previous pages. When you are satisfied with your selections, click Install. The
IBM Installation Manager is installed.
7. Click Finish.
Results
The IBM Installation Manager is restarted and the IBM Installation Manager home
screen is displayed.
What to do next
If upon restart of your IBM Installation Manager, you are not presented with the
set of SmartCloud Analytics - Predictive Insights packages for installation, do the
following:
1. Click Exit, to close the IBM Installation Manager.
2. Restart the IBM Installation Manager by running the command:
./install.sh
35
Procedure
1. 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 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 the
path for the shared directory. The suggested default directory is
/opt/IBM/scanalytics/install_<user>/shared.
The IBM Installation Manager provides the ability to share components
across products. SmartCloud Analytics - Predictive Insights does not share
components with any other product. It is a requirement of the IBM
Installation Manager that a shared directory be provided when you install
it. The shared directory must be unique for each user who installs the IBM
Installation 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_<user>/installer and then click Next.
If you choose to change Installation Directory from default directory
please take into account that the Installation Directory must be unique for
each 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 IBM
Installation Manager displays each distinct set of required information under a
heading. All headings can be selected within the pane on the left side.
3. Click Database creation configuration in the left pane and enter the required
information.
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 DB2
location. 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
8.
9.
10.
11.
What to do next
The SmartCloud Analytics - Predictive Insights installation is now complete, so
what do you do next?
37
c. Click Users & Groups > Manage Groups, select the users to which you
want to give SmartCloud Analytics - Predictive Insights access, and assign
the group predictiveInsightsUsers to the selected user.
2. Start SmartCloud Analytics - Predictive Insights consuming data and
discovering 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 <starttime> -n
j. Wait for the training period to complete at which point SmartCloud
Analytics - Predictive Insights produces alarms.
38
User accounts
The installation topology of SmartCloud Analytics - Predictive Insights can involve
a number of different user accounts. It is important to login as the correct user
when you pursue the installation of each component.
39
User
Notes
You can install all
SmartCloud Analytics Predictive Insights
components as a non-root
user, through one instance
of the IBM Installation
Manager, if either of the
following are true:
v That non-root user
account was used to
install all prerequisites.
Otherwise, only the root
user can be used to pursue
the installation of all
components through one
instance of the IBM
Installation Manager.
Note: SmartCloud Analytics - Predictive Insights requires that you use a BASH
shell for the scadmin user.
40
Analytics - Predictive Insights on that server has read, write and execute
permissions on this directory.
Procedure
1. 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
What to do next
If upon restart of your IBM Installation Manager, you are not presented with the
set of SmartCloud Analytics - Predictive Insights packages for installation, run
./install.sh -c once more.
41
Make sure that you have copied the installation package to the server on which
you are installing the component.
Procedure
1. 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 the
server 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
42
14.
15.
16.
17.
Should Validation fail choose 'r' to re-enter values, or else type 'n' to continue
Type 'i' to install.
Type 'f' to finish.
Type 'x' to exit.
Procedure
1. As the scadmin or root user, open a terminal session on the server on which
you want to install the Analytics component.
2. Navigate to the directory that contains the extracted SmartCloud Analytics Predictive Insights installation package.
3. Run the command:
./install.sh -c
4.
5.
6.
7.
8.
9.
43
10. To change Shared Resources location type 'm', or else type 'n' to accept the
default location, and press Enter. The suggested default directory is
/opt/IBM/scanalytics/install_<user>/shared. The IBM Installation Manager
provides the ability to share components across products. SmartCloud
Analytics - Predictive Insights does not share components with any other
product. It is a requirement of the IBM Installation Manager that a shared
directory be provided when you install it. The shared directory must be
unique for each user who installs the IBM Installation Manager on the same
server.
11. To change Packages location type 'm', or else type 'n' to accept the default
location, and press Enter. We suggest using default directory of
/opt/IBM/scanalytics/install_<user>/installer and then click Next. If you
choose to change Installation Directory from default directory please take into
account that the Installation Directory must be unique for each 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.
12. Select Analytics and type 'n'. Make sure you have deselected any components
that you do not wish to install as the current user. The IBM Installation
Manager displays each distinct set of required information under a heading.
All headings can be selected within the pane on the left side.
13. Enter the connection details for your database as requested.
14. Should Validation fail choose 'r' to re-enter values, or else type 'n' to continue
15. Type 'i' to install.
16. Type 'f' to finish.
17. Type 'x' to exit.
44
Procedure
1. As the user that installed Tivoli Integrated Portal, open a terminal session on
the server on which you want to install the UI component.
2. Navigate to the directory that contains the extracted SmartCloud Analytics Predictive Insights installation package.
3. Run the command:
./install.sh -c
4.
5.
6.
7.
8.
9.
10.
11.
12. Select UI and type 'n'. Make sure you have deselected any components that
you do not wish to install as the current user. The IBM Installation Manager
displays each distinct set of required information under a heading. All
headings can be selected within the pane on the left side.
13. Enter the connection details for your database as requested.
14. Should Validation fail choose 'r' to re-enter values, or else type 'n' to continue
15. Type 'i' to install.
16. Type 'f' to finish.
17. Type 'x' to exit.
45
Procedure
1. As the InfoSphere Streams administrator or root user, open a terminal session
on the server on which you want to install the Mediation tool.
2. Navigate to the directory that contains the extracted SmartCloud Analytics Predictive Insights installation package.
3. Run the command:
./install.sh -c
46
directory be provided when you install it. The shared directory must be
unique for each user who installs the IBM Installation Manager on the same
server.
11. To change Packages location type 'm', or else type 'n' to accept the default
location, and press Enter. We suggest using default directory of
/opt/IBM/scanalytics/install_<user>/installer and then click Next. If you
choose to change Installation Directory from default directory please take into
account that the Installation Directory must be unique for each 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.
12. Select Mediation tool and type 'n'. Make sure you have deselected any
components that you do not wish to install as the current user. The IBM
Installation Manager displays each distinct set of required information under a
heading. All headings can be selected within the pane on the left side.
13. Type 'i' to install.
14. Type 'f' to finish.
15. Type 'x' to exit.
47
What to do next
The SmartCloud Analytics - Predictive Insights installation is now complete, so
what do you do next?
Procedure
1. As the user previously used to install components on the server, open a
terminal session.
2. Navigate to the directory that contains the extracted SmartCloud Analytics Predictive Insights installation package.
48
4.
5.
6.
7.
8.
9.
10.
49
50
Procedure
Instructions on how to install the Mediation tool on Windows.
1. Log on to the Windows environment to which you want to install the
Mediation tool.
2. Extract the SmartCloud Analytics - Predictive Insights package from the media.
3. Open the windowsMediationTool folder within the extracted package. This
folder contains the file PredictiveInsights-MediationTooling-1.2.0-win32.zip.
4. Extract the ZIP file to your desired installation location.
5. Open the folder to which you extracted the ZIP file, and in turn open the
contained eclipse folder.
6. Double click on the eclipse.exe icon. When you open the tool, you will be
asked to choose a workspace. Choose a directory unique to the Mediation tool.
51
52
Procedure
Uninstalling the UI component. You must uninstall the UI component as the user
that was used to install Tivoli Integrated Portal.
1. Log into the server on which you have installed the UI component as the user
that you used to install Tivoli Integrated Portal.
2. Run ./install.sh
3. Select Uninstall
4. Click the check box for SmartCloud Analytics - Predictive Insights.
5. Click Next.
The next panel displays all the components installed as the current user.
6. To uninstall UI you must first connect to the SCAPI database. Enter DB
password and click Validate. If validation fails you can select check box to
ignore validation and continue
7. Click Next.
8. Enter Tivoli Integrated Portal user password and click Validate. If validation
fails you can select check box to ignore validation and continue
9. Click Next.
10. Click Uninstall.
UNinstall the Mediation tool, the Analytics component, and the Database
Copyright IBM Corp. 2011, 2013
53
component as the scadmin user. If you have distributed the installation of these
components, that is, installed each component on separate servers, log on to each
of these servers and run the following steps.
Note: Remember the order of uninstallation of these components is important. The
order must be
a. Mediation tool
b. Analytics
c. Database
11. Log onto the relevant server as the scadmin user.
12. Run ./install.sh
13. Select Uninstall
14. Click Next.
15. Click the check box for SmartCloud Analytics - Predictive Insights.
16. Click Next.
The next panel displays all the components installed as the current user.
17. For each component that you are uninstalling:
a. Enter the requested passwords.
b. Click Validate.
c. Click Next when all conditions have been satisfied.
18. When all component selections have been validated, click Uninstall.
54
55
56
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain
transactions, therefore, this statement might not apply to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
57
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Such information may be available, subject to appropriate terms and conditions,
including in some cases payment of a fee.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which
illustrate programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application
programs conforming to IBMs application programming interfaces.
58
If you are viewing this information in softcopy form, the photographs and color
illustrations might not be displayed.
Notices
59
60
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the Web at Copyright and
trademark information at http://www.ibm.com/legal/copytrade.shtml.
Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
other countries, or both.
Cell Broadband Engine and Cell/B.E. are trademarks of Sony Computer
Entertainment, Inc., in the United States, other countries, or both and is used under
license therefrom.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,
Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or
registered trademarks of Intel Corporation or its subsidiaries in the United States
and other countries.
IT Infrastructure Library is a registered trademark of the Central Computer and
Telecommunications Agency which is now part of the Office of Government
Commerce.
ITIL is a registered trademark, and a registered community trademark of the Office
of Government Commerce, and is registered in the U.S. Patent and Trademark
Office.
Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Sun Microsystems, Inc. in the United States, other countries,
or both.
61
62
Printed in USA