3. Update

Follow the instructions in this section if previous versions Zope and Plone have been installed on your system.

  1. Become root, stop and uninstall your Zope server:

    markus@x60s:~> su -l
    Password:
    x60s:~ # rczope stop
    Shutting down zope, instances: default                               done
    x60s:~ # rpm -e zope

  2. Rename your existing Zope instance which usually resides in /var/opt/zope/default:

    x60s:~ # cd /var/opt/zope/
    x60s:/var/opt/zope # ls
    .  ..  default
    x60s:/var/opt/zope # mv default default.old
    x60s:/var/opt/zope # cd

  3. Unpack the bundle:

    x60s:~ # tar xvjf Plone-3.0.1-openSUSE_10.2_bundle.tar.bz2
    Plone-3.0.1-openSUSE_10.2_bundle/
    Plone-3.0.1-openSUSE_10.2_bundle/python24-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-curses-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-demo-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-devel-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-elementtree-1.2.6-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-gdbm-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-idle-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-imaging-1.1.6-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-imaging-sane-1.1.6-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-tk-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-xml-2.4.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/zope-2.10.4-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/plone-3.0.1-1.i586.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-doc-2.4.4-1.noarch.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/python24-doc-pdf-2.4.4-1.noarch.rpm
    Plone-3.0.1-openSUSE_10.2_bundle/README/
    Plone-3.0.1-openSUSE_10.2_bundle/README/index.html
    Plone-3.0.1-openSUSE_10.2_bundle/README/x19.html
    Plone-3.0.1-openSUSE_10.2_bundle/README/x48.html
    Plone-3.0.1-openSUSE_10.2_bundle/README/x102.html
    Plone-3.0.1-openSUSE_10.2_bundle/README/x167.html
    Plone-3.0.1-openSUSE_10.2_bundle/README/x177.html
    Plone-3.0.1-openSUSE_10.2_bundle/README/x182.html
    Plone-3.0.1-openSUSE_10.2_bundle/README/docbook.css
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/caution.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/home.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/important.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/next.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/note.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/prev.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/tip.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/toc-blank.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/toc-minus.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/toc-plus.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/up.gif
    Plone-3.0.1-openSUSE_10.2_bundle/README/stylesheet-images/warning.gif
    x60s:~ # cd Plone-3.0.1-openSUSE_10.2_bundle/
    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle #

  4. Install Python and the Python XML interface:

    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rpm -Uhv python24-2.4.4-1.i586.rpm
    Preparing...                ########################################### [100%]
       1:python24               ########################################### [100%]
    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rpm -Uhv python24-xml-2.4.4-1.i586.rpm
    Preparing...                ########################################### [100%]
       1:python24-xml           ########################################### [100%]

  5. Install ElementTree:

    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rpm -Uhv python24-elementtree-1.2.6-1.i586.rpm
    Preparing...                ########################################### [100%]
       1:python24-elementtree   ########################################### [100%]

  6. Install the Python Imaging Library (PIL). First make sure that the packages blt, tcl and tk contained in openSUSE 10.2 are installed. Then:

    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rpm -Uhv python24-tk-2.4.4-1.i586.rpm
    Preparing...                ########################################### [100%]
       1:python24-tk            ########################################### [100%]
    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rpm -Uhv python24-imaging-1.1.6-1.i586.rpm
    Preparing...                ########################################### [100%]
       1:python24-imaging       ########################################### [100%]

  7. Install Zope:

    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rpm -Uhv zope-2.10.4-1.i586.rpm
    Preparing...                ########################################### [100%]
       1:zope                   ########################################### [100%]
    Updating etc/sysconfig/zope...
    Default zope instance not found, creating
    Instance home not absolute, placing under /var/opt/zope.

    Important

    If you have updated from the an older Zope version and if you had not removed it as described in step 1 you will see the following error message:

    /usr/bin/python: can't open file '/opt/zope/lib/python/Zope/Startup/zopectl.py':
    [Errno 2] No such file or directory
    ..failed
    The reason is that you have to upgrade your instance before you are able to start your new Zope version. Read on to find out how to upgrade. You were shown the error message because the old package contained a command which tried to restart the application after an update. In the new version this behaviour has been changed since you wouldn't expect rpm to activate services.

  8. Read the section Upgrading from Earlier Versions of Zope in /usr/share/doc/packages/zope/FAQ.txt. It tells you to copy the data from your previous Zope instance:

    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # cd /var/opt/zope/
    x60s:/var/opt/zope # cp default.old/var/Data.fs default/var/
    x60s:/var/opt/zope # cp -r default.old/Products/* default/Products/
    x60s:/var/opt/zope # cp -r default.old/Extensions/* default/Extensions/
    

  9. Move your old Zope instance to a safe place other than /var/opt/zope.

  10. Install Plone:

    x60s:/var/opt/zope # cd ~/Plone-3.0.1-openSUSE_10.2_bundle/
    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rpm -Uhv plone-3.0.1-1.i586.rpm
    Preparing...                ########################################### [100%]
       1:plone                  ########################################### [100%]

  11. Start Zope to see if the installation was successful:

    x60s:~/Plone-3.0.1-openSUSE_10.2_bundle # rczope start
    Starting zope, instances: default                                    done
    Open the Zope start page (http://localhost:8080/) in a web browser. If you see a page named Zope Quick Start your Zope server is up and running.

  12. The last steps which are necessary to update your Plone instances are described in the Plone Upgrade Guide. You might step in at item 6: "Go to http://yoursite/manage (aka. the ZMI) and click portal_migrations."