doc/book/en/admin/setup.rst
author Paul Tonelli <paul.tonelli@logilab.fr>
Thu, 29 Aug 2013 18:26:06 +0200
branchstable
changeset 9268 fc24e783dca5
parent 8597 293a595f4365
child 9269 7aa57201b0cd
permissions -rw-r--r--
[doc] additional documentation about pip install under both Windows and Debian
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     1
.. -*- coding: utf-8 -*-
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     2
1224
a9da8a8f0b19 [doc] Change id to english.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 221
diff changeset
     3
.. _SetUpEnv:
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     4
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
     5
Installation of a *CubicWeb* environment
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
     6
========================================
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
     7
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
     8
Official releases are available from the `CubicWeb.org forge`_ and from
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
     9
`PyPI`_. Since CubicWeb is developed using `Agile software development
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    10
<http://en.wikipedia.org/wiki/Agile_software_development>`_ techniques, releases
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    11
happen frequently. In a version numbered X.Y.Z, X changes after a few years when
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    12
the API breaks, Y changes after a few weeks when features are added and Z
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    13
changes after a few days when bugs are fixed.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    14
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    15
Depending on your needs, you will chose a different way to install CubicWeb on
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    16
your system:
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    17
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    18
- `Installation on Debian/Ubuntu`_
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    19
- `Installation on Windows`_
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    20
- `Installation in a virtualenv`_
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    21
- `Installation with pip`_
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    22
- `Installation with easy_install`_
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    23
- `Installation from tarball`_
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
    24
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    25
If you are a power-user and need the very latest features, you will
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    26
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    27
- `Install from version control`_
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    28
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    29
Once the software is installed, move on to :ref:`ConfigEnv` for better control
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    30
and advanced features of |cubicweb|.
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
    31
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    32
.. _`Installation on Debian/Ubuntu`: DebianInstallation_
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    33
.. _`Installation on Windows`: WindowsInstallation_
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    34
.. _`Installation in a virtualenv`: VirtualenvInstallation_
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    35
.. _`Installation with pip`: PipInstallation_
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    36
.. _`Installation with easy_install`: EasyInstallInstallation_
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    37
.. _`Installation from tarball`: TarballInstallation_
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    38
.. _`Install from version control`: MercurialInstallation_
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
    39
