// Copyright (C) 2014 Internet Systems Consortium, Inc. ("ISC") // // Permission to use, copy, modify, and/or distribute this software for any // purpose with or without fee is hereby granted, provided that the above // copyright notice and this permission notice appear in all copies. // // THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH // REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY // AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, // INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM // LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE // OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR // PERFORMANCE OF THIS SOFTWARE. #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using namespace isc::asiolink; using namespace isc::cc; using namespace isc::config; using namespace isc::data; using namespace isc::dhcp; using namespace isc::log; using namespace isc::util; using namespace std; namespace { /// @brief Configure DHCPv6 server using the configuration file specified. /// /// This function is used to both configure the DHCP server on its startup /// and dynamically reconfigure the server when SIGHUP signal is received. /// /// It fetches DHCPv6 server's configuration from the 'Dhcp6' section of /// the JSON configuration file. /// /// @param file_name Configuration file location. void configure(const std::string& file_name) { // This is a configuration backend implementation that reads the // configuration from a JSON file. isc::data::ConstElementPtr json; isc::data::ConstElementPtr dhcp6; isc::data::ConstElementPtr result; // Basic sanity check: file name must not be empty. try { if (file_name.empty()) { // Basic sanity check: file name must not be empty. isc_throw(isc::BadValue, "JSON configuration file not specified. Please " "use -c command line option."); } // Read contents of the file and parse it as JSON json = Element::fromJSONFile(file_name, true); if (!json) { LOG_ERROR(dhcp6_logger, DHCP6_CONFIG_LOAD_FAIL) .arg("Config file " + file_name + " missing or empty."); isc_throw(isc::BadValue, "Unable to process JSON configuration file:" + file_name); } // Get Dhcp6 component from the config dhcp6 = json->get("Dhcp6"); if (!dhcp6) { LOG_ERROR(dhcp6_logger, DHCP6_CONFIG_LOAD_FAIL) .arg("Config file " + file_name + " does not include 'Dhcp6' entry."); isc_throw(isc::BadValue, "Unable to process JSON configuration file:" + file_name); } // Use parsed JSON structures to configure the server result = ControlledDhcpv6Srv::processCommand("config-reload", dhcp6); } catch (const std::exception& ex) { LOG_ERROR(dhcp6_logger, DHCP6_CONFIG_LOAD_FAIL).arg(ex.what()); isc_throw(isc::BadValue, "Unable to process JSON configuration file:" + file_name); } if (!result) { // Undetermined status of the configuration. This should never happen, // but as the configureDhcp6Server returns a pointer, it is theoretically // possible that it will return NULL. LOG_ERROR(dhcp6_logger, DHCP6_CONFIG_LOAD_FAIL) .arg("Configuration failed: Undefined result of configureDhcp6Server" "() function after attempting to read " + file_name); return; } // Now check is the returned result is successful (rcode=0) or not ConstElementPtr comment; /// see @ref isc::config::parseAnswer int rcode; comment = parseAnswer(rcode, result); if (rcode != 0) { string reason = ""; if (comment) { reason = string(" (") + comment->stringValue() + string(")"); } LOG_ERROR(dhcp6_logger, DHCP6_CONFIG_LOAD_FAIL).arg(reason); isc_throw(isc::BadValue, "Failed to apply configuration:" << reason); } } /// @brief Signals handler for DHCPv6 server. /// /// This signal handler handles the following signals received by the DHCPv6 /// server process: /// - SIGHUP - triggers server's dynamic reconfiguration. /// - SIGTERM - triggers server's shut down. /// - SIGINT - triggers server's shut down. /// /// @param signo Signal number received. void signalHandler(int signo) { // SIGHUP signals a request to reconfigure the server. if (signo == SIGHUP) { // Get configuration file name. std::string file = ControlledDhcpv6Srv::getInstance()->getConfigFile(); try { LOG_INFO(dhcp6_logger, DHCP6_DYNAMIC_RECONFIGURATION).arg(file); configure(file); } catch (const std::exception& ex) { // Log the unsuccessful reconfiguration. The reason for failure // should be already logged. Don't rethrow an exception so as // the server keeps working. LOG_ERROR(dhcp6_logger, DHCP6_DYNAMIC_RECONFIGURATION_FAIL) .arg(file); } } else if ((signo == SIGTERM) || (signo == SIGINT)) { ElementPtr params(new isc::data::MapElement()); ControlledDhcpv6Srv::processCommand("shutdown", params); } } } namespace isc { namespace dhcp { void ControlledDhcpv6Srv::init(const std::string& file_name) { // Call parent class's init to initialize file name. Daemon::init(file_name); // Configure the server using JSON file. configure(file_name); // We don't need to call openActiveSockets() or startD2() as these // methods are called in processConfig() which is called by // processCommand("reload-config", ...) // Set signal handlers. When the SIGHUP is received by the process // the server reconfiguration will be triggered. When SIGTERM or // SIGINT will be received, the server will start shutting down. signal(SIGHUP, signalHandler); signal(SIGTERM, signalHandler); signal(SIGINT, signalHandler); } void ControlledDhcpv6Srv::cleanup() { // Nothing to do here. No need to disconnect from anything. } /// This is a logger initialization for JSON file backend. /// For now, it's just setting log messages to be printed on stdout. /// @todo: Implement this properly (see #3427) void Daemon::loggerInit(const char*, bool verbose, bool ) { setenv("B10_LOCKFILE_DIR_FROM_BUILD", "/tmp", 1); setenv("B10_LOGGER_ROOT", "kea", 0); setenv("B10_LOGGER_SEVERITY", (verbose ? "DEBUG":"INFO"), 0); setenv("B10_LOGGER_DBGLEVEL", "99", 0); setenv("B10_LOGGER_DESTINATION", "stdout", 0); isc::log::initLogger(); } }; };