S T R U C T O R I Z E R - User Guide
Installation > Windows

Manual "installation"

Download "the latest version of Structorizer (Windows & Linux)" from http://structorizer.fisch.lu and unzip it somewhere on your hard drive. Then simply run the contained file "Structorizer.exe".

The installer will register the file types ".nsd", ".arr" and ".arrz" and associate them to Structorizer, such that you will be able to double-click files of these types later on to open them automatically within Structorizer.

This may not always work for the file types ".arr" and ".arrz" by now, however. These file types are produced by the Arranger module and should also be associated to Structorizer. If the launcher failed to establish this association then the easiest way to mend this is to double-click one of them and select "Structorizer.exe" via the dialog that will normally open: First choose to select the application from the list of installed programs and then - since Structorizer is not known to the registry - use the "Search..." button in order to locate file "Structorizer.exe" in your installation folder.

You may easily place a shortcut link on your Desktop if you right-click the file "Structorizer.exe" in the unzipped folder and then derive a link to it, e.g. via the "Create Link" item in the Explorer File menu. Move the created link to the desktop, the start menu, or wherever you like, and rename it appropriately.

Trouble-shooting on start and in batch mode

If Structorizer fails to start (usually you should at least get an error message if something goes wrong) then it is most likely due to a missing or obsolete Java installation - remember that Structorizer is Java-based and the .exe file is more or less a wrapping launcher. In order to find out what exactly is the problem you may open the console (e.g. by starting the "cmd.exe" program) and run the "Structorizer.bat" script file contained in the "Structorizer" directory. This way you should obtain the error description text giving you enough hints to fix the problem. You might redirect the console output and error streams directly to log files by one of the following command lines (the first one for different log files, the second one for a common log file with both streams mixed):
Structorizer.bat 1> out.log 2> err.log
Structorizer.bat > allout.log 2>&1

(You may also have a look in section Logging but the Structorizer logging mechanism first requires Structorizer to have started at all.)

The "Structorizer.bat" file is also helpful to do source code generation from nsd files or to derive nsd files from source files as batch task via the console or in a script (see Export source code and Import for details). Command "Structorizer.bat -h" prints a short synopsis of the possible batch command options.

Attended Installation (setup)

Download the "Windows installer with latest version" from http://structorizer.fisch.lu,  which is a setup executable with name "structorizer.exe", then execute it locally. You may get a security warning, so make sure that the shown signatured publisher (should be: "Centre de gestion informatique de l'éducation") is valid. Some Windows versions may fail to display the publisher, though. If you trust the Structorizer makers nevertheless then go ahead, or use the manual installation (see above) otherwise. The setup will next offer you to install Structorizer either just for your account (which does not require administrative privileges) or for all users:

Windows installer - mode choice

If you choose "Install for all users" then the Windows User Access Control (UAC) will request you to authenticate against an account with administrative privileges.

The installer will now present the license agreement, which you will have to accept in order to go on:

Windows installer - license agreement

Afterwards you will be asked for the installation folder. The proposal you get depends on the chosen mode (the screenshot below shows an example of an account-specific installation with the fictitious user "whoever"):

Windows installer - destination folder choice

In case of an installation for all users you will obtain a different proposal, e.g:

Windows installer - central destination folder

Now you will have the choice among three different update modes or policies (each represented by a slightly different ini file to be installed, the policy can be altered at any time after the installation via the system control, see further below):

Windows installer - update policies

Whereas the first two policies ("Always ..." and "Look ..") will consult the product homepage on each start, the third one ("Never...") won't do so. The update request with the second policy will look like this when a differing version is detected:

Upla update dialog

Note that Structorizer itself has also a mode to check for newer versions (see preferences), which to activate doesn't make sense with this installation type because it would be redundant with the first two policies and would circumvent the third policy no matter whether you chose it to accelerate start or to preserve privacy. (The Structorizer-internal check is intended for use without installation.)

In the next step you will be asked whether you want a desktop shortcut (and maybe a quick-launch shortcut, too) created. When proceeding, the setup assistant will present you an overview of the made decisions and ask you whether to go on:

Windows installer - commitment

After having finished the installation you will be asked whether to launch Structorizer immediately or simply to exit the setup. Remember: In order to launch Structorizer now, Java must have been installed.

With the launch checkbox enabled, a splash screen sequence will inform you about the next steps, which include the update check (unless disabled), possibly the download of a newer Structorizer.jar file from the Structorizer home page into the installation folder) and the actual start:

Windows installer - download splash

Windows installer - download splash

Windows installer - start splash

After a successful installation you will find Structorizer listed in the "Programs and Features" tool of the Windows system administration (the screenshot below shows a Windows 10 installation with German locale):

About window - modify button

Via the "Modify" button (labelled "Ändern" in the screenshot above) you may alter the update policy (see before). With an installation for all users this requires an administrative role:

About window - update settings

If you want to uninstall Structorizer, you ought to do it via the "Uninstall" button from "Programs and Features", no matter whether Structorizer had been installed for all users or just for your account. The only difference is whether it requires administrative privileges. The uninstaller will first ask for your confirmation:

Windows installer - uninstaller

If you don't find the Structorizer entry in the "Programs and Features" tool, however, then you may go to the installation directory and execute file "unins000.exe" (marked with a green box in the screenshot below) directly. In case the installation directory is a system folder, you will have to execute "unins000.exe" as administrator.

Windows installer - uninstaller

If you happen to be oblivious about where you had installed Structorizer, you may always consult a running Structorizer instance launched via the installed shortcut. Just open the About dialog and select the "Paths" tab - the "Installation path" is what you are looking for, e.g.:

About window - installation path