This is an automated email from the ASF dual-hosted git repository. abudnikov pushed a commit to branch IGNITE-7595 in repository https://gitbox.apache.org/repos/asf/ignite.git
commit 6707062d9bc37f5b2ff96eb3a8fadf0887513353 Author: abudnikov <[email protected]> AuthorDate: Mon Aug 24 17:25:07 2020 +0300 update deb package installation instruction --- docs/_data/toc.yaml | 12 +++--- docs/_docs/installation/deb-rpm.adoc | 77 +++++++++++++++++++++++++++++++----- 2 files changed, 74 insertions(+), 15 deletions(-) diff --git a/docs/_data/toc.yaml b/docs/_data/toc.yaml index 1a412ff..81c3ee1 100644 --- a/docs/_data/toc.yaml +++ b/docs/_data/toc.yaml @@ -26,7 +26,7 @@ - title: Installing Using Docker url: /installation/installing-using-docker - title: Installing DEB or RPM package - url: /installation/dem-rpm + url: /installation/deb-rpm - title: Kubernetes items: - title: Amazon EKS @@ -185,10 +185,12 @@ items: - title: Introduction url: /monitoring-metrics/intro - - title: Configuring Metrics - url: /monitoring-metrics/configuring-metrics - - title: JMX Metrics - url: /monitoring-metrics/metrics + - title: Metrics + items: + - title: Configuring Metrics + url: /monitoring-metrics/configuring-metrics + - title: JMX Metrics + url: /monitoring-metrics/metrics - title: New Metrics System items: - title: Introduction diff --git a/docs/_docs/installation/deb-rpm.adoc b/docs/_docs/installation/deb-rpm.adoc index 883a2b6..a35b755 100644 --- a/docs/_docs/installation/deb-rpm.adoc +++ b/docs/_docs/installation/deb-rpm.adoc @@ -2,23 +2,80 @@ Apache Ignite can be installed from the official link:https://www.apache.org/dist/ignite/rpm[RPM] or link:https://www.apache.org/dist/ignite/deb[DEB] repositories. -== Configuring Repositories +== Installing Deb Package -Configure Apache Ignite's RPM or DEB repository, as follows (accept the GPG key import prompt if required), including specific Linux distribution settings: +Configure the repository: - -.Debian [source, shell] ---- -# Install dirmngr (if not already installed) for apt-key ability to retrieve remote GPG keys sudo apt update sudo apt install dirmngr --no-install-recommends ---- -[tabs] --- -tab:DEB[] -tab:RPM[] --- +[source, shell] +---- +sudo bash -c 'cat <<EOF > /etc/apt/sources.list.d/ignite.list +deb http://apache.org/dist/ignite/deb/ apache-ignite main +EOF' +sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61 +sudo apt update +---- + +Install the Apache Ignite package: + +[source, shell] +---- +sudo apt install apache-ignite --no-install-recommends +---- + +This will install the following files into your system: + +[cols="1,1,1",opts="header"] +|=== + +|Folder| Mapped To| Description +|/usr/share/apache-ignite|| The root of Apache Ignite's installation +|/usr/share/apache-ignite/bin|| Bin folder (scripts and executables) +|/etc/apache-ignite | /usr/share/apache-ignite/config| Default configuration files +|/var/log/apache-ignite| /var/lib/apache-ignite/log| Log directory +|/usr/lib/apache-ignite| /usr/share/apache-ignite/libs| Core and optional libraries +|/var/lib/apache-ignite| /usr/share/apache-ignite/work| Ignite work directory +|/usr/share/doc/apache-ignite || Documentation +|/usr/share/license/apache-ignite-{version} || Licenses +|/etc/systemd/system | systemd service configuration + +|=== + +== Running Ignite as a Service + +NOTE: If running on Windows 10 WSL or Docker, you should start Apache Ignite as a stand-alone process (not as a service). +//See the next section. + +To start an Ignite node with a custom configuration, run the following command: + +[source, shell] +---- +sudo systemctl start apache-ignite@<config_name> +---- + +The `<config_name>` parameter specifies the path to the configuration file relative to the `/etc/apache-ignite folder`. + +To launch the node at system startup, run the following command: + +[source, shell] +---- +sudo systemctl enable apache-ignite@<config name> +---- + + +//// +== Running Ignite as a Stand-Alone Process + +Use the commands below to start Ignite as a stand-alone process (cd to /usr/share/apache-ignite previously). +To change the default configuration, you can update the /etc/apache-ignite/default-config.xml file. +The default configuration uses Multicast IP Finder; if you want to use Static IP Finder, you need to change the default config file. +Learn more about TCP/IP Discovery in the corresponding page. + +////
