IBM Support

IBM Security Identity Virtual Appliance Firmware Update Transfer Utility



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.


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 and higher and ISPIM version 2.0.1 fixpack 2 and higher.



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.

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.

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.

Example 1
java -jar FileUpload.jar admin admin /work/temptrust.jks WebAS /Downloads/virtual_appliance.pkg TLSv1.2
Example 2
java -jar FileUpload.jar admin admin /work/temptrust.jks WebAS /Downloads/virtual_appliance.pkg TLSv1.2
Example 3
java -jar FileUpload.jar admin admin /work/temptrust.jks WebAS /Downloads/virtual_appliance.pkg TLSv1.2

Example 1
java -jar FileUpload.jar admin admin /work/temptrust.jks WebAS /Downloads/igiva_5.2.pkg TLSv1.2
Example 2
java -jar FileUpload.jar admin admin /work/temptrust.jks WebAS /Downloads/igiva_5.2.pkg TLSv1.2
Example 3
java -jar FileUpload.jar 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


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":"","Line of Business":{"code":"LOB24","label":"Security Software"}},{"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":"","Line of Business":{"code":"LOB24","label":"Security Software"}},{"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":"","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Document Information

Modified date:
03 February 2020