1 # -*- coding: utf-8 -*-
2 ##############################################################################
4 # OpenERP, Open Source Management Solution
5 # Copyright (C) 2004-2009 Tiny SPRL (<http://tiny.be>).
7 # This program is free software: you can redistribute it and/or modify
8 # it under the terms of the GNU Affero General Public License as
9 # published by the Free Software Foundation, either version 3 of the
10 # License, or (at your option) any later version.
12 # This program is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU Affero General Public License for more details.
17 # You should have received a copy of the GNU Affero General Public License
18 # along with this program. If not, see <http://www.gnu.org/licenses/>.
20 ##############################################################################
33 from cStringIO import StringIO
34 from openerp.tools.translate import _
35 import openerp.netsvc as netsvc
36 import openerp.pooler as pooler
37 import openerp.release as release
38 import openerp.sql_db as sql_db
39 import openerp.tools as tools
40 import openerp.modules
41 import openerp.exceptions
42 from openerp.service import http_server
44 #.apidoc title: Exported Service methods
45 #.apidoc module-mods: member-order: bysource
47 """ This python module defines the RPC methods available to remote clients.
49 Each 'Export Service' is a group of 'methods', which in turn are RPC
50 procedures to be called. Each method has its own arguments footprint.
53 _logger = logging.getLogger(__name__)
55 RPC_VERSION_1 = {'server_version': '6.1', 'protocol_version': 1}
57 # This should be moved to openerp.modules.db, along side initialize().
58 def _initialize_db(serv, id, db_name, demo, lang, user_password):
61 serv.actions[id]['progress'] = 0
62 cr = sql_db.db_connect(db_name).cursor()
63 openerp.modules.db.initialize(cr) # TODO this should be removed as it is done by pooler.restart_pool.
64 tools.config['lang'] = lang
68 pool = pooler.restart_pool(db_name, demo, serv.actions[id],
69 update_module=True)[1]
71 cr = sql_db.db_connect(db_name).cursor()
74 modobj = pool.get('ir.module.module')
75 mids = modobj.search(cr, 1, [('state', '=', 'installed')])
76 modobj.update_translations(cr, 1, mids, lang)
78 cr.execute('UPDATE res_users SET password=%s, context_lang=%s, active=True WHERE login=%s', (
79 user_password, lang, 'admin'))
80 cr.execute('SELECT login, password, name ' \
83 serv.actions[id].update(users=cr.dictfetchall(), clean=True)
87 serv.actions[id].update(clean=False, exception=e)
88 _logger.exception('CREATE DATABASE failed:')
89 serv.actions[id]['traceback'] = traceback.format_exc()
93 class db(netsvc.ExportService):
94 def __init__(self, name="db"):
95 netsvc.ExportService.__init__(self, name)
98 self.id_protect = threading.Semaphore()
100 self._pg_psw_env_var_is_set = False # on win32, pg_dump need the PGPASSWORD env var
102 def dispatch(self, method, params):
103 if method in [ 'create', 'get_progress', 'drop', 'dump',
105 'change_admin_password', 'migrate_databases',
109 security.check_super(passwd)
110 elif method in [ 'db_exist', 'list', 'list_lang', 'server_version' ]:
112 # No security check for these methods
115 raise KeyError("Method not found: %s" % method)
116 fn = getattr(self, 'exp_'+method)
119 def _create_empty_database(self, name):
120 db = sql_db.db_connect('template1')
122 chosen_template = tools.config['db_template']
124 cr.autocommit(True) # avoid transaction block
125 cr.execute("""CREATE DATABASE "%s" ENCODING 'unicode' TEMPLATE "%s" """ % (name, chosen_template))
129 def exp_create(self, db_name, demo, lang, user_password='admin'):
130 self.id_protect.acquire()
133 self.id_protect.release()
135 self.actions[id] = {'clean': False}
137 self._create_empty_database(db_name)
139 _logger.info('CREATE DATABASE %s', db_name.lower())
140 create_thread = threading.Thread(target=_initialize_db,
141 args=(self, id, db_name, demo, lang, user_password))
142 create_thread.start()
143 self.actions[id]['thread'] = create_thread
146 def exp_create_database(self, db_name, demo, lang, user_password='admin'):
147 """ Similar to exp_create but blocking."""
148 self.id_protect.acquire()
151 self.id_protect.release()
153 self.actions[id] = {'clean': False}
155 _logger.info('CREATE DATABASE %s', db_name.lower())
156 self._create_empty_database(db_name)
157 _initialize_db(self, id, db_name, demo, lang, user_password)
160 def exp_get_progress(self, id):
161 if self.actions[id]['thread'].isAlive():
162 # return openerp.modules.init_progress[db_name]
163 return (min(self.actions[id].get('progress', 0),0.95), [])
165 clean = self.actions[id]['clean']
167 users = self.actions[id]['users']
171 e = self.actions[id]['exception'] # TODO this seems wrong: actions[id]['traceback'] is set, but not 'exception'.
175 def exp_drop(self, db_name):
176 openerp.modules.registry.RegistryManager.delete(db_name)
177 sql_db.close_db(db_name)
179 db = sql_db.db_connect('template1')
181 cr.autocommit(True) # avoid transaction block
184 cr.execute('DROP DATABASE "%s"' % db_name)
186 _logger.error('DROP DB: %s failed:\n%s', db_name, e)
187 raise Exception("Couldn't drop database %s: %s" % (db_name, e))
189 _logger.info('DROP DB: %s', db_name)
195 def _set_pg_psw_env_var(self):
196 # see http://www.postgresql.org/docs/8.4/static/libpq-envars.html
197 # FIXME: This is not thread-safe, and should never be enabled for
198 # SaaS (giving SaaS users the super-admin password is not a good idea
200 if tools.config['db_password'] and not os.environ.get('PGPASSWORD', ''):
201 os.environ['PGPASSWORD'] = tools.config['db_password']
202 self._pg_psw_env_var_is_set = True
204 def _unset_pg_psw_env_var(self):
205 if self._pg_psw_env_var_is_set:
206 os.environ['PGPASSWORD'] = ''
208 def exp_dump(self, db_name):
210 self._set_pg_psw_env_var()
211 cmd = ['pg_dump', '--format=c', '--no-owner']
212 if tools.config['db_user']:
213 cmd.append('--username=' + tools.config['db_user'])
214 if tools.config['db_host']:
215 cmd.append('--host=' + tools.config['db_host'])
216 if tools.config['db_port']:
217 cmd.append('--port=' + str(tools.config['db_port']))
220 stdin, stdout = tools.exec_pg_command_pipe(*tuple(cmd))
227 'DUMP DB: %s failed! Please verify the configuration of the database password on the server. '\
228 'It should be provided as a -w <PASSWD> command-line option, or as `db_password` in the '\
229 'server configuration file.\n %s' % (db_name, data))
230 raise Exception, "Couldn't dump database"
231 _logger.info('DUMP DB successful: %s', db_name)
233 return base64.encodestring(data)
235 self._unset_pg_psw_env_var()
237 def exp_restore(self, db_name, data):
239 self._set_pg_psw_env_var()
241 if self.exp_db_exist(db_name):
242 _logger.warning('RESTORE DB: %s already exists' % (db_name,))
243 raise Exception, "Database already exists"
245 self._create_empty_database(db_name)
247 cmd = ['pg_restore', '--no-owner']
248 if tools.config['db_user']:
249 cmd.append('--username=' + tools.config['db_user'])
250 if tools.config['db_host']:
251 cmd.append('--host=' + tools.config['db_host'])
252 if tools.config['db_port']:
253 cmd.append('--port=' + str(tools.config['db_port']))
254 cmd.append('--dbname=' + db_name)
257 buf=base64.decodestring(data)
259 tmpfile = (os.environ['TMP'] or 'C:\\') + os.tmpnam()
260 file(tmpfile, 'wb').write(buf)
262 args2.append(' ' + tmpfile)
264 stdin, stdout = tools.exec_pg_command_pipe(*args2)
265 if not os.name == "nt":
266 stdin.write(base64.decodestring(data))
270 raise Exception, "Couldn't restore database"
271 _logger.info('RESTORE DB: %s' % (db_name))
275 self._unset_pg_psw_env_var()
277 def exp_rename(self, old_name, new_name):
278 openerp.modules.registry.RegistryManager.delete(old_name)
279 sql_db.close_db(old_name)
281 db = sql_db.db_connect('template1')
283 cr.autocommit(True) # avoid transaction block
286 cr.execute('ALTER DATABASE "%s" RENAME TO "%s"' % (old_name, new_name))
288 _logger.error('RENAME DB: %s -> %s failed:\n%s', old_name, new_name, e)
289 raise Exception("Couldn't rename database %s to %s: %s" % (old_name, new_name, e))
291 fs = os.path.join(tools.config['root_path'], 'filestore')
292 if os.path.exists(os.path.join(fs, old_name)):
293 os.rename(os.path.join(fs, old_name), os.path.join(fs, new_name))
295 _logger.info('RENAME DB: %s -> %s', old_name, new_name)
300 def exp_db_exist(self, db_name):
301 ## Not True: in fact, check if connection to database is possible. The database may exists
302 return bool(sql_db.db_connect(db_name))
304 def exp_list(self, document=False):
305 if not tools.config['list_db'] and not document:
306 raise openerp.exceptions.AccessDenied()
307 chosen_template = tools.config['db_template']
308 templates_list = tuple(set(['template0', 'template1', 'postgres', chosen_template]))
309 db = sql_db.db_connect('template1')
313 db_user = tools.config["db_user"]
314 if not db_user and os.name == 'posix':
316 db_user = pwd.getpwuid(os.getuid())[0]
318 cr.execute("select usename from pg_user where usesysid=(select datdba from pg_database where datname=%s)", (tools.config["db_name"],))
320 db_user = res and str(res[0])
322 cr.execute("select datname from pg_database where datdba=(select usesysid from pg_user where usename=%s) and datname not in %s order by datname", (db_user, templates_list))
324 cr.execute("select datname from pg_database where datname not in %s order by datname", (templates_list,))
325 res = [str(name) for (name,) in cr.fetchall()]
333 def exp_change_admin_password(self, new_password):
334 tools.config['admin_passwd'] = new_password
338 def exp_list_lang(self):
339 return tools.scan_languages()
341 def exp_server_version(self):
342 """ Return the version of the server
343 Used by the client to verify the compatibility with its own version
345 return release.version
347 def exp_migrate_databases(self,databases):
349 from openerp.osv.orm import except_orm
350 from openerp.osv.osv import except_osv
354 _logger.info('migrate database %s', db)
355 tools.config['update']['base'] = True
356 pooler.restart_pool(db, force_demo=False, update_module=True)
357 except except_orm, inst:
358 netsvc.abort_response(1, inst.name, 'warning', inst.value)
359 except except_osv, inst:
360 netsvc.abort_response(1, inst.name, 'warning', inst.value)
362 _logger.exception('Exception in migrate_databases:')
366 class common(netsvc.ExportService):
368 def __init__(self,name="common"):
369 netsvc.ExportService.__init__(self,name)
371 def dispatch(self, method, params):
372 if method in ['login', 'about', 'timezone_get', 'get_server_environment',
373 'login_message','get_stats', 'check_connectivity',
374 'list_http_services', 'version', 'authenticate']:
376 elif method in ['get_available_updates', 'get_migration_scripts', 'set_loglevel', 'get_os_time', 'get_sqlcount']:
379 security.check_super(passwd)
381 raise Exception("Method not found: %s" % method)
383 fn = getattr(self, 'exp_'+method)
386 def exp_login(self, db, login, password):
387 # TODO: legacy indirection through 'security', should use directly
388 # the res.users model
389 res = security.login(db, login, password)
390 msg = res and 'successful login' or 'bad login or password'
391 _logger.info("%s from '%s' using database '%s'", msg, login, db.lower())
394 def exp_authenticate(self, db, login, password, user_agent_env):
395 res_users = pooler.get_pool(db).get('res.users')
396 return res_users.authenticate(db, login, password, user_agent_env)
398 def exp_version(self):
401 def exp_about(self, extended=False):
402 """Return information about the OpenERP Server.
404 @param extended: if True then return version info
405 @return string if extended is False else tuple
410 OpenERP is an ERP+CRM program for small and medium businesses.
412 The whole source code is distributed under the terms of the
415 (c) 2003-TODAY, Fabien Pinckaers - Tiny sprl''')
418 return info, release.version
421 def exp_timezone_get(self, db, login, password):
422 return tools.misc.get_server_timezone()
424 def exp_get_available_updates(self, contract_id, contract_password):
425 import openerp.tools.maintenance as tm
427 rc = tm.remote_contract(contract_id, contract_password)
429 raise tm.RemoteContractException('This contract does not exist or is not active')
431 return rc.get_available_updates(rc.id, openerp.modules.get_modules_with_version())
433 except tm.RemoteContractException, e:
434 netsvc.abort_response(1, 'Migration Error', 'warning', str(e))
437 def exp_get_migration_scripts(self, contract_id, contract_password):
438 import openerp.tools.maintenance as tm
440 rc = tm.remote_contract(contract_id, contract_password)
442 raise tm.RemoteContractException('This contract does not exist or is not active')
443 if rc.status != 'full':
444 raise tm.RemoteContractException('Can not get updates for a partial contract')
446 _logger.info('starting migration with contract %s', rc.name)
448 zips = rc.retrieve_updates(rc.id, openerp.modules.get_modules_with_version())
450 from shutil import rmtree, copytree, copy
452 backup_directory = os.path.join(tools.config['root_path'], 'backup', time.strftime('%Y-%m-%d-%H-%M'))
453 if zips and not os.path.isdir(backup_directory):
454 _logger.info('create a new backup directory to \
455 store the old modules: %s', backup_directory)
456 os.makedirs(backup_directory)
459 _logger.info('upgrade module %s', module)
460 mp = openerp.modules.get_module_path(module)
462 if os.path.isdir(mp):
463 copytree(mp, os.path.join(backup_directory, module))
464 if os.path.islink(mp):
469 copy(mp + 'zip', backup_directory)
470 os.unlink(mp + '.zip')
474 base64_decoded = base64.decodestring(zips[module])
476 _logger.error('unable to read the module %s', module)
479 zip_contents = StringIO(base64_decoded)
483 tools.extract_zip_file(zip_contents, tools.config['addons_path'] )
485 _logger.error('unable to extract the module %s', module)
491 _logger.error('restore the previous version of the module %s', module)
492 nmp = os.path.join(backup_directory, module)
493 if os.path.isdir(nmp):
494 copytree(nmp, tools.config['addons_path'])
496 copy(nmp+'.zip', tools.config['addons_path'])
500 except tm.RemoteContractException, e:
501 netsvc.abort_response(1, 'Migration Error', 'warning', str(e))
503 _logger.exception('Exception in get_migration_script:')
506 def exp_get_server_environment(self):
507 os_lang = '.'.join( [x for x in locale.getdefaultlocale() if x] )
510 environment = '\nEnvironment Information : \n' \
513 %(platform.platform(), platform.os.name)
514 if os.name == 'posix':
515 if platform.system() == 'Linux':
516 lsbinfo = os.popen('lsb_release -a').read()
517 environment += '%s'%(lsbinfo)
519 environment += 'Your System is not lsb compliant\n'
520 environment += 'Operating System Release : %s\n' \
521 'Operating System Version : %s\n' \
522 'Operating System Architecture : %s\n' \
523 'Operating System Locale : %s\n'\
524 'Python Version : %s\n'\
525 'OpenERP-Server Version : %s'\
526 %(platform.release(), platform.version(), platform.architecture()[0],
527 os_lang, platform.python_version(),release.version)
530 def exp_login_message(self):
531 return tools.config.get('login_message', False)
533 def exp_set_loglevel(self, loglevel, logger=None):
534 # TODO Previously, the level was set on the now deprecated
535 # `openerp.netsvc.Logger` class.
538 def exp_get_stats(self):
539 res = "OpenERP server: %d threads\n" % threading.active_count()
540 res += netsvc.Server.allStats()
543 def exp_list_http_services(self):
544 return http_server.list_http_services()
546 def exp_check_connectivity(self):
547 return bool(sql_db.db_connect('template1'))
549 def exp_get_os_time(self):
552 def exp_get_sqlcount(self):
553 if not logging.getLogger('openerp.sql_db').isEnabledFor(logging.DEBUG):
554 _logger.warning("Counters of SQL will not be reliable unless logger openerp.sql_db is set to level DEBUG or higer.")
555 return sql_db.sql_counter
558 class objects_proxy(netsvc.ExportService):
559 def __init__(self, name="object"):
560 netsvc.ExportService.__init__(self,name)
562 def dispatch(self, method, params):
563 (db, uid, passwd ) = params[0:3]
565 if method == 'obj_list':
566 raise NameError("obj_list has been discontinued via RPC as of 6.0, please query ir.model directly!")
567 if method not in ['execute', 'execute_kw', 'exec_workflow']:
568 raise NameError("Method not available %s" % method)
569 security.check(db,uid,passwd)
570 assert openerp.osv.osv.service, "The object_proxy class must be started with start_object_proxy."
571 fn = getattr(openerp.osv.osv.service, method)
572 res = fn(db, uid, *params)
578 # - None = end of wizard
580 # Wizard Type: 'form'
585 # TODO: change local request to OSE request/reply pattern
587 class wizard(netsvc.ExportService):
588 def __init__(self, name='wizard'):
589 netsvc.ExportService.__init__(self,name)
595 def dispatch(self, method, params):
596 (db, uid, passwd ) = params[0:3]
598 if method not in ['execute','create']:
599 raise KeyError("Method not supported %s" % method)
600 security.check(db,uid,passwd)
601 fn = getattr(self, 'exp_'+method)
602 res = fn(db, uid, *params)
605 def _execute(self, db, uid, wiz_id, datas, action, context):
606 self.wiz_datas[wiz_id].update(datas)
607 wiz = netsvc.LocalService('wizard.'+self.wiz_name[wiz_id])
608 return wiz.execute(db, uid, self.wiz_datas[wiz_id], action, context)
610 def exp_create(self, db, uid, wiz_name, datas=None):
613 #FIXME: this is not thread-safe
615 self.wiz_datas[self.id] = {}
616 self.wiz_name[self.id] = wiz_name
617 self.wiz_uid[self.id] = uid
620 def exp_execute(self, db, uid, wiz_id, datas, action='init', context=None):
624 if wiz_id in self.wiz_uid:
625 if self.wiz_uid[wiz_id] == uid:
626 return self._execute(db, uid, wiz_id, datas, action, context)
628 raise openerp.exceptions.AccessDenied()
630 raise openerp.exceptions.Warning('Wizard not found.')
633 # TODO: set a maximum report number per user to avoid DOS attacks
639 class report_spool(netsvc.ExportService):
640 def __init__(self, name='report'):
641 netsvc.ExportService.__init__(self, name)
644 self.id_protect = threading.Semaphore()
646 def dispatch(self, method, params):
647 (db, uid, passwd ) = params[0:3]
649 if method not in ['report', 'report_get', 'render_report']:
650 raise KeyError("Method not supported %s" % method)
651 security.check(db,uid,passwd)
652 fn = getattr(self, 'exp_' + method)
653 res = fn(db, uid, *params)
656 def exp_render_report(self, db, uid, object, ids, datas=None, context=None):
662 self.id_protect.acquire()
665 self.id_protect.release()
667 self._reports[id] = {'uid': uid, 'result': False, 'state': False, 'exception': None}
669 cr = pooler.get_db(db).cursor()
671 obj = netsvc.LocalService('report.'+object)
672 (result, format) = obj.create(cr, uid, ids, datas, context)
675 self._reports[id]['exception'] = openerp.exceptions.DeferredException('RML is not available at specified location or not enough data to print!', tb)
676 self._reports[id]['result'] = result
677 self._reports[id]['format'] = format
678 self._reports[id]['state'] = True
679 except Exception, exception:
681 _logger.exception('Exception: %s\n', str(exception))
682 if hasattr(exception, 'name') and hasattr(exception, 'value'):
683 self._reports[id]['exception'] = openerp.exceptions.DeferredException(tools.ustr(exception.name), tools.ustr(exception.value))
686 self._reports[id]['exception'] = openerp.exceptions.DeferredException(tools.exception_to_unicode(exception), tb)
687 self._reports[id]['state'] = True
691 return self._check_report(id)
693 def exp_report(self, db, uid, object, ids, datas=None, context=None):
699 self.id_protect.acquire()
702 self.id_protect.release()
704 self._reports[id] = {'uid': uid, 'result': False, 'state': False, 'exception': None}
706 def go(id, uid, ids, datas, context):
707 cr = pooler.get_db(db).cursor()
709 obj = netsvc.LocalService('report.'+object)
710 (result, format) = obj.create(cr, uid, ids, datas, context)
713 self._reports[id]['exception'] = openerp.exceptions.DeferredException('RML is not available at specified location or not enough data to print!', tb)
714 self._reports[id]['result'] = result
715 self._reports[id]['format'] = format
716 self._reports[id]['state'] = True
717 except Exception, exception:
718 _logger.exception('Exception: %s\n', str(exception))
719 if hasattr(exception, 'name') and hasattr(exception, 'value'):
720 self._reports[id]['exception'] = openerp.exceptions.DeferredException(tools.ustr(exception.name), tools.ustr(exception.value))
723 self._reports[id]['exception'] = openerp.exceptions.DeferredException(tools.exception_to_unicode(exception), tb)
724 self._reports[id]['state'] = True
729 thread.start_new_thread(go, (id, uid, ids, datas, context))
732 def _check_report(self, report_id):
733 result = self._reports[report_id]
734 exc = result['exception']
736 netsvc.abort_response(exc, exc.message, 'warning', exc.traceback)
737 res = {'state': result['state']}
739 if tools.config['reportgz']:
741 res2 = zlib.compress(result['result'])
744 #CHECKME: why is this needed???
745 if isinstance(result['result'], unicode):
746 res2 = result['result'].encode('latin1', 'replace')
748 res2 = result['result']
750 res['result'] = base64.encodestring(res2)
751 res['format'] = result['format']
752 del self._reports[report_id]
755 def exp_report_get(self, db, uid, report_id):
756 if report_id in self._reports:
757 if self._reports[report_id]['uid'] == uid:
758 return self._check_report(report_id)
760 raise Exception, 'AccessDenied'
762 raise Exception, 'ReportNotFound'
765 def start_web_services():
773 # vim:expandtab:smartindent:tabstop=4:softtabstop=4:shiftwidth=4: