Better detailed x-pack installation guide

[mfn]

Tested with Kibana 5.3.0

On https://www.elastic.co/downloads/x-pack there's a special section for elasticsearch, mentioning this:

To install X-Pack on a DEB/RPM installation of the Elastic Stack, see DEB/RPM installation instructions.

And further detailing:

To install X-Pack on a DEB/RPM package installation, you need to run bin/plugin install from the /usr/share/elasticsearch directory with superuser permissions:
cd /usr/share/elasticsearch
sudo bin/elasticsearch-plugin install x-pack

The same seems to apply when Kibana is installed from deb package:

/usr/share/kibana $  bin/kibana-plugin install x-pack
fs.js:640
  return binding.open(pathModule._makeLong(path), stringToFlags(flags), mode);
                 ^

Error: EACCES: permission denied, open '/usr/share/kibana/optimize/.babelcache.json'
    at Error (native)
    at Object.fs.openSync (fs.js:640:18)
    at Object.fs.writeFileSync (fs.js:1333:33)
    at save (/usr/share/kibana/node_modules/babel-core/lib/api/register/cache.js:35:19)
    at _combinedTickCallback (internal/process/next_tick.js:67:7)
    at process._tickCallback (internal/process/next_tick.js:98:9)
    at Module.runMain (module.js:606:11)
    at run (bootstrap_node.js:394:7)
    at startup (bootstrap_node.js:149:9)
    at bootstrap_node.js:509:3

But this worked:

/usr/share/kibana $  sudo bin/kibana-plugin install x-pack
Attempting to transfer from x-pack
Attempting to transfer from https://artifacts.elastic.co/downloads/kibana-plugins/x-pack/x-pack-5.3.0.zip
Transferring 109091475 bytes....................
Transfer complete
Retrieving metadata from plugin archive
Extracting plugin archive
Extraction complete
Optimizing and caching browser bundles...
Plugin installation complete

But I also realized that in /usr/share/kibana not all is owner by root:

mfischer@swat-es02 /usr/share/kibana $  ls -l
total 704
drwxrwxr-x   2 root   root     4096 Apr 13 07:56 bin
-rw-rw-r--   1 root   root      562 Mar 23 04:46 LICENSE.txt
drwxrwxr-x   6 root   root     4096 Apr 13 07:56 node
drwxrwxr-x 480 root   root    20480 Apr 13 07:56 node_modules
-rw-rw-r--   1 root   root   652779 Mar 23 04:46 NOTICE.txt
drwxrwxr-x   3 kibana kibana   4096 Apr 13 07:56 optimize
-rw-rw-r--   1 root   root      701 Mar 23 04:46 package.json
drwxrwxr-x   3 kibana kibana   4096 Apr 13 08:41 plugins
-rw-rw-r--   1 root   root     4963 Mar 23 04:46 README.txt
drwxrwxr-x  10 root   root     4096 Apr 13 07:56 src
drwxrwxr-x   3 root   root     4096 Apr 13 07:56 ui_framework
drwxrwxr-x   2 root   root     4096 Apr 13 07:56 webpackShims

I then ended up with some files in e.g. optimize/ being owner by kibana and some by root. I had a feeling this isn't good and changed the owner ship back for all files in pre-kibana owned directories:

/usr/share/kibana $  sudo chown -R kibana.kibana optimize/ plugins/

Not sure if there's an official guide for this but would be nice if this can be clarified.

[jbudz]

@mfn you're on the right track, we have a short section here for plugins. The bug you ran into is filed at #8818. We'll leave this open for addressing plugin instructions in the x-pack docs.

[nreese]

Closing. x-pack is now automatically included in distribution starting in Kibana 6.3 and no longer needs to installed.