Elasticsearch的Debian包能够从downloaded from our website或APT repository
它能够用于在任何Debian-based的系统(如Debian和Ubuntu)上安装Elasticsearch。
Elasticsearch的最新稳定版在Download Elasticsearch下载,其余的版本在Past Releases page下载。html
NOTE:java
Elasticsearch须要java8或者更高的java版本。
可使用official Oracle distribution 或者使用open-source distribution 例如OpenJDK。web
咱们利用以下指纹签名的密钥签署验证了全部的包bootstrap
4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4
下载并安装公共签名密钥:网络
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
在继续以前,你可能须要在Debian上安装apt-transport-https包:oracle
sudo apt-get install apt-transport-https
将存储库定义保存到/etc/apt/sources.list.d/elastic-5.x.list:elasticsearch
echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list
WARNING:ide
不要使用add-apt-repository,由于它将添加一个deb-src条目,但咱们不提供源包。 若是你已添加deb-src条目,你将看到相似以下的错误:学习
Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)
从/etc/apt/sources.list文件中删除deb-src条目,安装能够正常工做测试
你能够经过以下命令安装Elasticsearch Debian软件包:
sudo apt-get update && sudo apt-get install elasticsearch
WARNING:
若是同一Elasticsearch存储库存在两个条目,则在apt-get update期间将出现相似如下错误:
Duplicate sources.list entry https://artifacts.elastic.co/packages/5.x/apt/ ...`
检查/etc/apt/sources.list.d/elasticsearch-5.x.list 中的重复条目,或者在/etc/apt/sources.list.d/和
/etc/apt/sources.list中寻找重复的条目
NOTE:
在systemd-based的版本,安装脚本将尝试设置内核参数(例如,vm.max_map_count); 你能够经过将环境变量ES_SKIP_SET_KERNEL_PARAMETERS设置为true来跳过此操做。
用于Elasticsearch v5.0.2的Debian软件包能够从网站下载并安装以下:
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.0.2.deb sha1sum elasticsearch-5.0.2.deb sudo dpkg -i elasticsearch-5.0.2.deb
Elasticsearch在安装后不会自动启动。 如何启动和中止Elasticsearch取决于你的系统是使用SysV init仍是systemd(由较新的发行版使用)。
你能够经过运行此命令来肯定:
ps -p 1
使用update-rc.d命令将Elasticsearch配置为在系统启动时自动启动:
sudo update-rc.d elasticsearch defaults 95 10
可使用service命令启动和中止Elasticsearch:
sudo -i service elasticsearch start sudo -i service elasticsearch stop
若是Elasticsearch因为任何缘由没法启动,它会将失败的缘由打印到STDOUT。 日志文件能够在/var/log/elasticsearch/中找到。
经过以下命令设置Elasticsearch 在系统启动时,自动启动
sudo /bin/systemctl daemon-reload sudo /bin/systemctl enable elasticsearch.service
Elasticsearch能够按以下方式启动和中止:
sudo systemctl start elasticsearch.service sudo systemctl stop elasticsearch.service
以上两条命令不会提供有关Elasticsearch是否已成功启动的反馈。 此信息将写入位于/var/log/elasticsearch/中的日志文件中。
(你能够尝试 sudo systemctl status elasticsearch.service)
默认状况下,Elasticsearch服务不会被记录到systemd journal。 要启用journalctl,必须从elasticsearch.service文件中的ExecStart命令行中删除--quiet选项。
当启用systemd日志记录时,使用journalctl命令能够得到日志记录信息:
To tail the journal:
sudo journalctl -f
To list journal entries for the elasticsearch service:
sudo journalctl --unit elasticsearch
To list journal entries for the elasticsearch service starting from a given time:
sudo journalctl --unit elasticsearch --since "2016-10-30 18:17:16"
有关更多命令行选项,请检查man journalctl或https://www.freedesktop.org/software/systemd/man/journalctl.html。
你能够经过向localhost上的端口9200发送HTTP请求来测试Elasticsearch节点是否正在运行:
GET /
若是elasticsearch正在运行,你会获得以下response
{ "name" : "Cp8oag6", "cluster_name" : "elasticsearch", "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA", "version" : { "number" : "5.0.2", "build_hash" : "f27399d", "build_date" : "2016-03-30T09:51:41.449Z", "build_snapshot" : false, "lucene_version" : "6.2.1" }, "tagline" : "You Know, for Search" }
默认状况下,Elasticsearch从/etc/elasticsearch/elasticsearch.yml文件加载其配置。
此配置文件的格式在Configuring Elasticsearch中进行了说明
Debian包还有一个系统配置文件/etc/default/elasticsearch,容许你设置如下参数:
参数 | 解释 |
---|---|
ES_USER | 定义user名称,默认为elasticsearch |
ES_GROUP | 定义group名称,默认为elasticsearch |
JAVA_HOME | 设置java路径 |
MAX_OPEN_FILES | 最大打开文件数,默认值为65536 |
MAX_LOCKED_MEMORY | 最大锁定内存大小,若是在elasticsearch.yml 设置了bootstrap.memory_lock=true,此处设置为unlimited |
MAX_MAP_COUNT | 进程可能具备的内存映射区域的最大数量。 若是使用mmapfs做为索引存储类型,请确保将其设置为较高的值。有关更多信息,请查看[]。 这是在启动elasticsearch以前经过sysctl设置的。 默认为262144。 |
LOG_DIR | 日志文件目录,默认为/var/log/elasticsearch |
DATA_DIR | 数据文件目录,默认为/var/lib/elasticsearch |
CONF_DIR | 配置文件目录(须要包括elasticsearch.yml和log4j2.properties文件),默认为/etc/elasticsearch |
ES_JAVA_OPTS | 想要应用的任何其余JVM系统属性 |
RESTART_ON_UPGRADE | 配置软件包升级时的从新启动,默认为false。 这意味着您必须在手动安装软件包后从新启动elasticsearch实例。这样作的缘由是确保集群中的升级不会致使持续的分片从新分配,从而致使高网络流量并减小集群的响应时间。 |
NOTE:
使用systemd的版本须要经过systemd而不是经过/etc/sysconfig/elasticsearch文件配置系统资源限制。 有关详细信息,请参阅。
Type | Description | Default Location | Setting |
---|---|---|---|
home | elasticsearch主目录($ES_HOME) | /usr/share/elasticsearch | |
bin | elasticsearch启动节点启动脚本,elasticsearch-plugin插件安装脚本 | /usr/share/elasticsearch/bin | |
conf | 配置文件,包含elasticsearch.yml | /etc/elasticsearch | path.conf |
conf | 环境变量设置,包括heap size、file descriptors | /etc/default/elasticsearch | |
data | 节点上分配的每一个index/shard的数据文件的位置,能够有多个位置 | /var/lib/elasticsearch | path.data |
logs | 日志文件的存放位置 | /var/log/elasticsearch | path.logs |
plugins | 插件文件的位置,每一个插件一个子文件夹 | /usr/share/elasticsearch/plugins | |
repo | 共享文件系统存储库位置,容纳多个位置。能够放置在此处指定的任何目录的任何子目录中。 | Not configured | path.repo |
script | 脚本文件的位置 | $ES_HOME/scripts | path.scripts |
你如今已经设置了一个测试Elasticsearch环境。 在开始认真开发或使用Elasticsearch开始生产以前,您须要进行一些额外的设置: