diff options
author | Ila | 2019-05-20 20:12:59 +0000 |
---|---|---|
committer | Ila | 2019-05-20 20:12:59 +0000 |
commit | 2fb6e00051c2502dc4b6941c9f59359fef4f4ba1 (patch) | |
tree | 257051baa164708be82737172b3e8803e62329c8 | |
parent | bf0968941ff5053a1b6626b1c6d8854a93c9ac7b (diff) |
changed readme!
-rw-r--r-- | README.rst | 55 | ||||
-rw-r--r-- | readme.md | 63 |
2 files changed, 63 insertions, 55 deletions
diff --git a/README.rst b/README.rst deleted file mode 100644 index 0ad0d43..0000000 --- a/README.rst +++ /dev/null @@ -1,55 +0,0 @@ -PostgreSQL Performance Farm -=========================== - -This repository contains the code for the PostgreSQL Performance Farm. - -IMPORTANT: migrating from Python2 to Python3 is in progress, hence why code might not work - for any issues feel free to contact @ila at [email protected] - -<<<<<<< HEAD - -======= ->>>>>>> refs/remotes/origin/master -web/ ----- - -The web/ directory contains the Django application that forms the basis of the -website. In order to run the site, you will need to setup a Python virtualenv, -e.g:: - - $ sudo pip install virtualenvwrapper - $ source /usr/local/bin/virtualenvwrapper.sh - $ mkvirtualenv pgperffarm - -For ease of future use, configure virtualenvs from your .bash_profile:: - - $ echo "source /usr/local/bin/virtualenvwrapper.sh" >> ~/.bash_profile - -To activate the environment in future sessions, run:: - - $ workon pgperffarm - -Then, install the required modules. Note that we use Django 1.8.11 as that's -what is currently supported on the postgresql.org infrastructure:: - - $ PATH=$PATH:/usr/local/pgsql/bin pip install -r web/requirements.txt - -Next, create a settings_local.py file:: - - $ cp web/pgperffarm/settings_local.py.in web/pgperffarm/settings_local.py - -Edit the file and change the database configuration and other settings to suit -your environment. Make sure you create the required database and user account -on your PostgreSQL server. - -Finally, synchronise the database:: - - $ cd web - $ python manage.py makemigrations - $ python manage.py migrate - -That should be all. To test, run the following command and point a browser at -the URL shown:: - - $ python manage.py runserver - -You should see the index page of the application. diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..a6da04f --- /dev/null +++ b/readme.md @@ -0,0 +1,63 @@ +# PostgreSQL Performance Farm + +This repository contains the code for the PostgreSQL Performance Farm. + +IMPORTANT: migrating from Python2 to Python3 is in progress, hence why code might not work - for any issues feel free to contact @ila at [email protected] + +---- + +#### Configuration + +```bash +refs/remotes/origin/masterweb/ +``` + +The web/ directory contains the Django application that forms the basis of the website. In order to run the site, you will need to setup a Python `virtualenv`, e.g: + +```bash +$ sudo pip install virtualenvwrapper +$ source /usr/local/bin/virtualenvwrapper.sh +$ mkvirtualenv pgperffarm +``` + +For ease of future use, configure virtualenvs from your `.bash_profile`: + +```bash +$ echo "source /usr/local/bin/virtualenvwrapper.sh" >> ~/.bash_profile +``` + +To activate the environment in future sessions, run: + +```bash +$ workon pgperffarm +``` + +Then, install the required modules. Note that we use Django 1.8 as that's what is currently supported on the postgresql.org infrastructure: + +```bash +$ PATH=$PATH:/usr/local/pgsql/bin pip install -r web/requirements.txt +``` + +Next, create a `settings_local.py` file:: + +```bash +$ cp web/pgperffarm/settings_local.py.in web/pgperffarm/settings_local.py +``` + +Edit the file and change the database configuration and other settings to suit your environment. Make sure you create the required database and user account on your PostgreSQL server. + +Finally, synchronise the database: + +```bash +$ cd web +$ python manage.py makemigrations +$ python manage.py migrate +``` + +That should be all. To test, run the following command and point a browser at the URL shown: + +```bash +$ python manage.py runserver +``` + +You should see the index page of the application.
\ No newline at end of file |