Changeset 2557 in main for trunk/docs


Ignore:
Timestamp:
08/13/13 12:40:17 (6 years ago)
Author:
pcosquer
Message:

doc: admin update install instruction of the upcoming stable version

Location:
trunk/docs/en/admin
Files:
2 added
3 edited

Legend:

Unmodified
Added
Removed
  • trunk/docs/en/admin/apache/simple_1.3.conf

    r2266 r2557  
    1 WSGIScriptAlias / /var/django/openPLM/trunk/openPLM/apache/django.wsgi 
     1<VirtualHost *:80> 
     2    ServerName openplm.example.com 
     3    DocumentRoot /var/www 
     4 
     5    WSGIScriptAlias / /var/django/openPLM/trunk/openPLM/apache/django.wsgi 
    26# required to enable webdav access  
    3 WSGIPassAuthorization On  
     7    WSGIPassAuthorization On  
    48 
    5 <Location /media/> 
    6     WSGIAccessScript /var/django/openPLM/trunk/openPLM/apache/access_restricted.wsgi 
    7 </Location> 
    8 Alias /static /var/django/openPLM/trunk/openPLM/static 
    9 <Directory /var/django/openPLM/trunk/openPLM/static> 
    10     Order deny,allow 
    11     Allow from all 
    12 </Directory> 
     9    <Location /media/> 
     10        WSGIAccessScript /var/django/openPLM/trunk/openPLM/apache/access_restricted.wsgi 
     11    </Location> 
    1312 
    14 Alias /media /var/django/openPLM/trunk/openPLM/media 
    15 <Directory /var/django/openPLM/trunk/openPLM/media> 
    16     Order deny,allow 
    17     Allow from all 
    18 </Directory> 
     13    Alias /static /var/django/openPLM/trunk/openPLM/static 
     14    <Directory /var/django/openPLM/trunk/openPLM/static> 
     15        Order deny,allow 
     16        Allow from all 
     17    </Directory> 
    1918 
     19    Alias /media /var/django/openPLM/trunk/openPLM/media 
     20    <Directory /var/django/openPLM/trunk/openPLM/media> 
     21        Order deny,allow 
     22        Allow from all 
     23    </Directory> 
     24 
     25</VirtualHost> 
  • trunk/docs/en/admin/ht_1_install_server.rst

    r2539 r2557  
    11=================================================== 
    2 How to install openPLM server 1.2 
     2How to install openPLM server 1.3 
    33=================================================== 
    44 
     
    88Previous versions: 
    99 
     10    - `1.2 <http://wiki.openplm.org/docs/1.2/en/admin/ht_1_install_server.html>`_ 
    1011    - `1.1 <http://wiki.openplm.org/docs/1.1/en/admin/ht_1_install_server.html>`_ 
    1112 
     
    1617This HowTo is based on: 
    1718 
    18     * Ubuntu 12.04 LTS server edition 
    19     * Apache Server version: Apache/2.2.22 (Ubuntu) 
     19 
     20    * Debian Wheezy 
     21    * Apache Server version: Apache/2.2.22 (from Debian) 
    2022    * PostgreSQL 9.1 
    21     * Python 2.7.3 
    22     * Django 1.3.1 
    23     * Celery 2.4.6 
    24     * Haystack 1.2.7 
    25     * Xapian 1.2.8 
    26     * Lepl 5.1.1 
    27     * South 0.7.3 
     23    * Python 2.6.X or 2.7.X 
     24    * Django 1.5.X 
     25    * Celery 3.0.X 
     26    * Haystack 1.2.X 
     27    * Xapian 1.2.X 
     28    * Lepl 5.0 
     29    * South 0.7.6 
     30    * Markdown 2.2 
     31 
    2832  
     33It is also valid on Debian Squeeze (Apache 2.2.16, PostgreSQL 8.4). 
    2934  
    3035.. note:: 
     
    3944First, you must install some dependencies: 
    4045 
    41     #. ``apt-get install swig build-essential pkg-config gettext`` 
    42     #. ``apt-get install apache2 libapache2-mod-wsgi`` 
    43     #. ``apt-get install python-pip python-dev python-imaging python-kjbuckets python-pypdf ipython`` 
    44     #. ``apt-get install graphviz graphviz-dev python-pygraphviz`` 
    45     #. ``apt-get install python-xapian rabbitmq-server python-django python-docutils`` 
    46     #. ``apt-get install python-django-celery python-django-south python-pisa`` 
    47     #. ``apt-get install postgresql python-psycopg2`` 
    48     #. ``apt-get install libgsf-bin`` 
    49     #. ``pip install odfpy 'django-haystack<2' lepl`` 
     46    #. ``apt-get install swig build-essential pkg-config gettext apache2 libapache2-mod-wsgi python-pip python-dev python-imaging python-kjbuckets python-pypdf ipython graphviz graphviz-dev python-pygraphviz  python-xapian rabbitmq-server postgresql libpq-dev python-tz python-pisa libgsf-bin imagemagick python-pisa python-lxml`` 
     47    #. ``pip install odfpy docutils celery django-celery 'django==1.5.1' 'south==0.7.6' psycopg2  'django-haystack<2' librabbitmq markdown lepl``  
    5048 
    5149To enable plain text search on files, you need to install the following 
     
    5553    #. ``pip install openxmllib`` 
    5654 
     55 
    5756Get the tarball containing the code 
    5857=================================== 
    5958 
    60     * `Download OpenPLM <http://wiki.openplm.org/trac/downloads/7>`_ 
     59    * `Download OpenPLM <http://wiki.openplm.org/trac/downloads/8>`_ 
    6160 
    6261Extract the code in /var and rename the directory to django 
    6362 
    64     * ``tar xzf openplm-1.2.tar.gz -C /var/`` 
     63    * ``tar xzf openplm-1.3.tar.gz -C /var/`` 
    6564     
    6665    * ``mv /var/openplm /var/django`` 
     
    8180Or you can grab your favorite editor and change the followings files yourself: 
    8281 
    83     * ``settings.py`` change **MEDIA_ROOT** and **TEMPLATE_DIRS** : 
     82    * ``settings.py`` change **MEDIA_ROOT** and **TEMPLATE_DIRS**: 
    8483 
    8584        .. code-block:: python 
     
    180179    * ``./manage.py syncdb --all`` 
    181180    * ``./manage.py migrate --all --fake`` 
    182     * ``./manage.py loaddada extra_lifecycles``   
     181    * ``./manage.py loaddata extra_lifecycles``   
    183182     
    184183    .. note:: 
     
    201200Change rights for the directory where thumbnails will be stored: 
    202201     
    203     * ``chown www-data:www-data /var/django/openPLM/media/thumbnails`` 
    204     * ``chown www-data:www-data /var/django/openPLM/media/public/thumbnails`` 
     202    * ``chown -R www-data:www-data /var/django/openPLM/trunk/openPLM/media/`` 
    205203  
    206204.. _search-engine: 
     
    255253    * ``cp /var/django/openPLM/etc/default/celeryd /etc/default/celeryd`` 
    256254    * ``chmod +x /etc/init.d/celeryd`` 
    257     * ``mkdir /var/{log,run}/celery`` 
    258     * ``chown www-data:www-data /var/{log,run}/celery`` 
     255    * ``update-rc.d celeryd defaults`` 
    259256 
    260257To launch :command:`celeryd`, run ``/etc/init.d/celeryd start``. 
    261258 
    262259 
    263 Check required modules 
    264 ====================== 
    265      
    266     * ``./bin/check_modules.py`` :: 
    267      
    268         All is ok 
     260Configure allowed hosts 
     261========================== 
     262 
     263Django 1.5 checks the host before serving a request. 
     264You must edit the :django:setting:`ALLOWED_HOSTS` setting so that 
     265django accepts to serve your requests. 
     266 
    269267 
    270268Configure Apache server 
    271269======================= 
    272270 
    273 Edit you Apache configuration file (:file:`/etc/apache2/httpd.conf`) and 
    274 add the following lines: 
    275      
    276 .. literalinclude:: apache/simple_1.1.conf 
     271Create a new apache's site (:file:`/etc/apache2/sites-available/openplm`) 
     272and add the following lines (replace the server name): 
     273     
     274.. literalinclude:: apache/simple_1.3b.conf 
    277275    :language: apache 
    278276 
     
    280278===================== 
    281279 
     280    * ``a2ensite openplm`` 
    282281    * ``service apache2 restart`` 
    283282 
     
    286285====================== 
    287286 
     287 
     288Editing the site adress 
     289------------------------- 
     290 
     291Edit the default Site (:samp:`http://{server}/admin/sites/site/1/`) and set the 
     292domain name. 
     293This should be the same domain set in the apache file and in the ALLOWED_HOST setting. 
     294You must login with the admin account. 
     295You can use ``localhost`` on a local installation. 
     296 
    288297Adding users 
    289298------------ 
    290299 
    291300To add users in OpenPLM, you have two methods. The first one uses the 
    292  delegation tab directly in OpenPLM and the second one uses the administration 
    293  interface. 
     301delegation tab directly in OpenPLM and the second one uses the administration 
     302interface. 
    294303 
    295304Recommanded method 
     
    349358    For more information about the `Django Admin tool <http://docs.djangoproject.com/en/dev/intro/tutorial02/>`_ .  
    350359 
    351 Then you must create a new *Site* (use the admin interface) and set the `SITE_ID` 
    352 variable in the :file:`settings.py` file. 
    353  
    354360You are now ready for your first login: :: 
    355361 
     
    370376be enabled) 
    371377 
    372 .. literalinclude:: apache/ssl_1.1.conf 
     378.. literalinclude:: apache/ssl_1.3b.conf 
    373379    :language: apache 
    374380 
     
    395401.. contents:: 
    396402    :local: 
    397  
    398 Admin pages are ugly 
    399 --------------------- 
    400  
    401 openPLM ships with a simlink (:file:`/path/to/openPLM/media/admin`) that may 
    402 be broken on your system. 
    403  
    404 To fix this link, run the following command: 
    405 ``ln -s `python -c 'import django; print django.__path__[0]'`/contrib/admin/media 
    406 /var/django/openPLM/media/admin`` 
    407403 
    408404 
  • trunk/docs/en/admin/ht_2_install_server.rst

    r2539 r2557  
    1818This HowTo is based on: 
    1919 
    20     * Debian Squeeze 
    21     * Apache Server version: Apache/2.2.16 (from Debian) 
    22     * PostgreSQL 8.4.4 
     20    * Debian Wheezy 
     21    * Apache Server version: Apache/2.2.22 (from Debian) 
     22    * PostgreSQL 9.1 
    2323    * Python 2.6.X or 2.7.X 
    2424    * Django 1.5.X 
     
    2929    * South 0.7.6 
    3030    * Markdown 2.2 
    31   
     31 
     32It is also valid on Debian Squeeze (Apache 2.2.16, PostgreSQL 8.4). 
    3233  
    3334.. note:: 
     
    237238django accepts to serve your requests. 
    238239 
    239 Check required modules 
    240 ====================== 
    241      
    242     * ``./bin/check_modules.py`` :: 
    243      
    244         /usr/local/lib/python2.6/dist-packages/pyPdf-1.12-py2.6.egg/pyPdf/pdf.py:52: DeprecationWarning: the sets module is deprecated 
    245         from sets import ImmutableSet 
    246         All is ok 
    247240 
    248241Configure Apache server 
    249242======================= 
    250243 
    251 Edit you Apache configuration file (:file:`/etc/apache2/sites-available/openplm`) and 
    252 add the following lines: 
     244Create a new apache's site (:file:`/etc/apache2/sites-available/openplm`) 
     245and add the following lines (replace the server name): 
    253246     
    254247.. literalinclude:: apache/simple_1.3.conf 
     
    263256First steps in openPLM 
    264257====================== 
     258 
     259Editing the site adress 
     260------------------------- 
     261 
     262Edit the default Site (:samp:`http://{server}/admin/sites/site/1/`) and set the 
     263domain name.  
     264This should be the same domain set in the apache file and in the ALLOWED_HOST setting. 
     265You must login with the admin account. 
     266You can use ``localhost`` on a local installation. 
    265267 
    266268Adding users 
Note: See TracChangeset for help on using the changeset viewer.