Welcome to Scribd, the world's digital library. Read, publish, and share books and documents. See more
Download
Standard view
Full view
of .
Look up keyword
Like this
0Activity
0 of .
Results for:
No results containing your search query
P. 1
Install

Install

Ratings: (0)|Views: 0|Likes:
Published by Michael Shonukan

More info:

Published by: Michael Shonukan on Mar 25, 2012
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as TXT, PDF, TXT or read online from Scribd
See more
See less

03/25/2012

pdf

text

original

 
=====================HowtoinstallDjango=====================ThisdocumentwillgetyouupandrunningwithDjango.InstallPython==============BeingaPythonWebframework,DjangorequiresPython.ItworkswithanyPythonversionfrom2.4to2.7(duetobackwardsincompatibilitiesinPython3.0,DjangodoesnotcurrentlyworkwithPython3.0;see:doc:`theDjangoFAQ</faq/install>`formoreinformationonsupportedPythonversionsandthe3.0transition).GetPythonathttp://www.python.org.Ifyou'rerunningLinuxorMacOSX,youprobablyalreadyhaveitinstalled...admonition::DjangoonJythonIfyouuseJython_(aPythonimplementationfortheJavaplatform),you'llneedtofollowafewadditionalsteps.See:doc:`/howto/jython`fordetails..._jython:http://jython.org/InstallApacheandmod_wsgi=============================IfyoujustwanttoexperimentwithDjango,skipaheadtothenextsection;DjangoincludesalightweightWebserveryoucanusefortesting,soyouwon'tneedtosetupApacheuntilyou'rereadytodeployDjangoinproduction.IfyouwanttouseDjangoonaproductionsite,useApachewith`mod_wsgi`_.mod_wsgiissimilartomod_perl--itembedsPythonwithinApacheandloadsPythoncodeintomemorywhentheserverstarts.CodestaysinmemorythroughoutthelifeofanApacheprocess,whichleadstosignificantperformancegainsoverotherserverarrangements.MakesureyouhaveApacheinstalled,withthemod_wsgimoduleactivated.DjangowillworkwithanyversionofApachethatsupportsmod_wsgi.See:doc:`HowtouseDjangowithmod_wsgi</howto/deployment/modwsgi>`forinformationonhowtoconfiguremod_wsgionceyouhaveitinstalled.Ifyoucan'tusemod_wsgiforsomereason,fearnot:Djangosupportsmanyotherdeploymentoptions.Agreatsecondchoiceis:doc:`mod_python</howto/deployment/modpython>`,thepredecessortomod_wsgi.Additionally,DjangofollowstheWSGI_spec,whichallowsittorunonavarietyofserverplatforms.Seethe`server-arrangementswikipage`_forspecificinstallationinstructionsforeachplatform..._Apache:http://httpd.apache.org/.._mod_wsgi:http://code.google.com/p/modwsgi/.._WSGI:http://www.python.org/dev/peps/pep-0333/.._server-arrangementswikipage:http://code.djangoproject.com/wiki/ServerArrangements.._database-installation:
 
