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:
		NOTE: Installation of Miniconda2-latest-Windows-x86 is mandatory in 'C drive' only.
		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:
==============
# 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.

	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.
================================================================================================
================================================================================================