Re-use a former customization file

If you want to update to the latest version of Mobile Authenticator Studio but want to re-use and migrate customization data from an earlier version, you need to modify the XML file for compatibility with the new Mobile Authenticator Studio version.

The modifications of older XML files are mandatory. Mobile Authenticator Studio cannot be customized with original XML files from an older version.

XML Conversion Tool

The Mobile Authenticator Studio package includes the XML Conversion Tool. It eases the Mobile Authenticator Studio update process by converting any 4.x XML configuration file into the latest version of the file. All converted XML files can be directly used by the Customization Tool.

The XML Conversion Tool integrates a folder path into the input and converts all former authenticator XML files from a specified output folder.

The formatting and comments of the original XML file will be deleted after the conversion process.

Conversion Tool via graphical user interface

To open the Conversion Tool, execute the script that corresponds to your operating system either by double-clicking the file or by starting it from a terminal. The relevant scripts are:

• for Microsoft Windows: Converter.bat

• for macOS: Converter.command

• for Linux: Converter.sh

Figure 2: Mobile Authenticator Studio Conversion Tool - graphical user interface

Conversion Tool via the command line

Open a terminal window and type the following command:

java –jar lib/xmlconverter.jar –inputFolder xml_input_folder –outputFolder xml_output_folder

The –inputFolder parameter specifies the path of the directory where the XML files to be converted are located.

The –outputFolder parameter specifies the path of the directory where the converted XML files must be copied to.