Creating New Instances

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.

Reference...