author | Julien Cristau <julien.cristau@logilab.fr> |
Tue, 28 Jan 2014 16:07:06 +0100 | |
changeset 9510 | a5231a557ac0 |
parent 7633 | ab1385ee7caa |
child 9916 | 986797d779ea |
permissions | -rw-r--r-- |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
1 |
.. -*- coding: utf-8 -*- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
2 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
3 |
.. _SetUpWindowsEnv: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
4 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
5 |
Installing a development environement on Windows |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
6 |
================================================ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
7 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
8 |
Setting up a Windows development environment is not too complicated |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
9 |
but it requires a series of small steps. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
10 |
|
7633
ab1385ee7caa
[book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7632
diff
changeset
|
11 |
We propose an example of a typical |cubicweb| installation on Windows |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
12 |
from sources. We assume everything goes into ``C:\\`` and for any |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
13 |
package, without version specification, "the latest is |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
14 |
the greatest". |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
15 |
|
7633
ab1385ee7caa
[book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7632
diff
changeset
|
16 |
Mind that adjusting the installation drive should be straightforward. |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
17 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
18 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
19 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
20 |
Install the required elements |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
21 |
----------------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
22 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
23 |
|cubicweb| requires some base elements that must be installed to run |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
24 |
correctly. So, first of all, you must install them : |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
25 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
26 |
* python >= 2.5 and < 3 |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
27 |
(`Download Python <http://www.python.org/download/>`_). |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
28 |
You can also consider the Python(x,y) distribution |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
29 |
(`Download Python(x,y) <http://code.google.com/p/pythonxy/wiki/Downloads>`_) |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
30 |
as it makes things easier for Windows user by wrapping in a single installer |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
31 |
python 2.5 plus numerous useful third-party modules and |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
32 |
applications (including Eclipse + pydev, which is an arguably good |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
33 |
IDE for Python under Windows). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
34 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
35 |
* `Twisted <http://twistedmatrix.com/trac/>`_ is an event-driven |
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
36 |
networking engine |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
37 |
(`Download Twisted <http://twistedmatrix.com/trac/>`_) |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
38 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
39 |
* `lxml <http://codespeak.net/lxml/>`_ library |
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
40 |
(version >=2.2.1) allows working with XML and HTML |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
41 |
(`Download lxml <http://pypi.python.org/pypi/lxml/2.2.1>`_) |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
42 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
43 |
* `Postgresql 8.4 <http://www.postgresql.org/>`_, |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
44 |
an object-relational database system |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
45 |
(`Download Postgresql <http://www.enterprisedb.com/products/pgdownload.do#windows>`_) |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
46 |
and its python drivers |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
47 |
(`Download psycopg <http://www.stickpeople.com/projects/python/win-psycopg/#Version2>`_) |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
48 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
49 |
* A recent version of `gettext` |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
50 |
(`Download gettext <http://download.logilab.org/pub/gettext/gettext-0.17-win32-setup.exe>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
51 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
52 |
* `rql <http://www.logilab.org/project/rql>`_, |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
53 |
the recent version of the Relationship Query Language parser |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
54 |
(`Download rql <http://download.logilab.org/pub/rql/rql-0.26.3.win32-py2.5.exe>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
55 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
56 |
Install optional elements |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
57 |
------------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
58 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
59 |
We recommend you to install the following elements. They are not |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
60 |
mandatory but they activate very interesting features in |cubicweb|: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
61 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
62 |
* `Simplejson <http://pypi.python.org/pypi/simplejson/>`_ |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
63 |
must be installed if you have python <= 2.5 |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
64 |
(`Download simplejson <http://www.osuch.org/python-simplejson%3Awin32>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
65 |
It is included in the Standard library from Python >= 2.6. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
66 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
67 |
* `Pyro <http://www.xs4all.nl/~irmen/pyro3/>`_ |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
68 |
enables remote access to cubicweb repository instances. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
69 |
It also allows the client and the server not running on the same machine |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
70 |
(`Download Pyro <http://www.xs4all.nl/~irmen/pyro3/download/>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
71 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
72 |
* `python-ldap <http://pypi.python.org/pypi/python-ldap>`_ |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
73 |
provides access to LDAP/Active directory directories |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
74 |
(`Download python-ldap <http://www.osuch.org/python-ldap>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
75 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
76 |
* `graphviz <http://www.graphviz.org/>`_ |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
77 |
which allow schema drawings. |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
78 |
(`Download graphviz <http://www.graphviz.org/Download_windows.php>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
79 |
It is quite recommended (albeit not mandatory). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
80 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
81 |
Other elements will activate more features once installed. Take a look |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
82 |
at :ref:`InstallDependencies`. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
83 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
84 |
Useful tools |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
85 |
------------ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
86 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
87 |
Some additional tools could be useful to develop :ref:`cubes <AvailableCubes>` |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
88 |
with the framework. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
89 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
90 |
* `mercurial <http://mercurial.selenic.com/>`_ and its standard windows GUI |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
91 |
(`TortoiseHG <http://tortoisehg.bitbucket.org/>`_) allow you to get the source |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
92 |
code of |cubicweb| from control version repositories. So you will be able to |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
93 |
get the latest development version and pre-release bugfixes in an easy way |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
94 |
(`Download mercurial <http://bitbucket.org/tortoisehg/stable/wiki/download>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
95 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
96 |
* You can also consider the ssh client `Putty` in order to peruse |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
97 |
mercurial over ssh (`Download <http://www.putty.org/>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
98 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
99 |
* If you are an Eclipse user, mercurial can be integrated using the |
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
100 |
`MercurialEclipse` plugin |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
101 |
(`Home page <http://www.vectrace.com/mercurialeclipse/>`_). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
102 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
103 |
Getting the sources |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
104 |
------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
105 |
|
7633
ab1385ee7caa
[book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7632
diff
changeset
|
106 |
There are two ways to get the sources of |cubicweb| and its |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
107 |
:ref:`cubes <AvailableCubes>`: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
108 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
109 |
* download the latest release (:ref:`SourceInstallation`) |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
110 |
* get the development version using Mercurial |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
111 |
(:ref:`MercurialInstallation`) |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
112 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
113 |
Environment variables |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
114 |
--------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
115 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
116 |
You will need some convenience environment variables once all is set up. These |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
117 |
variables are settable through the GUI by getting at the `System properties` |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
118 |
window (by righ-clicking on `My Computer` -> `properties`). |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
119 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
120 |
In the `advanced` tab, there is an `Environment variables` button. Click on |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
121 |
it. That opens a small window allowing edition of user-related and system-wide |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
122 |
variables. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
123 |
|
7632
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
124 |
We will consider only user variables. First, the ``PATH`` variable. Assuming |
3c9dfc6e820b
[book] fix some rest/sphinx errors
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7226
diff
changeset
|
125 |
you are logged as user *Jane*, add the following paths, separated by |
7226
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
126 |
semi-colons:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
127 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
128 |
C:\Documents and Settings\Jane\My Documents\Python\cubicweb\cubicweb\bin |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
129 |
C:\Program Files\Graphviz2.24\bin |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
130 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
131 |
The ``PYTHONPATH`` variable should also contain:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
132 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
133 |
C:\Documents and Settings\Jane\My Documents\Python\cubicweb\ |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
134 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
135 |
From now, on a fresh `cmd` shell, you should be able to type:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
136 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
137 |
cubicweb-ctl list |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
138 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
139 |
... and get a meaningful output. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
140 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
141 |
Running an instance as a service |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
142 |
-------------------------------- |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
143 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
144 |
This currently assumes that the instances configurations is located at |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
145 |
``C:\\etc\\cubicweb.d``. For a cube 'my_instance', you will find |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
146 |
``C:\\etc\\cubicweb.d\\my_instance\\win32svc.py``. |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
147 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
148 |
Now, register your instance as a windows service with:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
149 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
150 |
win32svc install |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
151 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
152 |
Then start the service with:: |
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
153 |
|
e88c57c10b34
[doc] major update of the install documentation
Alain Leufroy <alain.leufroy@logilab.fr>
parents:
diff
changeset
|
154 |
net start cubicweb-my_instance |
7633
ab1385ee7caa
[book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7632
diff
changeset
|
155 |
|
ab1385ee7caa
[book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7632
diff
changeset
|
156 |
In case this does not work, you should be able to see error reports in |
ab1385ee7caa
[book, admin] include some fixes done by auc in an email to me
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7632
diff
changeset
|
157 |
the application log, using the windows event log viewer. |