How to add IBM InfoSphere Information Server Enterprise Search 11.7.0.2 into an existing InfoSphere Information Server 11.7.0.2 installation

Steps

1) Verify that the Information Server Enterprise Search (ISES) host is ready for installation.

1.1) Check that all System requirements have been met. See  " Preparing the Information Server Enterprise Search node "  for details of the steps needed to setup the ISES host. You can use this pre-installation checklist while setting up the ISES host.

1.2) Installation of ISES will place the following packages on your system. Note that if you have any of these packages on the system prior to the install, they must be at exactly the same level as indicated below, or the install will fail:
        Version of RPM Packages

1.3) Address " Various issues related to upgrading IBM InfoSphere Information Server to version 11.7.0.2 " prior to starting the install.
 

2) Login as the root user or sudo as root to the ISES host, and perform the following steps on the ISES host.

2.1) You must setup passwordless ssh from the ISES host root user to itself.
        Note that this setup is needed even if you are not setting up passwordless ssh from the IIS host to the ISES host. This setup is needed only for the duration of the install.

    a. Generate an ssh key in the root home directory
           ssh-keygen -f ~/.ssh/id_rsa -q -N ""

    b. Add the generated ssh key to the authorized_keys file in the root home directory:
           cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys

   c. Verify ssh  login to ISES host without a password:
           ssh root@<ISESHOST NAME>

2.2) The sudo user should have directory create permissions on /home directory.

2.3) Download the images needed for the install.

2.3.1) Download the 11.7.0.2 suite image from Passport Advantage.
        For example, the suite image file is is-suite.is_11_7_0_2.linux64.RC2.181004.tar.gz

2.3.2) Download the IIS 11.7.0.2 Docker tar image from Fix Central:
              https://www.ibm.com/support/docview.wss?uid=ibm10734865
        For example, the Docker image file is
              fixpack_FP2_IS117_UGDocker_11700-11701.tar.gz

2.4) Extract the downloaded suite image.
        Change directory to is-suite/payloads/Shared/UGDockerDeploymentServices/payload/installer/
        Copy kubeselfextract.bsx to /tmp folder and make it executable

             cd is-suite/payloads/Shared/UGDockerDeploymentServices/payload/installer/
             cp kubeselextract.bsx  /tmp
             chmod +x /tmp/kubeselfextract.bsx

2.5) Copy the Token service public certificate file from the IIS host to /tmp folder on the ISES host

             scp  root@<IIS host>:<IIS install location>/ASBServer/apps/lib/iis/tknproperties/tokenservicepublic.cer  /tmp

        If the file does not exist on the IIS host, refer to Technote for information on creating the file.

2.6) Copy the buildinfo.txt file from the IIS host to /tmp folder on the ISES host

             scp  root@<IIS host>:<IIS install location>/buildinfo.txt  /tmp

2.7)  If any password specified in the uginfo.rsp file contains the '&' character, the entire password should be enclosed within double quotes, or you can escape the '&' characters using the '\' character.
        You can verify that all passwords containing the '&' character have been appropriately specified by successfully executing the following command:
             source /tmp/uginfo.rsp

2.8) Create a response file uginfo.rsp in the /tmp folder by copying the following properties and updating the values as indicated.

IS_INSTALL_HOME=<Information Server Install location>

IS_SERVER_HOST=<Services Tier long host name >

IS_SERVER_PORT=<AppServer port >

IS_ADMIN_USER=<Information Server Admin User>

IS_ADMIN_PASSWORD=<Information Server Admin Password>

APP_SERVER_TYPE=<was for WebSphere ND and lwas  for WebSphere Liberty>

XMETA_DB_HOST=<Information Server database long host name>

XMETA_DB_PORT=<Information Server database port>

XMETA_DB_USER=<Information Server xmeta database user>

XMETA_DB_PASSWORD=<Information Server xmeta database password>

XMETA_DB_TYPE=<db2 for DB2 database, oracle for ORACLE database, sqlserver for SQLSERVER database>

XMETA_DB_NAME=<Information Server xmeta database name>

XMETA_DB_DRIVER=<

• DB2 -  com.ibm.db2.jcc.DB2Driver
• ORACLE -  com.ibm.isf.jdbc.oracle.OracleDriver
• SQLServer -  com.ibm.isf.jdbc.sqlserver.SQLServerDriver

>

SOCIAL_DB_HOST=<same as XMETA_DB_HOST>

SOCIAL_DB_PORT=<same as XMETA_DB_PORT>

SOCIAL_DB_USER=<same as XMETA_DB_USER>

SOCIAL_DB_PASSWORD=<same as XMETA_DB_PASSWORD>

SOCIAL_DB_NAME=<same as XMETA_DB_NAME>

MASTER_NODE_HOST=<ISES master node long host name>

MASTER_NODE_USER=<ISES master node user>

UG_IMAGES_TAR_PATH=<11.7 Fix Pack 2 Docker tar images path which is downloaded from IBM Fix Central and copied to ISES host>

NUMBER_OF_NODES=<this is always 0 and should not be changed>

WEAVE_NET_IP=10.32.0.0/12

