UPDATE 5/14/08: We at the Open Planning Project no longer use topp.build.opencore.  For updated build instructions, see
getting-started
 

    getting started with topp-build-opencore

   1. 2.4.3 <= `python -V` < 2.5
   2. You will need to have *svn *and *wget* available on your execution
      path


    Quickstart

These are opinionated instructions on the most trouble free way to
install the opencore stack without polluting your machines site-packages
on a *nix OS. Windows users may be able to use parts of this process. If
you encounter problems, have suggestions or variation you think should
be published here, let us know </projects/opencore/contact_project_admins>.

   1. *Get workingenv

   2. *Create an environment*

      ~/$ workingenv/workingenv.py --home -r http://www.openplans.org/projects/opencore/getting-started/quickstart.txt mybuildenv

   3. *Activate environment*

                            ~/$ cd mybuildenv
                  ~/mybuildenv$ . bin/activate
      (mybuildenv)~/mybuildenv$                  # note how your prompt changes

   4. *Build all*

      (mybuildenv)~/mybuildenv$ build-opencore --deploydir ~/mydeployenv

      At the end you will get a list of instructions for starting zope
      and zeo with a default admin user name and password.

   5. *Switch to the deploy environment*

      (mybuildenv)~/mybuildenv$ cd ../mydeployenv
      (mybuildenv)~/mydeployenv$ source bin/activate
      (mydeployenv)~/mydeployenv$                  # note how your prompt changes



   6.

      *Start zope and zeo*. Start zope in the foreground so you can see
      any possible issues immediately.

      (mydeployenv)~/mydeployenv$ zeoctl start
      (mydeployenv)~/mydeployenv$ zopectl fg­

      *tip: *If you add '$WORKING_ENV/zeo/bin/zeoctl start' to
      '~/mydeployenv/bin/activate', zeo will be started everytime you
      activate the environment.

      At this point, you should be able to browse
      http://localhost:8080/manage_main and login using the default
      admin account.

   7. *Create an openplans site*.
      Use this form: http://localhost:8080/
      <http://localhost:8080/add-openplans.html>add-openplans.html
      <http://localhost:8080/add-openplans.html>




    More Info

There are a number of configuration options to the builder script,
allowing you to change the Zope and ZEO ports along with a handful of
other settings. You can run 'build-opencore --help' to see what options
are available to you. In particular, you may find the --with-products
options useful if you already one of the OpenCore product bundles on
your filesystem or have a custom bundle that extends opencore.



    Variations / Platform Specific Info


*Building Open Plans on Ubuntu
</projects/openplanscollaborationtest/building-open-plans-on-ubuntu>*

            /contributed by Rob Knapp/