5135
f15286235aef [doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 4747
diff changeset
    40
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    41
.. _DebianInstallation:
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    42
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    43
Debian/Ubuntu install
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    44
---------------------
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    45
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    46
|cubicweb| is packaged for Debian/Ubuntu (and derived
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    47
distributions). Their integrated package-management system make
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    48
installation and upgrade much easier for users since
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    49
dependencies (like databases) are automatically installed.
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    50
5135
f15286235aef [doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 4747
diff changeset
    51
Depending on the distribution you are using, add the appropriate line to your
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    52
`list of sources` (for example by editing ``/etc/apt/sources.list``).
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    53
8597
293a595f4365 [doc] ubuntu LTS is now Precise Pangolin
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 8330
diff changeset
    54
For Debian 6.0 Squeeze (stable)::
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    55
7099
ee9f1e1890e0 [doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 6880
diff changeset
    56
  deb http://download.logilab.org/production/ squeeze/
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    57
7099
ee9f1e1890e0 [doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 6880
diff changeset
    58
For Debian Sid (unstable)::
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    59
7099
ee9f1e1890e0 [doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 6880
diff changeset
    60
  deb http://download.logilab.org/production/ sid/
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    61
8597
293a595f4365 [doc] ubuntu LTS is now Precise Pangolin
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 8330
diff changeset
    62
For Ubuntu 12.04 Precise Pangolin (Long Term Support) and newer::
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    63
8597
293a595f4365 [doc] ubuntu LTS is now Precise Pangolin
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 8330
diff changeset
    64
  deb http://download.logilab.org/production/ precise/
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    65
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    66
The repositories are signed with the `Logilab's gnupg key`_. You can download
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    67
and register the key to avoid warnings::
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    68
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    69
  wget -q http://download.logilab.org/logilab-dists-key.asc -O- | sudo apt-key add -
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    70
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    71
Update your list of packages and perform the installation::
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    72
2172
cf8f9180e63e delete-trailing-whitespace
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 1714
diff changeset
    73
  apt-get update
6719
3d2b6e6af721 [doc] minor fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 6718
diff changeset
    74
  apt-get install cubicweb cubicweb-dev
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    75
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    76
``cubicweb`` installs the framework itself, allowing you to create new
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    77
instances. ``cubicweb-dev`` installs the development environment
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    78
allowing you to develop new cubes.
5135
f15286235aef [doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 4747
diff changeset
    79
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    80
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can access a
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    81
list of available cubes using ``apt-cache search cubicweb`` or at the
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    82
`CubicWeb.org forge`_.
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    83
6716
494d4465f032 [doc/book] Add a note about <database>-support virtual package.
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6310
diff changeset
    84
.. note::
494d4465f032 [doc/book] Add a note about <database>-support virtual package.
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6310
diff changeset
    85
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    86
  `cubicweb-dev` will install basic sqlite support. You can easily setup
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    87
  :ref:`cubicweb with other database <DatabaseInstallation>` using the following
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
    88
  virtual packages :
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    89
7633
ab1385ee7caa [book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7230
diff changeset
    90
  * `cubicweb-postgresql-support` contains the necessary dependencies for
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    91
    using :ref:`cubicweb with postgresql datatabase <PostgresqlConfiguration>`
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
    92
7633
ab1385ee7caa [book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7230
diff changeset
    93
  * `cubicweb-mysql-support` contains the necessary dependencies for using
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    94
    :ref:`cubicweb with mysql database <MySqlConfiguration>`.
2239
0f12f1ebf27c add note about logilab key file / apt-get
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 2175
diff changeset
    95
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    96
.. _`list of sources`: http://wiki.debian.org/SourcesList
7099
ee9f1e1890e0 [doc] fix urls pointing to repositories and download sites
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 6880
diff changeset
    97
.. _`Logilab's gnupg key`: http://download.logilab.org/logilab-dists-key.asc
5135
f15286235aef [doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 4747
diff changeset
    98
.. _`CubicWeb.org Forge`: http://www.cubicweb.org/project/
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
    99
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   100
.. _WindowsInstallation:
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   101
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   102
Windows Install
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   103
---------------
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   104
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   105
You need to have `python`_ version >= 2.5 and < 3 installed.
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   106
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   107
If you want an automated install, your best option is probably the
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   108
:ref:`EasyInstallInstallation`. EasyInstall is a tool that helps users to
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   109
install python packages along with their dependencies, searching for suitable
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   110
pre-compiled binaries on the `The Python Package Index`_.
5135
f15286235aef [doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 4747
diff changeset
   111
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   112
If you want better control over the process as well as a suitable development
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   113
environment or if you are having problems with `easy_install`, read on to
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   114
:ref:`SetUpWindowsEnv`.
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   115
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   116
.. _python:  http://www.python.org/
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   117
.. _`The Python Package Index`: http://pypi.python.org
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   118
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   119
.. _VirtualenvInstallation:
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   120
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   121
`Virtualenv` install
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   122
--------------------
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   123
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   124
Since version 3.9, |cubicweb| can be safely installed, used and contained inside
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   125
a `virtualenv`_. You can use either :ref:`pip <PipInstallation>` or
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   126
:ref:`easy_install <EasyInstallInstallation>` to install |cubicweb| inside an
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   127
activated virtual environment.
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
   128
6192
80388edf4e88 [doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 5314
diff changeset
   129
.. _PipInstallation:
80388edf4e88 [doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 5314
diff changeset
   130
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   131
`pip` install
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   132
-------------
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   133
9268
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   134
`pip <http://pip.openplans.org/>`_ is a python tool that helps downloading,
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   135
building, installing, and managing Python packages and their dependencies. It
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   136
is fully compatible with `virtualenv`_ and installs the packages from sources
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   137
published on the `The Python Package Index`_.
6192
80388edf4e88 [doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 5314
diff changeset
   138
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   139
.. _`virtualenv`: http://virtualenv.openplans.org/
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   140
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   141
A working compilation chain is needed to build the modules that include C
7636
1f81ef092e6b [book] fix some urls
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7633
diff changeset
   142
extensions. If you definitively wont, installing `Lxml <http://lxml.de/>`_,
1f81ef092e6b [book] fix some urls
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7633
diff changeset
   143
`Twisted Web <http://twistedmatrix.com/trac/wiki/Downloads/>`_ and `libgecode
1f81ef092e6b [book] fix some urls
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7633
diff changeset
   144
<http://www.gecode.org/>`_ will help.
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   145
9268
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   146
For Debian, these minimal dependencies can be obtained by doing::
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   147
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   148
  apt-get install gcc python-pip python-dev python-lxml
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   149
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   150
or, if you prefer to get as much as possible from pip::
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   151
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   152
  apt-get install gcc python-pip python-dev libxslt1-dev libxml2-dev
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   153
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   154
For Windows, you can install pre-built packages (possible `source
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   155
<http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_). For a minimal setup, install
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   156
`pip <http://www.lfd.uci.edu/~gohlke/pythonlibs/#pip>`_, `setuptools
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   157
<http://www.lfd.uci.edu/~gohlke/pythonlibs/#setuptools>`_, `libxml-python
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   158
<http://www.lfd.uci.edu/~gohlke/pythonlibs/#libxml-python>`_, `lxml
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   159
<http://www.lfd.uci.edu/~gohlke/pythonlibs/#lxml>`_ and `twisted
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   160
<http://www.lfd.uci.edu/~gohlke/pythonlibs/#twisted>`_ from this source making
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   161
sure to choose the correct architecture and version of Python.
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   162
fc24e783dca5 [doc] additional documentation about pip install
Paul Tonelli <paul.tonelli@logilab.fr>
parents: 8597
diff changeset
   163
Finally, install |cubicweb| and its dependencies, by running::
6192
80388edf4e88 [doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 5314
diff changeset
   164
80388edf4e88 [doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 5314
diff changeset
   165
  pip install cubicweb
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   166
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   167
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can access a
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   168
list of available cubes on
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   169
`PyPI <http://pypi.python.org/pypi?%3Aaction=search&term=cubicweb&submit=search>`_
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   170
or at the `CubicWeb.org forge`_.
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   171
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   172
For example, installing the *blog cube* is achieved by::
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   173
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   174
  pip install cubicweb-blog
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   175
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   176
.. _EasyInstallInstallation:
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   177
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   178
`easy_install` install
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   179
----------------------
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   180
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   181
.. note::
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   182
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   183
   If you are not a Windows user and you have a compilation environment, we
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   184
   recommend you to use the PipInstallation_.
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   185
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   186
`easy_install`_ is a python utility that helps downloading, installing, and
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   187
managing python packages and their dependencies.
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   188
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   189
Install |cubicweb| and its dependencies, run::
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   190
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   191
  easy_install cubicweb
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   192
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   193
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can access a
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   194
list of available cubes on `PyPI
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   195
<http://pypi.python.org/pypi?%3Aaction=search&term=cubicweb&submit=search>`_
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   196
or at the `CubicWeb.org Forge`_.
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   197
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   198
For example, installing the *blog cube* is achieved by::
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   199
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   200
  easy_install cubicweb-blog
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   201
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   202
.. note::
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   203
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   204
  If you encounter problem with :ref:`cubes <AvailableCubes>` installation,
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   205
  consider using :ref:`PipInstallation` which is more stable
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   206
  but can not installed pre-compiled binaries.
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   207
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   208
.. _`easy_install`: http://packages.python.org/distribute/easy_install.html
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   209
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   210
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   211
.. _SourceInstallation:
6310
554da7585fba [doc/book] more notes on setup
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6305
diff changeset
   212
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
   213
Install from source
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   214
-------------------
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
   215
6718
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   216
.. _TarballInstallation:
b741578ce7c9 [doc/book] Improve installation doc mostly about pip ans easy_install
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 6717
diff changeset
   217
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   218
You can download the archive containing the sources from
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   219
`http://download.logilab.org/pub/cubicweb/ <http://download.logilab.org/pub/cubicweb/>`_.
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
   220
6212
73565b770559 [doc] fix link to appendix
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 6192
diff changeset
   221
Make sure you also have all the :ref:`InstallDependencies`.
5135
f15286235aef [doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 4747
diff changeset
   222
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   223
Once uncompressed, you can install the framework from inside the uncompressed
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   224
folder with::
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   225
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   226
  python setup.py install
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   227
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   228
Or you can run |cubicweb| directly from the source directory by
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   229
setting the :ref:`resource mode <RessourcesConfiguration>` to `user`. This will
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   230
ease the development with the framework.
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   231
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   232
There is also a wide variety of :ref:`cubes <AvailableCubes>`. You can access a
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   233
list of availble cubes at the `CubicWeb.org Forge`_.
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   234
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   235
6192
80388edf4e88 [doc] improve doc thanks to user feedback
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 5314
diff changeset
   236
.. _MercurialInstallation:
5135
f15286235aef [doc] enhanced setup section: fix sections'level, more postgres tips, merge environment doc with cwconfig.py module docstring using custom autodocstring directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 4747
diff changeset
   237
3488
ab9e7bcfc764 [doc] add missing dependencies in annexes. explain more precisely source install.
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 3138
diff changeset
   238
Install from version control system
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   239
-----------------------------------
3488
ab9e7bcfc764 [doc] add missing dependencies in annexes. explain more precisely source install.
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 3138
diff changeset
   240
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   241
To keep-up with on-going development, clone the :ref:`Mercurial
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   242
<MercurialPresentation>` repository::
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
   243
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   244
  hg clone -u stable http://hg.logilab.org/cubicweb # stable branch
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   245
  hg clone http://hg.logilab.org/cubicweb # development branch
3488
ab9e7bcfc764 [doc] add missing dependencies in annexes. explain more precisely source install.
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 3138
diff changeset
   246
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   247
To get many of CubicWeb's dependencies and a nice set of base cubes, run the
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   248
`clone_deps.py` script located in `cubicweb/bin/`::
6304
228921b064c3 [doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6300
diff changeset
   249
228921b064c3 [doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6300
diff changeset
   250
  python cubicweb/bin/clone_deps.py
228921b064c3 [doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6300
diff changeset
   251
228921b064c3 [doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6300
diff changeset
   252
(Windows users should replace slashes with antislashes).
228921b064c3 [doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6300
diff changeset
   253
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   254
This script will clone a set of mercurial repositories into the
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   255
directory containing the ``cubicweb`` repository, and update them to the
6304
228921b064c3 [doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6300
diff changeset
   256
latest published version tag (if any).
228921b064c3 [doc,bin] add script to fetch & update most cw dependencies + some cubes
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6300
diff changeset
   257
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   258
.. note::
1460
6520efef1824 [doc] C011 content moved to C010
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1444
diff changeset
   259
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   260
  In every cloned repositories, a `hg tags` will display a list of
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   261
  tags in reverse chronological order. One reasonnable option is to go to a
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   262
  tagged version: the latest published version or example, as done by
7226
e88c57c10b34 [doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 7099
diff changeset
   263
  the `clone_deps` script)::
6310
554da7585fba [doc/book] more notes on setup
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6305
diff changeset
   264
7230
edd2a575a8e7 [doc] update of the update
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 7226
diff changeset
   265
   hg update cubicweb-version-3.12.2
6310
554da7585fba [doc/book] more notes on setup
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents: 6305
diff changeset
   266
6212
73565b770559 [doc] fix link to appendix
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 6192
diff changeset
   267
Make sure you also have all the :ref:`InstallDependencies`.
2393
6190852af97f [doc] add list of dependencies in appendix
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 2239
diff changeset
   268