ES_INSTALLDIR=<Enterprise search install directory. You should create an install directory say /opt/IBM/UGinstall with 755 permissions on the ISES host and provide that value>

# The default value of following property is 10.96.0.0/12

SERVICE_IP_RANGE=10.96.0.0/12

# The default value of following property is /tmp

SHOP4INFO_BAK_DIR=<Enterprise search backup directory. Create a backup directory say /opt/IBM/ESbackup with 755 permissions on the ISES host and give that value>

MASTER_DOCKER_VOLUME=<Docker install volume. For example /dev/sdc1>

UG_DOMAIN_NAME=<domain name of ISES machine>

XMETA_SR_DB_HOST=<same as XMETA_DB_HOST>

XMETA_SR_DB_USER=<XMETA SR database user>

XMETA_SR_DB_PASSWORD=<XMETA SR database password>

XMETA_SR_DB_PORT=<same as XMETA_DB_PORT>

XMETA_SR_DB_URL=<

•             DB2 -  jdbc\:db2\://<db host long name>\:<xmeta db port>/<xmeta db name>
•             Oracle SID -   jdbc:ibm:oracle://<db host long name>:<DB port>;SID=<database name>
•             Oracle service name -   jdbc:ibm:oracle://<db host long name>:<DB port>;serviceName=<service name>
•             SQLServer -   jdbc\:ibm\:sqlserver\://<db host long name>\:<sql server db port>;DatabaseName\=<database name>

>

XMETA_SR_DB_TYPE=<same as XMETA_DB_TYPE>

XMETA_SR_DB_DRIVER=<

• DB2 -  com.ibm.db2.jcc.DB2Driver
• ORACLE -  com.ibm.isf.jdbc.oracle.OracleDriver
• SQLServer -  com.ibm.isf.jdbc.sqlserver.SQLServerDriver

>

XMETA_SR_DB_NAME=<xmeta sr database name>

XMETA_DB_URL=<

• DB2 -   jdbc\:db2\://<db host long name>\:<xmeta db port>/<xmeta db name>
• Oracle SID -  jdbc:ibm:oracle://<db host long name>:<DB port>;SID=<database name>
• Oracle service name -  jdbc:ibm:oracle://<db host long name>:<DB port>;serviceName=<service name>
• SQLServer -  jdbc\:ibm\:sqlserver\://<db host long name>\:<sql server db port>;DatabaseName\=<database name>

>

XMETA_DB_ORACLE_TYPE=<For service name configuration serviceName and For SID configuration SID>

2.9) Check if Docker, or Kubernetes, or Ansible are already installed by using the following commands:

             yum list installed|grep docker
             yum list installed|grep kube
             yum list installed|grep ansible

        Remove any that are installed by using the following command:

             yum remove -y <package name>

2.10) Disable yum.repos.d by using the following commands:

            cd /etc/yum.repos.d
            grep enabled *
            sed -i -e 's/^enabled=1/enabled=0/g' *.repo

2.11) Run kubselfextract.bsx using the following command

         /tmp/kubeselfextract.bsx

2.12) Check for installation status in /opt/IBM/UGinstall/iiskubedeploy-<timestamp>.log

2.13) Copy /tmp/uginfo.rsp from the ISES host to IIS host <IIS install location>/UGDockerDeployment/installer

3) Login as root or sudo as root to the IIS host and perform the following steps on the IIS host.

3.1) Change directory to <IIS install location>/ASBServer/bin>

       Do the following four steps to set the properties as noted:

3.1.1) Set the Finley application host and port:
       ./iisAdmin.sh -set -key com.ibm.iis.odf.PredictorServiceEndpoint -value <Master node host>:32500
       The value provided for <Master node host> should be the same as the MASTER_NODE_HOST value in the uginfo.rsp file.

3.1.2) Set the Information Server Enterprise Search host name to the Information Server properties:
      ./iisAdmin.sh -set -key com.ibm.iis.ug.host.name -value <Master node host>
      The value provided for <Master node host> should be the same as the MASTER_NODE_HOST value in the uginfo.rsp file.

3.1.3) Set the list of allowed referer domain names:
      ./iisAdmin.sh -set -key com.ibm.iis.isf.security.AllowedRefererDomainNames -value  <DomainName or comma-separated DomainNames>
      where <DomainName or comma-separated DomainNames> refers to the network domain name that the Information Server host and Information Server Enterprise Search host belong to.

3.1.4) On the IIS Engine tier, edit the file <IIS install location>/ASBNode/conf/odf.properties and change the value of the property odf.zookeeper.connect to masterNodeHost:2181/kafka.

      After saving the file, restart the ODF service as described in Troubleshooting / Monitoring Analyses for Unified Governance ; see #2 in the section "Resolving the Problem":

      Change directory to <IIS Install location>/ASBNode/odf
      (for example, cd /opt/IBM/InformationServer/ASBNode/odf)
      ./ODFEngine stop
      ./ODFEngine start

3.2) Run SetSOSProperties.sh using the following commands:

        cd <IIS install location>/UGDockerDeployment/bin
        chmod +x SetSOSProperties.sh
        ./SetSOSProperties.sh <ISES host>

3.3) Restart WebSphere Application Server for the changes to take effect. See here for details.