[ZDP] BackTalk to Document The Zope Book (2.6 Edition)/Installing and Starting Zope

webmaster at zope.org webmaster at zope.org
Wed May 12 14:20:37 EDT 2004


A comment to the paragraph below was recently added via http://zope.org/Documentation/Books/ZopeBook/2_6Edition/InstallingZope.stx#2-40

---------------

    The Zope startup script named 'start' (or 'start.bat' on Windows)
    has many command-line switch options.  They are the same for UNIX
    and Windows (although some only work on one or the other).
    These command-line switches are detailed below::

        -h

          Output help text.

        -z path

          The location of the Zope installation.
          The default is the location of the "z2.py" script.

        -Z path

          Unix only! This option is ignored on windows.

          If this option is specified, a separate managemnt process will
          be created that restarts Zope after a shutdown (or crash).
          The path must point to a pid file that the process will record its
          process id in. The path may be relative, in which case it will be
          relative to the Zope location.

          To prevent use of a separate management process, provide an
          empty string: -Z=''

        -t n

          The number of threads to use.  The default is 4.

        -i n

          Set the interpreter check interval. This integer value
          determines how often the interpreter checks for periodic things
          such as thread switches and signal handlers. The Zope default
          is 500, but you may want to experiment with other values that
          may increase performance in your particular environment.

        -D

          Run in Zope debug mode.  This causes the Zope process not to
          detach from the controlling terminal, and is equivalent to
          supplying the environment variable setting Z_DEBUG_MODE=1

        -a ipaddress

          The IP address to listen on.  If this is an empty string
          (e.g. -a ''), then all addresses on the machine are used.

        -d ipaddress

          IP address of your DNS server. If this is an empty string
          (e.g. -d ''), then IP addresses will not be logged. If you have
          DNS service on your local machine then you can set this to
          127.0.0.1.

        -u username or uid number

          The username to run Zope as.  You may want to run Zope as
          a dedicated user.  This only works under Unix.  If Zope
          is started as root, it is a required parameter.

        -P [ipaddress:]number

          Set the web, ftp and monitor port numbers simultaneously
          as offsets from the number.  The web port number will be number+80.
          The FTP port number will be number+21.  The monitor port number will
          be number+99.

          The number can be preeceeded by an ip address follwed by a colon
          to specify an address to listen on. This allows different servers
          to listen on different addresses.

          Multiple -P options can be provided to run multiple sets of servers.

        -w port

          The Web server (HTTP) port.  This defaults to 8080. If this
          is a dash (e.g. -w -), then HTTP is disabled.

          The number can be preeceeded by an ip address follwed by a colon
          to specify an address to listen on. This allows different servers
          to listen on different addresses.

          Multiple -w options can be provided to run multiple servers.

        -W port

          The "WebDAV source" port.  If this is a dash (e.g. -w -), then
          "WebDAV source" is disabled.  The default is disabled.  Note that
          this feature is a workaround for the lack of "source-link" support
          in standard WebDAV clients.

          The port can be preeceeded by an ip address follwed by a colon
          to specify an address to listen on. This allows different servers
          to listen on different addresses.

          Multiple -W options can be provided to run multiple servers.

        -C
        --force-http-connection-close

          If present, this option causes Zope to close all HTTP connections,
          regardless of the 'Connection:' header (or lack of one) sent by
          the client.

        -f port

          The FTP port.  If this is a dash (e.g. -f -), then FTP
          is disabled.  The standard port for FTP services is 21.  The
          default is 8021.

          The port can be preeceeded by an ip address follwed by a colon
          to specify an address to listen on. This allows different servers
          to listen on different addresses.

          Multiple -f options can be provided to run multiple servers.

        -p path

          Path to the PCGI resource file.  The default value is
          var/pcgi.soc, relative to the Zope location.  If this is a dash
          (-p -) or the file does not exist, then PCGI is disabled.

        -F path_or_port

          Either a port number (for inet sockets) or a path name (for unix
          domain sockets) for the FastCGI Server.  If the flag and value are
          not specified then the FastCGI Server is disabled.

        -m port

          The secure monitor server port. If this is a dash
          (-m -), then the monitor server is disabled. The monitor server
          allows interactive Python style access to a running ZServer. To
          access the server see medusa/monitor_client.py or
          medusa/monitor_client_win32.py. The monitor server password is the
          same as the Zope emergency user password set in the 'access'
          file. The default is to not start up a monitor server.

          The port can be preeceeded by an ip address follwed by a colon
          to specify an address to listen on. This allows different servers
          to listen on different addresses.

          Multiple -m options can be provided to run multiple servers.

        --icp port

          The ICP port. ICP can be used to distribute load between back-end
          zope servers, if you are using an ICP-aware front-end proxy such
          as Squid.

          The port can be preeceeded by an ip address follwed by a colon
          to specify an address to listen on. This allows different servers
          to listen on different addresses.

          Multiple --icp options can be provided to run multiple servers.

        -l path

          Path to the ZServer log file. If this is a relative path then the
          log file will be written to the 'var' directory. The default is
          'var/Z2.log'. 

        -r

          Run ZServer is read-only mode. ZServer won't write anything to disk.
          No log files, no pid files, nothing. This means that you can't do a
          lot of stuff like use PCGI, and zdaemon. ZServer will log hits to
          STDOUT and zLOG will log to STDERR.

        -L

          Enable locale (internationalization) support. The value passed for
          this option should be the name of the locale to be used (see your
          operating system documentation for locale information specific to
          your system). If an empty string is passed for this option (-L ''),
          Zope will set the locale to the user's default setting (typically
          specified in the $LANG environment variable). If your Python
          installation does not support the locale module, the requested
          locale is not supported by your system or an empty string was
          passed but no default locale can be found, an error will be raised
          and Zope will not start.

        -X

          Disable servers. This might be used to effectively disable all
          default server settings or previous server settings in the option
          list before providing new settings. For example to provide just a
          web server:

            ./start -X -w80

        -M file

          Save detailed logging information to the given file.
          This log includes separate entries for:

            - The start of a request,
            - The start of processing the request in an application thread,
            - The start of response output, and
            - The end of the request.

      % Anonymous User - May 12, 2004 2:20 pm:
       How can one use these type of options if you have Zope setup as a Windows service? I tried to use the "Start
       parameters" field within Windows Services interface for my Zope Instance service but didn't seem to change
       the port numbers for example.



More information about the ZDP mailing list