Installing a WebSphere Liberty fix archive to InfoSphere Information Server

1. Shut down Information Server: https://www-01.ibm.com/support/knowledgecenter/SSZJPZ_11.3.0/com.ibm.swg.im.iis.found.admin.common.doc/topics/c_wsadmin_shutting_down_services.html
   It is recommended that you shut down all tiers of Information Server while the services tier is updated. It is required that you shut down WebSphere Liberty processes:
   Linux or Unix©:
   /opt/IBM/InformationServer/ASBServer/bin/MetadataServer.sh stop
   
   Windows:
   > net stop InfoSvr
   In addition, if you installed the IBM InfoSphere Metadata Interchange Agent as a client tier, run
   > net stop mis
   .
2. In your shell or command window, change to the Information Server installation directory
   Linux or Unix©:
   # cd /opt/IBM/InformationServer
   
   Windows:
   > cd C:\IBM\InformationServer
   .
3. If you are installing a patch, make a backup of the wlp directory
   Linux or Unix©:
   # cp -Rp wlp wlp.backup
   
   Windows: Use Windows explorer to copy C:\IBM\InformationServer\wlp to C:\IBM\InformationServer\wlp.backup
   
   If you are installing a WebSphere Liberty Fixpack, rename the wlp directory
   Linux or Unix©:
   # cd /opt/IBM/InformationServer
   # mv wlp wlp.backup
   
   Windows: Use Windows explorer to rename C:\IBM\InformationServer\wlp to C:\IBM\InformationServer\wlp.backup
   .
4. Install patch:
   Linux or Unix©:
   # /opt/IBM/InformationServer/jdk/bin/java -jar <pathToPatchFile>/<archive supplied by support.jar> --installLocation /opt/IBM/InformationServer
   
   Windows:
   > C:\IBM\InformationServer\jdk\bin\java -jar <pathToPatchFile>\<archive supplied by support.jar> --installLocation C:\IBM\InformationServer
   
   Install Fixpack:
   
   Linux or Unix©:
   # /opt/IBM/InformationServer/jdk/bin/java -jar <pathToPatchFile>/<archive supplied by support.jar> /opt/IBM/InformationServer
   # cp -r wlp.backup/usr/servers/iis/ wlp/usr/servers
   # cp -r wlp.backup/etc/ wlp
   # cp -r wlp.backup/usr/extension/ wlp/usr/
   
   Windows:
   > C:\IBM\InformationServer\jdk\bin\java -jar <pathToPatchFile>\<archive supplied by support.jar> C:\IBM\InformationServer\wlp
   
   Use Windows explorer to copy the following directories to the same location in the new wlp folder:
   C:\IBM\InformationServer\wlp.backup\etc
   C:\IBM\InformationServer\wlp.backup\usr\extension (if present)
   C:\IBM\InformationServer\wlp.backup\usr\servers\iis (if present)
   C:\IBM\InformationServer\wlp.backup\usr\servers\mis (if present)
    
5. Usage of the Reporting feature in Administration Console might require J2EE_EXT_CP to be updated.
   For all Information Server releases, each time WebSphere Liberty is updated, do the following steps to address JR57893:
   
         a. On the services tier, change directory to <IIS_INSTALL_HOME>
   
         b. Locate J2EE_EXT_CP in your setupEnv.sh or setupEnv.bat file.
              For example,
                     J2EE_EXT_CP=/opt/IBM/InformationServer/wlp/lib/com.ibm.ws.crypto.passwordutil_1.0.59.jar:/opt/IBM/InformationServer/wlp/lib/com.ibm.ws.kernel.service_1.3.59.jar:/opt/IBM/InformationServer/wlp/lib/com.ibm.ws.kernel.boot_1.0.59.jar:/opt/IBM/InformationServer/wlp/lib/com.ibm.ws.logging_1.0.59.jar
   
         c. When WebSphere Liberty is updated, the version of the JAR files listed in J2EE_EXT_CP might change. The value for J2EE_EXT_CP must be updated to match the current version of these WebSphere Liberty JAR files.
             For example, run the following command and note the current version of the crypto library:
                  Linux or Unix©: ls -ld wlp/lib/com.ibm.ws.crypto.passwordutil_*.jar
                  Windows: dir wlp\lib\com.ibm.ws.crypto.passwordutil_*.jar
   
                  -rwxr-xr-x 1 root root 79842 Feb 28 03:19 /opt/IBM/InformationServer/wlp/lib/com.ibm.ws.crypto.passwordutil_1.0.61.jar
   
         d. If the version in step c is not the same as the version observed in step b:
                 - Take a backup of your setupEnv.sh or setupEnv.bat file.
                 - Update J2EE_EXT_CP with the version observed in step c.
   
         e. Ensure that each JAR file listed in J2EE_EXT_CP matches its current version.
   
   Note:
   In order to address JR57893, anytime WebSphere Liberty is upgraded from version 8.5.5.8 or earlier to 8.5.5.9 or later, the following must be installed:
   
       For 11.5 installations:
           Information Server Framework (ISF) 11.5 Rollup patch 8 or later, or
           Information Server 11.5 Service Pack 2
       For 11.3 installations:
           Information Server Framework (ISF) 11.3 Rollup patch 8 or later
6. Windows: Once the patch is successfully installed, start the Liberty profile with --clean to clear the cache:
   > C:\IBM\InformationServer\wlp\server.bat start iis --clean
   > C:\IBM\InformationServer\wlp\server.bat stop iis --clean
   
   If you installed the IBM InfoSphere Metadata Interchange Agent as a client tier:
   > C:\IBM\InformationServer\wlp\server.bat start mis --clean
   > C:\IBM\InformationServer\wlp\server.bat stop mis --clean
   .
7. Restart Information Server: https://www-01.ibm.com/support/knowledgecenter/SSZJPZ_11.3.0/com.ibm.swg.im.iis.found.admin.common.doc/topics/c_wsadmin_shutting_down_services.html
   https://www-01.ibm.com/support/knowledgecenter/SSZJPZ_11.5.0/com.ibm.swg.im.iis.found.admin.common.doc/topics/c_wsadmin_shutting_down_services.html
   Specifically, to restart WebSphere Liberty:
   Linux or Unix©:
   /opt/IBM/InformationServer/ASBServer/bin/MetadataServer.sh run
   
   Windows:
   > net start InfoSvr
   In addition, if you installed the IBM InfoSphere Metadata Interchange Agent as a client tier, run
   > net start mis

Notes:

• 1. Fix pack 16.0.0.2 is the next WebSphere® Application Server Liberty Fix pack after 8.5.5.9. The preceding instructions can be used to install any WebSphere® Application Server Liberty Fix pack including fix packs after 8.5.5.9.
  2. The WebSphere Liberty instance used by Information Server is located in <IS-INSTALL>\wlp (for example, C:\IBM\InformationServer\wlp). It must not be moved to a different location.