[IMP] install doc: wording, windows instructions post-2.7.9
This commit is contained in:
parent
a472c4cfc9
commit
cbb0ad80cd
|
@ -35,8 +35,8 @@ This documents attempts to describe most of the installation options.
|
||||||
deployment.
|
deployment.
|
||||||
|
|
||||||
The source code can be obtained by downloading a tarball or using git.
|
The source code can be obtained by downloading a tarball or using git.
|
||||||
Using git makes it easier to update, switching between multiple versions
|
Using git makes it easier to update, switch between multiple versions
|
||||||
and contribute.
|
(including the current development version) or contribute.
|
||||||
|
|
||||||
.. _setup/install/demo:
|
.. _setup/install/demo:
|
||||||
|
|
||||||
|
@ -202,26 +202,26 @@ edit a configuration file.
|
||||||
Finally it provides greater control over the system's set up, and allows more
|
Finally it provides greater control over the system's set up, and allows more
|
||||||
easily keeping (and running) multiple versions of Odoo side-by-side.
|
easily keeping (and running) multiple versions of Odoo side-by-side.
|
||||||
|
|
||||||
There are two way to get the odoo sourcei source tarball or git.
|
There are two way to get the odoo source source zip or git.
|
||||||
|
|
||||||
Using git allows simpler update and easier switching between differents
|
* Odoo zip can be downloaded from
|
||||||
versions of Odoo. It also simplifies maintaining non-module patches and
|
https://nightly.odoo.com/8.0/nightly/src/odoo_8.0.latest.zip, the zip file
|
||||||
contributions. The primary drawback of git is that it is significantly larger
|
then needs to be uncompressed to use its content
|
||||||
than a tarball as it contains the entire history of the Odoo project.
|
|
||||||
|
|
||||||
The Odoo tarball can be downloaded from
|
* git allows simpler update and easier switching between differents versions
|
||||||
https://nightly.odoo.com/8.0/nightly/src/odoo_8.0-latest.tar.gz
|
of Odoo. It also simplifies maintaining non-module patches and
|
||||||
|
contributions. The primary drawback of git is that it is significantly
|
||||||
|
larger than a tarball as it contains the entire history of the Odoo project.
|
||||||
|
|
||||||
On windows `7-Zip <http://www.7-zip.org>`_ may be use to decompress the archive
|
The git repository is https://github.com/odoo/odoo.git.
|
||||||
as Windows does not handle .tar.gz archives natively.
|
|
||||||
|
|
||||||
The git repository is https://github.com/odoo/odoo.git and can be cloned using
|
Downloading it requires a `a git client <http://git-scm.com/download/>`_
|
||||||
the command
|
(which may be available via your distribution on linux) and can be performed
|
||||||
|
using the following command:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
$ git clone https://github.com/odoo/odoo.git
|
|
||||||
|
|
||||||
|
$ git clone https://github.com/odoo/odoo.git
|
||||||
|
|
||||||
Installing dependencies
|
Installing dependencies
|
||||||
-----------------------
|
-----------------------
|
||||||
|
@ -230,16 +230,21 @@ Source installation requires manually installing dependencies:
|
||||||
|
|
||||||
* Python 2.7.
|
* Python 2.7.
|
||||||
|
|
||||||
- on Linux, already included
|
- on Linux and OS X, included by default
|
||||||
- on OS X, already included
|
- on Windows, use `the official Python 2.7.9 installer
|
||||||
- on Windows, use `the official Python 2.7 installer
|
|
||||||
<https://www.python.org/downloads/windows/>`_.
|
<https://www.python.org/downloads/windows/>`_.
|
||||||
|
|
||||||
|
.. warning:: select "add python.exe to Path" during installation, and
|
||||||
|
reboot afterwards to ensure the :envvar:`PATH` is updated
|
||||||
|
|
||||||
|
.. note:: if Python is already installed, make sure it is 2.7.9, previous
|
||||||
|
versions are less convenient and 3.x versions are not compatible
|
||||||
|
with Odoo
|
||||||
|
|
||||||
* PostgreSQL, to use a local database
|
* PostgreSQL, to use a local database
|
||||||
|
|
||||||
After installation you will need to create a postgres user (also named a
|
After installation you will need to create a postgres user: by default the
|
||||||
role), by default the only user is ``postgres``, and Odoo forbids connecting
|
only user is ``postgres``, and Odoo forbids connecting as ``postgres``.
|
||||||
as ``postgres``.
|
|
||||||
|
|
||||||
- on Linux, use your distribution's package, then create a postgres user
|
- on Linux, use your distribution's package, then create a postgres user
|
||||||
named like your login:
|
named like your login:
|
||||||
|
@ -252,37 +257,43 @@ Source installation requires manually installing dependencies:
|
||||||
use without a password.
|
use without a password.
|
||||||
|
|
||||||
- on OS X, `postgres.app <http://postgresapp.com>`_ is the simplest way to
|
- on OS X, `postgres.app <http://postgresapp.com>`_ is the simplest way to
|
||||||
get started, then create a postgres user like on Linux.
|
get started, then create a postgres user as on Linux
|
||||||
|
|
||||||
- on Windows, use `PostgreSQL for windows`_ then add PostgreSQL's ``bin``
|
- on Windows, use `PostgreSQL for windows`_ then
|
||||||
directory (default: ``C:\Program Files\PostgreSQL\9.3\bin``) to your
|
|
||||||
:envvar:`PATH`
|
|
||||||
|
|
||||||
Then create a postgres user with a password using the pg admin gui, for
|
- add PostgreSQL's ``bin`` directory (default:
|
||||||
example login ``odoo`` and password ``odoo``.
|
``C:\Program Files\PostgreSQL\9.4\bin``) to your :envvar:`PATH`
|
||||||
|
- create a postgres user with a password using the pg admin gui: open
|
||||||
|
pgAdminIII, double-click the server to create a connection, select
|
||||||
|
:menuselection:`Edit --> New Object --> New Login Role`, enter the
|
||||||
|
usename in the :guilabel:`Role Name` field (e.g. ``odoo``), then open
|
||||||
|
the :guilabel:`Definition` tab and enter the password (e.g. ``odoo``),
|
||||||
|
then click :guilabel:`OK`.
|
||||||
|
|
||||||
This user and password will be provided with the -w and -r option or in the
|
The user and password must be passed to Odoo using either the
|
||||||
config file.
|
:option:`-w <odoo.py -w>` and :option:`-r <odoo.py -r>` options or
|
||||||
|
:ref:`the configuration file <reference/cmdline/config>`
|
||||||
|
|
||||||
* Python dependencies listed in the :file:`requirements.txt` file.
|
* Python dependencies listed in the :file:`requirements.txt` file.
|
||||||
|
|
||||||
|
- on Linux, python dependencies may be installable with the system's package
|
||||||
- on Linux python dependencies may be installable with the system's package
|
|
||||||
manager or using pip.
|
manager or using pip.
|
||||||
|
|
||||||
For libraries using native code (Pillow, lxml, greenlet, gevent, psycopg2) it
|
For libraries using native code (Pillow, lxml, greenlet, gevent, psycopg2,
|
||||||
may be necessary to install development tools and native dependencies before
|
ldap) it may be necessary to install development tools and native
|
||||||
pip is able to install the dependencies themselves. These are available in
|
dependencies before pip is able to install the dependencies themselves.
|
||||||
``-dev`` or ``-devel`` packages for Python, Postgres, libxml2, libxslt and
|
These are available in ``-dev`` or ``-devel`` packages for Python,
|
||||||
libevent. Then the dependecies can be installed using
|
Postgres, libxml2, libxslt, libevent and libsasl2. Then the Python
|
||||||
|
dependecies can themselves be installed:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
$ pip install -r requirements.txt
|
$ pip install -r requirements.txt
|
||||||
|
|
||||||
- on OS X, install the Command Line Tools (``xcode-select --install``) the
|
- on OS X, you will need to install the Command Line Tools
|
||||||
native dependency via your preferred package manager (macports_,
|
(``xcode-select --install``) then download and install a package manager
|
||||||
homebrew_). Then pip can be used.
|
of your choice (homebrew_, macports_) to install non-Python dependencies.
|
||||||
|
pip can then be used to install the Python dependencies as on Linux:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
|
@ -294,70 +305,66 @@ Source installation requires manually installing dependencies:
|
||||||
Install ``psycopg`` using the installer here
|
Install ``psycopg`` using the installer here
|
||||||
http://www.stickpeople.com/projects/python/win-psycopg/
|
http://www.stickpeople.com/projects/python/win-psycopg/
|
||||||
|
|
||||||
Install ``pip`` from http://www.lfd.uci.edu/~gohlke/pythonlibs/
|
|
||||||
|
|
||||||
Then edit the requirements.txt file:
|
Then edit the requirements.txt file:
|
||||||
|
|
||||||
- remove ``psycopg`` as you already have it.
|
- remove ``psycopg2`` as you already have it.
|
||||||
|
- remove the optional ``python-ldap``, ``gevent`` and ``psutil`` because
|
||||||
- remove the optional ``python-ldap``, ``gevent`` and ``psutil`` because they
|
they require compilation.
|
||||||
require compilation.
|
|
||||||
|
|
||||||
- add ``pypiwin32`` because it's needed under windows.
|
- add ``pypiwin32`` because it's needed under windows.
|
||||||
|
|
||||||
Then use pip to install install the dependecies using the following command
|
Then use pip to install install the dependencies using the following
|
||||||
from a cmd.exe prompt
|
command from a cmd.exe prompt (replace ``\YourOdooPath`` by the actual
|
||||||
|
path where you downloaded Odoo):
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: ps1
|
||||||
|
|
||||||
C:\> cd \YourOdooPath
|
C:\> cd \YourOdooPath
|
||||||
C:\YourOdooPath> C:\Python27\Scripts\pip.exe install -r requirements.txt
|
C:\YourOdooPath> C:\Python27\Scripts\pip.exe install -r requirements.txt
|
||||||
|
|
||||||
* Less css compiler via nodejs
|
* *Less CSS* via nodejs
|
||||||
|
|
||||||
- on Linux, use your distribution's package to install nodejs and npm.
|
- on Linux, use your distribution's package manager to install nodejs and
|
||||||
|
npm.
|
||||||
|
|
||||||
In debian wheezy and Ubuntu 13.10 and before you need to install nodejs
|
.. warning::
|
||||||
manually.
|
|
||||||
|
|
||||||
.. code-block:: console
|
In debian wheezy and Ubuntu 13.10 and before you need to install
|
||||||
|
nodejs manually:
|
||||||
|
|
||||||
$ wget -qO- https://deb.nodesource.com/setup | bash -
|
.. code-block:: console
|
||||||
$ apt-get install -y nodejs
|
|
||||||
|
|
||||||
Starting from jessie and Ubuntu 14.04 the distribution's package works. But
|
$ wget -qO- https://deb.nodesource.com/setup | bash -
|
||||||
you may need to had a symlink as npm packages shebngs uses node whereas
|
$ apt-get install -y nodejs
|
||||||
debian uses nodejs.
|
|
||||||
|
|
||||||
.. code-block:: console
|
In later debian (>jessie) and ubuntu (>14.04) you may need to add a
|
||||||
|
symlink as npm packages call ``node`` but debian calls the binary
|
||||||
|
``nodejs``
|
||||||
|
|
||||||
$ apt-get install -y npm
|
.. code-block:: console
|
||||||
$ sudo ln -s /usr/bin/nodejs /usr/bin/node
|
|
||||||
|
|
||||||
Once you have npm working, install less and less-plugin-clean-css.
|
$ apt-get install -y npm
|
||||||
|
$ sudo ln -s /usr/bin/nodejs /usr/bin/node
|
||||||
|
|
||||||
|
Once npm is installed, use it to install less and less-plugin-clean-css:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
$ sudo npm install -g less less-plugin-clean-css
|
$ sudo npm install -g less less-plugin-clean-css
|
||||||
|
|
||||||
|
- on OS X, install nodejs via your preferred package manager (homebrew_,
|
||||||
|
macports_) then install less and less-plugin-clean-css:
|
||||||
- on OS X, install nodejs via your preferred package manager (macports_,
|
|
||||||
homebrew_) then install less and less-plugin-clean-css.
|
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
$ sudo npm install -g less less-plugin-clean-css
|
$ sudo npm install -g less less-plugin-clean-css
|
||||||
|
|
||||||
|
- on Windows, `install nodejs <http://nodejs.org/download/>`_, reboot (to
|
||||||
|
update the :envvar:`PATH`) and install less and less-plugin-clean-css:
|
||||||
|
|
||||||
- on Windows, install nodejs then reboot and install less and
|
.. code-block:: ps1
|
||||||
less-plugin-clean-css.
|
|
||||||
|
|
||||||
.. code-block:: console
|
|
||||||
|
|
||||||
C:\> npm install -g less less-plugin-clean-css
|
C:\> npm install -g less less-plugin-clean-css
|
||||||
|
|
||||||
|
|
||||||
Running Odoo
|
Running Odoo
|
||||||
------------
|
------------
|
||||||
|
|
||||||
|
@ -373,29 +380,30 @@ Common necessary configurations are:
|
||||||
|
|
||||||
Odoo has no defaults beyond
|
Odoo has no defaults beyond
|
||||||
`psycopg2's defaults <http://initd.org/psycopg/docs/module.html>`_: connects
|
`psycopg2's defaults <http://initd.org/psycopg/docs/module.html>`_: connects
|
||||||
over a UNIX socket on port 5432 with the current user and no password.
|
over a UNIX socket on port 5432 with the current user and no password. By
|
||||||
|
default this should work on Linux and OS X, but it *will not work* on
|
||||||
|
windows as it does not support UNIX sockets.
|
||||||
|
|
||||||
* Custom addons path beyond the defaults, to load your own modules
|
* Custom addons path beyond the defaults, to load your own modules
|
||||||
|
|
||||||
Under Windows a typical way to execute odoo would be:
|
Under Windows a typical way to execute odoo would be:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: ps1
|
||||||
|
|
||||||
C:\YourOdooPath> python odoo.py -w odoo -r odoo --addons-path=addons,../mymodules --db-filter=mydb$
|
C:\YourOdooPath> python odoo.py -w odoo -r odoo --addons-path=addons,../mymodules --db-filter=mydb$
|
||||||
|
|
||||||
Where ``odoo``, ``odoo`` are the postgresql login and password,
|
Where ``odoo``, ``odoo`` are the postgresql login and password,
|
||||||
``../mymodules`` a directory with additional addons and ``mydb`` the default db
|
``../mymodules`` a directory with additional addons and ``mydb`` the default
|
||||||
to serve on localhost:8069
|
db to serve on localhost:8069
|
||||||
|
|
||||||
Under Unix a typical way to execute odoo would be:
|
Under Unix a typical way to execute odoo would be:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
$ ./odoo.py --addons-path=addons,../mymodules --db-filter=mydb$
|
$ ./odoo.py --addons-path=addons,../mymodules --db-filter=mydb$
|
||||||
|
|
||||||
Where ``../mymodules`` is a directory with additional addons and ``mydb`` the default db
|
|
||||||
to serve on localhost:8069
|
|
||||||
|
|
||||||
|
Where ``../mymodules`` is a directory with additional addons and ``mydb`` the
|
||||||
|
default db to serve on localhost:8069
|
||||||
|
|
||||||
.. _demo: https://demo.odoo.com
|
.. _demo: https://demo.odoo.com
|
||||||
.. _EPEL: https://fedoraproject.org/wiki/EPEL
|
.. _EPEL: https://fedoraproject.org/wiki/EPEL
|
||||||
|
|
Loading…
Reference in New Issue