Fatal Error on Startup

Issue: When restarting the application after a hard crash (one where the application closes), you receive an error: A serious error occurred during startup. OpenIZ Mobile cannot continue. Please reference the following error code when seeking help :: << error code >>

Applies To:

  • OpenIZ Disconnected Client Android


  • The error mentioned in the issue section appears on splash screen

  • You cannot continue loading the application

Cause: This error is caused because the configuration file has somehow become corrupted on the tablet data store. The device has no way of recovering from this error, and the configuration is lost. However the data is still in tact, if you want the data off the tablet, you will have to manually extract it and send the contents of the outbox manually to the server.


  1. Download and install the OpenIZ Disconnected Client SDK (https://github.com/MohawkMEDIC/openizdc/releases)

  2. Download and install the Android SDK tools (https://developer.android.com/studio/releases/platform-tools.html)

  3. Enable developer mode on the tablet which is impacted (https://www.androidcentral.com/how-enable-developer-settings-android-42)

  4. Run the following command: 1. If you are running OpenIZ Vanilla: brainbug --pkgid=org.openiz.mobile --bkfile=mycrash.ab 2. If you are running TImR : brainbug --pkgid=tz.timr.mobile --bkfile=mycrash.ab

  5. If successful, brainbug will create a directory called mycrash.ab on your desktop.

  6. Send this file to your support personnel and they will be able to extract the tablet crash files and data, If you do not have a support organization you can follow these steps:

    1. Run the brainbug tool again to extract the file: brainbug --extract=.\mycrash --bkfile=mycrash.ab

    2. In the directory .\mycrash\apps\tz.timr.mobile\f (or org.openiz.core if using vanilla) you will notice two folders: .config and .local, make a note of where these folders are.

    3. Reset the minims configuration using minims --reset

    4. Run the MINIMS debugging tool using minims --ref="C:\Program Files (x86)\Mohawk College\OpenIZ\sdk\org.openiz.core.pak" --applet=.\

    5. Join the security realm to which you want to push the recovered data. Be sure to subscribe to the right facility.

    6. Stop the mini-ims server by pressing Enter

    7. Start the mini-ims server again (you can press the up arrow key in windows)

    8. Cancel this sync by pressing enter.

    9. Restart the mini-ims with the specified parameters from step vii.

  7. You can now access your data as though it was on the tablet (including forcing a synchronization).

Last updated