ClickHouse/programs/install/Install.cpp

1238 lines
46 KiB
C++
Raw Normal View History

2020-08-08 18:38:34 +00:00
#include <iostream>
#include <filesystem>
#include <boost/program_options.hpp>
#include <sys/stat.h>
2020-08-27 03:58:05 +00:00
#include <pwd.h>
2020-08-08 18:38:34 +00:00
#if defined(__linux__)
#include <syscall.h>
#include <linux/capability.h>
#endif
2020-12-17 17:06:01 +00:00
#if defined(OS_DARWIN)
#include <mach-o/dyld.h>
#endif
2020-08-08 18:38:34 +00:00
#include <Common/Exception.h>
#include <Common/ShellCommand.h>
#include <Common/formatReadable.h>
#include <Common/Config/ConfigProcessor.h>
#include <Common/OpenSSLHelpers.h>
#include <Common/hex.h>
2021-10-02 07:13:14 +00:00
#include <base/getResource.h>
#include <base/sleep.h>
2020-08-08 18:38:34 +00:00
#include <IO/ReadBufferFromFileDescriptor.h>
#include <IO/WriteBufferFromFileDescriptor.h>
#include <IO/ReadBufferFromFile.h>
#include <IO/WriteBufferFromFile.h>
2020-11-26 01:44:26 +00:00
#include <IO/MMapReadBufferFromFile.h>
2020-08-08 18:38:34 +00:00
#include <IO/ReadBufferFromMemory.h>
#include <IO/copyData.h>
#include <IO/Operators.h>
#include <readpassphrase.h>
#include <Poco/Util/XMLConfiguration.h>
/** This tool can be used to install ClickHouse without a deb/rpm/tgz package, having only "clickhouse" binary.
* It also allows to avoid dependency on systemd, upstart, SysV init.
*
2020-08-08 18:38:34 +00:00
* The following steps are performed:
*
* - copying the binary to binary directory (/usr/bin).
* - creation of symlinks for tools.
* - creation of clickhouse user and group.
* - creation of config directory (/etc/clickhouse-server).
* - creation of default configuration files.
* - creation of a directory for logs (/var/log/clickhouse-server).
* - creation of a data directory if not exists.
* - setting a password for default user.
* - choose an option to listen connections.
* - changing the ownership and mode of the directories.
* - setting capabilities for binary.
* - setting ulimits for the user.
* - (todo) put service in cron.
2020-08-08 18:38:34 +00:00
*
* It does not install clickhouse-odbc-bridge.
*/
namespace DB
{
namespace ErrorCodes
{
extern const int FILE_DOESNT_EXIST;
extern const int CANNOT_OPEN_FILE;
extern const int SYSTEM_ERROR;
extern const int NOT_ENOUGH_SPACE;
2021-10-16 17:03:45 +00:00
extern const int NOT_IMPLEMENTED;
extern const int CANNOT_KILL;
2020-08-08 18:38:34 +00:00
}
}
2021-04-13 17:34:11 +00:00
/// ANSI escape sequence for intense color in terminal.
#define HILITE "\033[1m"
#define END_HILITE "\033[0m"
2021-10-16 17:03:45 +00:00
#if defined(OS_DARWIN)
2021-10-16 23:04:53 +00:00
/// Until createUser() and createGroup() are implemented, only sudo-less installations are supported/default for macOS.
2021-10-16 17:03:45 +00:00
static constexpr auto DEFAULT_CLICKHOUSE_SERVER_USER = "";
static constexpr auto DEFAULT_CLICKHOUSE_SERVER_GROUP = "";
static constexpr auto DEFAULT_CLICKHOUSE_BRIDGE_USER = "";
static constexpr auto DEFAULT_CLICKHOUSE_BRIDGE_GROUP = "";
#else
static constexpr auto DEFAULT_CLICKHOUSE_SERVER_USER = "clickhouse";
static constexpr auto DEFAULT_CLICKHOUSE_SERVER_GROUP = "clickhouse";
static constexpr auto DEFAULT_CLICKHOUSE_BRIDGE_USER = "clickhouse-bridge";
static constexpr auto DEFAULT_CLICKHOUSE_BRIDGE_GROUP = "clickhouse-bridge";
#endif
2021-06-14 10:35:12 +00:00
using namespace DB;
namespace po = boost::program_options;
namespace fs = std::filesystem;
2020-11-26 01:44:26 +00:00
static auto executeScript(const std::string & command, bool throw_on_error = false)
2020-08-08 18:38:34 +00:00
{
auto sh = ShellCommand::execute(command);
2020-08-09 02:13:56 +00:00
WriteBufferFromFileDescriptor wb_stdout(STDOUT_FILENO);
WriteBufferFromFileDescriptor wb_stderr(STDERR_FILENO);
copyData(sh->out, wb_stdout);
copyData(sh->err, wb_stderr);
if (throw_on_error)
{
sh->wait();
return 0;
}
else
return sh->tryWait();
2020-08-08 18:38:34 +00:00
}
2020-11-26 01:44:26 +00:00
static bool ask(std::string question)
2020-08-08 18:38:34 +00:00
{
while (true)
{
std::string answer;
std::cout << question;
std::getline(std::cin, answer);
if (!std::cin.good())
return false;
if (answer.empty() || answer == "n" || answer == "N")
return false;
if (answer == "y" || answer == "Y")
return true;
}
}
2020-11-26 01:44:26 +00:00
static bool filesEqual(std::string path1, std::string path2)
{
MMapReadBufferFromFile in1(path1, 0);
MMapReadBufferFromFile in2(path2, 0);
/// memcmp is faster than hashing and comparing hashes
return in1.buffer().size() == in2.buffer().size()
&& 0 == memcmp(in1.buffer().begin(), in2.buffer().begin(), in1.buffer().size());
}
2021-10-16 17:03:45 +00:00
static void changeOwnership(const String & file_name, const String & user_name, const String & group_name = {}, bool recursive = true)
{
if (!user_name.empty() || !group_name.empty())
{
std::string command = fmt::format("chown {} {}:{} '{}'", (recursive ? "-R" : ""), user_name, group_name, file_name);
fmt::print(" {}\n", command);
executeScript(command);
}
}
2020-08-08 18:38:34 +00:00
2021-10-16 17:03:45 +00:00
static void createGroup(const String & group_name)
2020-08-08 18:38:34 +00:00
{
2021-10-16 17:03:45 +00:00
if (!group_name.empty())
2020-08-08 18:38:34 +00:00
{
2021-10-16 17:03:45 +00:00
#if defined(OS_DARWIN)
2021-10-16 23:04:53 +00:00
// TODO: implement.
2021-10-16 17:03:45 +00:00
throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Unable to create a group in macOS");
#else
std::string command = fmt::format("groupadd -r {}", group_name);
fmt::print(" {}\n", command);
executeScript(command);
#endif
2020-08-08 18:38:34 +00:00
}
2021-10-16 17:03:45 +00:00
}
2020-08-08 18:38:34 +00:00
2021-10-16 17:03:45 +00:00
static void createUser(const String & user_name, [[maybe_unused]] const String & group_name)
{
if (!user_name.empty())
{
#if defined(OS_DARWIN)
2021-10-16 23:04:53 +00:00
// TODO: implement.
2021-10-16 17:03:45 +00:00
throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Unable to create a user in macOS");
#else
std::string command = group_name.empty()
? fmt::format("useradd -r --shell /bin/false --home-dir /nonexistent --user-group {}", user_name)
: fmt::format("useradd -r --shell /bin/false --home-dir /nonexistent -g {} {}", group_name, user_name);
fmt::print(" {}\n", command);
executeScript(command);
#endif
}
}
int mainEntryClickHouseInstall(int argc, char ** argv)
{
2020-08-08 18:38:34 +00:00
try
{
2021-10-16 17:03:45 +00:00
po::options_description desc;
desc.add_options()
("help,h", "produce help message")
("prefix", po::value<std::string>()->default_value("/"), "prefix for all paths")
("binary-path", po::value<std::string>()->default_value("usr/bin"), "where to install binaries")
("config-path", po::value<std::string>()->default_value("etc/clickhouse-server"), "where to install configs")
("log-path", po::value<std::string>()->default_value("var/log/clickhouse-server"), "where to create log directory")
("data-path", po::value<std::string>()->default_value("var/lib/clickhouse"), "directory for data")
("pid-path", po::value<std::string>()->default_value("var/run/clickhouse-server"), "directory for pid file")
("user", po::value<std::string>()->default_value(DEFAULT_CLICKHOUSE_SERVER_USER), "clickhouse user to create")
("group", po::value<std::string>()->default_value(DEFAULT_CLICKHOUSE_SERVER_GROUP), "clickhouse group to create")
;
po::variables_map options;
po::store(po::parse_command_line(argc, argv, desc), options);
if (options.count("help"))
{
std::cout << "Usage: "
<< (getuid() == 0 ? "" : "sudo ")
<< argv[0]
<< " install [options]\n";
std::cout << desc << '\n';
return 1;
}
2020-08-08 18:38:34 +00:00
/// We need to copy binary to the binary directory.
2020-12-17 20:09:03 +00:00
/// The binary is currently run. We need to obtain its path from procfs (on Linux).
2020-08-08 18:38:34 +00:00
2020-12-17 17:06:01 +00:00
#if defined(OS_DARWIN)
2020-12-17 20:09:03 +00:00
uint32_t path_length = 0;
_NSGetExecutablePath(nullptr, &path_length);
2020-12-18 00:30:01 +00:00
if (path_length <= 1)
2020-12-17 17:06:01 +00:00
Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot obtain path to the binary");
2020-12-17 20:09:03 +00:00
std::string path(path_length, std::string::value_type());
auto res = _NSGetExecutablePath(&path[0], &path_length);
if (res != 0)
2020-12-17 17:06:01 +00:00
Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot obtain path to the binary");
2021-10-16 17:03:45 +00:00
if (path.back() == '\0')
path.pop_back();
2020-12-17 17:06:01 +00:00
fs::path binary_self_path(path);
2020-12-18 03:17:23 +00:00
#else
2020-08-08 18:38:34 +00:00
fs::path binary_self_path = "/proc/self/exe";
2020-12-17 17:06:01 +00:00
#endif
2020-12-18 03:17:23 +00:00
2020-08-08 18:38:34 +00:00
if (!fs::exists(binary_self_path))
throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot obtain path to the binary from {}, file doesn't exist",
binary_self_path.string());
2020-11-26 01:44:26 +00:00
fs::path binary_self_canonical_path = fs::canonical(binary_self_path);
2020-08-08 18:38:34 +00:00
/// Copy binary to the destination directory.
2020-08-11 22:49:38 +00:00
/// TODO An option to link instead of copy - useful for developers.
2020-08-08 18:38:34 +00:00
2021-10-16 17:03:45 +00:00
fs::path prefix = options["prefix"].as<std::string>();
fs::path bin_dir = prefix / options["binary-path"].as<std::string>();
2020-08-08 18:38:34 +00:00
fs::path main_bin_path = bin_dir / "clickhouse";
fs::path main_bin_tmp_path = bin_dir / "clickhouse.new";
fs::path main_bin_old_path = bin_dir / "clickhouse.old";
2020-11-26 01:44:26 +00:00
size_t binary_size = fs::file_size(binary_self_path);
2020-08-08 18:38:34 +00:00
2020-11-26 01:44:26 +00:00
bool old_binary_exists = fs::exists(main_bin_path);
2020-11-26 02:11:55 +00:00
bool already_installed = false;
2020-08-08 18:38:34 +00:00
2020-11-26 02:11:55 +00:00
/// Check if the binary is the same file (already installed).
2020-11-26 01:44:26 +00:00
if (old_binary_exists && binary_self_canonical_path == fs::canonical(main_bin_path))
{
2020-11-26 02:11:55 +00:00
already_installed = true;
2020-11-26 01:44:26 +00:00
fmt::print("ClickHouse binary is already located at {}\n", main_bin_path.string());
2020-08-08 18:38:34 +00:00
}
2020-11-26 02:11:55 +00:00
/// Check if binary has the same content.
else if (old_binary_exists && binary_size == fs::file_size(main_bin_path))
2020-08-08 18:38:34 +00:00
{
2020-11-26 02:11:55 +00:00
fmt::print("Found already existing ClickHouse binary at {} having the same size. Will check its contents.\n",
main_bin_path.string());
if (filesEqual(binary_self_path.string(), main_bin_path.string()))
2020-11-26 01:44:26 +00:00
{
2020-11-26 02:11:55 +00:00
already_installed = true;
2020-11-26 01:44:26 +00:00
fmt::print("ClickHouse binary is already located at {} and it has the same content as {}\n",
main_bin_path.string(), binary_self_canonical_path.string());
}
2020-08-08 18:38:34 +00:00
}
2020-11-26 02:11:55 +00:00
if (already_installed)
2020-08-08 18:38:34 +00:00
{
2020-11-26 02:11:55 +00:00
if (0 != chmod(main_bin_path.string().c_str(), S_IRUSR | S_IRGRP | S_IROTH | S_IXUSR | S_IXGRP | S_IXOTH))
throwFromErrno(fmt::format("Cannot chmod {}", main_bin_path.string()), ErrorCodes::SYSTEM_ERROR);
2020-08-08 18:38:34 +00:00
}
2020-11-26 02:11:55 +00:00
else
{
2021-10-16 17:03:45 +00:00
if (!fs::exists(bin_dir))
{
fmt::print("Creating binary directory {}.\n", bin_dir.string());
fs::create_directories(bin_dir);
}
2020-11-26 02:11:55 +00:00
size_t available_space = fs::space(bin_dir).available;
if (available_space < binary_size)
throw Exception(ErrorCodes::NOT_ENOUGH_SPACE, "Not enough space for clickhouse binary in {}, required {}, available {}.",
bin_dir.string(), ReadableSize(binary_size), ReadableSize(available_space));
2020-11-26 01:44:26 +00:00
2020-11-26 02:11:55 +00:00
fmt::print("Copying ClickHouse binary to {}\n", main_bin_tmp_path.string());
2020-08-08 18:38:34 +00:00
2020-11-26 02:11:55 +00:00
try
{
ReadBufferFromFile in(binary_self_path.string());
WriteBufferFromFile out(main_bin_tmp_path.string());
copyData(in, out);
out.sync();
2020-11-26 01:44:26 +00:00
2020-11-26 02:11:55 +00:00
if (0 != fchmod(out.getFD(), S_IRUSR | S_IRGRP | S_IROTH | S_IXUSR | S_IXGRP | S_IXOTH))
throwFromErrno(fmt::format("Cannot chmod {}", main_bin_tmp_path.string()), ErrorCodes::SYSTEM_ERROR);
2020-11-26 01:44:26 +00:00
2020-11-26 02:11:55 +00:00
out.finalize();
}
catch (const Exception & e)
{
if (e.code() == ErrorCodes::CANNOT_OPEN_FILE && geteuid() != 0)
std::cerr << "Install must be run as root: sudo ./clickhouse install\n";
throw;
}
2020-11-26 01:44:26 +00:00
2020-11-26 02:11:55 +00:00
if (old_binary_exists)
{
fmt::print("{} already exists, will rename existing binary to {} and put the new binary in place\n",
main_bin_path.string(), main_bin_old_path.string());
2020-11-26 01:44:26 +00:00
2020-11-26 02:11:55 +00:00
/// There is file exchange operation in Linux but it's not portable.
fs::rename(main_bin_path, main_bin_old_path);
2020-11-26 01:44:26 +00:00
}
2020-11-26 02:11:55 +00:00
fmt::print("Renaming {} to {}.\n", main_bin_tmp_path.string(), main_bin_path.string());
fs::rename(main_bin_tmp_path, main_bin_path);
2020-11-26 01:44:26 +00:00
}
2020-08-08 18:38:34 +00:00
/// Create symlinks.
std::initializer_list<const char *> tools
{
"clickhouse-server",
"clickhouse-client",
"clickhouse-local",
"clickhouse-benchmark",
"clickhouse-copier",
"clickhouse-obfuscator",
2020-09-07 03:22:47 +00:00
"clickhouse-git-import",
2020-08-08 18:38:34 +00:00
"clickhouse-compressor",
"clickhouse-format",
"clickhouse-extract-from-config"
};
for (const auto & tool : tools)
{
bool need_to_create = true;
fs::path symlink_path = bin_dir / tool;
if (fs::exists(symlink_path))
{
bool is_symlink = fs::is_symlink(symlink_path);
fs::path points_to;
if (is_symlink)
2021-05-24 16:03:09 +00:00
points_to = fs::weakly_canonical(fs::read_symlink(symlink_path));
2020-08-08 18:38:34 +00:00
if (is_symlink && points_to == main_bin_path)
{
need_to_create = false;
}
else
{
if (!is_symlink)
{
fs::path rename_path = symlink_path.replace_extension(".old");
fmt::print("File {} already exists but it's not a symlink. Will rename to {}.\n",
symlink_path.string(), rename_path.string());
fs::rename(symlink_path, rename_path);
}
else if (points_to != main_bin_path)
{
fmt::print("Symlink {} already exists but it points to {}. Will replace the old symlink to {}.\n",
symlink_path.string(), points_to.string(), main_bin_path.string());
fs::remove(symlink_path);
}
}
}
if (need_to_create)
{
fmt::print("Creating symlink {} to {}.\n", symlink_path.string(), main_bin_path.string());
fs::create_symlink(main_bin_path, symlink_path);
}
}
/// Creation of clickhouse user and group.
std::string user = options["user"].as<std::string>();
std::string group = options["group"].as<std::string>();
if (!group.empty())
{
2021-06-14 10:35:12 +00:00
fmt::print("Creating clickhouse group if it does not exist.\n");
2021-10-16 17:03:45 +00:00
createGroup(group);
2020-08-08 18:38:34 +00:00
}
else
2021-10-16 17:03:45 +00:00
fmt::print("Will not create a dedicated clickhouse group.\n");
2021-06-14 10:35:12 +00:00
if (!user.empty())
{
fmt::print("Creating clickhouse user if it does not exist.\n");
2021-10-16 17:03:45 +00:00
createUser(user, group);
2020-08-08 18:38:34 +00:00
if (group.empty())
group = user;
2020-08-08 18:38:34 +00:00
/// Setting ulimits.
try
{
2021-10-16 17:03:45 +00:00
#if defined(OS_DARWIN)
/// TODO Set ulimits on macOS.
#else
2020-08-08 18:38:34 +00:00
fs::path ulimits_dir = "/etc/security/limits.d";
fs::path ulimits_file = ulimits_dir / fmt::format("{}.conf", user);
fmt::print("Will set ulimits for {} user in {}.\n", user, ulimits_file.string());
std::string ulimits_content = fmt::format(
"{0}\tsoft\tnofile\t262144\n"
"{0}\thard\tnofile\t262144\n", user);
fs::create_directories(ulimits_dir);
WriteBufferFromFile out(ulimits_file.string());
out.write(ulimits_content.data(), ulimits_content.size());
out.sync();
out.finalize();
2021-10-16 17:03:45 +00:00
#endif
2020-08-08 18:38:34 +00:00
}
catch (...)
{
std::cerr << "Cannot set ulimits: " << getCurrentExceptionMessage(false) << "\n";
}
}
else
2021-10-16 17:03:45 +00:00
fmt::print("Will not create a dedicated clickhouse user.\n");
2020-08-08 18:38:34 +00:00
/// Creating configuration files and directories.
fs::path config_dir = prefix / options["config-path"].as<std::string>();
if (!fs::exists(config_dir))
{
fmt::print("Creating config directory {}.\n", config_dir.string());
fs::create_directories(config_dir);
}
fs::path main_config_file = config_dir / "config.xml";
fs::path users_config_file = config_dir / "users.xml";
fs::path config_d = config_dir / "config.d";
fs::path users_d = config_dir / "users.d";
2021-10-16 17:03:45 +00:00
fs::path log_path = prefix / options["log-path"].as<std::string>();
fs::path data_path = prefix / options["data-path"].as<std::string>();
fs::path pid_path = prefix / options["pid-path"].as<std::string>();
2020-08-08 18:38:34 +00:00
bool has_password_for_default_user = false;
2020-11-12 16:48:17 +00:00
if (!fs::exists(config_d))
2020-08-08 18:38:34 +00:00
{
fmt::print("Creating config directory {} that is used for tweaks of main server configuration.\n", config_d.string());
fs::create_directory(config_d);
2020-11-12 16:48:17 +00:00
}
2020-08-08 18:38:34 +00:00
2020-11-12 16:48:17 +00:00
if (!fs::exists(users_d))
{
2020-08-08 18:38:34 +00:00
fmt::print("Creating config directory {} that is used for tweaks of users configuration.\n", users_d.string());
fs::create_directory(users_d);
2020-11-12 16:48:17 +00:00
}
2020-08-08 18:38:34 +00:00
2020-11-12 16:48:17 +00:00
if (!fs::exists(main_config_file))
{
2020-08-08 18:38:34 +00:00
std::string_view main_config_content = getResource("config.xml");
if (main_config_content.empty())
{
fmt::print("There is no default config.xml, you have to download it and place to {}.\n", main_config_file.string());
}
else
{
2021-10-16 17:03:45 +00:00
{
WriteBufferFromFile out(main_config_file.string());
out.write(main_config_content.data(), main_config_content.size());
out.sync();
out.finalize();
}
/// Override the default paths.
/// Data paths.
{
std::string data_file = config_d / "data-paths.xml";
WriteBufferFromFile out(data_file);
out << "<yandex>\n"
" <path>" << data_path.string() << "</path>\n"
" <tmp_path>" << (data_path / "tmp").string() << "</tmp_path>\n"
" <user_files_path>" << (data_path / "user_files").string() << "</user_files_path>\n"
" <format_schema_path>" << (data_path / "format_schemas").string() << "</format_schema_path>\n"
"</yandex>\n";
out.sync();
out.finalize();
fmt::print("Data path configuration override is saved to file {}.\n", data_file);
}
/// Logger.
{
std::string logger_file = config_d / "logger.xml";
WriteBufferFromFile out(logger_file);
out << "<yandex>\n"
" <logger>\n"
" <log>" << (log_path / "clickhouse-server.log").string() << "</log>\n"
" <errorlog>" << (log_path / "clickhouse-server.err.log").string() << "</errorlog>\n"
" </logger>\n"
"</yandex>\n";
out.sync();
out.finalize();
fmt::print("Log path configuration override is saved to file {}.\n", logger_file);
}
/// User directories.
{
std::string user_directories_file = config_d / "user-directories.xml";
WriteBufferFromFile out(user_directories_file);
out << "<yandex>\n"
" <user_directories>\n"
" <local_directory>\n"
" <path>" << (data_path / "access").string() << "</path>\n"
" </local_directory>\n"
" </user_directories>\n"
"</yandex>\n";
out.sync();
out.finalize();
fmt::print("User directory path configuration override is saved to file {}.\n", user_directories_file);
}
/// OpenSSL.
{
std::string openssl_file = config_d / "openssl.xml";
WriteBufferFromFile out(openssl_file);
out << "<yandex>\n"
" <openSSL>\n"
" <server>\n"
" <certificateFile>" << (config_dir / "server.crt").string() << "</certificateFile>\n"
" <privateKeyFile>" << (config_dir / "server.key").string() << "</privateKeyFile>\n"
" <dhParamsFile>" << (config_dir / "dhparam.pem").string() << "</dhParamsFile>\n"
" </server>\n"
" </openSSL>\n"
"</yandex>\n";
out.sync();
out.finalize();
fmt::print("OpenSSL path configuration override is saved to file {}.\n", openssl_file);
}
2020-08-08 18:38:34 +00:00
}
2020-11-12 16:48:17 +00:00
}
else
{
fmt::print("Config file {} already exists, will keep it and extract path info from it.\n", main_config_file.string());
ConfigProcessor processor(main_config_file.string(), /* throw_on_bad_incl = */ false, /* log_to_console = */ false);
ConfigurationPtr configuration(new Poco::Util::XMLConfiguration(processor.processConfig()));
if (configuration->has("path"))
{
data_path = configuration->getString("path");
2021-10-16 17:03:45 +00:00
fmt::print("{} has {} as data path.\n", main_config_file.string(), data_path.string());
2020-11-12 16:48:17 +00:00
}
if (configuration->has("logger.log"))
{
log_path = fs::path(configuration->getString("logger.log")).remove_filename();
2021-10-16 17:03:45 +00:00
fmt::print("{} has {} as log path.\n", main_config_file.string(), log_path.string());
2020-11-12 17:28:24 +00:00
}
2020-11-12 16:48:17 +00:00
}
2020-08-08 18:38:34 +00:00
2020-11-12 16:48:17 +00:00
if (!fs::exists(users_config_file))
{
2020-08-08 18:38:34 +00:00
std::string_view users_config_content = getResource("users.xml");
if (users_config_content.empty())
{
fmt::print("There is no default users.xml, you have to download it and place to {}.\n", users_config_file.string());
}
else
{
WriteBufferFromFile out(users_config_file.string());
out.write(users_config_content.data(), users_config_content.size());
out.sync();
out.finalize();
}
}
else
{
2020-11-13 11:31:37 +00:00
fmt::print("Users config file {} already exists, will keep it and extract users info from it.\n", users_config_file.string());
2020-08-08 18:38:34 +00:00
/// Check if password for default user already specified.
2020-11-12 16:48:17 +00:00
ConfigProcessor processor(users_config_file.string(), /* throw_on_bad_incl = */ false, /* log_to_console = */ false);
ConfigurationPtr configuration(new Poco::Util::XMLConfiguration(processor.processConfig()));
2020-08-08 18:38:34 +00:00
2020-11-12 16:48:17 +00:00
if (!configuration->getString("users.default.password", "").empty()
2020-11-26 02:11:55 +00:00
|| !configuration->getString("users.default.password_sha256_hex", "").empty()
|| !configuration->getString("users.default.password_double_sha1_hex", "").empty())
2020-08-08 18:38:34 +00:00
{
2020-11-12 16:48:17 +00:00
has_password_for_default_user = true;
2020-08-08 18:38:34 +00:00
}
}
/// Create directories for data and log.
if (fs::exists(log_path))
{
2021-10-16 17:03:45 +00:00
fmt::print("Log directory {} already exists.\n", log_path.string());
2020-08-08 18:38:34 +00:00
}
else
{
2021-10-16 17:03:45 +00:00
fmt::print("Creating log directory {}.\n", log_path.string());
2020-08-08 18:38:34 +00:00
fs::create_directories(log_path);
}
if (fs::exists(data_path))
{
2021-10-16 17:03:45 +00:00
fmt::print("Data directory {} already exists.\n", data_path.string());
2020-08-08 18:38:34 +00:00
}
else
{
2021-10-16 17:03:45 +00:00
fmt::print("Creating data directory {}.\n", data_path.string());
2020-08-08 18:38:34 +00:00
fs::create_directories(data_path);
}
if (fs::exists(pid_path))
{
2021-10-16 17:03:45 +00:00
fmt::print("Pid directory {} already exists.\n", pid_path.string());
}
else
{
2021-10-16 17:03:45 +00:00
fmt::print("Creating pid directory {}.\n", pid_path.string());
fs::create_directories(pid_path);
}
/// Chmod and chown data and log directories
2021-10-16 17:03:45 +00:00
changeOwnership(log_path, user, group);
changeOwnership(pid_path, user, group);
2021-10-16 17:03:45 +00:00
/// Not recursive, because there can be a huge number of files and it will be slow.
changeOwnership(data_path, user, group, /* recursive= */ false);
2020-08-11 22:48:25 +00:00
/// All users are allowed to read pid file (for clickhouse status command).
fs::permissions(pid_path, fs::perms::owner_all | fs::perms::group_read | fs::perms::others_read, fs::perm_options::replace);
/// Other users in clickhouse group are allowed to read and even delete logs.
fs::permissions(log_path, fs::perms::owner_all | fs::perms::group_all, fs::perm_options::replace);
/// Data directory is not accessible to anyone except clickhouse.
fs::permissions(data_path, fs::perms::owner_all, fs::perm_options::replace);
2020-08-08 18:38:34 +00:00
2021-06-14 10:35:12 +00:00
fs::path odbc_bridge_path = bin_dir / "clickhouse-odbc-bridge";
fs::path library_bridge_path = bin_dir / "clickhouse-library-bridge";
if (fs::exists(odbc_bridge_path) || fs::exists(library_bridge_path))
{
2021-10-16 17:03:45 +00:00
createGroup(DEFAULT_CLICKHOUSE_BRIDGE_GROUP);
createUser(DEFAULT_CLICKHOUSE_BRIDGE_USER, DEFAULT_CLICKHOUSE_BRIDGE_GROUP);
2021-06-14 10:35:12 +00:00
if (fs::exists(odbc_bridge_path))
2021-10-16 17:03:45 +00:00
changeOwnership(odbc_bridge_path, DEFAULT_CLICKHOUSE_BRIDGE_USER, DEFAULT_CLICKHOUSE_BRIDGE_GROUP);
2021-06-14 10:35:12 +00:00
if (fs::exists(library_bridge_path))
2021-10-16 17:03:45 +00:00
changeOwnership(library_bridge_path, DEFAULT_CLICKHOUSE_BRIDGE_USER, DEFAULT_CLICKHOUSE_BRIDGE_GROUP);
2021-06-14 10:35:12 +00:00
}
2020-08-08 18:38:34 +00:00
2021-04-13 19:11:45 +00:00
bool stdin_is_a_tty = isatty(STDIN_FILENO);
2020-08-08 18:38:34 +00:00
bool stdout_is_a_tty = isatty(STDOUT_FILENO);
2021-04-14 14:27:13 +00:00
/// dpkg or apt installers can ask for non-interactive work explicitly.
const char * debian_frontend_var = getenv("DEBIAN_FRONTEND");
bool noninteractive = debian_frontend_var && debian_frontend_var == std::string_view("noninteractive");
bool is_interactive = !noninteractive && stdin_is_a_tty && stdout_is_a_tty;
/// We can ask password even if stdin is closed/redirected but /dev/tty is available.
bool can_ask_password = !noninteractive && stdout_is_a_tty;
2020-08-08 18:38:34 +00:00
2021-06-14 10:35:12 +00:00
/// Set up password for default user.
2020-08-08 18:38:34 +00:00
if (has_password_for_default_user)
{
2021-04-13 20:51:44 +00:00
fmt::print(HILITE "Password for default user is already specified. To remind or reset, see {} and {}." END_HILITE "\n",
2020-08-08 18:38:34 +00:00
users_config_file.string(), users_d.string());
}
2021-04-14 14:27:13 +00:00
else if (!can_ask_password)
2020-08-08 18:38:34 +00:00
{
2021-04-13 20:51:44 +00:00
fmt::print(HILITE "Password for default user is empty string. See {} and {} to change it." END_HILITE "\n",
2020-08-08 18:38:34 +00:00
users_config_file.string(), users_d.string());
}
else
{
2021-04-13 19:11:45 +00:00
/// NOTE: When installing debian package with dpkg -i, stdin is not a terminal but we are still being able to enter password.
/// More sophisticated method with /dev/tty is used inside the `readpassphrase` function.
2020-08-08 18:38:34 +00:00
char buf[1000] = {};
std::string password;
if (auto * result = readpassphrase("Enter password for default user: ", buf, sizeof(buf), 0))
password = result;
if (!password.empty())
{
std::string password_file = users_d / "default-password.xml";
WriteBufferFromFile out(password_file);
#if USE_SSL
std::vector<uint8_t> hash;
hash.resize(32);
encodeSHA256(password, hash.data());
std::string hash_hex;
hash_hex.resize(64);
for (size_t i = 0; i < 32; ++i)
writeHexByteLowercase(hash[i], &hash_hex[2 * i]);
out << "<yandex>\n"
" <users>\n"
" <default>\n"
" <password remove='1' />\n"
2020-08-08 18:38:34 +00:00
" <password_sha256_hex>" << hash_hex << "</password_sha256_hex>\n"
" </default>\n"
" </users>\n"
"</yandex>\n";
out.sync();
out.finalize();
2021-04-13 20:51:44 +00:00
fmt::print(HILITE "Password for default user is saved in file {}." END_HILITE "\n", password_file);
2020-08-08 18:38:34 +00:00
#else
out << "<yandex>\n"
" <users>\n"
" <default>\n"
" <password><![CDATA[" << password << "]]></password>\n"
" </default>\n"
" </users>\n"
"</yandex>\n";
out.sync();
out.finalize();
2021-04-13 20:51:44 +00:00
fmt::print(HILITE "Password for default user is saved in plaintext in file {}." END_HILITE "\n", password_file);
2020-08-08 18:38:34 +00:00
#endif
has_password_for_default_user = true;
}
else
2021-04-13 20:51:44 +00:00
fmt::print(HILITE "Password for default user is empty string. See {} and {} to change it." END_HILITE "\n",
2020-08-08 18:38:34 +00:00
users_config_file.string(), users_d.string());
}
2020-10-20 18:09:15 +00:00
/** Set capabilities for the binary.
*
* 1. Check that "setcap" tool exists.
* 2. Check that an arbitrary program with installed capabilities can run.
* 3. Set the capabilities.
*
* The second is important for Docker and systemd-nspawn.
* When the container has no capabilities,
* but the executable file inside the container has capabilities,
* then attempt to run this file will end up with a cryptic "Operation not permitted" message.
*/
2020-08-08 18:38:34 +00:00
#if defined(__linux__)
fmt::print("Setting capabilities for clickhouse binary. This is optional.\n");
2020-10-20 18:09:15 +00:00
std::string command = fmt::format("command -v setcap >/dev/null"
" && echo > {0} && chmod a+x {0} && {0} && setcap 'cap_net_admin,cap_ipc_lock,cap_sys_nice+ep' {0} && {0} && rm {0}"
" && setcap 'cap_net_admin,cap_ipc_lock,cap_sys_nice+ep' {1}"
" || echo \"Cannot set 'net_admin' or 'ipc_lock' or 'sys_nice' capability for clickhouse binary."
" This is optional. Taskstats accounting will be disabled."
" To enable taskstats accounting you may add the required capability later manually.\"",
2020-11-26 02:11:55 +00:00
"/tmp/test_setcap.sh", fs::canonical(main_bin_path).string());
2020-08-08 18:38:34 +00:00
executeScript(command);
#endif
/// If password was set, ask for open for connections.
if (is_interactive && has_password_for_default_user)
{
if (ask("Allow server to accept connections from the network (default is localhost only), [y/N]: "))
{
std::string listen_file = config_d / "listen.xml";
WriteBufferFromFile out(listen_file);
out << "<yandex>\n"
" <listen_host>::</listen_host>\n"
"</yandex>\n";
out.sync();
out.finalize();
fmt::print("The choice is saved in file {}.\n", listen_file);
}
}
2021-10-16 17:03:45 +00:00
/// Chmod and chown configs
changeOwnership(config_dir, user, group);
/// Symlink "preprocessed_configs" is created by the server, so "write" is needed.
fs::permissions(config_dir, fs::perms::owner_all, fs::perm_options::replace);
/// Subdirectories, so "execute" is needed.
if (fs::exists(config_d))
fs::permissions(config_d, fs::perms::owner_read | fs::perms::owner_exec, fs::perm_options::replace);
if (fs::exists(users_d))
fs::permissions(users_d, fs::perms::owner_read | fs::perms::owner_exec, fs::perm_options::replace);
/// Readonly.
if (fs::exists(main_config_file))
fs::permissions(main_config_file, fs::perms::owner_read, fs::perm_options::replace);
if (fs::exists(users_config_file))
fs::permissions(users_config_file, fs::perms::owner_read, fs::perm_options::replace);
std::string maybe_password;
if (has_password_for_default_user)
maybe_password = " --password";
fmt::print(
"\nClickHouse has been successfully installed.\n"
"\nStart clickhouse-server with:\n"
2020-11-26 01:44:26 +00:00
" sudo clickhouse start\n"
"\nStart clickhouse-client with:\n"
" clickhouse-client{}\n\n",
2020-11-26 01:44:26 +00:00
maybe_password);
2020-08-08 18:38:34 +00:00
}
2020-11-26 02:11:55 +00:00
catch (const fs::filesystem_error &)
{
std::cerr << getCurrentExceptionMessage(false) << '\n';
if (getuid() != 0)
std::cerr << "\nRun with sudo.\n";
return getCurrentExceptionCode();
2020-08-08 18:38:34 +00:00
}
catch (...)
{
2020-08-11 22:04:38 +00:00
std::cerr << getCurrentExceptionMessage(false) << '\n';
2020-08-08 18:38:34 +00:00
return getCurrentExceptionCode();
}
return 0;
}
namespace
{
int start(const std::string & user, const fs::path & executable, const fs::path & config, const fs::path & pid_file)
{
if (fs::exists(pid_file))
{
ReadBufferFromFile in(pid_file.string());
UInt64 pid;
if (tryReadIntText(pid, in))
{
fmt::print("{} file exists and contains pid = {}.\n", pid_file.string(), pid);
if (0 == kill(pid, 0))
{
fmt::print("The process with pid = {} is already running.\n", pid);
return 2;
}
}
else
{
fmt::print("{} file exists but damaged, ignoring.\n", pid_file.string());
fs::remove(pid_file);
}
}
else
{
/// Create a directory for pid file.
/// It's created by "install" but we also support cases when ClickHouse is already installed different way.
fs::path pid_path = pid_file;
pid_path.remove_filename();
fs::create_directories(pid_path);
/// All users are allowed to read pid file (for clickhouse status command).
fs::permissions(pid_path, fs::perms::owner_all | fs::perms::group_read | fs::perms::others_read, fs::perm_options::replace);
2021-10-16 17:03:45 +00:00
changeOwnership(pid_path, user);
}
std::string command = fmt::format("{} --config-file {} --pid-file {} --daemon",
executable.string(), config.string(), pid_file.string());
if (!user.empty())
{
2020-08-27 03:58:05 +00:00
bool may_need_sudo = geteuid() != 0;
if (may_need_sudo)
{
struct passwd *p = getpwuid(geteuid());
// Only use sudo when we are not the given user
if (p == nullptr || std::string(p->pw_name) != user)
command = fmt::format("sudo -u '{}' {}", user, command);
}
else
command = fmt::format("su -s /bin/sh '{}' -c '{}'", user, command);
}
fmt::print("Will run {}\n", command);
executeScript(command, true);
/// Wait to start.
size_t try_num = 0;
constexpr size_t num_tries = 60;
for (; try_num < num_tries; ++try_num)
{
fmt::print("Waiting for server to start\n");
if (fs::exists(pid_file))
{
fmt::print("Server started\n");
break;
}
2021-01-04 14:05:06 +00:00
sleepForSeconds(1);
}
if (try_num == num_tries)
{
fmt::print("Cannot start server. You can execute {} without --daemon option to run manually.\n", command);
fs::path log_path;
{
ConfigProcessor processor(config.string(), /* throw_on_bad_incl = */ false, /* log_to_console = */ false);
ConfigurationPtr configuration(new Poco::Util::XMLConfiguration(processor.processConfig()));
if (configuration->has("logger.log"))
log_path = fs::path(configuration->getString("logger.log")).remove_filename();
}
if (log_path.empty())
{
fmt::print("Cannot obtain path to logs (logger.log) from config file {}.\n", config.string());
}
else
{
fs::path stderr_path = log_path;
stderr_path.replace_filename("stderr.log");
fmt::print("Look for logs at {} and for {}.\n", log_path.string(), stderr_path.string());
}
return 3;
}
return 0;
}
UInt64 isRunning(const fs::path & pid_file)
{
UInt64 pid = 0;
if (fs::exists(pid_file))
{
2021-06-14 21:58:29 +00:00
try
{
2021-06-14 21:58:29 +00:00
ReadBufferFromFile in(pid_file.string());
if (tryReadIntText(pid, in))
{
fmt::print("{} file exists and contains pid = {}.\n", pid_file.string(), pid);
}
else
{
fmt::print("{} file exists but damaged, ignoring.\n", pid_file.string());
fs::remove(pid_file);
}
}
2021-06-14 21:58:29 +00:00
catch (const Exception & e)
{
2021-06-14 21:58:29 +00:00
if (e.code() != ErrorCodes::FILE_DOESNT_EXIST)
throw;
/// If file does not exist (TOCTOU) - it's ok.
}
}
if (!pid)
{
auto sh = ShellCommand::execute("pidof clickhouse-server");
if (tryReadIntText(pid, sh->out))
{
fmt::print("Found pid = {} in the list of running processes.\n", pid);
}
else if (!sh->out.eof())
{
fmt::print("The pidof command returned unusual output.\n");
}
WriteBufferFromFileDescriptor std_err(STDERR_FILENO);
copyData(sh->err, std_err);
sh->tryWait();
}
if (pid)
{
if (0 == kill(pid, 0))
{
fmt::print("The process with pid = {} is running.\n", pid);
}
2021-04-24 01:15:48 +00:00
else if (errno == ESRCH)
{
2021-04-24 01:56:16 +00:00
fmt::print("The process with pid = {} does not exist.\n", pid);
2021-04-24 23:42:18 +00:00
return 0;
}
2021-04-24 23:42:18 +00:00
else
throwFromErrno(fmt::format("Cannot obtain the status of pid {} with `kill`", pid), ErrorCodes::CANNOT_KILL);
}
if (!pid)
{
fmt::print("Now there is no clickhouse-server process.\n");
}
return pid;
}
2020-11-26 04:54:18 +00:00
int stop(const fs::path & pid_file, bool force)
{
UInt64 pid = isRunning(pid_file);
if (!pid)
return 0;
2020-11-26 04:54:18 +00:00
int signal = force ? SIGKILL : SIGTERM;
const char * signal_name = force ? "kill" : "terminate";
if (0 == kill(pid, signal))
fmt::print("Sent {} signal to process with pid {}.\n", signal_name, pid);
else
2020-11-26 04:54:18 +00:00
throwFromErrno(fmt::format("Cannot send {} signal", signal_name), ErrorCodes::SYSTEM_ERROR);
size_t try_num = 0;
constexpr size_t num_tries = 60;
for (; try_num < num_tries; ++try_num)
{
fmt::print("Waiting for server to stop\n");
if (!isRunning(pid_file))
{
fmt::print("Server stopped\n");
break;
}
2021-01-04 14:05:06 +00:00
sleepForSeconds(1);
}
if (try_num == num_tries)
{
fmt::print("Will terminate forcefully.\n", pid);
if (0 == kill(pid, 9))
fmt::print("Sent kill signal.\n", pid);
else
throwFromErrno("Cannot send kill signal", ErrorCodes::SYSTEM_ERROR);
/// Wait for the process (100 seconds).
constexpr size_t num_kill_check_tries = 1000;
constexpr size_t kill_check_delay_ms = 100;
for (size_t i = 0; i < num_kill_check_tries; ++i)
{
fmt::print("Waiting for server to be killed\n");
if (!isRunning(pid_file))
{
fmt::print("Server exited\n");
break;
}
sleepForMilliseconds(kill_check_delay_ms);
}
if (isRunning(pid_file))
{
throw Exception(ErrorCodes::CANNOT_KILL,
2021-09-24 23:37:30 +00:00
"The server process still exists after {} tries (delay: {} ms)",
num_kill_check_tries, kill_check_delay_ms);
}
}
return 0;
}
}
int mainEntryClickHouseStart(int argc, char ** argv)
{
try
{
2021-10-16 17:03:45 +00:00
po::options_description desc;
desc.add_options()
("help,h", "produce help message")
("prefix", po::value<std::string>()->default_value("/"), "prefix for all paths")
("binary-path", po::value<std::string>()->default_value("usr/bin"), "directory with binary")
("config-path", po::value<std::string>()->default_value("etc/clickhouse-server"), "directory with configs")
("pid-path", po::value<std::string>()->default_value("var/run/clickhouse-server"), "directory for pid file")
("user", po::value<std::string>()->default_value(DEFAULT_CLICKHOUSE_SERVER_USER), "clickhouse user")
;
po::variables_map options;
po::store(po::parse_command_line(argc, argv, desc), options);
if (options.count("help"))
{
std::cout << "Usage: "
<< (getuid() == 0 ? "" : "sudo ")
<< argv[0]
<< " start\n";
return 1;
}
std::string user = options["user"].as<std::string>();
2021-10-16 17:03:45 +00:00
fs::path prefix = options["prefix"].as<std::string>();
fs::path executable = prefix / options["binary-path"].as<std::string>() / "clickhouse-server";
fs::path config = prefix / options["config-path"].as<std::string>() / "config.xml";
fs::path pid_file = prefix / options["pid-path"].as<std::string>() / "clickhouse-server.pid";
return start(user, executable, config, pid_file);
}
catch (...)
{
2020-08-11 22:04:38 +00:00
std::cerr << getCurrentExceptionMessage(false) << '\n';
return getCurrentExceptionCode();
}
}
int mainEntryClickHouseStop(int argc, char ** argv)
{
try
{
2021-10-16 17:03:45 +00:00
po::options_description desc;
desc.add_options()
("help,h", "produce help message")
("prefix", po::value<std::string>()->default_value("/"), "prefix for all paths")
("pid-path", po::value<std::string>()->default_value("var/run/clickhouse-server"), "directory for pid file")
("force", po::bool_switch(), "Stop with KILL signal instead of TERM")
;
po::variables_map options;
po::store(po::parse_command_line(argc, argv, desc), options);
if (options.count("help"))
{
std::cout << "Usage: "
<< (getuid() == 0 ? "" : "sudo ")
<< argv[0]
<< " stop\n";
return 1;
}
fs::path prefix = options["prefix"].as<std::string>();
fs::path pid_file = prefix / options["pid-path"].as<std::string>() / "clickhouse-server.pid";
2020-11-26 04:54:18 +00:00
return stop(pid_file, options["force"].as<bool>());
}
catch (...)
{
2020-08-11 22:04:38 +00:00
std::cerr << getCurrentExceptionMessage(false) << '\n';
return getCurrentExceptionCode();
}
}
int mainEntryClickHouseStatus(int argc, char ** argv)
{
2021-10-16 17:03:45 +00:00
try
{
po::options_description desc;
desc.add_options()
("help,h", "produce help message")
("prefix", po::value<std::string>()->default_value("/"), "prefix for all paths")
("pid-path", po::value<std::string>()->default_value("var/run/clickhouse-server"), "directory for pid file")
;
2021-10-16 17:03:45 +00:00
po::variables_map options;
po::store(po::parse_command_line(argc, argv, desc), options);
2021-10-16 17:03:45 +00:00
if (options.count("help"))
{
std::cout << "Usage: "
<< (getuid() == 0 ? "" : "sudo ")
<< argv[0]
<< " status\n";
return 1;
}
fs::path prefix = options["prefix"].as<std::string>();
fs::path pid_file = prefix / options["pid-path"].as<std::string>() / "clickhouse-server.pid";
isRunning(pid_file);
}
catch (...)
{
2020-08-11 22:04:38 +00:00
std::cerr << getCurrentExceptionMessage(false) << '\n';
return getCurrentExceptionCode();
}
2021-10-16 17:03:45 +00:00
return 0;
}
int mainEntryClickHouseRestart(int argc, char ** argv)
{
try
{
2021-10-16 17:03:45 +00:00
po::options_description desc;
desc.add_options()
("help,h", "produce help message")
("prefix", po::value<std::string>()->default_value("/"), "prefix for all paths")
("binary-path", po::value<std::string>()->default_value("usr/bin"), "directory with binary")
("config-path", po::value<std::string>()->default_value("etc/clickhouse-server"), "directory with configs")
("pid-path", po::value<std::string>()->default_value("var/run/clickhouse-server"), "directory for pid file")
("user", po::value<std::string>()->default_value(DEFAULT_CLICKHOUSE_SERVER_USER), "clickhouse user")
("force", po::value<bool>()->default_value(false), "Stop with KILL signal instead of TERM")
;
po::variables_map options;
po::store(po::parse_command_line(argc, argv, desc), options);
if (options.count("help"))
{
std::cout << "Usage: "
<< (getuid() == 0 ? "" : "sudo ")
<< argv[0]
<< " restart\n";
return 1;
}
std::string user = options["user"].as<std::string>();
2021-10-16 17:03:45 +00:00
fs::path prefix = options["prefix"].as<std::string>();
fs::path executable = prefix / options["binary-path"].as<std::string>() / "clickhouse-server";
fs::path config = prefix / options["config-path"].as<std::string>() / "config.xml";
fs::path pid_file = prefix / options["pid-path"].as<std::string>() / "clickhouse-server.pid";
2020-11-26 04:54:18 +00:00
if (int res = stop(pid_file, options["force"].as<bool>()))
return res;
2021-10-16 17:03:45 +00:00
return start(user, executable, config, pid_file);
}
catch (...)
{
2020-08-11 22:04:38 +00:00
std::cerr << getCurrentExceptionMessage(false) << '\n';
return getCurrentExceptionCode();
}
}