Content uploaded by Alan Bluck
Author content
All content in this area was uploaded by Alan Bluck on Oct 04, 2019
Content may be subject to copyright.
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Page of
© ASB Software Development
Limited
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Contents
IBM Installations - ASB Software Development Limited Publications.................................3
Watson Foundational Component Installation................................................................... 4
Install Annotation Administration Console..................................................................... 5
Install Application Builder............................................................................................ 17
Conguration of Application Builder............................................................................ 18
Default login credentials........................................................................................... 19
Starting Services.......................................................................................................... 20
Install the Zoo Keeper service..................................................................................... 20
Install the ResultsModule service................................................................................. 21
Check the status of the ResultsModule service........................................................21
Install the AppBuilder Service...................................................................................... 22
Start the services in this order.................................................................................22
Stopping Services........................................................................................................ 23
Open the ports on the rewall service.........................................................................23
Add oneWEX Datasource............................................................................................. 24
Install Watson Explorer Engine....................................................................................24
Install Results Module.................................................................................................. 25
Install ZooKeeper......................................................................................................... 25
Installing the SIRE RPM le for Watson Explorer..........................................................28
Procedure...................................................................................................................... 28
Annotation Administration Console.................................................................................30
Watson Explorer Engine administration tool Installation.................................................34
Encryption Key Generation.......................................................................................34
Checks on the System.............................................................................................. 34
Congure the Watson Explorer Engine embedded webserver (non-production use
only)......................................................................................................................... 36
Default login credentials........................................................................................... 38
To unpack the repositories........................................................................................39
Display Creation Tutorial................................................................................................. 40
Appendix A – server.xml of the Application Builder web app..........................................46
Appendix B – Integration of the Watson Explorer services into the startup of Linux.......48
Appendix C – Deprecated Features of Watson Explorer 12.0.x.......................................49
Page of
ABS
TRA
CT
This
doc
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
IBM Installations - ASB Software Development Limited
Publications
https://doi.org/10.13140/RG.2.2.12248.44803
Watson Explorer 12.0.3 oneWEX Installation on IBM Cloud CENTOS 8.0 Linux with Docker
Containers
! "#
$$!%
https://doi.org/10.13140/RG.2.2.20256.94729
IBM Cloud Private P8 Container CPIT Installation on CENTOS Linux 8.0
(NB Above describes the installation of the base CENTOS 8.0 Linux system for this document)
https://doi.org/10.13140/RG.2.2.36842.88007
Installation of Eclipse Codewind and Docker Compose on RHEL 8 Linux with IBM Cloud
Private CE (Community Edition)
https://doi.org/10.13140/RG.2.2.20160.69129
IBM FileNet P8 Java Development on ECM Cloud Private Container P8 Examples
https://doi.org/10.13140/RG.2.2.27358.18246
IBM Cloud Private P8 Container CPIT Installation on RedHat Enterprise Linux 8.0
https://doi.org/10.13140/RG.2.2.22030.92486
Problem Resolution Procedures For fixing Software Installation Issues
https://doi.org/10.13140/RG.2.2.27345.89440
IBM BAW 18.0 Installation phase1 preprint with install of IBM Workflow Center 8.6.1.19002
https://doi.org/10.13140/RG.2.2.10491.67369
DB2 10.5 Installation on CENTOS 8.0 V1
https://doi.org/10.13140/RG.2.2.33527.57761
IBM Security Directory Services 6.4- Installation on RHEL 8.0
https://doi.org/10.13140/RG.2.2.15007.10408
WebSphere 8.5.5.15 Installation 29-06-2019 on VMWare Workstation Pro 15.1
https://doi.org/10.13140/RG.2.2.15737.83048
IBM BAW 18.0 Installation 18 07 2019 - Install of IBM Security Directory Suite 8.0.1.1 on CENTOS 8
using VMWare Workstation Pro 15.1
https://doi.org/10.13140/RG.2.2.21708.16001
Case Manager 5.3.3 Installation on RHEL 8.0 with Content Navigator 3.0.6
https://doi.org/10.13140/RG.2.2.31489.10082
Installation of Oracle 12C on the Linux operating system
https://doi.org/10.13140/RG.2.2.14590.95049
Content Navigator 3.0.6 Installation on RHEL 8.0_V1.docx
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
https://doi.org/10.13140/RG.2.2.21170.76480
Content Foundation 5.5.3 Installation on RHEL 8.0_V2.docx
https://doi.org/10.13140/RG.2.2.30401.51048
Case Manager Installation on RHEL 8.0_Preparation.docx
This document provides step by step Installation steps to install
IBM FileNet Content Engine 5.5.2
Watson Foundational Component Installation
'(
http://www.redbooks.ibm.com/abstracts/sg247877.html
REF:
https://www.ibm.com/support/knowledgecenter/en/SS8NLW_12.0.0/com.ibm.swg.im.infosphere.d
ataexpl.install.doc/c_module_oview.html
“The Watson Explorer foundational components are comprised of the following installable modules:
Application Builder
Simplifies developing 360-degree information applications that deliver targeted, relevant data to users
based on their roles or interests within the enterprise or a specific organization.
Watson Explorer Engine
Provides a web-based development and deployment environment for enterprise information navigation
applications.
Annotation Administration Console
Provides a web-based administration tool for configuring custom and domain specific text analytics
that can enhance Watson Explorer 360-degree view and content mining applications.
IBM Knowledge Center
Provides online help for IBM Watson Explorer Foundational Components and IBM Watson
Explorer Analytical Components.
Results Module
Enables local administrators of enterprise information navigation applications to easily extend those
applications with business-specific highlighting of selected query results and by incorporating domain-
specific knowledge such as taxonomies.
ZooKeeper
Provides a distributed coordination service and associated data repository for storing configuration
information about distributed applications.”
The available Watson Explorer foundational component modules are:
Module Module file extension
Watson Explorer Engine wex-engine-12.0.0.x.rpm
Zookeeper wex-zookeeper-12.0.0.x.rpm
Application Builder wex-appbuilder-12.0.0.x.rpm
Results Module wex-resultsmodule-12.0.0.x.rpm
BigIndex wex-bigindex-12.0.0.x.rpm
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Install Annotation Administration Console
)*)
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Page + of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
! ,--,&&,&))&,+
Additionally if required, the packages from the Fedora project can also be accessed:
https://fedoraproject.org/wiki/EPEL
$!, ,$!,$
Page . of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
yum-cong-manager --enable epel
yum clean all && sudo yum update -y
yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
REF: http://mirror.centos.org/centos/7/os/x86_64/Packages/
#/0!#$1
Page 2 of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
3## ! "#1
4#$ !/1
[root@ecmukdemo20 Downloads]# chmod 775 *.rpm
[root@ecmukdemo20 Downloads]# ls
compat-libstdc++-33-3.2.3-72.el7.i686.rpm Container-PIT.zip ufone_tweets.csv
compat-libstdc++-33-3.2.3-72.el7.x86_64.rpm enron_mail_20150507.tar.gz
Install the 32 bit compat-libstdc++-33 library
[root@ecmukdemo20 Downloads]# yum install compat-libstdc++-33-3.2.3-72.el7.i686.rpm
CentOS-8 - AppStream 1.7 kB/s | 4.3 kB 00:02
CentOS-8 - Base 1.7 kB/s | 3.8 kB 00:02
CentOS-8 - Extras 645 B/s | 1.5 kB 00:02
CentOS-8 - Plus 1.4 kB/s | 3.0 kB 00:02
Docker CE Stable - x86_64 3.1 kB/s | 3.5 kB 00:01
Docker CE Stable - Sources 2.8 kB/s | 3.5 kB 00:01
Extra Packages for Enterprise Linux 8 - x86_64 23 kB/s | 29 kB 00:01
Dependencies resolved.
=====================================================================================================
Package Arch Version Repository Size
=====================================================================================================
Installing:
compat-libstdc++-33 i686 3.2.3-72.el7 @commandline 196 k
Transaction Summary
=====================================================================================================
Install 1 Package
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Total size: 196 k
Installed size: 722 k
Is this ok [y/N]: y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing : 1/1
Installing : compat-libstdc++-33-3.2.3-72.el7.i686 1/1
Running scriptlet: compat-libstdc++-33-3.2.3-72.el7.i686 1/1
Verifying : compat-libstdc++-33-3.2.3-72.el7.i686 1/1
Installed:
compat-libstdc++-33-3.2.3-72.el7.i686
Complete!
[root@ecmukdemo20 Downloads]# ls
compat-libstdc++-33-3.2.3-72.el7.i686.rpm Container-PIT.zip ufone_tweets.csv
compat-libstdc++-33-3.2.3-72.el7.x86_64.rpm enron_mail_20150507.tar.gz
Install the 64 bit compat-libstdc++-33 library
[root@ecmukdemo20 Downloads]# yum install compat-libstdc++-33-3.2.3-72.el7.x86_64.rpm
Last metadata expiration check: 0:00:38 ago on Wed 02 Oct 2019 09:27:27 AM EDT.
Dependencies resolved.
=====================================================================================================
Package Arch Version Repository Size
=====================================================================================================
Installing:
compat-libstdc++-33 x86_64 3.2.3-72.el7 @commandline 191 k
Transaction Summary
=====================================================================================================
Install 1 Package
Total size: 191 k
Installed size: 811 k
Is this ok [y/N]: y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing : 1/1
Installing : compat-libstdc++-33-3.2.3-72.el7.x86_64 1/1
Running scriptlet: compat-libstdc++-33-3.2.3-72.el7.x86_64 1/1
Verifying : compat-libstdc++-33-3.2.3-72.el7.x86_64 1/1
Installed:
compat-libstdc++-33-3.2.3-72.el7.x86_64
Complete!
56!$"!378
* **0,,,*
)*)
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
9$#$,:! !
$$ !/$
;$%)
<!1!$"!)))$"
=!1!
>1/
4"9
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
?1* *?@*
31*!*!*
4!!!!$44A% 1+
3# 1.
B 12&
4#
?1* *?@*
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
9! 1&
09>? 12&&
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
56!$"!78)*!
C4&&?=#1!4@@935>9'9@(('B7)))
>!!$1
!0$!!!$
@!
!/#$!
0$ /!!$
!$
(0! 1!
* *?@**
)*!!
(0! 1 $#!
! ,
(0! &1!
!/#!#,,
#))!)!, D44AE>','F*E*,
=G!4@@93 G!$#!!!
56!$"!78)*)
(14H9I9H'(0$))!#)
[root@ecmukdemo20 bin]# yum install java
Last metadata expiration check: 3:00:45 ago on Wed 02 Oct 2019 11:13:00 AM EDT.
Dependencies resolved.
==================================================================================
Package Arch Version
Repository Size
==================================================================================
Page + of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Installing:
java-1.8.0-openjdk x86_64 1:1.8.0.222.b10-0.el8_0
AppStream 297 k
Installing dependencies:
copy-jdk-configs noarch 3.7-1.el8
AppStream 27 k
java-1.8.0-openjdk-headless x86_64 1:1.8.0.222.b10-0.el8_0
AppStream 32 M
javapackages-filesystem noarch 5.3.0-1.module_el8.0.0+11+5b8c10bd
AppStream 30 k
tzdata-java noarch 2019a-1.el8
AppStream 188 k
lksctp-tools x86_64 1.0.18-3.el8
BaseOS 100 k
Enabling module streams:
javapackages-runtime 201801
Transaction Summary
==================================================================================
Install 6 Packages
Total download size: 33 M
Installed size: 113 M
Is this ok [y/N]: y
Downloading Packages:
(1/6): copy-jdk-configs-3.7-1.el8.noarch.rpm 200 kB/s | 27 kB
00:00
(2/6): javapackages-filesystem-5.3.0-1.module_el8.0.0+11+5b8c10bd.noarch 455 kB/s | 30 kB
00:00
(3/6): java-1.8.0-openjdk-1.8.0.222.b10-0.el8_0.x86_64.rpm 1.3 MB/s | 297 kB
00:00
(4/6): tzdata-java-2019a-1.el8.noarch.rpm 1.0 MB/s | 188 kB
00:00
(5/6): lksctp-tools-1.0.18-3.el8.x86_64.rpm 146 kB/s | 100 kB
00:00
(6/6): java-1.8.0-openjdk-headless-1.8.0.222.b10-0.el8_0.x86_64.rpm 6.4 MB/s | 32 MB
00:05
----------------------------------------------------------------------------------
Total 4.3 MB/s | 33 MB
00:07
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Running scriptlet: copy-jdk-configs-3.7-1.el8.noarch
1/1
Running scriptlet: java-1.8.0-openjdk-headless-1:1.8.0.222.b10-0.el8_0.x86_64
1/1
Preparing :
1/1
Installing : lksctp-tools-1.0.18-3.el8.x86_64
1/6
Running scriptlet: lksctp-tools-1.0.18-3.el8.x86_64
1/6
Installing : tzdata-java-2019a-1.el8.noarch
2/6
Installing : javapackages-filesystem-5.3.0-1.module_el8.0.0+11+5b8c10bd.noarch
3/6
Installing : copy-jdk-configs-3.7-1.el8.noarch
4/6
Installing : java-1.8.0-openjdk-headless-1:1.8.0.222.b10-0.el8_0.x86_64
5/6
Running scriptlet: java-1.8.0-openjdk-headless-1:1.8.0.222.b10-0.el8_0.x86_64
5/6
Installing : java-1.8.0-openjdk-1:1.8.0.222.b10-0.el8_0.x86_64
6/6
Page . of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Running scriptlet: java-1.8.0-openjdk-1:1.8.0.222.b10-0.el8_0.x86_64
6/6
Running scriptlet: copy-jdk-configs-3.7-1.el8.noarch
6/6
Running scriptlet: java-1.8.0-openjdk-1:1.8.0.222.b10-0.el8_0.x86_64
6/6
Verifying : copy-jdk-configs-3.7-1.el8.noarch
1/6
Verifying : java-1.8.0-openjdk-1:1.8.0.222.b10-0.el8_0.x86_64
2/6
Verifying : java-1.8.0-openjdk-headless-1:1.8.0.222.b10-0.el8_0.x86_64
3/6
Verifying : javapackages-filesystem-5.3.0-1.module_el8.0.0+11+5b8c10bd.noarch
4/6
Verifying : tzdata-java-2019a-1.el8.noarch
5/6
Verifying : lksctp-tools-1.0.18-3.el8.x86_64
6/6
Installed:
java-1.8.0-openjdk-1:1.8.0.222.b10-0.el8_0.x86_64
copy-jdk-configs-3.7-1.el8.noarch
java-1.8.0-openjdk-headless-1:1.8.0.222.b10-0.el8_0.x86_64
javapackages-filesystem-5.3.0-1.module_el8.0.0+11+5b8c10bd.noarch
tzdata-java-2019a-1.el8.noarch
lksctp-tools-1.0.18-3.el8.x86_64
Complete!
[root@ecmukdemo20 bin]#
Install Application Builder
[root@ecmukdemo20 watson]# yum install wex-appbuilder-12.0.3.0-
dae_en.el6.rpm
Last metadata expiration check: 0:53:51 ago on Wed 02 Oct 2019 09:27:27 AM
EDT.
Dependencies resolved.
===================================================================
Package Arch Version
Repository Size
===================================================================
Installing:
wex-appbuilder x86_64 12.0.3.0-2487
@commandline 363 M
Transaction Summary
===================================================================
Install 1 Package
Total size: 363 M
Installed size: 517 M
Is this ok [y/N]: y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing :
1/1
Page 2 of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Running scriptlet: wex-appbuilder-12.0.3.0-2487.x86_64
1/1
Installing : wex-appbuilder-12.0.3.0-2487.x86_64
1/1
Running scriptlet: wex-appbuilder-12.0.3.0-2487.x86_64
1/1
Verifying : wex-appbuilder-12.0.3.0-2487.x86_64
1/1
Installed:
wex-appbuilder-12.0.3.0-2487.x86_64
4! J
[root@ecmukdemo20 watson]# yum install wex-bigindex-12.0.3.0-dae_en.el6.rpm
Last metadata expiration check: 1:07:45 ago on Wed 02 Oct 2019 09:27:27 AM EDT.
Dependencies resolved.
==========================================================================
Package Arch Version Repository
Size
==========================================================================
Installing:
wex-bigindex x86_64 12.0.3.0-2487
@commandline 38 M
Transaction Summary
==========================================================================
Install 1 Package
Total size: 38 M
Installed size: 43 M
Is this ok [y/N]: y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing :
1/1
Running scriptlet: wex-bigindex-12.0.3.0-2487.x86_64
1/1
Installing : wex-bigindex-12.0.3.0-2487.x86_64
1/1
Running scriptlet: wex-bigindex-12.0.3.0-2487.x86_64
1/1
Verifying : wex-bigindex-12.0.3.0-2487.x86_64
1/1
Installed:
wex-bigindex-12.0.3.0-2487.x86_64
Complete!
[root@ecmukdemo20 watson]#
Conguration of Application Builder
REF
https://www.ibm.com/support/knowledgecenter/en/SS8NLW_12.0.0/com.ibm.swg.im.info
sphere.dataexpl.install.doc/r_ab-cong-ab.html
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Default login credentials
User name: data-explorer-admin
Password TH1nk1710
REF:
https://www.ibm.com/support/knowledgecenter/en/SS8NLW_12.0.0/com.ibm.swg.im.info
sphere.dataexpl.appbuilder.doc/t_de-ab-devapp-entities-user.html
Stop services
Make a backup of the )0! le from the
9 $* *$**9 $ directory, and then open the le in a text
editor.
The following example shows the default Application Builder administrator user, data-
explorer-admin, and sample user names and passwords:
<basicRegistry id="basic" realm="customRealm">
<user name="data-explorer-admin" password="TH1nk1710" />
<user name="user-1" password="password-1" />
<user name="user-2" password="password-2" />
</basicRegistry>
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Starting Services
REF:
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.watson.wex.fc.
install.doc/c_wex_native_services.html#c_wex_native_services.dita
Important: When starting the Services always:
Start ZooKeeper first (Application Builder relies on ZooKeeper for configuration data).
Start all other services except Application Builder.
Start Application Builder last.
Install the Zoo Keeper service
REF:
https://www.ibm.com/support/knowledgecenter/en/SS8NLW_12.0.0/com.ibm.watson.wex
.fc.install.doc/c_wex_native_cong_zk.html
* *!*K(L*MN
[root@ecmukdemo20 ZooKeeper]# )*:" ,/#
Which language do you want to use for the conguration tool? The current language is
['en']. Other available languages are: ['en']:
Which port do you want ZooKeeper to listen on for clients? The port is currently [2]:
Specify the directory to store ZooKeeper's data in. The current directory is
5* *!*K(L*MN 3]:
Specify the ZooKeeper ID. It is currently []:
Specify the servers and ports ZooKeeper's cluster will use. The current list is
[server.1O1+...1+222]:
Provide any additional zookeeper conguration as a semicolon-separated list. The
conguration is currently:
5"!OP$ $#) '4$O&P$ $#) $#?OP
A!OPA!O]
Do you want to install ZooKeeper's service? [y/N]:
[root@ecmukdemo20 ZooKeeper]#
/opt/ibm/WEX/ZooKeeper
1The Zookeeper service will automatically start Zookeeper whenever you restart a system
on which it is installed.
Installing the service is recommended.
[root@ecmukdemo20 ZooKeeper]#
systemctl start zookeeper.service
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Install the ResultsModule service
!$ K(0 ))0
'(
https://www.ibm.com/support/pages/release-notes-ibm-watson-explorer-foundational-
components-version-120#new12031
See Appendix C for details of the deprecated 12.0.x features
[root@ecmukdemo20 WEX]# * *!*K(L*'$@$
[root@ecmukdemo20 ResultsModule]#
daemon intl java license README.txt resultsmodule-cong resultsmodule.properties
swidtag wlp
[root@ecmukdemo20 ResultsModule]# )*$!$,/#
Which language do you want to use for the conguration tool? The current language is
['en']. Other available languages are: [GG]:
Which port do you want Results Module to listen on? The port is currently [22]:
What virtual directory should Results Module use? It is currently [ResultsModule]:
Do you want to install the service for Results Module? [y/N]:
[root@ecmukdemo20 ResultsModule]#
* *!*K(L*'$@$
[root@ecmukdemo20 ResultsModule]#
systemctl start resultsmodule.service
Check the status of the ResultsModule service
cd /opt/ibm/WEX/ResultsModule/wlp/bin/
./server status ResultsModule
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Install the AppBuilder Service
* *!*K(L*9 $
56!$"!9 $78)* $,/#
K#$#$$/#$Q$
#$#5GG7)#$#15GG71
K$$9 $$Q!$
59 $71
K $9 $Q $
52271
KMN $$9
$Q$$51271
K! $$9 $Q
$$! 5 $71
3$9 $Q5*71
systemctl start appbuilder.service
cd /opt/ibm/WEX/AppBuilder/daemon
./appbuilder.sysvinit
Start the services in this order
systemctl start zookeeper.service
systemctl start resultsmodule.service
systemctl start appbuilder.service
systemctl enable zookeeper.service
systemctl enable resultsmodule.service
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
systemctl enable appbuilder.service
Stopping Services
R$!$ )
systemctl stop appbuilder.service
systemctl stop resultsmodule.service
systemctl stop zookeeper.service
Open the ports on the rewall service
systemctl start rewalld
systemctl enable rewalld
rewall-cmd --zone=public --permanent --add-port 2181/tcp
rewall-cmd --zone=public --permanent --add-port 43981/tcp
rewall-cmd --zone=public --permanent --add-port 8080/tcp
rewall-cmd --zone=public --permanent --add-port 8081/tcp
rewall-cmd --zone=public --permanent --add-port 16777/tcp
rewall-cmd --zone=public --permanent --add-port 16888/tcp
rewall-cmd --reload
You can adjust the configuration of the application server by editing the server.xml file in
the AppBuilder/wlp/usr/servers/AppBuilder directory of your installation
Ie
vi /opt/ibm/WEX/AppBuilder/wlp/usr/servers/AppBuilder/server.xml
REF: server.xml
See Appendix A – server.xml of the Application Builder web app for the full server.xml OOTB
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.swg.im.infosph
ere.dataexpl.appbuilder.doc/c_de-ab-system-wlp.html
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Add oneWEX Datasource
For a oneWEX data source, enter the fully qualified URL of the oneWEX instance. The URL takes
the following form: http://hostname:port/
https://localhost/admin/main/#/admin/datasets
The process to use oneWEX as a data source for Application Builder is the same as for
a Watson Explorer Engine backend:
1. Index the data. For oneWEX, that means that you upload data to
the oneWEX instance.
2. Add the data source in Application Builder. In this case, the data source is oneWEX.
3. Create entity types. For oneWEX, you connect the entity types to an instance and
collection.
4. Use the entity type as you develop your entity model and application.
REF
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.swg.im.infosph
ere.dataexpl.appbuilder.doc/c_onewex_ab_ds.html
Install Watson Explorer Engine
[root@ecmukdemo20 watson]# yum install wex-engine-12.0.3.0-dae_en.el6.rpm
Last metadata expiration check: 1:09:59 ago on Wed 02 Oct 2019 09:27:27 AM EDT.
Dependencies resolved.
==========================================================================
Package Arch Version Repository
Size
==========================================================================
Installing:
wex-engine x86_64 12.0.3.0-2487
@commandline 1.2 G
Transaction Summary
==========================================================================
Install 1 Package
Total size: 1.2 G
Installed size: 1.9 G
Is this ok [y/N]: y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Running transaction
Preparing :
1/1
Running scriptlet: wex-engine-12.0.3.0-2487.x86_64
1/1
Installing : wex-engine-12.0.3.0-2487.x86_64
1/1
Running scriptlet: wex-engine-12.0.3.0-2487.x86_64
1/1
Verifying : wex-engine-12.0.3.0-2487.x86_64
1/1
Installed:
wex-engine-12.0.3.0-2487.x86_64
Complete!
[root@ecmukdemo20 watson]#
Install Results Module
56!$"!78$!0,$!$,))&),
E)+) !
A!0 "111#K1.1.9@
(3)
3 )
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOO
>"#9I'
B:
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOO
?#1
0,$!$02+E+))&),2.
6!!&+@
B$!!
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOO
?>"#
:1&+@
?:1@
?"5*71
3#>"#1
'$#"
"$)
'$#
$)
'$#
> #1*
'$# 10,$!$,))&),2.)02+E+
*
?#10,$!$,))&),2.)02+E+
*
'$# 10,$!$,))&),2.)02+E+
*
I#10,$!$,))&),2.)02+E+
*
Page + of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
?1
0,$!$,))&),2.)02+E+
4! J
Install ZooKeeper
56!$"!78
[root@ecmukdemo20 watson]# yum install wex-zookeeper-12.0.3.0-
dae_en.el6.rpm
Last metadata expiration check: 1:20:55 ago on Wed 02 Oct 2019 09:27:27 AM
EDT.
Dependencies resolved.
===================================================================
Package Arch Version
Repository Size
===================================================================
Installing:
wex-zookeeper x86_64 12.0.3.0-2487
@commandline 150 M
Transaction Summary
===================================================================
Install 1 Package
Total size: 150 M
Installed size: 250 M
Is this ok [y/N]: y
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing :
1/1
Running scriptlet: wex-zookeeper-12.0.3.0-2487.x86_64
1/1
Installing : wex-zookeeper-12.0.3.0-2487.x86_64
1/1
Running scriptlet: wex-zookeeper-12.0.3.0-2487.x86_64
1/1
Verifying : wex-zookeeper-12.0.3.0-2487.x86_64
1/1
Installed:
wex-zookeeper-12.0.3.0-2487.x86_64
Complete!
[root@ecmukdemo20 watson]#
REF:
Page . of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.watson.wex.wk
s.integration.doc/anno-machine-export-upload.html
In the field for the path to the file, enter the path, including the name of the file, and click OK. For
example, /home/esadmin/sample.zip.
REF:
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.watson.wex.wk
s.integration.doc/anno-machine-sire.html
Page 2 of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
REF
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.discovery.es.t
m.doc/iiyscviewlet.html
Installing the SIRE RPM le for Watson Explorer
Procedure
1. Install the required libraries, by running the following command:
yum -y install apr apr-util boost-filesystem boost-iostreams boost-program-
options boost-regex boost-serialization
[root@ecmukdemo20 watson]# yum -y install apr apr-util boost-filesystem boost-
iostreams boost-program-options boost-regex boost-serialization
Last metadata expiration check: 2:08:22 ago on Wed 02 Oct 2019 11:13:00 AM EDT.
Package boost-iostreams-1.66.0-6.el8.x86_64 is already installed.
Package boost-program-options-1.66.0-6.el8.x86_64 is already installed.
Package boost-regex-1.66.0-6.el8.x86_64 is already installed.
Dependencies resolved.
==========================================================================
Package Arch Version
Repository Size
==========================================================================
Installing:
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
apr x86_64 1.6.3-9.el8
AppStream 125 k
apr-util x86_64 1.6.1-6.el8
AppStream 105 k
boost-filesystem x86_64 1.66.0-6.el8
AppStream 49 k
boost-serialization x86_64 1.66.0-6.el8
AppStream 128 k
Installing weak dependencies:
apr-util-bdb x86_64 1.6.1-6.el8
AppStream 25 k
apr-util-openssl x86_64 1.6.1-6.el8
AppStream 27 k
Transaction Summary
==========================================================================
Install 6 Packages
Total download size: 458 k
Installed size: 1.4 M
Downloading Packages:
(1/6): apr-util-bdb-1.6.1-6.el8.x86_64.rpm 21 kB/s
| 25 kB 00:01
(2/6): apr-util-openssl-1.6.1-6.el8.x86_64.rpm 405 kB/s
| 27 kB 00:00
(3/6): apr-1.6.3-9.el8.x86_64.rpm 100 kB/s
| 125 kB 00:01
(4/6): apr-util-1.6.1-6.el8.x86_64.rpm 84 kB/s
| 105 kB 00:01
(5/6): boost-filesystem-1.66.0-6.el8.x86_64.rpm 472 kB/s
| 49 kB 00:00
(6/6): boost-serialization-1.66.0-6.el8.x86_64.rpm 1.0 MB/s
| 128 kB 00:00
--------------------------------------------------------------------------
Total 185 kB/s
| 458 kB 00:02
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing :
1/1
Installing : apr-1.6.3-9.el8.x86_64
1/6
Running scriptlet: apr-1.6.3-9.el8.x86_64
1/6
Installing : apr-util-bdb-1.6.1-6.el8.x86_64
2/6
Installing : apr-util-openssl-1.6.1-6.el8.x86_64
3/6
Installing : apr-util-1.6.1-6.el8.x86_64
4/6
Running scriptlet: apr-util-1.6.1-6.el8.x86_64
4/6
Installing : boost-serialization-1.66.0-6.el8.x86_64
5/6
Running scriptlet: boost-serialization-1.66.0-6.el8.x86_64
5/6
Installing : boost-filesystem-1.66.0-6.el8.x86_64
6/6
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Running scriptlet: boost-filesystem-1.66.0-6.el8.x86_64
6/6
Verifying : apr-1.6.3-9.el8.x86_64
1/6
Verifying : apr-util-1.6.1-6.el8.x86_64
2/6
Verifying : apr-util-bdb-1.6.1-6.el8.x86_64
3/6
Verifying : apr-util-openssl-1.6.1-6.el8.x86_64
4/6
Verifying : boost-filesystem-1.66.0-6.el8.x86_64
5/6
Verifying : boost-serialization-1.66.0-6.el8.x86_64
6/6
Installed:
apr-1.6.3-9.el8.x86_64 apr-util-1.6.1-6.el8.x86_64
boost-filesystem-1.66.0-6.el8.x86_64 boost-serialization-1.66.0-
6.el8.x86_64
apr-util-bdb-1.6.1-6.el8.x86_64 apr-util-openssl-1.6.1-
6.el8.x86_64
Complete!
[root@ecmukdemo20 watson]#
2. Install the SIRE ES_INSTALL_ROOT/bin/sire/sire-20160429-
2.x86_64.rpm file by running the following command:
rpm -ivh sire-20160429-2.x86_64.rpm
3. Log in as the default content analytics administrator. The default user ID is esadmin.
4. To set the SIRE environment variables, enter the following commands to restart the
system:
5. esadmin system stopall
esadmin system startall
Annotation Administration Console
http://ecmukdemo20:8390/ESAdmin/loginForm.jsp
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Login esadmin/lenet
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Page && of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Watson Explorer Engine administration tool Installation
REF
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.watson.wex.fc.
install.doc/c_wex_native_cong_engine.html
Encryption Key Generation
A default encryption key is included when you install Watson Explorer Engine
To Change this follow:
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.watson.wex.fc.
install.doc/c_wex_native_cong_engine_enc.html
#!!?@%
Checks on the System
';$S#"
mkdir /opt/tests
/opt/ibm/WEX/Engine/bin/micro-test --all /opt/tests
Check Log results
[root@ecmukdemo20 bin]# mkdir /opt/tests
[root@ecmukdemo20 bin]# /opt/ibm/WEX/Engine/bin/micro-test --all /opt/tests
System micro-test tool.
Run with --help for information about individual tests.
Starting full run.
Starting mktemp test: 20000 reps, P=0.00, dir=/opt/tests/micro-test-temp.
20000 20000 0.06 ms/temp
Starting buffered write test: 42949672960 bytes in /opt/tests/micro-test-temp
40900 40960 110.76 MB/secc
Waiting for I/O to be flushed to disk.
40960 40960 103.44 MB/sec
Starting buffered read test : /opt/tests/micro-test-temp
40960 94.51 MB/sec
Starting seek test: /opt/tests/micro-test-temp, nthreads=16, block_size=8192,
n_blocks=976562, ms=30000
228.63 seeks/sec
Starting unbuffered write test: 1073741824 bytes in /opt/tests/micro-test-temp
1024 1024 509.71 MB/sec
Starting unbuffered read test: /opt/tests/micro-test-temp
1024 665.80 MB/sec
Starting sqlite-insert test: 5000 inserts
5000 527.26 inserts/sec
Starting sqlite-insert-transaction test: 5000 inserts
5000 90909.09 inserts/sec
Starting sqlite-insert-indexed test: 5000 inserts
5000 79365.08 inserts/sec
Starting sqlite-select test: 5000 selects
5000 1613.42 selects/sec
Starting sqlite-select-indexed test: 5000 selects
5000 3516.17 selects/sec
Starting sqlite-update test: 5000 updates
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
5000 2777.78 updates/sec
Starting sqlite-update-indexed test: 5000 updates
5000 31446.54 updates/sec
Starting sqlite-update-text-indexed test: 5000 updates
5000 61728.39 updates/sec
Starting sqlite-delete test: 5000 deletes
5000 570.78 deletes/sec
Starting sqlite-delete-transaction test: 5000 deletes
5000 5347.59 deletes/sec
Starting sqlite-delete-indexed test: 5000 deletes
5000 83333.34 deletes/sec
Starting the xsl test. 100 iterations
xslt result 15 ms
Starting virus scanner test: 5 reps 6 sleep /opt/tests/micro-test-temp
virus scanner not detected
Checking ability to create core dumps:
Overall, the check(s) passed with warnings.
The "system-wide core dump handler" check passed with warnings (reason: core
dumps will be captured by a non-kernel process: /usr/lib/systemd/systemd-coredump
%P %u %g %s %t %c %h %e
).
The "value of RLIMIT_CORE" check passed (reason: core dumps are enabled and
there is no restriction on core dump size).
Results:
Temporary file creation: 0.06 ms
Buffered Write speed: 103.44 MB/sec
Buffered Read speed: 94.51 MB/sec
Unbuffered Write speed: 509.71 MB/sec
Unbuffered Read speed: 665.80 MB/sec
Unbuffered Seek rate: 228.63 seeks/sec
Virus scanner detected: no
sqlite-insert time: 527.26 inserts/sec
sqlite-insert-transaction time: 90909.09 inserts/sec
sqlite-insert-indexed time: 79365.08 inserts/sec
sqlite-select time: 1613.42 selects/sec
sqlite-select-indexed time: 3516.17 selects/sec
sqlite-update time: 2777.78 updates/sec
sqlite-update-indexed time: 31446.54 updates/sec
sqlite-update-text-indexed time: 61728.39 updates/sec
sqlite-delete time: 570.78 deletes/sec
sqlite-delete-transaction time: 5347.59 deletes/sec
sqlite-delete-indexed time: 83333.34 deletes/sec
Runtime environment's ability to create core dumps: passed with warnings
Consult the documentation to properly understand and interpret your system's
ability or inability to create core dumps.
xsl time: 15.39 ms
[root@ecmukdemo20 bin]#
Page &+ of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Congure the Watson Explorer Engine embedded webserver (non-production use
only)
REF:
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.swg.im.infosph
ere.dataexpl.install.doc/c_velocity-web-server-conguration.html
Running embedded-webserver-cong
NB this command can also be rerun to change the parameters after
stopping the engine using ./engine-shutdown
NB the port 9080 is already used by the acce tool on the FileNet P8 container, so I am
using 2
, 2T# 2
cd /opt/ibm/WEX/Engine/bin
./embedded-webserver-config
Which language do you want to use for the configuration tool? The
current language is ['en']. Other available languages are: ['en']:
Specify the virtual directory for the embedded webserver to place
Engine in. It is currently [vivisimo]:
Do you wish to enable debugging mode for the embedded webserver?
[y/N]:
y
NB use N for production deployments!
Specify the group that the embedded webserver's workers will run in.
It is currently [apache]:
Specify the hostname that the embedded webserver should use. It is
currently [ecmukdemo20.asbsoftware.co.uk]:
Specify the port the embedded webserver will listen on. It is currently
using [9080]:
19080
Specify the user that the embedded webserver will run its workers as. It
is currently [apache]:
Do you want to enable the embedded webserver? [y/N]:
y
[root@ecmukdemo20 bin]#
“Once you have started the Watson Explorer Engine embedded webserver, you can complete
your Watson Explorer Engine installation by accessing the Watson Explorer Engine administration
tool through the embedded web server.”
Page &. of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
If you do not know how to contact the Watson Explorer Engine embedded web server, you can use
the ./engine-status command to show a URL that you can use to contact the web server.
(NB this is stated in the IBM documentation as embedded-webserver is-running but
this just gives the following:)
http://ecmukdemo20.asbsoftware.co.uk:19080/vivisimo/cgi-bin/admin
Open the port 19080 on the rewall
/,!,,:O $,, !,,, 2*
/,!,,
* *!*K(L*(#*
)*!,
)*#,$
REF:
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.watson.wex.fc.
install.doc/c_wex_native_accessing.html
1**!$"!)))$"12*!*#,*!
Page &2 of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Default login credentials
User name: data-explorer-admin
Password TH1nk1710
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Zoom in to see the options more clearly!
To unpack the repositories
Click Help->About
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Help About
Click $ "
Display Creation Tutorial
REF
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.swg.im.infosph
ere.dataexpl.engine.tut.display.doc/c_graphical-displays.html
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.swg.im.infosph
ere.dataexpl.engine.tut.display.doc/t_display-tut-create-display.html
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Click - on Projects and enter display-tutorial based on the core project and Add
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Click + then enter the display name (display-tutorial-display) required, click Add
Page & of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Click edit on the project display-tutorial Display line
Click OK
click display-tutorial beside the Project: label in the left-hand Watson Explorer
Engine administration tool navigation menu
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Enter testing as a search string and click Search
The screen below is displayed:
Enter Jockey to see a subset (as in the IBM Tutorial!)
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
My URL is
http://ecmukdemo20.asbsoftware.co.uk:19080/vivisimo/cgi-bin/query-meta?v
%3Aproject=display-tutorial&query=Jockey
REF:
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.swg.im.infosph
ere.dataexpl.engine.tut.display.doc/c_display-tut-customizing.html
Page + of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Appendix A – server.xml of the Application Builder web app
<server description="AppBuilder">
<webContainer useoriginalrequeststate="true"></webContainer>
<!-- Enable features -->
<featureManager>
<feature>servlet-3.0</feature>
<feature>appSecurity-1.0</feature>
<feature>ldapRegistry-3.0</feature>
</featureManager>
<httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="8080" httpsPort="9088"></httpEndpoint>
<!-- Hard-coded username and password to allow initial configuration -->
<basicRegistry id="basic" realm="customRealm">
<user name="data-explorer-admin" password="TH1nk1710"></user>
</basicRegistry>
<!-- Sample LDAP configuration:
* Keep the value of the realm attribute as Login. It matches the value
of the <realm-name> node that is referenced in the web.xml file, which
is located in the
/WEX/AppBuilder/wlp/usr/servers/AppBuilder/apps/AppBuilder/WEB-INF
directory. The value is determined by Application Builder code.
* Change the baseDN to the node which is the parent of both the Users
and Groups DNs
* Change the bindDN to the DN of an account in the LDAP server, created
for the Application Builder service
* The value for the userFilter and userIdMap user entry attributes
("sAMAccountName" in the following example) should be set in
Application Builder in the user entity's "Identifier" field. If you
use the LDAP directory as the data store that populates the user
entity, it is optional to select the value from the "Login with field"
list. However, if you use a search collection as the data store to
authorize user names that are authenticated with the LDAP registry,
you must select the value from the "Login with field" list.
-->
<!-- Sample LDAP configuration -->
<!--
<ldapRegistry
id="ldap"
realm="Login"
host="sample.ibm.com"
port="389"
ignoreCase="true"
baseDN="DC=sample,DC=ibm,DC=com"
bindDN="sample@sample.ibm.com"
bindPassword="PASSWORD"
ldapType="Microsoft Active Directory">
<activedFilters
userFilter="(&(sAMAccountName=%v)(objectClass=user))"
groupFilter="(&(cn=%v)(objectClass=group))"
userIdMap="user:sAMAccountName"
groupIdMap="*:cn"
groupMemberIdMap="memberOf:member">
</activedFilters>
</ldapRegistry>
-->
<!-- Sample LDAP configuration with SSL enabled -->
<!--
<ldapRegistry
id="ldap"
realm="Login"
host="ldap.sample.com"
port="389"
ignoreCase="true"
baseDN="DC=sample,DC=ibm,DC=com"
bindDN="sample@sample.ibm.com"
bindPassword="PASSWORD"
Page . of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
ldapType="Microsoft Active Directory"
sslEnabled="true"
sslRef="LDAPSSLSettings">
<activedFilters
userFilter="(&(sAMAccountName=%v)(objectClass=user))"
groupFilter="(&(cn=%v)(objectClass=group))"
userIdMap="user:sAMAccountName"
groupIdMap="*:cn" groupMemberIdMap="memberOf:member">
</activedFilters>
</ldapRegistry>
<sslDefault sslRef="LDAPSSLSettings" />
<ssl id="LDAPSSLSettings"
keyStoreRef="LDAPKeyStore"
trustStoreRef="LDAPTrustStore" />
<keyStore id="LDAPKeyStore"
location="installation_directory/WEX/AppBuilder/wlp/usr/servers/AppBuilder/sslCert.jks"
type="JKS" password="PASSWORD" />
<keyStore id="LDAPTrustStore"
location="installation_directory/AppBuilder/wlp/usr/servers/AppBuilder/sslCert.jks"
type="JKS" password="PASSWORD" />
-->
<!--
Security role configuration:
* Ensure the group name(s) nested in the ApplicationBuilderUsers security
role has the same value as the "cn" attribute of the group(s) to which
acccess is being restricted.
* Multiple "group" elements can be used to allow access to multiple LDAP
groups.
* If an attribute other than "cn" is used for group identifier, change it
above in both the "groupFilter" and the "groupIdMap" attributes above.
* If all WebSphere-authenticated users should get access to Application
Builder, then replace all "group" elements with the "special-subject"
entry commented out below.
-->
<application type="war" id="AppBuilder" name="AppBuilder" location="$
{server.config.dir}/apps/AppBuilder">
<application-bnd>
<security-role name="ApplicationBuilderUsers">
<!-- Use one or more group or user elements to restrict Application
Builder access -->
<!--
<group name="REPLACE_THIS_WITH_THE_CUSTOMER_LDAP_GROUP"/>
<user name="REPLACE_THIS_WITH_ADDITIONAL_USER_TO_BE_GRANTED_ACCESS"/>
-->
<!-- Use this entry, rather than groups or users , if all LDAP
authenticated users should be granted access to Application
Builder. -->
<special-subject type="ALL_AUTHENTICATED_USERS"></special-subject>
</security-role>
</application-bnd>
</application>
<applicationMonitor updateTrigger="disabled" dropinsEnabled="false"></applicationMonitor>
<mimeTypes>
<type>svg=image/svg+xml</type>
<type>SVG=image/svg+xml</type>
<type>ico=image/vnd.microsoft.icon</type>
<type>ICO=image/vnd.microsoft.icon</type>
</mimeTypes>
</server>
Page 2 of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Appendix B – Integration of the Watson Explorer services into the startup of
Linux
REF
https://www.ibm.com/support/knowledgecenter/SS8NLW_12.0.0/com.ibm.swg.im.infosph
ere.dataexpl.install.doc/c_de-init.html
For users of Systemd initialization system, for example RHEL 7 (and CENTOS 8), service scripts
are automatically tied into startup and shutdown mechanisms after enabling the background service.
Page of
IBM Watson Explorer Foundational Components 12.0.3 Installation and Conguration on
CentOS Linux 8.0
Alan S. Bluck
© ASB Software Development Limited
Appendix C – Deprecated Features of Watson Explorer
12.0.x
REF:
https://www.ibm.com/support/pages/release-notes-ibm-watson-explorer-foundational-
components-version-120#new12031
Effective with Watson Explorer V12, the following features in Watson Explorer Foundational
Components are included as a convenience, but will be removed in the subsequent
releases.
Results Module
Big Index
The Collection Broker
SMB Connector supports SMB 1.0 only.
The following data source connectors in Watson Explorer Foundational Components are
included as a convenience and will no longer be supported. They will be removed in
subsequent releases.
Large Database Connector
Legacy SharePoint Connector
Universal SAP KM Connector
Enovia Connector
Exchange 2003 / 2007 Connector
SMB Fileshares Connector
Confluence Connector
IBM Web Content Manager Connector
Page of