Jiwa 7.02.01.00 Service Release 15
Potential Breaking Changes
07.02.01 SR 15 has potential breaking changes to plugins which extend the REST API. See the breaking changes section of this article for details.
It is also advisable to update the REST API to the version shipped with SR15 - 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 15 includes all issues addressed in Jiwa 07.02.01.00 Service Release 14 in addition to the following:
Getting issues...
REST API
Breaking Changes
Potential breaking changes
07.02.01 SR15 has some potential breaking changes for plugins which extend the REST API.
If you have custom plugins which add new routes to the REST API, there are potential breaking changes in the REST API which may require minor changes to the custom plugins.
If the custom plugin had service methods which used the GetManager() extension method, then they need to be modified to use an extension method of the same name from the base Request and to wrap their code in a using statement.
Code which was like this:
JiwaFinancials.Jiwa.JiwaApplication.Manager manager = this.GetManager();
// other service method code in hereNeeds to change to this:
using(JiwaFinancials.Jiwa.JiwaApplication.Manager manager = this.Request.GetManager())
{
// other service method code in here
}DEV-9153 has full details of all the changes made.
Cumulative Issues Addressed In Service Release
A complete list of all issues addressed:
Getting issues...