Install Terminator¶
Want to try Terminator? This guide will guide you through installing Terminator and its requirements.
Before proceeding, consider installing these first:
- At least Python 2.6
- python-pip installer
- git distributed version control system
- A database management system like PostgreSQL or MySQL
- The Python bindings for the installed database management system
- Optionally a mail server
Local installation¶
In order to install Terminator run the following commands:
$ sudo pip install virtualenvwrapper
$ mkvirtualenv <env-name>
(env-name) $ git clone https://github.com/translate/terminator.git
(env-name) $ cd terminator
(env-name) $ pip install -r requirements/base.txt
Creating a Database¶
It is necessary to create a database to store all Terminator data. This database must be UTF-8 encoded. You can give it any name. How to create that database is out of this documents scope, so please refer to your database documentation.
Warning
This database must be UTF-8 encoded.
Customizing the Configuration¶
The initial configuration includes settings that most likely you are going to change, for example you must change the DATABASES setting to match your database settings (database engine, database name, database user,...), or change the DEBUG, SECRET_KEY, TIME_ZONE, EMAIL_PORT or ADMINS settings.
Note
If you are going to use a mail server perhaps you will have to customize other Django settings not included in Terminator configuration. If this is the case then just add those settings to Django configuration file.
Setting Up the Database¶
Before your run Terminator for the first time, you need to create the schema for the database and populate it with initial data. This is done by executing the syncdb management command:
(env-name) $ cd project
(env-name) $ python manage.py syncdb --noinput
Running Terminator¶
To run it, just issue:
(env-name) $ python manage.py runserver
And the server will start listening on port 8000. This can be accessed from your
web browser at http://localhost:8000/
.
This default installation already provides several default user accounts with different roles:
- User usuario with password usuario (has superuser role)
- User dono with password dono
- User lexi with password lexi
- User term with password term
If you want to try the import feature you have to use the usuario user account. You may test it using TBX files like the ones provided by Proxecto Trasno.
Deploying Terminator using a Web Server¶
If you want to deploy Terminator using a web server like Apache, please refer to Django deployment documentation.