Getyourdatabaserunning=========================IfyouplantouseDjango'sdatabaseAPIfunctionality,you'llneedtomakesureadatabaseserverisrunning.DjangosupportsmanydifferentdatabaseserversandisofficiallysupportedwithPostgreSQL_,MySQL_,Oracle_andSQLite_(althoughSQLitedoesn'trequireaseparateservertoberunning).Inadditiontotheofficiallysupporteddatabases,therearebackendsprovidedby3rdpartiesthatallowyoutouseotherdatabaseswithDjango:*`SybaseSQLAnywhere`_ *`IBMDB2`_ *`MicrosoftSQLServer2005`_ *Firebird_ *ODBC_ TheDjangoversionsandORMfeaturessupportedbytheseunofficialbackendsvaryconsiderably.Queriesregardingthespecificcapabilitiesoftheseunofficialbackends,alongwithanysupportqueries,shouldbedirectedtothesupportchannelsprovidedbyeach3rdpartyproject.Inadditiontoadatabasebackend,you'llneedtomakesureyourPythondatabasebindingsareinstalled.*Ifyou'reusingPostgreSQL,you'llneedthepsycopg_package.Djangosupportsbothversion1and2.(WhenyouconfigureDjango'sdatabaselayer,specifyeither``postgresql``[forversion1]or``postgresql_psycopg2``[forversion2].)Youmightwanttorefertoour:ref:`PostgreSQLnotes<postgresql-notes>`forfurthertechnicaldetailsspecifictothisdatabase.Ifyou'reonWindows,checkouttheunofficial`compiledWindowsversion`_.*Ifyou'reusingMySQL,you'llneedMySQLdb_,version1.2.1p2orhigher.Youwillalsowanttoreadthedatabase-specific:ref:`notesfortheMySQLbackend<mysql-notes>`.*Ifyou'reusingSQLiteandPython2.4,you'llneedpysqlite_.Useversion2.0.3orhigher.Python2.5shipswithanSQLitewrapperinthestandardlibrary,soyoudon'tneedtoinstallanythingextrainthatcase.Pleasereadthe:ref:`SQLitebackendnotes<sqlite-notes>`.*Ifyou'reusingOracle,you'llneedacopyofcx_Oracle_,butpleasereadthedatabase-specific:ref:`notesfortheOraclebackend<oracle-notes>`forimportantinformationregardingsupportedversionsofbothOracleand``cx_Oracle``.*Ifyou'reusinganunofficial3rdpartybackend,pleaseconsultthedocumentationprovidedforanyadditionalrequirements.IfyouplantouseDjango's``manage.pysyncdb``commandtoautomaticallycreatedatabasetablesforyourmodels,you'llneedtoensurethatDjangohaspermissiontocreateandaltertablesinthedatabaseyou'reusing;ifyouplantomanuallycreatethetables,youcansimplygrantDjango``SELECT``,``INSERT``,``UPDATE``and``DELETE``permissions.Onsomedatabases,Djangowillneed``ALTERTABLE``privilegesduring``syncdb``butwon'tissue``ALTERTABLE``statementsonatableonce``syncdb``hascreatedit.
 
Ifyou'reusingDjango's:doc:`testingframework</topics/testing>`totestdatabasequeries,Djangowillneedpermissiontocreateatestdatabase..._PostgreSQL:http://www.postgresql.org/.._MySQL:http://www.mysql.com/.._psycopg:http://initd.org/pub/software/psycopg/.._compiledWindowsversion:http://stickpeople.com/projects/python/win-psycopg/.._MySQLdb:http://sourceforge.net/projects/mysql-python.._SQLite:http://www.sqlite.org/.._pysqlite:http://trac.edgewall.org/wiki/PySqlite.._cx_Oracle:http://cx-oracle.sourceforge.net/.._Oracle:http://www.oracle.com/.._SybaseSQLAnywhere:http://code.google.com/p/sqlany-django/.._IBMDB2:http://code.google.com/p/ibm-db/.._MicrosoftSQLServer2005:http://code.google.com/p/django-mssql/.._Firebird:http://code.google.com/p/django-firebird/.._ODBC:http://code.google.com/p/django-pyodbc/.._removing-old-versions-of-django:RemoveanyoldversionsofDjango=================================IfyouareupgradingyourinstallationofDjangofromapreviousversion,youwillneedtouninstalltheoldDjangoversionbeforeinstallingthenewversion.IfyouinstalledDjangousing``setup.pyinstall``,uninstallingisassimpleasdeletingthe``django``directoryfromyourPython``site-packages``.IfyouinstalledDjangofromaPythonegg,removetheDjango``.egg``file,andremovethereferencetotheegginthefilenamed``easy-install.pth``.Thisfileshouldalsobelocatedinyour``site-packages``directory...admonition::Wherearemy``site-packages``stored?Thelocationofthe``site-packages``directorydependsontheoperatingsystem,andthelocationinwhichPythonwasinstalled.Tofindoutyoursystem's``site-packages``location,executethefollowing:..code-block::bashpython-c"fromdistutils.sysconfigimportget_python_lib;printget_python_lib()"(Notethatthisshouldberunfromashellprompt,notaPythoninteractiveprompt.).._install-django-code:InstalltheDjangocode=======================Installationinstructionsareslightlydifferentdependingonwhetheryou'reinstallingadistribution-specificpackage,downloadingthelatestofficialrelease,orfetchingthelatestdevelopmentversion.It'seasy,nomatterwhichwayyouchoose.

You're Reading a Free Preview

Download
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->