Personal tools
You are here: Home → Documentation → Tutorials → Installing Plone 3 with the Unified Installer → Creating New Instances
Support

Get Help

Join our chat rooms or support forums if you have more specific questions.

Plone Training
Learn how to design, build, and deploy a website in Plone through one of the numerous Plone training sessions around the world.
Find Plone training…
 
Document Actions

Creating New Instances

The Unified Installer may be used to create additional Zope/Plone instances.

smcmahon

The Unified Installer is a kit for installing Zope and Plone from source on most Unix-like systems, including Linux, BSD, OS X and Solaris. This tutorial introduces its use and options.
Page 5 of 6.

Once you have used the Unified Installer to build a complete Plone 3 install, you may wish to create additional working instances to run other sites (or sets of sites). The Unified Installer makes it possible to set up new instances that will use the Python and Zope code base of your main install.

To install a new instance, first decide whether it will be a root or normal-user install. You may use the code base of a root-level install for a new root-level instance, or a non-root install for a new non-root instance. Also, the new instance may be a ZEO or stand-alone install, independent of the choice made for the main installation.

The Commands

Change into the directory containing the install.sh file of your unpacked Universal Installer.

Precede the following commands by "sudo" or by using "su -" to switch to root.

For a ZEO cluster instance:

./install.sh zeo --instance=new_instance_name

For a stand-alone Zope instance:

./install.sh standalone --instance=new_instance_name

new_instance_name should be a simple directory name -- not a full pathname. The new directory will be created as a new subdirectory of your full installation and will share its Python and buildout cache.

Setting New Ports

Your new instance isn't ready to run yet, because it's set to use the default ports and will conflict with the previous installation. Fortunately, that's easy to fix.

Change into the directory containing your new instance and open buildout.cfg with your favorite text editor.

If this is a standalone instance, you'll need to set a new port in just one spot:

http-address = 8080

There's a little more work for a ZEO instance. You'll need to change two http-address entries (one for each client) and the port for the ZEO server, which is set in the line:

zeo-address = 127.0.0.1:8100

Change only the port number (8100); leave the IP address alone.

Build It

Save your changes and run buildout to update all the parts of the installation:

bin/buildout

If this is a root install, preface the command with "sudo" or use su to change to root.

You're now ready to run your new instance.

Next: Command-Line Options Previous: Running the Unified Installer  
 
by smcmahon — last modified April 24, 2008 - 22:12 All content is copyright Plone Foundation and the individual contributors.

For any issues with the web site functionality, please file a ticket.

Please consult the policy on plone.org content if you want your content published on this site.

Servers and hosting by