Jiwa 7.02.01.00 Service Release 17
- Mike Sheen
- Julie Hanlon
Potential Breaking Changes
A previous service release, 07.02.01 SR 15, introduced a potential breaking change to plugins which extend the REST API. As this Service Release, SR17, includes those changes upgrading to SR17 may expose you to breaking changes. See the breaking changes section of the Jiwa 7.02.01.00 Service Release 15 article for details.
It is also advisable to update the REST API to the version shipped with SR17 - see the section below on Obtaining the latest REST API.
About Service Releases
Jiwa 7 Service Releases are cumulative, and later Service Releases supersede earlier Service Releases.
This means you only need to install the most recent Service Release to obtain all the fixes of previous Service Releases. Installing a later Service Release will automatically remove older Service Releases.
Installing a later version of Jiwa will also remove any service releases for previous versions.
Where to Obtain
The service release is obtained from the downloads page of the support portal.
How to Install
Typically the .msp file, once downloaded can by run simply by double-clicking the file to run.
However, if an error such as the following occurs:
"A file that is required cannot be installed because the cabinet file <%path%>\disk1.cab has an invalid digital signature. This may indicate that the cabinet file is corrupt"
Then you should open an elevated command prompt and run the .msp from there. An elevated command prompt is simply a command prompt run as Administrator.
Stop Jiwa Services and close Jiwa applications
Before installing, you should ensure any applications or services using Jiwa components - such as the Jiwa Plugin Scheduler Service, or the Jiwa REST API are stopped. The installer will set the Startup Type to "Disabled", so it's important to note that after the installation is completed you should set your Startup Type - preferably to "Automatic" and then restart the service again.
Make sure there is no Jiwa Application (Jiwa.exe) running on the machine or an error may occur "Error writing to file" or similar.
How to remove
To remove a service release Jiwa needs to be Uninstalled first.
In Windows Control Panel Add/Remove programs - Uninstall Jiwa - All related service releases will be uninstalled at the same time.
Re-install Jiwa again then install the required Service Release.
Solutions in Addition to Service Release
There are issues that have been addressed that cannot be included in Service Releases. There are also enhancements that are described in more detail in this section. Please review this list - Solutions in Addition to Service Releases.
Issues Addressed In Service Release
Jiwa 07.02.01.00 Service Release 17 includes all issues addressed in Jiwa 07.02.01.00 Service Release 16 in addition to the following:
Getting issues...
REST API
The minimum version of the REST API plugin required for SR 17 is 7.2.1.52.
When importing the plugin for use, don’t forget to enable it.
Obtaining the latest REST API
As service releases cannot make database changes, to obtain the latest REST API plugin, you must extract it from the IIS Web package which is updated in this Service Release.
The web package is located in the Program Files (x86)\Jiwa Financials\Jiwa 7\JiwaAPI folder and is named JiwaAPI.zip. Extract the contents of this archive to a folder and locate the Plugin REST API.xml and import this into Jiwa using the Plugin Maintenance form.
NOTE: Using the latest REST API plugin will require all clients to have the same Service Release installed, as the plugin is dependent on changes only introduced in this Service Release.
Cumulative Issues Addressed In Service Release
A complete list of all issues addressed:
Getting issues...