Ignore:
Timestamp:
17 Jan 2009, 15:08:22 (16 years ago)
Author:
hraban
Message:

trying to update docs to versions in use

Location:
WAeUP_Doc/ExtendedInstructions
Files:
1 added
1 edited

Legend:

Unmodified
Added
Removed
  • WAeUP_Doc/ExtendedInstructions/1InstallingZope.rst

    r1617 r3860  
    2020installations from Zope instances. Usually, you only have *one
    2121installation of a certain Zope version* installed (in case of WAeUP:
    22 version 2.9.3), while there might be *several Zope instances* installed
     22version 2.9.8), while there might be *several Zope instances* installed
    2323based on the one Zope installation, but located at different locations
    2424in the filesystem.
     
    4747five instances, which listen on five different ports. A browser is
    4848connected to port 8082, which is served by the 'waeup'-instance, which
    49 in turn deploys a Zope 2.9.3 installation (sharing it with two other
     49in turn deploys a Zope 2.9.8 installation (sharing it with two other
    5050instances).
    5151
     
    5555
    5656TODO
     57
     58Installing Zope on MacOS X
     59--------------------------
     60
     61Mostly the same as on Linux (see below).
     62
     63  * Your home directory (~) is `/Users/user`.
     64 
     65  * You need to install Developer Tools (XCode).
     66 
     67  * You need to install wget on your own (perhaps use MacPorts or Fink) or use curl.
     68 
     69  * Depending on your OS version you need to install an older Python version,
     70    perhaps via MacPorts or Fink.
     71    (*Don't touch Apple's default Python installation!*)
    5772
    5873Installing Zope on Linux
     
    7489  ::
    7590
    76     ~$ wget http://www.zope.org/Products/Zope/2.9.3/Zope-2.9.3.tgz
     91    ~$ wget http://www.zope.org/Products/Zope/2.9.8/Zope-2.9.8-final.tgz
    7792    ~$ mkdir -p zope/base zope/build zope/pkgs zope/instances
    78     ~$ cp Zope-2.9.3.tgz zope/build
    79     ~$ mv Zope-2.9.3.tgz zope/pkgs   
     93    ~$ cp Zope-2.9.8-final.tgz zope/build
     94    ~$ mv Zope-2.9.8-final.tgz zope/pkgs   
    8095    ~$ cd zope/build
    81     ~/zope/build$ tar -xzf Zope-2.9.3.tgz
    82     ~/zope/build$ cd Zope-2.9.3
    83     ~/zope/build/Zope-2.9.3$ ./configure --prefix=/home/user/zope/base/2_9_3
    84     ~/zope/build/Zope-2.9.3$ make
    85     ~/zope/build/Zope-2.9.3$ make install
    86     ~/zope/build/Zope-2.9.3$ /home/user/zope/base/2_9_3/bin/mkzopeinstance.py -d /home/user/zope/instances/myinstance1 -u user:secret
    87     ~/zope/build/Zope-2.9.3$ /home/user/zope/instances/myinstance1/bin/zopectl start
     96    ~/zope/build$ tar -xzf Zope-2.9.8-final.tgz
     97    ~/zope/build$ cd Zope-2.9.8-final
     98    ~/zope/build/Zope-2.9.8-final$ ./configure --prefix=/home/user/zope/base/2_9_8
     99    ~/zope/build/Zope-2.9.8-final$ make
     100    ~/zope/build/Zope-2.9.8-final$ make install
     101    ~/zope/build/Zope-2.9.8-final$ /home/user/zope/base/2_9_8/bin/mkzopeinstance.py -d /home/user/zope/instances/myinstance1 -u user:secret
     102    ~/zope/build/Zope-2.9.8-final$ /home/user/zope/instances/myinstance1/bin/zopectl start
    88103
    89104  *Fig. 2: Zope install on Linux / Short version*
     
    97112  1. *Get the sources*
    98113
    99      Get the Zope sources from http://www.zope.org/. For the
    100      WAeUP-portal you currently need the 2.9.3 version of Zope, which can
    101      be found here: http://www.zope.org/Products/Zope/2.9.3/Zope-2.9.3.tgz
    102 
    103      Using the commandline you might change to your home directory ('cd') and
     114     Get the Zope sources from `http://www.zope.org/`. For the
     115     WAeUP-portal you currently need the 2.9.8 version of Zope, which can
     116     be found here: `http://www.zope.org/Products/Zope/2.9.8/Zope-2.9.8-final.tgz`
     117
     118     Using the commandline you might change to your home directory (`cd`) and
    104119     do (the dollar-sign here and elsewhere denotes the commandline
    105120     prompt, the tilde in front of the dollar sign means: 'home directory'):
     
    108123
    109124         ~$ cd
    110          ~$ wget http://www.zope.org/Products/Zope/2.9.3/Zope-2.9.3.tgz
    111          --16:03:00--  http://www.zope.org/Products/Zope/2.9.3/Zope-2.9.3.tgz
    112                => `Zope-2.9.3.tgz'
     125         ~$ wget http://www.zope.org/Products/Zope/2.9.8/Zope-2.9.8-final.tgz
     126         --16:03:00--  http://www.zope.org/Products/Zope/2.9.8/Zope-2.9.8-final.tgz
     127               => `Zope-2.9.8-final.tgz'
    113128         Resolving www.zope.org... 63.240.213.171
    114129         Connecting to www.zope.org|63.240.213.171|:80... connected.
     
    118133         100%[====================================>] 8,010,113    203.30K/s    ETA 00:00
    119134
    120          16:03:50 (156.42 KB/s) - `Zope-2.9.3.tgz' saved [8010113/8010113]
     135         16:03:50 (156.42 KB/s) - `Zope-2.9.8-final.tgz' saved [8010113/8010113]
    121136
    122137
     
    203218       ::
    204219
    205          ~$ cp Zope-2.9.3.tgz zope/build
     220         ~$ cp Zope-2.9.8-final.tgz zope/build
    206221
    207222     Afterwards we put the sources into the pkgs-directory to keep it
     
    210225       ::
    211226
    212          ~$ mv Zope-2.9.3.tgz zope/pkgs
     227         ~$ mv Zope-2.9.8-final.tgz zope/pkgs
    213228
    214229     The command 'mv' *moves* a file to a different location, thereby
     
    220235
    221236         ~$ cd zope/build
    222          ~/zope/build$ tar -xzf Zope-2.9.3.tgz
     237         ~/zope/build$ tar -xzf Zope-2.9.8-final.tgz
    223238
    224239     The commandline options 'xzf' mean: e(x)tract the file, un(z)ip the
    225      file and do the whole operation on the (f)ile Zope-2.9.3.tgz.
    226 
    227      This creates a new subdirectory 'Zope-2.9.3' with all required
     240     file and do the whole operation on the (f)ile Zope-2.9.8-final.tgz.
     241
     242     This creates a new subdirectory 'Zope-2.9.8-final' with all required
    228243     sources.
    229244
     
    234249       ::
    235250
    236          ~/zope/build$ cd Zope-2.9.3
     251         ~/zope/build$ cd Zope-2.9.8-final
    237252
    238253     Here you can find a file configure, which is most important, to
     
    242257       ::
    243258
    244          ~/zope/build/Zope-2.9.3$ ./configure --help
     259         ~/zope/build/Zope-2.9.8-final$ ./configure --help
    245260
    246261         configure [--help] [--quiet] [--with-python=path] [--prefix=path]
     
    255270
    256271         Given no options, configure will search your PATH for a suitable
    257          Python interpreter and use '/usr/local/Zope-2.9.3' as a prefix.
     272         Python interpreter and use '/usr/local/Zope-2.9.8-final' as a prefix.
    258273
    259274     Basically, it tells you, that you can give a special Python
     
    291306       ::
    292307
    293          ~/zope/build/Zope-2.9.3$ ./configure --prefix=/home/user/zope/base/2_9_3
     308         ~/zope/build/Zope-2.9.8-final$ ./configure --prefix=/home/user/zope/base/2_9_8
    294309
    295310     Here we want Zope to be installed in
    296      /home/user/zope/base/2_9_3. Note, that the path
     311     /home/user/zope/base/2_9_8. Note, that the path
    297312     /home/user/zope/base/ must already exist before executing the
    298      above command, while the subdirectory '2_9_3' (yes, its a
     313     above command, while the subdirectory '2_9_8' (yes, its a
    299314     diretory name) should be created by the build process.
    300315
     
    322337       ::
    323338 
    324          ~/zope/build/Zope-2.9.3$ make
     339         ~/zope/build/Zope-2.9.8-final$ make
    325340
    326341     and, if everything worked fine:
     
    328343       ::
    329344
    330          ~/zope/build/Zope-2.9.3$ make install
     345         ~/zope/build/Zope-2.9.8-final$ make install
    331346
    332347     The first step, the call of 'make', takes the biggest amount of
     
    358373       ::
    359374
    360          ~$ cd /home/user/zope/base/2_9_3
    361 
    362      Instead of '2_9_3' you must use the name given to the prefix
     375         ~$ cd /home/user/zope/base/2_9_8
     376
     377     Instead of '2_9_8' you must use the name given to the prefix
    363378     option of the 'configure'-script above.
    364379
     
    368383       ::
    369384
    370          ~/zope/base/2_9_3$ ls
     385         ~/zope/base/2_9_8$ ls
    371386         bin  include  lib  skel  zopeskel
    372          ~/zope/base/2_9_3$ cd bin
    373          ~/zope/base/2_9_3/bin$ ls
     387         ~/zope/base/2_9_8$ cd bin
     388         ~/zope/base/2_9_8/bin$ ls
    374389         analyze.py        fstail.py           requestprofiler.py   zeoctl.py
    375390         checkbtrees.py    fstest.py           runzeo.py            zeopack.py
     
    393408      ::
    394409
    395         ~/zope/base/2_9_3/bin$ ./mkzopeinstance.py --help
     410        ~/zope/base/2_9_8/bin$ ./mkzopeinstance.py --help
    396411        mkzopeinstance.py:  Create a Zope instance home.
    397412
     
    420435      ::
    421436
    422         ~/zope/base/2_9_3/bin$ ./mkzopeinstance.py -d /home/user/zope/instances/myinstance1 -u user:secret
     437        ~/zope/base/2_9_8/bin$ ./mkzopeinstance.py -d /home/user/zope/instances/myinstance1 -u user:secret
    423438
    424439    This takes only about one second. If you do not give a username
     
    485500
    486501    With growing version numbers of Zope also the Zope configuration
    487     file grows larger and larger. For version 2.9.3 there are too many
     502    file grows larger and larger. For version 2.9.8 there are too many
    488503    options available in zope.conf, to discuss every single option
    489504    herein.
     
    595610
    596611*Uli Fouquet*
     612
     613(updated in 2009-01 to Zope 2.9.8, as used by current WAeUP portals, by Hraban)
Note: See TracChangeset for help on using the changeset viewer.