Migration from 3.18 to version 4.0 - sepinf-inc/IPED GitHub Wiki

User Migration

IPED-4.0.0 needs Java 11 + JavaFx. Iped.exe automatically calls its embedded java 11, so you don't need to have java installed. If you want to use another java virtual machine, we recommend Liberica OpenJDK 11 FULL (not standard) package. If you get an error like:

UnsupportedClassVersionError: iped/app/bootstrap/Bootstrap has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0

You need to update your java to version 11 or simply use iped.exe.

Reusing config files from previous versions is strongly not recommended. All profiles were unified, they are not specific for each language anymore. Default profile was moved to root folder again. Profiles are now differential, just the differences to the default profile are configured into other profiles. This makes it easy to identify the differences between profiles. Profiles now are also hierarchical, if you change some config in the default (root) profile, that will be inherited by other profiles too, except if the config option is fixed/overriden into them.

Several options related to old features were renamed, merged or moved to different configuration files, they are listed below. For new options of new features, check the user manual.

LocalConfig:

  • kffDb, ledWkffPath, projectVicHashSetPath, photoDNAHashDatabase were merged into the new hashesDB. It is the place where your hash database was created when importing hashsets, please look at Hash Database v4 to see how to import them.

PS: -importkff command line option was also removed, being replaced by the new lib/iped-hashdb.jar import tool, please check the link above for its usage.

IPEDConfig.txt:

  • hash was renamed to hashes and moved to conf/HashTaskConfig.txt. A new enableHash boolean was created.
  • enableKff, enableLedWkff & enableProjectVicHashLookup were merged and renamed to enableHashDBLookup. A new enablePhotoDNALookup was created
  • excludeKffIgnorable was renamed to excludeKnown and moved to conf/HashDBLookupConfig.txt
  • enableOCR was moved to conf/OCRConfig.txt
  • addUnallocated and addFileSlacks were moved to conf/FileSystemConfig.txt
  • indexUnallocated were moved to conf/IndexTaskConfig.txt
  • indexUnknownFiles and indexCorruptedFiles were renamed to parseUnknown and parseCorrupted and moved to conf/ParsingTaskConfig.txt
  • enableKFFCarving was renamed to enableLedCarving

PS: Behavior change: a new enableAutomaticExportFiles boolean was created, now it must be enabled if you want to automatically extract files from evidence to case folder using conf/CategoriesToExport.txt or conf/KeywordsToExport.txt.

AdvancedConfig.txt:

  • entropyTest was moved to IPEDConfig.txt
  • robustImageReading, numImageReaders, ignoreHardLinks, minOrphanSizeToIgnore, unallocatedFragSize, skipFolderRegex were moved to conf/FileSystemConfig.txt
  • enableExternalParsing, numExternalParsers, externalParsingMaxMem, phoneParsersToUse, timeOut, timeOutPerMB, sortPDFChars, minRawStringSize, processImagesInPDFs, storeTextCacheOnDisk were moved to conf/ParsingTaskConfig.txt
  • minItemSizeToFragment were moved to conf/SplitLargeBinaryConfig.txt
  • forceMerge, extraCharsToIndex, convertCharsToLowerCase, filterNonLatinChars, convertCharsToAscii, textSplitSize, useNIOFSDirectory, commitIntervalSeconds, storeTermVectors, maxTokenLength were moved to conf/IndexTaskConfig.txt
  • all OCR Settings, except processImagesInPDFs, were moved to conf/OCRConfig.txt
  • all Search Settings plus embedLibreOffice were moved to conf/AnalysisConfig.txt

PhotoDNAConfig.txt:

  • skipKffFiles was renamed to skipHashDBFiles
  • maxSimilarityDistance and searchRotatedAndFlipped were moved to conf/PhotoDNALookupConfig.txt

CategoriesByTypeConfig.txt and CategoryHierarchy.txt were merged into CategoriesConfig.json

KFFTaskConfig.txt was totally refactored to a new NSRLConfig.json

Portuguese translation for Checked Items, previously Itens Selecionados, changed to Itens Marcados.