README for Osdag installation and use

======================================

System Requirements:
====================
Supported Operating Systems:
Windows Vista
Windows 7,
Windows 8,
Windows 8.1
Windows 10
RAM and Storage Space:
Minimum 2 Gb RAM recommended
Minimum 4 Gb free storage space recommended

===================================================================================
=============
===================================================================================
=============
Basic User:
===========
# If you have already installed the previous version of Osdag in your system then
skip step 1) & 2) and just run the new downloaded Osdag_setup_x86.exe.

Installation steps:
===================
# See Advanced-User section below, before you execute these steps.
1) Run Miniconda2-latest-Windows-x86.exe
# Follow on-screen instructions AND select the following options in the
Setup:
a) Install for: [All Users (requires admin privileges)]
b) Destination Folder: ["C:\ProgramData\Miniconda2"]
c) Advanced Options: Check both the options:
i) Add Anaconda to my PATH environment variable
ii) Register Anaconda as my default Python 2.7
2) Run wkhtmltox-0.12.4_msvc2015-win32.exe
# Follow on-screen instructions AND select the following option in the
Setup:
a) Destination Folder: ["C:\Program Files (x86)\wkhtmltopdf"]
3) Run Osdag_setup_x86.exe and follow on-screen instructions
# The default directory to install Osdag is the User Desktop.
You may choose any other location. However, DO NOT choose any of the
following locations:
a) Program Files
b) Program Files (x86)
c) ProgramData

Running Osdag:
==============
After the installation is complete, you may run Osdag by one of the following
methods:
double-clicking on the Desktop shortcut or
double-clicking on the Start Menu shortcut or
navigating to the installation-directory and double-clicking the Osdag
shortcut

===================================================================================
=============
===================================================================================
=============
Advanced User:
==============
Criteria:
=========
If you satisfy one of the following two conditions, then you will need to
follow a different installation procedure.
Condition a) You already use Anaconda/Miniconda
Condition b) You have already installed a version of python on your computer
AND you wish to keep that as the system default instead of the
Miniconda(/Anaconda)-python

Installation:
=============
1)Run wkhtmltox-0.12.4_msvc2015-win32.exe
# Follow on-screen instructions AND select the following option in the
Setup:
a) Destination Folder: ["C:\Program Files (x86)\wkhtmltopdf"]

2)Miniconda
If you do not have Miniconda installed and are ok with installing it.
And wish to not Register Anaconda as the default Python 2.7, you will need to
install it (same as the basic user) BUT follow the steps in the "Running Osdag"
section below, instead of the basic user "Running Osdag" steps.

If you already are a Miniconda or Anaconda user,

Navigate to the "dependencies" folder in the installation-
directory.
Open the "install_osdag_dependencies.bat" in a text editor and
Manually install the missing python packages listed in the .bat
file, through conda.
In the next step (of running Osdag_setup_x86), when the installer
prompts if you have Miniconda installed, just close the window and let the
installer continue.

3) Run Osdag_setup_x86.exe and follow on-screen instructions

# The default directory to install Osdag is the User Desktop.
You may choose any other location. However, DO NOT choose any of the
following locations:
a) Program Files
b) Program Files (x86)
c) ProgramData

Running Osdag:
=============
You need navigate to the Osdag-installation folder, in a command prompt, and
use the following command to run Osdag:
python osdagMainPage.py
# You need to replace 'python' in the above command with python from
the miniconda-package, if you opted not to register it as the system default python
You can create a batch file that contains the above command and create a
shortcut to Run Osdag.
===================================================================================
=============
===================================================================================
=============