Difference between revisions of "Application Development Framework setup on Windows"

From Datonis
Jump to: navigation, search
(Creating dev setup page for Windows)
 
m
 
(12 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
== Download and install Mongodb ==
 
== Download and install Mongodb ==
 +
# Note that you will need a 64 bit Windows machine for this setup.
 +
# Download mongodb installer for '''Windows Server 2008 R2 64-bit and later, with SSL support x64''' from: [https://www.mongodb.com/download-center#community MongoDB Download Center]
 +
# Follow instructions from [https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/ Mongodb documentation] for:
 +
## Downloading and installing the correct version for your platform
 +
## Setting up paths for data and log storage
 +
## Setting up Mongodb as a Windows service
  
 
== Install Ruby ==
 
== Install Ruby ==
 +
Download and install Ruby version [https://dl.bintray.com/oneclick/rubyinstaller/rubyinstaller-2.3.3-x64.exe 2.3.3 x64] from https://rubyinstaller.org/downloads/
  
== Install development tools ==
+
Make sure you check the options to Add ruby to your system path during the installation. Refer screenshot below
 +
 
 +
[[File:Ruby-installation.png]]
 +
 
 +
== Install nodejs ==
 +
Download and install latest nodejs version for Windows x64 platform from https://nodejs.org/en/download/
 +
 
 +
== Install and configure development tools ==
 +
* Install MSYS2 for Windows x64 platform from: http://www.msys2.org/. For example the file name for 64-bit version would be similar to:  msys2-x86_64-20161025.exe
 +
* Run the msys2 shell (by navigating through the Start menu)
 +
 
 +
  [[File:Navigate-msys2.png|800x800px]]
 +
 
 +
* Install development tools by issuing command '''pacman -S mingw-w64-x86_64-toolchain.''' Select all option
 +
 
 +
  [[File:Install-compiler.png]]
 +
 
 +
* Similarly install make by issuing command '''pacman -S make'''
 +
* Also, install vim '''pacman -S vim'''
 +
* Open file ~/.bashrc using vim and add the following two lines at the end of the file:
 +
** export PATH=$PATH:/c/Ruby23-x64/bin:/c/Program\ Files/nodejs
 +
** alias vi=vim
 +
 
 +
  [[File:Edit-bashrc-rails.png]]
 +
 
 +
* Close the shell by typing '''exit'''
  
 
== Configure the application framework ==
 
== Configure the application framework ==
 +
* Run the msys2 shell
 +
* Navigate to the directory containing the app_framework
 +
* Run command '''gem install bundler'''
 +
* Next, run the command '''bundle install.''' Note that this will take a while to complete
 +
 +
  [[File:Bundle-install2.png]]
 +
* Close the shell by entering '''exit'''
  
 
== Starting the development web server ==
 
== Starting the development web server ==
 +
* Start windows command prompt
 +
* Navigate to the directory containing the app_framework
 +
* Run '''rake db:seed'''. This will create a default management user
 +
* Run '''rake setup:load'''. This will create default pages within the app
 +
* Next, you can start the server by entering command: '''rails s -p 3001'''
 +
 +
== Configuring the application ==
 +
* By default, the system generates an administrator with following credentials:
 +
** username: admin@appframework.com
 +
** password: admin123$
 +
* Open the [http://localhost:3001/admin_login admin page] in web browser and enter the above credentials. Make sure that the login works. Note that it will take a while to start for the first time. Basically a lot of javascript is getting compiled in the backend
 +
* On the Admin dashboard, you can add two types of users
 +
** Accounts on Datonis - These should be account administrators on several accounts on Datonis. All users on such accounts will be able to login to the application
 +
** Admin for the local application - These are local application administrators. You can add more users for application administration.

Latest revision as of 11:51, 17 August 2017

Follow the steps in the sequence described below:

Download and install Mongodb

  1. Note that you will need a 64 bit Windows machine for this setup.
  2. Download mongodb installer for Windows Server 2008 R2 64-bit and later, with SSL support x64 from: MongoDB Download Center
  3. Follow instructions from Mongodb documentation for:
    1. Downloading and installing the correct version for your platform
    2. Setting up paths for data and log storage
    3. Setting up Mongodb as a Windows service

Install Ruby

Download and install Ruby version 2.3.3 x64 from https://rubyinstaller.org/downloads/

Make sure you check the options to Add ruby to your system path during the installation. Refer screenshot below

Ruby-installation.png

Install nodejs

Download and install latest nodejs version for Windows x64 platform from https://nodejs.org/en/download/

Install and configure development tools

  • Install MSYS2 for Windows x64 platform from: http://www.msys2.org/. For example the file name for 64-bit version would be similar to:  msys2-x86_64-20161025.exe
  • Run the msys2 shell (by navigating through the Start menu)
 Navigate-msys2.png 
  • Install development tools by issuing command pacman -S mingw-w64-x86_64-toolchain. Select all option
 Install-compiler.png 
  • Similarly install make by issuing command pacman -S make
  • Also, install vim pacman -S vim
  • Open file ~/.bashrc using vim and add the following two lines at the end of the file:
    • export PATH=$PATH:/c/Ruby23-x64/bin:/c/Program\ Files/nodejs
    • alias vi=vim
 Edit-bashrc-rails.png
  • Close the shell by typing exit

Configure the application framework

  • Run the msys2 shell
  • Navigate to the directory containing the app_framework
  • Run command gem install bundler
  • Next, run the command bundle install. Note that this will take a while to complete
 Bundle-install2.png
  • Close the shell by entering exit

Starting the development web server

  • Start windows command prompt
  • Navigate to the directory containing the app_framework
  • Run rake db:seed. This will create a default management user
  • Run rake setup:load. This will create default pages within the app
  • Next, you can start the server by entering command: rails s -p 3001

Configuring the application

  • By default, the system generates an administrator with following credentials:
    • username: admin@appframework.com
    • password: admin123$
  • Open the admin page in web browser and enter the above credentials. Make sure that the login works. Note that it will take a while to start for the first time. Basically a lot of javascript is getting compiled in the backend
  • On the Admin dashboard, you can add two types of users
    • Accounts on Datonis - These should be account administrators on several accounts on Datonis. All users on such accounts will be able to login to the application
    • Admin for the local application - These are local application administrators. You can add more users for application administration.