DPT manual Installation and launch
The tool is distributed as a zip-file, named: APE_data_preparation_tool_2.6.1.zip, where the number indicates the version of the tool. The most recent version of the tool (v2.6.1) is available for download over here.
The only requirement that is needed for running the tool is that you need to have Java 6 or higher installed on your computer. You can verify whether Java is installed on your computer, and which version, by launching the command prompt (Windows) or terminal (Linux) and typing: java -version. On a MacIntosh computer you can go to 'system preferences' and see if there is a Java icon there, if so, Java is installed and you can click on the icon to check the version.
Once you have downloaded the zip-file please do the following:
- Uncompress the zip-file with winzip, 7-zip, unzip or a similar tool towards a location of your choic to create the executabe and auxiliary files: two folders (named: libe and xls) and five files:
- You will have a folder containing 2 folders (lib and xls) and 5 files.
- Depending on your Operating System (OS):
- Using Windows: double-click on the launch.bat file,
- Using UNIX: using your terminal launch the launch.sh file (i.e. type: shlaunch.sh – make sure that the file has at least the execution right: chmod +x launch.sh),
- Using OS X: double-click on the APE_data_preparation_tool-jar-with-dependencies.jar file.
In Windows double-clicking the APE_datapreparation_tool_jar-with-dependencies.jar file can also be used as an alternative to double-clicking the launch.bat file.
- On the first launch of the tool, a dialogue box will ask first for your country code (2-letter country code, in capital characters, compliant to iso3166), then an identifier for your archives: please enter your registered ISIL identifier (if you have one, else you will still need to enter a valid iso15511 code). Note that you can change those anytime you want in the options. Be aware that the dialogue box might stay in the background so that you could not see it at first.
The ISO standard 15511 consists of up to 14 characters, usually starting with a two-letter country code (or a one-three- of four-letter organisational code), followed by a hyphen, followed by an alphanumeric code for the single institution. The latter can contain the digits 0 to 9, the characters A to Z and the characters -, / or \.
- The program should now be running (see figure 1 below), if that’s not the case, please refer to the troubleshooting section of this manual.
- The folder now contains 4 folders (apeoptions, lib, output and xsl) and 6 files.
