diff --git a/doc/README.services_extension b/doc/README.services_extension new file mode 100644 index 0000000000..738f71f124 --- /dev/null +++ b/doc/README.services_extension @@ -0,0 +1,33 @@ +Services API enhancements in Firebird v2. +----------------------------------------- + +1) Services API extension for new shutdown modes. +(Alex Peshkov, peshkoff@mail.ru, 2008) + +New DB shutdown modes can now be set using services. A number of new +isc_spb_prp_* constants should be used for it. + +isc_spb_prp_shutdown_mode and isc_spb_prp_online_mode are used to perform +database shutdown/online operation. They have a single byte parameter, +setting new shutdown mode: isc_spb_prp_sm_normal, isc_spb_prp_sm_multi, +isc_spb_prp_sm_single and isc_spb_prp_sm_full. They exactly match gfix's +shutdown modes. When performing shutdown operation, you must specify +also type of shutdown: one of isc_spb_prp_force_shutdown, +isc_spb_prp_attachments_shutdown or isc_spb_prp_transactions_shutdown. +They have single int (4-byte) parameter, specifying timeout for desired +operation. +Please note that old-styled parameters are also supported and should be +used to enter default shutdown (currently 'multy') and online ('normal') +modes. + +Samples of use of new parameters in fbsvcmgr utility (supposing login and +password are set using some other method): + Shutdown database to single-user maintenance mode: + fbsvcmgr service_mgr action_properties dbname employee prp_shutdown_mode prp_sm_single prp_force_shutdown 0 + After it enable multi-user maintenance: + fbsvcmgr service_mgr action_properties dbname employee prp_online_mode prp_sm_multi + After it go to full shutdown mode, disabling new attachments during 60 seconds: + fbsvcmgr service_mgr action_properties dbname employee prp_shutdown_mode prp_sm_full prp_attachments_shutdown 60 + Return to normal state: + fbsvcmgr service_mgr action_properties dbname employee prp_online_mode prp_sm_normal + diff --git a/doc/WhatsNew b/doc/WhatsNew index 7a6ae35889..b53a361a00 100644 --- a/doc/WhatsNew +++ b/doc/WhatsNew @@ -2,6 +2,13 @@ * v2.5 Alpha 1 ************** + * Improvement CORE-1107 + Services API extension for new (single, full) shutdown modes + See also: + /doc/README.services_extension + Contributor(s): + Alex Peshkov + * Bugfix CORE-1930 Possible server crash if procedure was altered to have no outputs and dependent procedures were not recompiled Contributor(s):