Adds information on setting up repositories for Kibana deb & rpm installation.

docs/kibana-repositories.asciidoc

@@ -0,0 +1,113 @@
+[[setup-repositories]]
+=== Kibana Repositories
+
+Binary packages for Kibana are available for Unix distributions that support the `apt` and `yum` tools.We also have 
+repositories available for APT and YUM based distributions. 
+
+NOTE: Since the packages are created as part of the Kibana build, source packages are not available.
+
+Packages are signed with the PGP key http://pgp.mit.edu/pks/lookup?op=vindex&search=0xD27D666CD88E42B4[D88E42B4], which 
+has the following fingerprint:
+
+    4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4
+
+[float]
+[[kibana-apt]]
+===== Installing Kibana with apt-get
+
+. Download and install the Public Signing Key:
++
+[source,sh]
+--------------------------------------------------
+wget -qO - https://packages.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
+--------------------------------------------------
++
+. Add the repository definition to your `/etc/apt/sources.list` file:
++
+[source, sh]
+--------------------------------------------------
+echo "deb http://packages.elastic.co/kibana/{branch}/debian stable main" | sudo tee -a /etc/apt/sources.list
+--------------------------------------------------
++
+[WARNING]
+==================================================
+Use the `echo` method described above to add the Kibana repository.  Do not use `add-apt-repository`, as that command 
+adds a `deb-src` entry with no corresponding source package.
+When the `deb-src` entry, is present, the commands in this procedure generate an error similar to the following:
+
+    Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)
+
+Delete the `deb-src` entry from the `/etc/apt/sources.list` file to clear the error.
+==================================================
++
+. Run `apt-get update` and the repository is ready for use. Install Kibana with the following command:
++
+[source,sh]
+--------------------------------------------------
+sudo apt-get update && sudo apt-get install kibana
+--------------------------------------------------
++
+. Configure Kibana to automatically start during bootup. If your distribution is using the System V version of `init`, 
+run the following command:
++
+[source,sh]
+--------------------------------------------------
+sudo update-rc.d kibana defaults 95 10
+--------------------------------------------------
++
+. If your distribution is using `systemd`, run the following commands instead:
++
+[source,sh]
+--------------------------------------------------
+sudo /bin/systemctl daemon-reload
+sudo /bin/systemctl enable kibana.service
+--------------------------------------------------
+
+[float]
+[[kibana-yum]]
+===== Installing Kibana with yum
+
+WARNING: The repositories set up in this procedure are not compatible with distributions using version 3 of `rpm`, such 
+as CentOS version 5.
+
+. Download and install the public signing key:
++
+[source,sh]
+--------------------------------------------------
+rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
+--------------------------------------------------
++
+. Create a file named `kibana.repo` in the `/etc/yum.repos.d/` directory with the following contents:
++
+[source,sh]
+--------------------------------------------------
+[kibana-{branch}]
+name=Kibana repository for {branch}.x packages
+baseurl=http://packages.elastic.co/kibana/{branch}/centos
+gpgcheck=1
+gpgkey=http://packages.elastic.co/GPG-KEY-elasticsearch
+enabled=1
+--------------------------------------------------
++
+. Install Kibana by running the following command:
++
+[source,sh]
+--------------------------------------------------
+yum install kibana
+--------------------------------------------------
++
+Configure Kibana to automatically start during bootup. If your distribution is using the System V version of `init`, 
+run the following command:
++
+[source,sh]
+--------------------------------------------------
+chkconfig --add kibana
+--------------------------------------------------
++
+. If your distribution is using `systemd`, run the following commands instead:
++
+[source,sh]
+--------------------------------------------------
+sudo /bin/systemctl daemon-reload
+sudo /bin/systemctl enable kibana.service
+--------------------------------------------------

docs/setup.asciidoc

@@ -21,10 +21,10 @@ To get Kibana up and running:
 . Download the https://www.elastic.co/downloads/kibana[Kibana 4 binary package] for your platform.
 . Extract the `.zip` or `tar.gz` archive file.
 
-On Unix, you can instead run the package manager suited for your distribution:
+On Unix, you can instead run the package manager suited for your distribution.
 
-* Red Hat, Centos: `yum install kibana`
-* Debian: `apt-get install kibana`
+[float]
+include::kibana-repositories.asciidoc[]
 
 After installing, run Kibana from the install directory: `bin/kibana` (Linux/MacOSX) or `bin\kibana.bat` (Windows).