# HG changeset patch # User Arthur Lutz # Date 1580677800 -3600 # Node ID 24a15a69b84a4c4c95d079e7db1633c9733dbb04 # Parent a82e56d4814abd616213e3d366077bd5267b503f [doc] remove setup instructions for Windows diff -r a82e56d4814a -r 24a15a69b84a doc/book/admin/index.rst --- a/doc/book/admin/index.rst Fri Jan 31 16:31:44 2020 +0100 +++ b/doc/book/admin/index.rst Sun Feb 02 22:10:00 2020 +0100 @@ -14,7 +14,6 @@ :numbered: setup - setup-windows config cubicweb-ctl create-instance diff -r a82e56d4814a -r 24a15a69b84a doc/book/admin/setup-windows.rst --- a/doc/book/admin/setup-windows.rst Fri Jan 31 16:31:44 2020 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,142 +0,0 @@ -.. -*- coding: utf-8 -*- - -.. _SetUpWindowsEnv: - -Installing a development environement on Windows -================================================ - -Setting up a Windows development environment is not too complicated -but it requires a series of small steps. - -We propose an example of a typical |cubicweb| installation on Windows -from sources. We assume everything goes into ``C:\\`` and for any -package, without version specification, "the latest is -the greatest". - -Mind that adjusting the installation drive should be straightforward. - - - -Install the required elements ------------------------------ - -|cubicweb| requires some base elements that must be installed to run -correctly. So, first of all, you must install them : - -* python >= 2.6 and < 3 - (`Download Python `_). - You can also consider the Python(x,y) distribution - (`Download Python(x,y) `_) - as it makes things easier for Windows user by wrapping in a single installer - python 2.7 plus numerous useful third-party modules and - applications (including Eclipse + pydev, which is an arguably good - IDE for Python under Windows). - -* `lxml `_ library - (version >=2.2.1) allows working with XML and HTML - (`Download lxml `_) - -* `Postgresql `_, - an object-relational database system - (`Download Postgresql `_) - and its python drivers - (`Download psycopg `_) - -* A recent version of `gettext` - (`Download gettext `_). - -* `rql `_, - the recent version of the Relationship Query Language parser. - -Install optional elements -------------------------- - -We recommend you to install the following elements. They are not -mandatory but they activate very interesting features in |cubicweb|: - -* `python-ldap `_ - provides access to LDAP/Active directory directories - (`Download python-ldap `_). - -* `graphviz `_ - which allow schema drawings. - (`Download graphviz `_). - It is quite recommended (albeit not mandatory). - -Other elements will activate more features once installed. Take a look -at :ref:`InstallDependencies`. - -Useful tools ------------- - -Some additional tools could be useful to develop :ref:`cubes ` -with the framework. - -* `mercurial `_ and its standard windows GUI - (`TortoiseHG `_) allow you to get the source - code of |cubicweb| from control version repositories. So you will be able to - get the latest development version and pre-release bugfixes in an easy way - (`Download mercurial `_). - -* You can also consider the ssh client `Putty` in order to peruse - mercurial over ssh (`Download `_). - -* If you are an Eclipse user, mercurial can be integrated using the - `MercurialEclipse` plugin - (`Home page `_). - -Getting the sources -------------------- - -There are two ways to get the sources of |cubicweb| and its -:ref:`cubes `: - -* download the latest release (:ref:`SourceInstallation`) -* get the development version using Mercurial - (:ref:`MercurialInstallation`) - -Environment variables ---------------------- - -You will need some convenience environment variables once all is set up. These -variables are settable through the GUI by getting at the `System properties` -window (by righ-clicking on `My Computer` -> `properties`). - -In the `advanced` tab, there is an `Environment variables` button. Click on -it. That opens a small window allowing edition of user-related and system-wide -variables. - -We will consider only user variables. First, the ``PATH`` variable. Assuming -you are logged as user *Jane*, add the following paths, separated by -semi-colons:: - - C:\Documents and Settings\Jane\My Documents\Python\cubicweb\cubicweb\bin - C:\Program Files\Graphviz2.24\bin - -The ``PYTHONPATH`` variable should also contain:: - - C:\Documents and Settings\Jane\My Documents\Python\cubicweb\ - -From now, on a fresh `cmd` shell, you should be able to type:: - - cubicweb-ctl list - -... and get a meaningful output. - -Running an instance as a service --------------------------------- - -This currently assumes that the instances configurations is located at -``C:\\etc\\cubicweb.d``. For a cube 'my_instance', you will find -``C:\\etc\\cubicweb.d\\my_instance\\win32svc.py``. - -Now, register your instance as a windows service with:: - - win32svc install - -Then start the service with:: - - net start cubicweb-my_instance - -In case this does not work, you should be able to see error reports in -the application log, using the windows event log viewer. diff -r a82e56d4814a -r 24a15a69b84a doc/book/admin/setup.rst --- a/doc/book/admin/setup.rst Fri Jan 31 16:31:44 2020 +0100 +++ b/doc/book/admin/setup.rst Sun Feb 02 22:10:00 2020 +0100 @@ -16,7 +16,6 @@ your system: - `Installation on Debian/Ubuntu`_ -- `Installation on Windows`_ - `Installation in a virtualenv`_ - `Installation with pip`_ - `Installation with easy_install`_ @@ -30,7 +29,6 @@ and advanced features of |cubicweb|. .. _`Installation on Debian/Ubuntu`: DebianInstallation_ -.. _`Installation on Windows`: WindowsInstallation_ .. _`Installation in a virtualenv`: VirtualenvInstallation_ .. _`Installation with pip`: PipInstallation_ .. _`Installation with easy_install`: EasyInstallInstallation_ @@ -85,25 +83,6 @@ .. _`Logilab's gnupg key`: https://www.logilab.fr/logilab-debian-keyring.gpg .. _`CubicWeb.org Forge`: http://www.cubicweb.org/project/ -.. _WindowsInstallation: - -Windows Install ---------------- - -You need to have `python`_ version >= 2.5 and < 3 installed. - -If you want an automated install, your best option is probably the -:ref:`EasyInstallInstallation`. EasyInstall is a tool that helps users to -install python packages along with their dependencies, searching for suitable -pre-compiled binaries on the `The Python Package Index`_. - -If you want better control over the process as well as a suitable development -environment or if you are having problems with `easy_install`, read on to -:ref:`SetUpWindowsEnv`. - -.. _python: http://www.python.org/ -.. _`The Python Package Index`: http://pypi.python.org - .. _VirtualenvInstallation: `Virtualenv` install