add reference on how to create the database after installation

This commit is contained in:
Julien Fastré 2014-12-04 16:33:54 +01:00
parent ec446826a3
commit cc6326bc15
3 changed files with 58 additions and 3 deletions

View File

@ -24,6 +24,7 @@ Contents of this documentation:
:maxdepth: 2
installation/installation.rst
installation/install_new_bundles.rst
development/index.rst

View File

@ -0,0 +1,16 @@
.. Copyright (C) 2014 Champs Libres Cooperative SCRLFS
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License".
.. _install-new-bundles:
Install new bundles to your installation
########################################
.. todo::
the section "install new bundles" must be written. Help appreciated :-)

View File

@ -107,12 +107,22 @@ Composer will download `the standard architecture`_ and ask you a few question a
You may accept the default parameters of `debug_toolbar`, `debug_redirects` and `use_assetic_controller` for a demonstration installation. For production, set them all to `false`.
.. note::
If composer ask you the following question : ::
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?
You may answer `Y` (Yes), or simply press the `return` button.
.. note::
At the end of your installation, composer will warn you to execute database migration script, with this message : ::
Some migration files have been imported. You should run `php app/console doctrine:migrations:status` and/or `php app/console doctrine:migrations:migrate` to apply them to your DB.
We will proceed to this step some steps further. See :ref:`create-database-schema`.
Check your requirements
^^^^^^^^^^^^^^^^^^^^^^^
@ -125,6 +135,34 @@ You should check your installation by running
Which will give you information about how your installation fullfill the requirements to running Chill, and give you advices to optimize your installation.
.. _create-database-schema:
Create your database schema
^^^^^^^^^^^^^^^^^^^^^^^^^^^
This step will create your table and minimum information into your database. Simply run
.. code-block:: bash
php app/console doctrine:migrations:migrate
SQL queries will be printed into your console.
Populate your database with basic information
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Once your database schema is ready, you should populate your database with some basic information. Those are provided through scripts and might depends from the bundle you choose to install (see :ref:`install-new-bundles`)
The main bundle require two scripts to be executed :
.. code-block:: bash
php app/console chill:main:countries:populate
php app/console chill:main:languages:populate
Those will populate database, respectively, with countries (using ISO declaration) and languages (using, also, ISO informations).
Launch your server
^^^^^^^^^^^^^^^^^^