1 // -*- mode:C++; tab-width:8; c-basic-offset:2; indent-tabs-mode:t -*-
2 // vim: ts=8 sw=2 smarttab
14 #include <curl/curl.h>
16 #include <boost/intrusive_ptr.hpp>
20 #include "common/ceph_argparse.h"
21 #include "global/global_init.h"
22 #include "global/signal_handler.h"
23 #include "common/config.h"
24 #include "common/errno.h"
25 #include "common/Timer.h"
26 #include "common/safe_io.h"
27 #include "include/compat.h"
28 #include "include/str_list.h"
29 #include "include/stringify.h"
30 #include "rgw_common.h"
31 #include "rgw_rados.h"
33 #include "rgw_period_pusher.h"
34 #include "rgw_realm_reloader.h"
36 #include "rgw_rest_s3.h"
37 #include "rgw_rest_swift.h"
38 #include "rgw_rest_admin.h"
39 #include "rgw_rest_usage.h"
40 #include "rgw_rest_user.h"
41 #include "rgw_rest_bucket.h"
42 #include "rgw_rest_metadata.h"
43 #include "rgw_rest_log.h"
44 #include "rgw_rest_opstate.h"
45 #include "rgw_replica_log.h"
46 #include "rgw_rest_replica_log.h"
47 #include "rgw_rest_config.h"
48 #include "rgw_rest_realm.h"
49 #include "rgw_swift_auth.h"
51 #include "rgw_tools.h"
52 #include "rgw_resolve.h"
54 #include "rgw_request.h"
55 #include "rgw_process.h"
56 #include "rgw_frontend.h"
57 #if defined(WITH_RADOSGW_BEAST_FRONTEND)
58 #include "rgw_asio_frontend.h"
59 #endif /* WITH_RADOSGW_BEAST_FRONTEND */
66 #include "include/types.h"
67 #include "common/BackTrace.h"
69 #ifdef HAVE_SYS_PRCTL_H
70 #include <sys/prctl.h>
73 #define dout_subsys ceph_subsys_rgw
77 static sig_t sighandler_alrm
;
81 static int signal_fd
[2] = {0, 0};
82 static std::atomic
<int64_t> disable_signal_fd
= { 0 };
84 void signal_shutdown()
86 if (!disable_signal_fd
) {
88 int ret
= write(signal_fd
[0], (char *)&val
, sizeof(val
));
90 derr
<< "ERROR: " << __func__
<< ": write() returned "
91 << cpp_strerror(errno
) << dendl
;
96 static void wait_shutdown()
99 int r
= safe_read_exact(signal_fd
[1], &val
, sizeof(val
));
101 derr
<< "safe_read_exact returned with error" << dendl
;
105 static int signal_fd_init()
107 return socketpair(AF_UNIX
, SOCK_STREAM
, 0, signal_fd
);
110 static void signal_fd_finalize()
116 static void handle_sigterm(int signum
)
118 dout(1) << __func__
<< dendl
;
119 #if defined(WITH_RADOSGW_FCGI_FRONTEND)
120 FCGX_ShutdownPending();
123 // send a signal to make fcgi's accept(2) wake up. unfortunately the
124 // initial signal often isn't sufficient because we race with accept's
125 // check of the flag wet by ShutdownPending() above.
126 if (signum
!= SIGUSR1
) {
129 // safety net in case we get stuck doing an orderly shutdown.
130 uint64_t secs
= g_ceph_context
->_conf
->rgw_exit_timeout_secs
;
133 dout(1) << __func__
<< " set alarm for " << secs
<< dendl
;
138 static void godown_alarm(int signum
)
143 #ifdef HAVE_CURL_MULTI_WAIT
144 static void check_curl()
148 static void check_curl()
150 derr
<< "WARNING: libcurl doesn't support curl_multi_wait()" << dendl
;
151 derr
<< "WARNING: cross zone / region transfer performance may be affected" << dendl
;
155 class C_InitTimeout
: public Context
{
158 void finish(int r
) override
{
159 derr
<< "Initialization timeout, failed to initialize" << dendl
;
166 cerr
<< "usage: radosgw [options...]" << std::endl
;
167 cerr
<< "options:\n";
168 cerr
<< " --rgw-region=<region> region in which radosgw runs\n";
169 cerr
<< " --rgw-zone=<zone> zone in which radosgw runs\n";
170 cerr
<< " --rgw-socket-path=<path> specify a unix domain socket path\n";
171 cerr
<< " -m monaddress[:port] connect to specified monitor\n";
172 cerr
<< " --keyring=<path> path to radosgw keyring\n";
173 cerr
<< " --logfile=<logfile> file to log debug output\n";
174 cerr
<< " --debug-rgw=<log-level>/<memory-level> set radosgw debug level\n";
175 generic_server_usage();
180 static RGWRESTMgr
*set_logging(RGWRESTMgr
*mgr
)
182 mgr
->set_logging(true);
186 static RGWRESTMgr
*rest_filter(RGWRados
*store
, int dialect
, RGWRESTMgr
*orig
)
188 RGWSyncModuleInstanceRef sync_module
= store
->get_sync_module();
189 return sync_module
->get_rest_filter(dialect
, orig
);
193 * start up the RADOS connection and then handle HTTP messages as they come in
195 #ifdef BUILDING_FOR_EMBEDDED
196 extern "C" int cephd_rgw(int argc
, const char **argv
)
198 int main(int argc
, const char **argv
)
201 // dout() messages will be sent to stderr, but FCGX wants messages on stdout
202 // Redirect stderr to stdout.
203 TEMP_FAILURE_RETRY(close(STDERR_FILENO
));
204 if (TEMP_FAILURE_RETRY(dup2(STDOUT_FILENO
, STDERR_FILENO
)) < 0) {
206 cout
<< "failed to redirect stderr to stdout: " << cpp_strerror(err
)
211 /* alternative default for module */
212 vector
<const char *> def_args
;
213 def_args
.push_back("--debug-rgw=1/5");
214 def_args
.push_back("--keyring=$rgw_data/keyring");
216 vector
<const char*> args
;
217 argv_to_vec(argc
, argv
, args
);
220 // First, let's determine which frontends are configured.
221 int flags
= CINIT_FLAG_UNPRIVILEGED_DAEMON_DEFAULTS
;
222 global_pre_init(&def_args
, args
, CEPH_ENTITY_TYPE_CLIENT
, CODE_ENVIRONMENT_DAEMON
,
225 list
<string
> frontends
;
226 get_str_list(g_conf
->rgw_frontends
, ",", frontends
);
227 multimap
<string
, RGWFrontendConfig
*> fe_map
;
228 list
<RGWFrontendConfig
*> configs
;
229 if (frontends
.empty()) {
230 frontends
.push_back("civetweb");
232 for (list
<string
>::iterator iter
= frontends
.begin(); iter
!= frontends
.end(); ++iter
) {
235 if (f
.find("civetweb") != string::npos
) {
236 // If civetweb is configured as a frontend, prevent global_init() from
237 // dropping permissions by setting the appropriate flag.
238 flags
|= CINIT_FLAG_DEFER_DROP_PRIVILEGES
;
239 if (f
.find("port") != string::npos
) {
240 // check for the most common ws problems
241 if ((f
.find("port=") == string::npos
) ||
242 (f
.find("port= ") != string::npos
)) {
243 derr
<< "WARNING: civetweb frontend config found unexpected spacing around 'port' "
244 << "(ensure civetweb port parameter has the form 'port=80' with no spaces "
245 << "before or after '=')" << dendl
;
250 RGWFrontendConfig
*config
= new RGWFrontendConfig(f
);
251 int r
= config
->init();
254 cerr
<< "ERROR: failed to init config: " << f
<< std::endl
;
258 configs
.push_back(config
);
260 string framework
= config
->get_framework();
261 fe_map
.insert(pair
<string
, RGWFrontendConfig
*>(framework
, config
));
264 // Now that we've determined which frontend(s) to use, continue with global
265 // initialization. Passing false as the final argument ensures that
266 // global_pre_init() is not invoked twice.
267 // claim the reference and release it after subsequent destructors have fired
268 auto cct
= global_init(&def_args
, args
, CEPH_ENTITY_TYPE_CLIENT
,
269 CODE_ENVIRONMENT_DAEMON
,
270 flags
, "rgw_data", false);
272 for (std::vector
<const char*>::iterator i
= args
.begin(); i
!= args
.end(); ++i
) {
273 if (ceph_argparse_flag(args
, i
, "-h", "--help", (char*)NULL
)) {
279 // maintain existing region root pool for new multisite objects
280 if (!g_conf
->rgw_region_root_pool
.empty()) {
281 const char *root_pool
= g_conf
->rgw_region_root_pool
.c_str();
282 if (g_conf
->rgw_zonegroup_root_pool
.empty()) {
283 g_conf
->set_val_or_die("rgw_zonegroup_root_pool", root_pool
);
285 if (g_conf
->rgw_period_root_pool
.empty()) {
286 g_conf
->set_val_or_die("rgw_period_root_pool", root_pool
);
288 if (g_conf
->rgw_realm_root_pool
.empty()) {
289 g_conf
->set_val_or_die("rgw_realm_root_pool", root_pool
);
293 // for region -> zonegroup conversion (must happen before common_init_finish())
294 if (!g_conf
->rgw_region
.empty() && g_conf
->rgw_zonegroup
.empty()) {
295 g_conf
->set_val_or_die("rgw_zonegroup", g_conf
->rgw_region
.c_str());
300 if (g_conf
->daemonize
) {
301 global_init_daemonize(g_ceph_context
);
304 SafeTimer
init_timer(g_ceph_context
, mutex
);
307 init_timer
.add_event_after(g_conf
->rgw_init_timeout
, new C_InitTimeout
);
310 // Enable the perf counter before starting the service thread
311 g_ceph_context
->enable_perf_counter();
313 common_init_finish(g_ceph_context
);
315 int r
= rgw_tools_init(g_ceph_context
);
317 derr
<< "ERROR: unable to initialize rgw tools" << dendl
;
323 curl_global_init(CURL_GLOBAL_ALL
);
325 #if defined(WITH_RADOSGW_FCGI_FRONTEND)
329 RGWRados
*store
= RGWStoreManager::get_storage(g_ceph_context
,
330 g_conf
->rgw_enable_gc_threads
, g_conf
->rgw_enable_lc_threads
, g_conf
->rgw_enable_quota_threads
,
331 g_conf
->rgw_run_sync_thread
, g_conf
->rgw_dynamic_resharding
);
334 init_timer
.cancel_all_events();
335 init_timer
.shutdown();
338 derr
<< "Couldn't init storage provider (RADOS)" << dendl
;
341 r
= rgw_perf_start(g_ceph_context
);
343 derr
<< "ERROR: failed starting rgw perf" << dendl
;
347 rgw_rest_init(g_ceph_context
, store
, store
->get_zonegroup());
350 init_timer
.cancel_all_events();
351 init_timer
.shutdown();
354 rgw_user_init(store
);
355 rgw_bucket_init(store
->meta_mgr
);
356 rgw_log_usage_init(g_ceph_context
, store
);
362 get_str_list(g_conf
->rgw_enable_apis
, apis
);
364 map
<string
, bool> apis_map
;
365 for (list
<string
>::iterator li
= apis
.begin(); li
!= apis
.end(); ++li
) {
366 apis_map
[*li
] = true;
369 // S3 website mode is a specialization of S3
370 const bool s3website_enabled
= apis_map
.count("s3website") > 0;
371 // Swift API entrypoint could placed in the root instead of S3
372 const bool swift_at_root
= g_conf
->rgw_swift_url_prefix
== "/";
373 if (apis_map
.count("s3") > 0 || s3website_enabled
) {
374 if (! swift_at_root
) {
375 rest
.register_default_mgr(set_logging(rest_filter(store
, RGW_REST_S3
,
376 new RGWRESTMgr_S3(s3website_enabled
))));
378 derr
<< "Cannot have the S3 or S3 Website enabled together with "
379 << "Swift API placed in the root of hierarchy" << dendl
;
384 if (apis_map
.count("swift") > 0) {
385 RGWRESTMgr_SWIFT
* const swift_resource
= new RGWRESTMgr_SWIFT
;
387 if (! g_conf
->rgw_cross_domain_policy
.empty()) {
388 swift_resource
->register_resource("crossdomain.xml",
389 set_logging(new RGWRESTMgr_SWIFT_CrossDomain
));
392 swift_resource
->register_resource("healthcheck",
393 set_logging(new RGWRESTMgr_SWIFT_HealthCheck
));
395 swift_resource
->register_resource("info",
396 set_logging(new RGWRESTMgr_SWIFT_Info
));
398 if (! swift_at_root
) {
399 rest
.register_resource(g_conf
->rgw_swift_url_prefix
,
400 set_logging(rest_filter(store
, RGW_REST_SWIFT
,
403 if (store
->get_zonegroup().zones
.size() > 1) {
404 derr
<< "Placing Swift API in the root of URL hierarchy while running"
405 << " multi-site configuration requires another instance of RadosGW"
406 << " with S3 API enabled!" << dendl
;
409 rest
.register_default_mgr(set_logging(swift_resource
));
413 if (apis_map
.count("swift_auth") > 0) {
414 rest
.register_resource(g_conf
->rgw_swift_auth_entry
,
415 set_logging(new RGWRESTMgr_SWIFT_Auth
));
418 if (apis_map
.count("admin") > 0) {
419 RGWRESTMgr_Admin
*admin_resource
= new RGWRESTMgr_Admin
;
420 admin_resource
->register_resource("usage", new RGWRESTMgr_Usage
);
421 admin_resource
->register_resource("user", new RGWRESTMgr_User
);
422 admin_resource
->register_resource("bucket", new RGWRESTMgr_Bucket
);
424 /*Registering resource for /admin/metadata */
425 admin_resource
->register_resource("metadata", new RGWRESTMgr_Metadata
);
426 admin_resource
->register_resource("log", new RGWRESTMgr_Log
);
427 admin_resource
->register_resource("opstate", new RGWRESTMgr_Opstate
);
428 admin_resource
->register_resource("replica_log", new RGWRESTMgr_ReplicaLog
);
429 admin_resource
->register_resource("config", new RGWRESTMgr_Config
);
430 admin_resource
->register_resource("realm", new RGWRESTMgr_Realm
);
431 rest
.register_resource(g_conf
->rgw_admin_entry
, admin_resource
);
434 /* Initialize the registry of auth strategies which will coordinate
435 * the dynamic reconfiguration. */
436 auto auth_registry
= \
437 rgw::auth::StrategyRegistry::create(g_ceph_context
, store
);
439 /* Header custom behavior */
440 rest
.register_x_headers(g_conf
->rgw_log_http_headers
);
442 OpsLogSocket
*olog
= NULL
;
444 if (!g_conf
->rgw_ops_log_socket_path
.empty()) {
445 olog
= new OpsLogSocket(g_ceph_context
, g_conf
->rgw_ops_log_data_backlog
);
446 olog
->init(g_conf
->rgw_ops_log_socket_path
);
449 r
= signal_fd_init();
451 derr
<< "ERROR: unable to initialize signal fds" << dendl
;
455 init_async_signal_handler();
456 register_async_signal_handler(SIGHUP
, sighup_handler
);
457 register_async_signal_handler(SIGTERM
, handle_sigterm
);
458 register_async_signal_handler(SIGINT
, handle_sigterm
);
459 register_async_signal_handler(SIGUSR1
, handle_sigterm
);
460 sighandler_alrm
= signal(SIGALRM
, godown_alarm
);
462 map
<string
, string
> service_map_meta
;
463 service_map_meta
["pid"] = stringify(getpid());
465 list
<RGWFrontend
*> fes
;
469 for (multimap
<string
, RGWFrontendConfig
*>::iterator fiter
= fe_map
.begin();
470 fiter
!= fe_map
.end(); ++fiter
, ++fe_count
) {
471 RGWFrontendConfig
*config
= fiter
->second
;
472 string framework
= config
->get_framework();
473 RGWFrontend
*fe
= NULL
;
475 if (framework
== "civetweb" || framework
== "mongoose") {
476 framework
= "civetweb";
477 std::string uri_prefix
;
478 config
->get_val("prefix", "", &uri_prefix
);
480 RGWProcessEnv env
= { store
, &rest
, olog
, 0, uri_prefix
, auth_registry
};
482 fe
= new RGWCivetWebFrontend(env
, config
);
484 else if (framework
== "loadgen") {
486 config
->get_val("port", 80, &port
);
487 std::string uri_prefix
;
488 config
->get_val("prefix", "", &uri_prefix
);
490 RGWProcessEnv env
= { store
, &rest
, olog
, port
, uri_prefix
, auth_registry
};
492 fe
= new RGWLoadGenFrontend(env
, config
);
494 #if defined(WITH_RADOSGW_BEAST_FRONTEND)
495 else if ((framework
== "beast") &&
496 cct
->check_experimental_feature_enabled("rgw-beast-frontend")) {
498 config
->get_val("port", 80, &port
);
499 std::string uri_prefix
;
500 config
->get_val("prefix", "", &uri_prefix
);
501 RGWProcessEnv env
{ store
, &rest
, olog
, port
, uri_prefix
, auth_registry
};
502 fe
= new RGWAsioFrontend(env
);
504 #endif /* WITH_RADOSGW_BEAST_FRONTEND */
505 #if defined(WITH_RADOSGW_FCGI_FRONTEND)
506 else if (framework
== "fastcgi" || framework
== "fcgi") {
507 framework
= "fastcgi";
508 std::string uri_prefix
;
509 config
->get_val("prefix", "", &uri_prefix
);
510 RGWProcessEnv fcgi_pe
= { store
, &rest
, olog
, 0, uri_prefix
, auth_registry
};
512 fe
= new RGWFCGXFrontend(fcgi_pe
, config
);
514 #endif /* WITH_RADOSGW_FCGI_FRONTEND */
516 service_map_meta
["frontend_type#" + stringify(fe_count
)] = framework
;
517 service_map_meta
["frontend_config#" + stringify(fe_count
)] = config
->get_config();
520 dout(0) << "WARNING: skipping unknown framework: " << framework
<< dendl
;
524 dout(0) << "starting handler: " << fiter
->first
<< dendl
;
527 derr
<< "ERROR: failed initializing frontend" << dendl
;
532 derr
<< "ERROR: failed run" << dendl
;
539 r
= store
->register_to_service_map("rgw", service_map_meta
);
541 derr
<< "ERROR: failed to register to service map: " << cpp_strerror(-r
) << dendl
;
547 // add a watcher to respond to realm configuration changes
548 RGWPeriodPusher
pusher(store
);
549 RGWFrontendPauser
pauser(fes
, &pusher
);
550 RGWRealmReloader
reloader(store
, service_map_meta
, &pauser
);
552 RGWRealmWatcher
realm_watcher(g_ceph_context
, store
->realm
);
553 realm_watcher
.add_watcher(RGWRealmNotify::Reload
, reloader
);
554 realm_watcher
.add_watcher(RGWRealmNotify::ZonesNeedPeriod
, pusher
);
556 #if defined(HAVE_SYS_PRCTL_H)
557 if (prctl(PR_SET_DUMPABLE
, 1) == -1) {
558 cerr
<< "warning: unable to set dumpable flag: " << cpp_strerror(errno
) << std::endl
;
564 derr
<< "shutting down" << dendl
;
566 for (list
<RGWFrontend
*>::iterator liter
= fes
.begin(); liter
!= fes
.end();
568 RGWFrontend
*fe
= *liter
;
572 for (list
<RGWFrontend
*>::iterator liter
= fes
.begin(); liter
!= fes
.end();
574 RGWFrontend
*fe
= *liter
;
579 for (list
<RGWFrontendConfig
*>::iterator liter
= configs
.begin();
580 liter
!= configs
.end(); ++liter
) {
581 RGWFrontendConfig
*fec
= *liter
;
585 unregister_async_signal_handler(SIGHUP
, sighup_handler
);
586 unregister_async_signal_handler(SIGTERM
, handle_sigterm
);
587 unregister_async_signal_handler(SIGINT
, handle_sigterm
);
588 unregister_async_signal_handler(SIGUSR1
, handle_sigterm
);
589 shutdown_async_signal_handler();
591 rgw_log_usage_finalize();
595 RGWStoreManager::close_storage(store
);
598 rgw_shutdown_resolver();
599 curl_global_cleanup();
601 rgw_perf_stop(g_ceph_context
);
603 dout(1) << "final shutdown" << dendl
;
605 signal_fd_finalize();