How to install OSDEA-GUI

Before proceeding, you need to have downloaded OSDEA-GUI.

Installing OSDEA-GUI requires the three following steps:
 * 1) Unzipping the OSDEA package you've downloaded.
 * 2) Installing lpsolve on your machine (if not already done).
 * 3) Copying the swt.jar library which corresponds to your system into the OSDEA lib folder.

Each step is detailed below.

1. Unzipping the OSDEA-GUI zip file

 * Create a folder wherever you want on your system (e.g. 'OSDEA-GUI').
 * Put the OSDEA-GUI-vX.X.zip file in this folder.
 * Unarchive the zip file (on windows install 7zip if you cannot unzip the file). On linux you should have the option from the right-click menu; alternatively find some unzip tools in your package manager).
 * You should now have a lpsolve folder, a *_lib folder, a SWT folder and an executable jar (the OSDEA-GUI program).

2. Installing lpsolve
The lpsolve DLLs are included in the OSDEA downloads. If you have downloaded the OSDEA GUI program, the lpsolve files are in the folder: lpsolve-v5.5.2.0\yourSystem. If you are using the source code, they can be found under: DEASolver\lpsolve\yourSystem folders.

To install lpsolve, you simply need to copy the lpsolve library and the java stub to a system directory:
 * On windows, select the 32 or 64 bits lpsolve DLLs (resp. lpsolve55.dll and lpsolve55j.dll) depending on the version of the JRE you are using. Copy them to:
 * C:\Windows\System32 for Windows machines with the exception of
 * C:\Windows\SysWOW64 if you use the 32 bits lpsolve DLL on a 64 Bits Windows system (i.e. if you are running a 32 bit JRE on a 64 bits OS).
 * On Linux (*nix) systems:
 * Select the 32 or 64 bits lpsolve libraries (resp. liblpsolve55j.so and liblpsolve55.so) and copy them to the /usr/lib directory (alt./usr/local/lib - otherwise run ldconfig to add the lpsolve libraries to your system's libraries path).
 * On mac (osx32):
 * use the build-osx build file with the liblpsolve55.dylib library.

3. Copying the swt.jar file to the lib folder
The last thing required is to copy the swt.jar library for your systems to the 'OSDEA-GUI-vX.X_lib' folder. The steps are as follows:
 * Confirm which JVM you have installed: open a terminal and type java -version.
 * Locate the corresponding swt.jar library: browse to the 'SWT' folder and go to the folder corresponding to your OS/JVM. For example, if you are using windows and have a 32 bits JVM, you need to use the swt.jar library located in the win32 folder.
 * Copy the swt.jar library and paste it in the 'OSDEA-GUI-vX.X_lib' folder.

If you're already installed the lpsolve libraries on your system, you can run the program by double-clicking on OSDEA-GUI-vX.X.jar.

Running OSDEA
Congratulations, you've installed OSDEA-GUI. You can now run the program by double-clicking on the OSDEA-GUI-vX.X.jar file (the file might simply be called 'OSDEA-GUI-vX.X' on your system).

Troubleshoot
If you're having problem running the application, you will probably find the throubleshoot useful!