SanteDB Brain Bug

The brain bug tool is named after the infamous "Brain Bug" from the movie Starship Troopers. The tool does exactly what that alien did, it extracts logs, files and databases from the dCDR Android Application.

The tool was developed to overcome the fact that extracting Android backups is difficult on Microsoft Windows operating systems. To run the brainbug tool you will need the Android SDK installed on your Windows environment.

Command Line Options

Tool: sdb-bb.exe

The following command line options are available for the brain bug tool.

Option	Description	Example
help	Show help for the tool and exit	--help
pkgid	Identifies the package of the android application you wish to extract logs and files for. The package identifier is the id of your solution.	--pkgid=mm.mpi.app
sdk	If you've installed the Android SDK in a different location than the default for your operating system, this is the path to the adb.exe tool.	--sdk="C:\android"
bkfile	If you wish to simply extract your application from the android device and save it to ship to another developer, specify the backup file. Conversely, if you wish to simply extract the contents of a backup file, specify the backup file.	--bkfile=mybackup
tar	If you wish to extract a TAR file from the .ab file then specify the tar archive to be saved.	--tar=mybackup.tar
extract	If you wish to extract the contents of the backup directly to a folder on your computer, this is the path to the extract location.	--extract=C:\issue1
password	Specify the password for an encyrpted backup	--password=Foo123

Extracting a dCDR/DCG Backup

Developers and system administrators can manually extract the contents of a backup file (in SanteDB version 3.0 ending with .bin ) using the BrainBug tool. The command to extract is:

sdb-bb --extract=C:\temp\problem_that_im_diagnosing --bkfile=backup_file_from_tablet.bin --password=Foo123