IBM Support

IBM Security Identity Virtual Appliance Firmware Update Transfer Utility

Troubleshooting


Problem

The Security Identity Virtual Appliance allows update by two methods: USB and Firmware Update Utility. This firmware transfer utility can be used by the following products:
  • IBM Governance and Intelligence Virtual Appliance (IGIVA)
  • IBM Security Identity Manager Virtual Appliance (ISIMVA)
The firmware transfer utility is also available for IBM Security Privileged Identity Manager Virtual Appliance (ISPIMVA). However, for ISPIMVA, follow the instructions that are provided in ISPIMVA File Update Transfer Utility.

Symptom

REST APIs are added to the virtual appliance to support the firmware transfer utility.

Resolving The Problem


This utility performs the same function as the virtual appliance's CLI transfer_firmware command for each product.

Note: This utility does not work with earlier versions of ISIMVA or ISPIMVA. This function is available on ISIM version 7.0.0.2 and higher and ISPIM version 2.0.1 fixpack 2 and higher.

 

For ISIMVA and IGIVA


Copy the utility to a system where Java is already installed. Java version 1.8 is recommended. You can use the Java version 1.8 that is installed with many IBM products, such as WebSphere Application Server.

Copy the firmware update (pkg) file, obtained from IBM Fix Central, and a keystore (jks attached below) to the file system. Run the java command, that is specified in the following 'Usage' section, to upload the pkg file.

Usage:
java -jar FileUpload.jar <Hostname:PORT> <AdminId> <AdminPassword> <Truststore Filepath> <Truststore Password> <Absolute path to pkg file> <sslProtocol>

Note: The command syntax is different from earlier versions of FileUpload.jar.

Examples:
Note: It is suggested to use hostname rather than an IP address and without specifying the port number. However, if you encounter connection issues, consider using hostname or the IP address both with and without the port.

ISIMVA
Example 1
java -jar FileUpload.jar isimva.example.com admin admin /work/temptrust.jks WebAS /Downloads/virtual_appliance.pkg TLSv1.2
Example 2
java -jar FileUpload.jar isimva.example.com:443 admin admin /work/temptrust.jks WebAS /Downloads/virtual_appliance.pkg TLSv1.2
 
Example 3
java -jar FileUpload.jar 127.0.0.1:443 admin admin /work/temptrust.jks WebAS /Downloads/virtual_appliance.pkg TLSv1.2

IGIVA
Example 1
java -jar FileUpload.jar igiva.example.com admin admin /work/temptrust.jks WebAS /Downloads/igiva_5.2.pkg TLSv1.2
Example 2
java -jar FileUpload.jar igiva.example.com:9443 admin admin /work/temptrust.jks WebAS /Downloads/igiva_5.2.pkg TLSv1.2
Example 3
java -jar FileUpload.jar 127.0.0.1:9443 admin admin /work/temptrust.jks WebAS /Downloads/igiva_5.2.pkg TLSv1.2
FileUpload.jarFileUpload.jar 6 March 2018
23 February 2017
FileUpload_2.1.0.jar 23 February 2017


Once the pkg file is transferred, use the appliance CLI to install the firmware.
ISIMVA 7.0.0.x: isim > firmware_update > install_firmware
ISIMVA 7.0.1.x: isim > upgrade > install
ISPIMVA 2.0.2: ispim > upgrade > install_firmware
IGIVA: igi > upgrade > install

For ISPIMVA


Follow the instructions that are provided in the ISPIMVA File Update Transfer Utility technote.

 

[{"Product":{"code":"SSRMWJ","label":"IBM Security Identity Manager"},"Business Unit":{"code":"BU008","label":"Security"},"Component":"Identity Manager Virtual Appliance","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":""},{"Product":{"code":"SSRQBP","label":"IBM Security Privileged Identity Manager"},"Business Unit":{"code":"BU008","label":"Security"},"Component":"Privileged Identity Manager Virtual Appliance","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.0.1;2.0.2;2.1.0","Edition":""},{"Product":{"code":"SSGHJR","label":"IBM Security Identity Governance and Intelligence"},"Business Unit":{"code":"BU008","label":"Security"},"Component":"Installation","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.2;5.2.1;5.2.2","Edition":""}]

Document Information

Modified date:
03 February 2020

UID

swg21965218