Skip to content

Z
Zope
Commit bb251bb1 authored by Jim Fulton's avatar Jim Fulton
Browse files
Options

Got rid of DOS line endings. Waaaa.

parent d2147ecd
Hide whitespace changes
Inline Side-by-side
Showing with 618 additions and 618 deletions
ZServer/ZService.py
View file @ bb251bb1
############################################################################## ##############################################################################
# #
# Zope Public License (ZPL) Version 1.0 # Zope Public License (ZPL) Version 1.0
# ------------------------------------- # -------------------------------------
# #
# Copyright (c) Digital Creations. All rights reserved. # Copyright (c) Digital Creations. All rights reserved.
# #
# This license has been certified as Open Source(tm). # This license has been certified as Open Source(tm).
# #
# Redistribution and use in source and binary forms, with or without # Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are # modification, are permitted provided that the following conditions are
# met: # met:
# #
# 1. Redistributions in source code must retain the above copyright # 1. Redistributions in source code must retain the above copyright
# notice, this list of conditions, and the following disclaimer. # notice, this list of conditions, and the following disclaimer.
# #
# 2. Redistributions in binary form must reproduce the above copyright # 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions, and the following disclaimer in # notice, this list of conditions, and the following disclaimer in
# the documentation and/or other materials provided with the # the documentation and/or other materials provided with the
# distribution. # distribution.
# #
# 3. Digital Creations requests that attribution be given to Zope # 3. Digital Creations requests that attribution be given to Zope
# in any manner possible. Zope includes a "Powered by Zope" # in any manner possible. Zope includes a "Powered by Zope"
# button that is installed by default. While it is not a license # button that is installed by default. While it is not a license
# violation to remove this button, it is requested that the # violation to remove this button, it is requested that the
# attribution remain. A significant investment has been put # attribution remain. A significant investment has been put
# into Zope, and this effort will continue if the Zope community # into Zope, and this effort will continue if the Zope community
# continues to grow. This is one way to assure that growth. # continues to grow. This is one way to assure that growth.
# #
# 4. All advertising materials and documentation mentioning # 4. All advertising materials and documentation mentioning
# features derived from or use of this software must display # features derived from or use of this software must display
# the following acknowledgement: # the following acknowledgement:
# #
# "This product includes software developed by Digital Creations # "This product includes software developed by Digital Creations
# for use in the Z Object Publishing Environment # for use in the Z Object Publishing Environment
# (http://www.zope.org/)." # (http://www.zope.org/)."
# #
# In the event that the product being advertised includes an # In the event that the product being advertised includes an
# intact Zope distribution (with copyright and license included) # intact Zope distribution (with copyright and license included)
# then this clause is waived. # then this clause is waived.
# #
# 5. Names associated with Zope or Digital Creations must not be used to # 5. Names associated with Zope or Digital Creations must not be used to
# endorse or promote products derived from this software without # endorse or promote products derived from this software without
# prior written permission from Digital Creations. # prior written permission from Digital Creations.
# #
# 6. Modified redistributions of any form whatsoever must retain # 6. Modified redistributions of any form whatsoever must retain
# the following acknowledgment: # the following acknowledgment:
# #
# "This product includes software developed by Digital Creations # "This product includes software developed by Digital Creations
# for use in the Z Object Publishing Environment # for use in the Z Object Publishing Environment
# (http://www.zope.org/)." # (http://www.zope.org/)."
# #
# Intact (re-)distributions of any official Zope release do not # Intact (re-)distributions of any official Zope release do not
# require an external acknowledgement. # require an external acknowledgement.
# #
# 7. Modifications are encouraged but must be packaged separately as # 7. Modifications are encouraged but must be packaged separately as
# patches to official Zope releases. Distributions that do not # patches to official Zope releases. Distributions that do not
# clearly separate the patches from the original work must be clearly # clearly separate the patches from the original work must be clearly
# labeled as unofficial distributions. Modifications which do not # labeled as unofficial distributions. Modifications which do not
# carry the name Zope may be packaged in any form, as long as they # carry the name Zope may be packaged in any form, as long as they
# conform to all of the clauses above. # conform to all of the clauses above.
# #
# #
# Disclaimer # Disclaimer
# #
# THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS ``AS IS'' AND ANY # THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS ``AS IS'' AND ANY
# EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DIGITAL CREATIONS OR ITS # PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DIGITAL CREATIONS OR ITS
# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND # USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT # OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
# OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF # OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE. # SUCH DAMAGE.
# #
# #
# This software consists of contributions made by Digital Creations and # This software consists of contributions made by Digital Creations and
# many individuals on behalf of Digital Creations. Specific # many individuals on behalf of Digital Creations. Specific
# attributions are listed in the accompanying credits file. # attributions are listed in the accompanying credits file.
# #
############################################################################## ##############################################################################
""" """
ZServer as a NT service. ZServer as a NT service.
The serice starts up and monitors a ZServer process. The serice starts up and monitors a ZServer process.
Features: Features:
* When you start the service it starts ZServer * When you start the service it starts ZServer
* When you stop the serivice it stops ZServer * When you stop the serivice it stops ZServer
* It monitors ZServer and restarts it if it exits abnormally * It monitors ZServer and restarts it if it exits abnormally
* If ZServer is shutdown from the web, the service stops. * If ZServer is shutdown from the web, the service stops.
* If ZServer cannot be restarted, the service stops. * If ZServer cannot be restarted, the service stops.
Usage: Usage:
Installation Installation
The ZServer service should be installed by the Zope Windows The ZServer service should be installed by the Zope Windows
installer. You can manually install, uninstall the service from installer. You can manually install, uninstall the service from
the commandline. the commandline.
ZService.py [options] install|update|remove|start [...] ZService.py [options] install|update|remove|start [...]
|stop|restart [...]|debug [...] |stop|restart [...]|debug [...]
Options for 'install' and 'update' commands only: Options for 'install' and 'update' commands only:
--username domain\username : The Username the service is to run --username domain\username : The Username the service is to run
under under
--password password : The password for the username --password password : The password for the username
--startup [manual|auto|disabled] : How the service starts, --startup [manual|auto|disabled] : How the service starts,
default = manual default = manual
Commands Commands
install : Installs the service install : Installs the service
update : Updates the service, use this when you change update : Updates the service, use this when you change
ZServer.py ZServer.py
remove : Removes the service remove : Removes the service
start : Starts the service, this can also be done from the start : Starts the service, this can also be done from the
services control panel services control panel
stop : Stops the service, this can also be done from the stop : Stops the service, this can also be done from the
services control panel services control panel
restart : Restarts the service restart : Restarts the service
debug : Runs the service in debug mode debug : Runs the service in debug mode
You can view the usage options by running ZServer.py without any You can view the usage options by running ZServer.py without any
arguments. arguments.
Note: you may have to register the Python service program first, Note: you may have to register the Python service program first,
win32\pythonservice.exe /register win32\pythonservice.exe /register
Starting Zope Starting Zope
Start Zope by clicking the 'start' button in the services control Start Zope by clicking the 'start' button in the services control
panel. You can set Zope to automatically start at boot time by panel. You can set Zope to automatically start at boot time by
choosing 'Auto' startup by clicking the 'statup' button. choosing 'Auto' startup by clicking the 'statup' button.
Stopping Zope Stopping Zope
Stop Zope by clicking the 'stop' button in the services control Stop Zope by clicking the 'stop' button in the services control
panel. You can also stop Zope through the web by going to the panel. You can also stop Zope through the web by going to the
Zope control panel and by clicking 'Shutdown'. Zope control panel and by clicking 'Shutdown'.
Event logging Event logging
Zope events are logged to the NT application event log. Use the Zope events are logged to the NT application event log. Use the
event viewer to keep track of Zope events. event viewer to keep track of Zope events.
Registry Settings Registry Settings
You can change how the service starts ZServer by editing a registry You can change how the service starts ZServer by editing a registry
key. key.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\
<Service Name>\Parameters\start <Service Name>\Parameters\start
The value of this key is the command which the service uses to The value of this key is the command which the service uses to
start ZServer. For example: start ZServer. For example:
"C:\Program Files\Zope\bin\python.exe" "C:\Program Files\Zope\bin\python.exe"
"C:\Program Files\Zope\z2.py" -w 8888 "C:\Program Files\Zope\z2.py" -w 8888
TODO: TODO:
* Integrate it into the Windows installer. * Integrate it into the Windows installer.
* Add ZLOG logging in addition to event log logging. * Add ZLOG logging in addition to event log logging.
* Make it easier to run multiple Zope services with one Zope install * Make it easier to run multiple Zope services with one Zope install
This script does for NT the same sort of thing zdaemon.py does for UNIX. This script does for NT the same sort of thing zdaemon.py does for UNIX.
Requires Python win32api extensions. Requires Python win32api extensions.
""" """
import sys, os, string, time, imp import sys, os, string, time, imp
# Some fancy path footwork is required here because we # Some fancy path footwork is required here because we
# may be run from python.exe or lib/win32/PythonService.exe # may be run from python.exe or lib/win32/PythonService.exe
home=os.path.split(os.path.split(sys.executable)[0])[0] home=os.path.split(os.path.split(sys.executable)[0])[0]
if sys.executable[-10:]!='python.exe': if sys.executable[-10:]!='python.exe':
home=os.path.split(home)[0] home=os.path.split(home)[0]
home=os.path.split(home)[0] home=os.path.split(home)[0]
sys.path.append(os.path.join(home, 'ZServer')) sys.path.append(os.path.join(home, 'ZServer'))
sys.path.append(os.path.join(home, 'bin', 'lib', 'win32')) sys.path.append(os.path.join(home, 'bin', 'lib', 'win32'))
sys.path.append(os.path.join(home, 'bin', 'lib', 'win32', 'lib')) sys.path.append(os.path.join(home, 'bin', 'lib', 'win32', 'lib'))
# pythoncom and pywintypes are special, and require these hacks when # pythoncom and pywintypes are special, and require these hacks when
# we dont have a standard Python installation around. # we dont have a standard Python installation around.
import win32api import win32api
def magic_import(modulename, filename): def magic_import(modulename, filename):
# by Mark Hammond # by Mark Hammond
try: try:
# See if it does import first! # See if it does import first!
return __import__(modulename) return __import__(modulename)
except ImportError: except ImportError:
pass pass
# win32 can find the DLL name. # win32 can find the DLL name.
h = win32api.LoadLibrary(filename) h = win32api.LoadLibrary(filename)
found = win32api.GetModuleFileName(h) found = win32api.GetModuleFileName(h)
# Python can load the module # Python can load the module
mod = imp.load_module(modulename, None, found, ('.dll', 'rb', imp.C_EXTENSION)) mod = imp.load_module(modulename, None, found, ('.dll', 'rb', imp.C_EXTENSION))
# inject it into the global module list. # inject it into the global module list.
sys.modules[modulename] = mod sys.modules[modulename] = mod
# And finally inject it into the namespace. # And finally inject it into the namespace.
globals()[modulename] = mod globals()[modulename] = mod
win32api.FreeLibrary(h) win32api.FreeLibrary(h)
magic_import('pywintypes','pywintypes15.dll') magic_import('pywintypes','pywintypes15.dll')
import win32serviceutil, win32service, win32event, win32process import win32serviceutil, win32service, win32event, win32process
try: import servicemanager try: import servicemanager
except: pass except: pass
class ZServerService(win32serviceutil.ServiceFramework): class ZServerService(win32serviceutil.ServiceFramework):
# Some trickery to determine the service name. The WISE # Some trickery to determine the service name. The WISE
# installer will write an svcname.txt to the ZServer dir # installer will write an svcname.txt to the ZServer dir
# that we can use to figure out our service name. # that we can use to figure out our service name.
path=os.path.join(home, 'ZServer', 'svcname.txt') path=os.path.join(home, 'ZServer', 'svcname.txt')
file=open(path, 'r') file=open(path, 'r')
_svc_name_=string.strip(file.readline()) _svc_name_=string.strip(file.readline())
file.close() file.close()
_svc_display_name_ = "Zope (%s)" % _svc_name_ _svc_display_name_ = "Zope (%s)" % _svc_name_
restart_min_time=5 # if ZServer restarts before this many restart_min_time=5 # if ZServer restarts before this many
# seconds then we have a problem, and # seconds then we have a problem, and
# need to stop the service. # need to stop the service.
def __init__(self, args): def __init__(self, args):
win32serviceutil.ServiceFramework.__init__(self, args) win32serviceutil.ServiceFramework.__init__(self, args)
self.hWaitStop = win32event.CreateEvent(None, 0, 0, None) self.hWaitStop = win32event.CreateEvent(None, 0, 0, None)
def SvcDoRun(self): def SvcDoRun(self):
self.start_zserver() self.start_zserver()
while 1: while 1:
rc=win32event.WaitForMultipleObjects( rc=win32event.WaitForMultipleObjects(
(self.hWaitStop, self.hZServer), 0, win32event.INFINITE) (self.hWaitStop, self.hZServer), 0, win32event.INFINITE)
if rc - win32event.WAIT_OBJECT_0 == 0: if rc - win32event.WAIT_OBJECT_0 == 0:
break break
else: else:
self.restart_zserver() self.restart_zserver()
self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING, 5000) self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING, 5000)
def SvcStop(self): def SvcStop(self):
servicemanager.LogInfoMsg('Stopping Zope.') servicemanager.LogInfoMsg('Stopping Zope.')
try: try:
self.stop_zserver() self.stop_zserver()
except: except:
pass pass
self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING) self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
win32event.SetEvent(self.hWaitStop) win32event.SetEvent(self.hWaitStop)
def start_zserver(self): def start_zserver(self):
sc=self.get_start_command() sc=self.get_start_command()
result=win32process.CreateProcess(None, self.get_start_command(), result=win32process.CreateProcess(None, self.get_start_command(),
None, None, 0, 0, None, None, win32process.STARTUPINFO()) None, None, 0, 0, None, None, win32process.STARTUPINFO())
self.hZServer=result[0] self.hZServer=result[0]
self.last_start_time=time.time() self.last_start_time=time.time()
servicemanager.LogInfoMsg('Starting Zope.') servicemanager.LogInfoMsg('Starting Zope.')
def stop_zserver(self): def stop_zserver(self):
win32process.TerminateProcess(self.hZServer,0) win32process.TerminateProcess(self.hZServer,0)
def restart_zserver(self): def restart_zserver(self):
if time.time() - self.last_start_time < self.restart_min_time: if time.time() - self.last_start_time < self.restart_min_time:
servicemanager.LogErrorMsg('Zope died and could not be restarted.') servicemanager.LogErrorMsg('Zope died and could not be restarted.')
self.SvcStop() self.SvcStop()
code=win32process.GetExitCodeProcess(self.hZServer) code=win32process.GetExitCodeProcess(self.hZServer)
if code == 0: if code == 0:
# Exited with a normal status code, # Exited with a normal status code,
# assume that shutdown is intentional. # assume that shutdown is intentional.
self.SvcStop() self.SvcStop()
else: else:
servicemanager.LogWarningMsg('Restarting Zope.') servicemanager.LogWarningMsg('Restarting Zope.')
self.start_zserver() self.start_zserver()
def get_start_command(self): def get_start_command(self):
return win32serviceutil.GetServiceCustomOption(self,'start') return win32serviceutil.GetServiceCustomOption(self,'start')
def set_start_command(value): def set_start_command(value):
"sets the ZServer start command" "sets the ZServer start command"
win32serviceutil.SetServiceCustomOption(ZServerService,'start',value) win32serviceutil.SetServiceCustomOption(ZServerService,'start',value)
if __name__=='__main__': if __name__=='__main__':
win32serviceutil.HandleCommandLine(ZServerService) win32serviceutil.HandleCommandLine(ZServerService)
if 'install' in sys.argv: if 'install' in sys.argv:
command='"%s" "%s" -S' % (sys.executable, os.path.join(home,'z2.py')) command='"%s" "%s" -S' % (sys.executable, os.path.join(home,'z2.py'))
set_start_command(command) set_start_command(command)
print "Setting ZServer start command to:", command print "Setting ZServer start command to:", command
lib/python/ZServer/ZService.py
View file @ bb251bb1
############################################################################## ##############################################################################
# #
# Zope Public License (ZPL) Version 1.0 # Zope Public License (ZPL) Version 1.0
# ------------------------------------- # -------------------------------------
# #
# Copyright (c) Digital Creations. All rights reserved. # Copyright (c) Digital Creations. All rights reserved.
# #
# This license has been certified as Open Source(tm). # This license has been certified as Open Source(tm).
# #
# Redistribution and use in source and binary forms, with or without # Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are # modification, are permitted provided that the following conditions are
# met: # met:
# #
# 1. Redistributions in source code must retain the above copyright # 1. Redistributions in source code must retain the above copyright
# notice, this list of conditions, and the following disclaimer. # notice, this list of conditions, and the following disclaimer.
# #
# 2. Redistributions in binary form must reproduce the above copyright # 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions, and the following disclaimer in # notice, this list of conditions, and the following disclaimer in
# the documentation and/or other materials provided with the # the documentation and/or other materials provided with the
# distribution. # distribution.
# #
# 3. Digital Creations requests that attribution be given to Zope # 3. Digital Creations requests that attribution be given to Zope
# in any manner possible. Zope includes a "Powered by Zope" # in any manner possible. Zope includes a "Powered by Zope"
# button that is installed by default. While it is not a license # button that is installed by default. While it is not a license
# violation to remove this button, it is requested that the # violation to remove this button, it is requested that the
# attribution remain. A significant investment has been put # attribution remain. A significant investment has been put
# into Zope, and this effort will continue if the Zope community # into Zope, and this effort will continue if the Zope community
# continues to grow. This is one way to assure that growth. # continues to grow. This is one way to assure that growth.
# #
# 4. All advertising materials and documentation mentioning # 4. All advertising materials and documentation mentioning
# features derived from or use of this software must display # features derived from or use of this software must display
# the following acknowledgement: # the following acknowledgement:
# #
# "This product includes software developed by Digital Creations # "This product includes software developed by Digital Creations
# for use in the Z Object Publishing Environment # for use in the Z Object Publishing Environment
# (http://www.zope.org/)." # (http://www.zope.org/)."
# #
# In the event that the product being advertised includes an # In the event that the product being advertised includes an
# intact Zope distribution (with copyright and license included) # intact Zope distribution (with copyright and license included)
# then this clause is waived. # then this clause is waived.
# #
# 5. Names associated with Zope or Digital Creations must not be used to # 5. Names associated with Zope or Digital Creations must not be used to
# endorse or promote products derived from this software without # endorse or promote products derived from this software without
# prior written permission from Digital Creations. # prior written permission from Digital Creations.
# #
# 6. Modified redistributions of any form whatsoever must retain # 6. Modified redistributions of any form whatsoever must retain
# the following acknowledgment: # the following acknowledgment:
# #
# "This product includes software developed by Digital Creations # "This product includes software developed by Digital Creations
# for use in the Z Object Publishing Environment # for use in the Z Object Publishing Environment
# (http://www.zope.org/)." # (http://www.zope.org/)."
# #
# Intact (re-)distributions of any official Zope release do not # Intact (re-)distributions of any official Zope release do not
# require an external acknowledgement. # require an external acknowledgement.
# #
# 7. Modifications are encouraged but must be packaged separately as # 7. Modifications are encouraged but must be packaged separately as
# patches to official Zope releases. Distributions that do not # patches to official Zope releases. Distributions that do not
# clearly separate the patches from the original work must be clearly # clearly separate the patches from the original work must be clearly
# labeled as unofficial distributions. Modifications which do not # labeled as unofficial distributions. Modifications which do not
# carry the name Zope may be packaged in any form, as long as they # carry the name Zope may be packaged in any form, as long as they
# conform to all of the clauses above. # conform to all of the clauses above.
# #
# #
# Disclaimer # Disclaimer
# #
# THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS ``AS IS'' AND ANY # THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS ``AS IS'' AND ANY
# EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DIGITAL CREATIONS OR ITS # PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DIGITAL CREATIONS OR ITS
# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND # USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT # OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
# OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF # OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE. # SUCH DAMAGE.
# #
# #
# This software consists of contributions made by Digital Creations and # This software consists of contributions made by Digital Creations and
# many individuals on behalf of Digital Creations. Specific # many individuals on behalf of Digital Creations. Specific
# attributions are listed in the accompanying credits file. # attributions are listed in the accompanying credits file.
# #
############################################################################## ##############################################################################
""" """
ZServer as a NT service. ZServer as a NT service.
The serice starts up and monitors a ZServer process. The serice starts up and monitors a ZServer process.
Features: Features:
* When you start the service it starts ZServer * When you start the service it starts ZServer
* When you stop the serivice it stops ZServer * When you stop the serivice it stops ZServer
* It monitors ZServer and restarts it if it exits abnormally * It monitors ZServer and restarts it if it exits abnormally
* If ZServer is shutdown from the web, the service stops. * If ZServer is shutdown from the web, the service stops.
* If ZServer cannot be restarted, the service stops. * If ZServer cannot be restarted, the service stops.
Usage: Usage:
Installation Installation
The ZServer service should be installed by the Zope Windows The ZServer service should be installed by the Zope Windows
installer. You can manually install, uninstall the service from installer. You can manually install, uninstall the service from
the commandline. the commandline.
ZService.py [options] install|update|remove|start [...] ZService.py [options] install|update|remove|start [...]
|stop|restart [...]|debug [...] |stop|restart [...]|debug [...]
Options for 'install' and 'update' commands only: Options for 'install' and 'update' commands only:
--username domain\username : The Username the service is to run --username domain\username : The Username the service is to run
under under
--password password : The password for the username --password password : The password for the username
--startup [manual|auto|disabled] : How the service starts, --startup [manual|auto|disabled] : How the service starts,
default = manual default = manual
Commands Commands
install : Installs the service install : Installs the service
update : Updates the service, use this when you change update : Updates the service, use this when you change
ZServer.py ZServer.py
remove : Removes the service remove : Removes the service
start : Starts the service, this can also be done from the start : Starts the service, this can also be done from the
services control panel services control panel
stop : Stops the service, this can also be done from the stop : Stops the service, this can also be done from the
services control panel services control panel
restart : Restarts the service restart : Restarts the service
debug : Runs the service in debug mode debug : Runs the service in debug mode
You can view the usage options by running ZServer.py without any You can view the usage options by running ZServer.py without any
arguments. arguments.
Note: you may have to register the Python service program first, Note: you may have to register the Python service program first,
win32\pythonservice.exe /register win32\pythonservice.exe /register
Starting Zope Starting Zope
Start Zope by clicking the 'start' button in the services control Start Zope by clicking the 'start' button in the services control
panel. You can set Zope to automatically start at boot time by panel. You can set Zope to automatically start at boot time by
choosing 'Auto' startup by clicking the 'statup' button. choosing 'Auto' startup by clicking the 'statup' button.
Stopping Zope Stopping Zope
Stop Zope by clicking the 'stop' button in the services control Stop Zope by clicking the 'stop' button in the services control
panel. You can also stop Zope through the web by going to the panel. You can also stop Zope through the web by going to the
Zope control panel and by clicking 'Shutdown'. Zope control panel and by clicking 'Shutdown'.
Event logging Event logging
Zope events are logged to the NT application event log. Use the Zope events are logged to the NT application event log. Use the
event viewer to keep track of Zope events. event viewer to keep track of Zope events.
Registry Settings Registry Settings
You can change how the service starts ZServer by editing a registry You can change how the service starts ZServer by editing a registry
key. key.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\
<Service Name>\Parameters\start <Service Name>\Parameters\start
The value of this key is the command which the service uses to The value of this key is the command which the service uses to
start ZServer. For example: start ZServer. For example:
"C:\Program Files\Zope\bin\python.exe" "C:\Program Files\Zope\bin\python.exe"
"C:\Program Files\Zope\z2.py" -w 8888 "C:\Program Files\Zope\z2.py" -w 8888
TODO: TODO:
* Integrate it into the Windows installer. * Integrate it into the Windows installer.
* Add ZLOG logging in addition to event log logging. * Add ZLOG logging in addition to event log logging.
* Make it easier to run multiple Zope services with one Zope install * Make it easier to run multiple Zope services with one Zope install
This script does for NT the same sort of thing zdaemon.py does for UNIX. This script does for NT the same sort of thing zdaemon.py does for UNIX.
Requires Python win32api extensions. Requires Python win32api extensions.
""" """
import sys, os, string, time, imp import sys, os, string, time, imp
# Some fancy path footwork is required here because we # Some fancy path footwork is required here because we
# may be run from python.exe or lib/win32/PythonService.exe # may be run from python.exe or lib/win32/PythonService.exe
home=os.path.split(os.path.split(sys.executable)[0])[0] home=os.path.split(os.path.split(sys.executable)[0])[0]
if sys.executable[-10:]!='python.exe': if sys.executable[-10:]!='python.exe':
home=os.path.split(home)[0] home=os.path.split(home)[0]
home=os.path.split(home)[0] home=os.path.split(home)[0]
sys.path.append(os.path.join(home, 'ZServer')) sys.path.append(os.path.join(home, 'ZServer'))
sys.path.append(os.path.join(home, 'bin', 'lib', 'win32')) sys.path.append(os.path.join(home, 'bin', 'lib', 'win32'))
sys.path.append(os.path.join(home, 'bin', 'lib', 'win32', 'lib')) sys.path.append(os.path.join(home, 'bin', 'lib', 'win32', 'lib'))
# pythoncom and pywintypes are special, and require these hacks when # pythoncom and pywintypes are special, and require these hacks when
# we dont have a standard Python installation around. # we dont have a standard Python installation around.
import win32api import win32api
def magic_import(modulename, filename): def magic_import(modulename, filename):
# by Mark Hammond # by Mark Hammond
try: try:
# See if it does import first! # See if it does import first!
return __import__(modulename) return __import__(modulename)
except ImportError: except ImportError:
pass pass
# win32 can find the DLL name. # win32 can find the DLL name.
h = win32api.LoadLibrary(filename) h = win32api.LoadLibrary(filename)
found = win32api.GetModuleFileName(h) found = win32api.GetModuleFileName(h)
# Python can load the module # Python can load the module
mod = imp.load_module(modulename, None, found, ('.dll', 'rb', imp.C_EXTENSION)) mod = imp.load_module(modulename, None, found, ('.dll', 'rb', imp.C_EXTENSION))
# inject it into the global module list. # inject it into the global module list.
sys.modules[modulename] = mod sys.modules[modulename] = mod
# And finally inject it into the namespace. # And finally inject it into the namespace.
globals()[modulename] = mod globals()[modulename] = mod
win32api.FreeLibrary(h) win32api.FreeLibrary(h)
magic_import('pywintypes','pywintypes15.dll') magic_import('pywintypes','pywintypes15.dll')
import win32serviceutil, win32service, win32event, win32process import win32serviceutil, win32service, win32event, win32process
try: import servicemanager try: import servicemanager
except: pass except: pass
class ZServerService(win32serviceutil.ServiceFramework): class ZServerService(win32serviceutil.ServiceFramework):
# Some trickery to determine the service name. The WISE # Some trickery to determine the service name. The WISE
# installer will write an svcname.txt to the ZServer dir # installer will write an svcname.txt to the ZServer dir
# that we can use to figure out our service name. # that we can use to figure out our service name.
path=os.path.join(home, 'ZServer', 'svcname.txt') path=os.path.join(home, 'ZServer', 'svcname.txt')
file=open(path, 'r') file=open(path, 'r')
_svc_name_=string.strip(file.readline()) _svc_name_=string.strip(file.readline())
file.close() file.close()
_svc_display_name_ = "Zope (%s)" % _svc_name_ _svc_display_name_ = "Zope (%s)" % _svc_name_
restart_min_time=5 # if ZServer restarts before this many restart_min_time=5 # if ZServer restarts before this many
# seconds then we have a problem, and # seconds then we have a problem, and
# need to stop the service. # need to stop the service.
def __init__(self, args): def __init__(self, args):
win32serviceutil.ServiceFramework.__init__(self, args) win32serviceutil.ServiceFramework.__init__(self, args)
self.hWaitStop = win32event.CreateEvent(None, 0, 0, None) self.hWaitStop = win32event.CreateEvent(None, 0, 0, None)
def SvcDoRun(self): def SvcDoRun(self):
self.start_zserver() self.start_zserver()
while 1: while 1:
rc=win32event.WaitForMultipleObjects( rc=win32event.WaitForMultipleObjects(
(self.hWaitStop, self.hZServer), 0, win32event.INFINITE) (self.hWaitStop, self.hZServer), 0, win32event.INFINITE)
if rc - win32event.WAIT_OBJECT_0 == 0: if rc - win32event.WAIT_OBJECT_0 == 0:
break break
else: else:
self.restart_zserver() self.restart_zserver()
self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING, 5000) self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING, 5000)
def SvcStop(self): def SvcStop(self):
servicemanager.LogInfoMsg('Stopping Zope.') servicemanager.LogInfoMsg('Stopping Zope.')
try: try:
self.stop_zserver() self.stop_zserver()
except: except:
pass pass
self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING) self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
win32event.SetEvent(self.hWaitStop) win32event.SetEvent(self.hWaitStop)
def start_zserver(self): def start_zserver(self):
sc=self.get_start_command() sc=self.get_start_command()
result=win32process.CreateProcess(None, self.get_start_command(), result=win32process.CreateProcess(None, self.get_start_command(),
None, None, 0, 0, None, None, win32process.STARTUPINFO()) None, None, 0, 0, None, None, win32process.STARTUPINFO())
self.hZServer=result[0] self.hZServer=result[0]
self.last_start_time=time.time() self.last_start_time=time.time()
servicemanager.LogInfoMsg('Starting Zope.') servicemanager.LogInfoMsg('Starting Zope.')
def stop_zserver(self): def stop_zserver(self):
win32process.TerminateProcess(self.hZServer,0) win32process.TerminateProcess(self.hZServer,0)
def restart_zserver(self): def restart_zserver(self):
if time.time() - self.last_start_time < self.restart_min_time: if time.time() - self.last_start_time < self.restart_min_time:
servicemanager.LogErrorMsg('Zope died and could not be restarted.') servicemanager.LogErrorMsg('Zope died and could not be restarted.')
self.SvcStop() self.SvcStop()
code=win32process.GetExitCodeProcess(self.hZServer) code=win32process.GetExitCodeProcess(self.hZServer)
if code == 0: if code == 0:
# Exited with a normal status code, # Exited with a normal status code,
# assume that shutdown is intentional. # assume that shutdown is intentional.
self.SvcStop() self.SvcStop()
else: else:
servicemanager.LogWarningMsg('Restarting Zope.') servicemanager.LogWarningMsg('Restarting Zope.')
self.start_zserver() self.start_zserver()
def get_start_command(self): def get_start_command(self):
return win32serviceutil.GetServiceCustomOption(self,'start') return win32serviceutil.GetServiceCustomOption(self,'start')
def set_start_command(value): def set_start_command(value):
"sets the ZServer start command" "sets the ZServer start command"
win32serviceutil.SetServiceCustomOption(ZServerService,'start',value) win32serviceutil.SetServiceCustomOption(ZServerService,'start',value)
if __name__=='__main__': if __name__=='__main__':
win32serviceutil.HandleCommandLine(ZServerService) win32serviceutil.HandleCommandLine(ZServerService)
if 'install' in sys.argv: if 'install' in sys.argv:
command='"%s" "%s" -S' % (sys.executable, os.path.join(home,'z2.py')) command='"%s" "%s" -S' % (sys.executable, os.path.join(home,'z2.py'))
set_start_command(command) set_start_command(command)
print "Setting ZServer start command to:", command print "Setting ZServer start command to:", command
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
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7