You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

82 lines
2.4 KiB

  1. INSTALL.txt
  2. ===========
  3. Web Notes Framework Installation guide
  4. Web Notes Framework (WNF) is a meta-data driven web app framework. After install, you build
  5. and configure your application from the web browser.
  6. WNF requires the following applications
  7. 1. Python
  8. 2. MySQL
  9. 3. MySQL-Python (connector)
  10. 4. simplejson (for Python 2.4 or lower)
  11. 5. email (for Python 2.4 or lower)
  12. 6. pytz (easy_install pytz)
  13. 7. Apache
  14. 8. PIL (optional - for image processing (thumbnails etc)
  15. - yum install libjpeg-devel
  16. - yum install python-imaging
  17. )
  18. ------------------------------------------------------------------------
  19. 1. Create a databse instance for your application
  20. Call the install script with the following options. For more options use -h
  21. python [folder]/cgi-bin/webnotes/install_lib/install.py MYSQL_ROOT_LOGIN MYSQL_ROOT_PASSWORD DBNAME
  22. ------------------------------------------------------------------------
  23. 2. Setup defs.py
  24. The framework picks up the database details from cgi-bin/webnotes/defs.py
  25. You need to edit this file and set your database name and other options
  26. ------------------------------------------------------------------------
  27. 3. Configuring Apache
  28. a. You must set Apache to execute index.cgi file, one way to do this is to add cgi handler
  29. and add ExecCGI in the options directive.
  30. b. You can also add couple of lines below to block Apache from rendering .py files
  31. RewriteEngine on
  32. RewriteRule \.py - [F]
  33. c. Add "index.cgi" to DirectoryIndex
  34. ------------------------------------------------------------------------
  35. 4. Login to application
  36. Start Apache, go to your web-browser and point to the folder where you installed the framework
  37. The default logins are:
  38. login: Administrator
  39. password: admin
  40. ------------------------------------------------------------------------
  41. Step by step instructions on CentOS/Fedora:
  42. 0.Check out the source code.
  43. 1. Modify the v170/cgi-bin/webnotes/defs file to your required settings and rename it to defs.py
  44. 2. yum install mysql
  45. 3. yum install httpd
  46. 4. yum install MySQL-python
  47. 5. yum install python-setuptools
  48. 6. easy_install pytz
  49. 7. easy_install email
  50. 8. easy_install simplejson suds
  51. 9. easy_install pygeoip (optional for geo ip)
  52. 9. yum install libjpeg-devel (optional)
  53. 10.yum install python-imaging (optional)
  54. 11. Edit /etc/httpd/conf/httpd.conf and add the options as mentioned above.
  55. 12. from the trunk/v170/cgi-bin folder run python webnotes/install_lib/install.py install