Fix readme for 2.0.0.0-IBM-IMA-IFIT16370

Content

Fix: 2.0.0.0-IBM-IMA-IFIT16370
Date: July 29, 2016

Component:

IBM MessageSight 2.0.0.0 Cumulative Interim Fix

(Note: all MessageSight 2.x ifixes are cumulative. In addition, because of the nature of the fix packaging for 2.0, any published fix can be used for the initial of MessageSight. It is recommend to install the latest IFIX or FP as the initial install of the product.)

Fix:

Component	md5sum	bytes	File
Server	20590e33b83de1a5df63d9f1698ef298	207365939	IBMIoTMessageSightServer-2.0.20160725-1817.tz
WebUI	bc8dd46f700cb3aa9af08d86694e1f55	165146182	IBMIoTMessageSightWebUI-2.0.20160725-1817.tz

APARs fixed in this build:

APAR	Description
IT16370	Update Java for CVE-2016-3426
IT16372	The store can be corrupted after a server restart when a subscription has processed 4.2 million or more messages.
IT16373	Duplicate messages for shared subscription if subscriber disconnects
IT16374	MQ Channel password is not stored correctly in internal config
IT16375	Topic Monitors not sync'd on HA failover
IT16376	WebUI session timeout improvements
IT16377	WebUI user and config data not saved after container updates
IT16378	Crash while upgrading server in clustered env
IT16379	Messages may be redelivered for MQTT durable subscriptions for disconnected (and reconnected) clients
IT16380	WebUI fails if removed/reinstalled with rpm or yum

Before you install:

We recommend performing a backup before upgrading the firmware:

Backup and restore

Installing the fix:

1. Prepare the IBM IoT MessageSight .tz files for installation.

For more information, see Preparing the IBM IoT MessageSight .tz packages for installation.

2. Build the IBM IoT MessageSight Docker image.

Build the IBM IoT MessageSight server image by issuing the following command:

cd imaserver
mv *.rpm imaserver.rpm
docker build --force-rm=true -t imaserver:2.0 .

3. Build the IBM IoT MessageSight Web UI image by issuing the following command:

cd imawebui
mv *.rpm imawebui.rpm
docker build --force-rm=true -t imawebui:2.0 .

4. Stop the existing containers.

Stop the server container by issuing the following command:

docker stop <server_container_name>

where <server_container_name> is the name of the container in which the IBM IoT MessageSight server is running. For example,

docker stop IMA

5. Stop the Web UI container by issuing the following command:

docker stop <webui_container_name>

where <webui_container_name> is the name of the container in which the IBM IoT MessageSight Web UI is running. For example,

docker stop IMAWEBUI

6. Remove the containers.

Remove the server container by issuing the following command:

docker rm <server_container_name>

where <server_container_name> is the name of the container in which the IBM IoT MessageSight server was running. For example,

docker rm IMA

Remove the Web UI container by issuing the following command:

docker rm <webui_container_name>

where <webui_container_name> is the name of the container in which the IBM IoT MessageSight Web UI was running. For example,

docker rm IMAWEBUI

7. Remove the old MessageSight images.

Remove the IBM IoT MessageSight server image by issuing the following command:

docker rmi -f $(docker ps | grep imaserver | awk '{print $3}')

Remove the IBM IoT MessageSight Web UI image by issuing the following command:

docker rmi -f $(docker ps | grep imawebui | awk '{print $3}')

8. Start the containers. Use the same Docker run command that you used previously before applying the update.

For example, to start the IBM IoT MessageSight server container, use a command similar to the following command:

docker run --cap-add SYS_ADMIN --net=host -P -it --name=IMA --env-file=IBMIoTMessageSightServer-docker.env -m <memory> -v /mnt/messagesight:/var/messagesight -v /mnt/tmp:/var/tmp -d imaserver:2.0

To start the IBM IoT MessageSight Web UI container, use a command similar to the following command:

docker run --cap-add SYS_ADMIN --net=host -P -it --name=IMAW --env-file=IBMIoTMessageSightServer-docker.env
-m <memory> -v /mnt/messagesight:/var/messagesight -v /mnt/tmp:/var/tmp -d imaserver:2.0

Verifying the installation:

If this is your initial install of the product see Configuring the licensed usage for IBM IoT MessageSight and accepting the license by using REST Administration APIs for accepting the product license.

If this is an update, then you can verify the status of the server see Viewing the status of an IBM IoT MessageSight server and services by using REST Administration APIs.