README for Osdag installation and use ====================================== System Requirements: ==================== Supported Operating Systems: Windows Vista Windows 7, Windows 8, Windows 8.1, Windows 10 Supported Architecture: 64-bit RAM and Storage Space: Minimum 2 Gb RAM recommended Minimum 4 Gb free storage space recommended ================================================================================================ ================================================================================================ Basic User: =========== 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:\Program Files (x86)\Miniconda2"] 1. After selecting the “Program Files (x86)\” directory, manually type “Miniconda2” (without quotes) 2. If an error message appears saying, “The installation directory has 2 spaces”, ignore it by clicking OK. 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 Osdag_setup_x86.exe and follow on-screen instructions # The default directory to install Osdag is the User’s 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: i) double-clicking on the Desktop shortcut or ii) double-clicking on the Start Menu shortcut or iii) navigating to the installation-directory and double-clicking on 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 a) If you already are a Miniconda/Anaconda user:- i) Navigate to the "dependencies" folder in the installation-directory ii) Open the "install_osdag_dependencies.bat" in a text editor and iii) Manually install the missing python packages listed in the .bat file, through conda. iv) In Step 3 ("Run Osdag_setup_x86"), when the installer prompts if you have Miniconda installed, just close the window and let the installer continue. b) If you do not have Miniconda installed and are OK with installing it and but do not wish to Register Anaconda as the default Python 2.7: i) First install Miniconda2-latest-Windows-x86.exe (same as the basic user) BUT follow the steps in the "Running Osdag" section below, instead of the "Running Osdag" steps of the basic user. 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 may choose to create a batch file that contains the above command and create a shortcut to Run Osdag. ================================================================================================ ================================================================================================