source: INSTALL @ 8fdcce4

cremcrem2crem3devdev2diademsdj1.6feature/breadcrumbsfeature/ts-0.5feature/ts-0.5.4feature/writecacheformagenericinstru_searchlamlam2mapsv3mergenlivemultiprobproductionrelease/1.4.4sabiodsearchsecurityserversocialstoragetelecastertestvideo
Last change on this file since 8fdcce4 was 8fdcce4, checked in by yomguy <yomguy@…>, 4 years ago

fix mimetype analyzer (telemeta side), fix csrf for login, (re)add TEMPLATE_CONTEXT_PROCESSORS to settings

  • Property mode set to 100644
File size: 5.1 KB
Line 
1==================
2Telemeta - INSTALL
3==================
4
5-----------------
60. Requirements
7-----------------
8
9Telemeta is designed to run on Linux and other UNIX based architectures.
10It depends on several python librairies like Django (version >= 1.1.1).
11See http://djangoproject.com.
12
13Other needed librairies are listed below.
14
15-----------------------
161. Install the software
17-----------------------
18
19Install the dependencies
20-------------------------
21
22* On Debian (Squeeze recommended) or Ubuntu Lucid:
23
24    Install all dependencies like this::
25       
26        sudo aptitude install python python-xml python-mutagen python-django \
27                              python-imaging python-mysqldb mysql-server python-numpy python-scipy \
28                              python-ctypes python-setuptools python-support python-docutils
29
30    Just add these lines to your /etc/apt/sources-list::
31
32        deb http://debian.parisson.org/ binary/
33        deb-src http://debian.parisson.org/ source/
34        deb http://www.debian-multimedia.org stable main
35
36    Then::
37
38        sudo apt-get update
39
40* On other linux platforms:
41
42    Please install all dependencies thanks to your application manager.
43
44
45Install TimeSide
46-----------------
47
48In order to get all the Web Audio Components from TimeSide,
49you have to download and install it from source.
50
51So, checkout the last archives at :
52http://code.google.com/p/timeside/downloads/list
53
54Install it like in the following example::
55
56    tar xzf timeside-0.2.tar.gz
57    cd timeside-0.2
58
59Read the README and INSTALL file, install dependencies and then::
60
61    sudo python setup.py install
62
63
64Install Telemeta
65------------------
66
67* On Debian style systems, if you have added our repositories::
68
69    sudo apt-get install telemeta
70
71* Else:
72
73    Download the latest release of telemeta at
74    http://telemeta.org
75
76    Uncompress the archive like::
77
78        tar xzvf telemeta_0.5.1.tar.gz
79
80    Go to the main folder of telemeta and run this command
81    in a shell as root::
82
83        sudo python setup.py install
84
85
86--------------------------
872. Create a Django project
88--------------------------
89
90If you haven't already done it, start a new django project::
91
92    cd ~/my_projects
93    django-admin startproject mysite
94
95
96-----------------------------------------
973. Create the media and cache directories
98-----------------------------------------
99
100We need 2 directories for media and caching::
101
102    cd mysite
103    mkdir media cache cache/data cache/export
104
105
106You might want to place these data directories somewhere else, no pb.
107
108
109----------------------------------
1104. Configure the telemeta project
111----------------------------------
112
113Edit the file settings.py in a text editor.
114Modifiy the following variables:
115
116    ADMINS =            telemeta requires that you indicate an administrator here
117    DATABASES =         your database setting dict (don't forget to create the database if needed)
118    MEDIA_ROOT =        absolute path to the media directory you just created
119    INSTALLED_APPS =    add 'telemeta' to the tuple
120   
121Add the following variables:
122   
123    TEMPLATE_CONTEXT_PROCESSORS = (
124        'django.core.context_processors.request',
125        'django.core.context_processors.auth',)
126
127    TELEMETA_ORGANIZATION =  name of the organization which hosts this installation
128    TELEMETA_SUBJECTS =      tuple of subject keywords (used for Dublin Core), such as "Ethnology", etc...
129    TELEMETA_CACHE_DIR =     absolute path to the cache directory that you just created
130    TELEMETA_GMAP_KEY =      your Google Map API key
131    TELEMETA_DOWNLOAD_ENABLED =  True to enable audio data download
132
133Just paste the lines below::
134
135    LOGIN_URL = '/login'
136    LOGIN_REDIRECT_URL = '/'
137    TELEMETA_EXPORT_CACHE_DIR = TELEMETA_CACHE_DIR + "/export"
138    TELEMETA_DATA_CACHE_DIR = TELEMETA_CACHE_DIR + "/data"
139    CACHE_BACKEND = "file://" + TELEMETA_CACHE_DIR + "/data"
140
141
142--------------------------
1435. Initialize the database
144--------------------------
145
146This synchronizes the DB with the model::
147
148    python manage.py syncdb
149
150
151----------------------
1526. Configure your urls
153----------------------
154
155    The simplest case is to have telemeta running at public root. To do so, add this url in urls.py::
156
157    (r'^', include('telemeta.urls')),
158
159
160--------------------
1617. Start the project
162--------------------
163
164We are ready to start the telemeta server::
165
166    python manage.py runserver
167
168By default, the server starts on the port 8000. You can override this with, for example::
169
170    python manage.py runserver 9000
171
172
173------------------------------------
1748. Go the web page with your browser
175------------------------------------
176
177    http://localhost:8000
178
179    or
180
181    http://localhost:9000
182
183Enjoy it !
184
185-------------------
1869. Configure Apache
187-------------------
188
189If you want to use Telemeta through a web server, it is highly recommended to use Apache 2
190with the mod_wsgi module as explained in the following page :
191
192http://docs.djangoproject.com/en/1.1/howto/deployment/modwsgi/#howto-deployment-modwsgi
193
194This will prevent Apache to put some audio data in the cache memory as it is usually the case with mod_python.
195
196-------------------------
19710. Contact / More infos
198-------------------------
199
200See README and http://telemeta.org.
201
202
Note: See TracBrowser for help on using the repository browser.