Commit 7385f6c8 authored by Tino Wildenhain's avatar Tino Wildenhain

Changed INSTALL.txt to focus new users on zopectl

rather then runzope to avoid all the hassle with
not detaching and thus mysteriously stopping zopes.
parent 6d458a29
......@@ -62,7 +62,17 @@ Building Zope
within the build directory (e.g. 'in-place'). You may start
Zope by running::
./bin/runzope
./bin/zopectl start
See ./log/event.log for any output which may happen during
start of Zope. If anything goes wrong you will see there.
If you use
./bin/zopectl fg
instead, the output is generated to the screen. In this case
Zope does not detach from terminal.
Optional: Building Zope Using The "Clean-Source-Tree" Method
......@@ -102,21 +112,44 @@ Starting Zope
Once an instance home has been created, the Zope server can now be
started using this command:
/location/of/zope/instance/bin/runzope
/location/of/zope/instance/bin/zopectl start
During start, zope emits log messages into ./log/event.log
You can examine it with the usual tools (cat, more, tail)
and see if there are any errors preventing zope from starting.
/location/of/zope/instance/bin/zopectl fg
can be used to instead output these messages to the console. This
way zope does not detach from terminal.
If you get errors indicating that addresses are in use, then you
will have to supply arguments to runzope to change the ports used
for HTTP or FTP. The default HTTP and FTP ports used by Zope are
8080 and 8021 respectively. You can change the ports used by
specifying the "port-base" parameter to runzope. For example, to
run Zope on ports 9080 and 9021::
editing ./etc/zope.conf apropriately.
The section usually is like this:
<http-server>
# valid keys are "address" and "force-connection-close"
address 8080
# force-connection-close on
</http-server>
address can just be a port number as shown, but also a host:port
pair to bind to a specific interface only.
zopectl can be linked as rc-script in the usual start directories
on linux or other system V unix variants.
./bin/runzope -X port-base=1000
You can use zopectl interactively as a command shell by just
calling it w/o any arguments. Try help there and help <command>
to find out about additionally commands of zopectl. These commands
work also on command line.
There is also an interactive Zope command shell named 'zopectl' that
may be invoked by running 'bin/zopectl'. By default, 'zopectl
start' will start a background process that manages Zope and
'zopectl stop' will stop the background process.
By default, 'zopectl start' will start a background process that
manages Zope and 'zopectl stop' will stop the background process.
Logging In To Zope
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment