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
...@@ -3,7 +3,7 @@ Building and installing Zope from source ...@@ -3,7 +3,7 @@ Building and installing Zope from source
Welcome to Zope! This document describes building and installing Welcome to Zope! This document describes building and installing
Zope on UNIX and Linux. Zope on UNIX and Linux.
See WINDOWS.txt for information about Windows. See the PLATFORMS See WINDOWS.txt for information about Windows. See the PLATFORMS
directory for notes about various other platforms. directory for notes about various other platforms.
...@@ -62,7 +62,17 @@ Building Zope ...@@ -62,7 +62,17 @@ Building Zope
within the build directory (e.g. 'in-place'). You may start within the build directory (e.g. 'in-place'). You may start
Zope by running:: 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 Optional: Building Zope Using The "Clean-Source-Tree" Method
...@@ -102,21 +112,44 @@ Starting Zope ...@@ -102,21 +112,44 @@ Starting Zope
Once an instance home has been created, the Zope server can now be Once an instance home has been created, the Zope server can now be
started using this command: 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 If you get errors indicating that addresses are in use, then you
will have to supply arguments to runzope to change the ports used 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 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 8080 and 8021 respectively. You can change the ports used by
specifying the "port-base" parameter to runzope. For example, to editing ./etc/zope.conf apropriately.
run Zope on ports 9080 and 9021::
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 By default, 'zopectl start' will start a background process that
may be invoked by running 'bin/zopectl'. By default, 'zopectl manages Zope and 'zopectl stop' will stop the background process.
start' will start a background process that manages Zope and
'zopectl stop' will stop the background process.
Logging In To Zope 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