"Fossies" - the Fresh Open Source Software Archive

Member "icinga-web-1.14.1/doc/README.SUSE" (19 Dec 2017, 3418 Bytes) of package /linux/misc/old/icinga-web-1.14.1.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "README.SUSE": 1.13.1_vs_1.14.0.

    1 Icinga Web as package on SUSE
    2 -----------------------------
    3 
    4 NOTE: Keep in mind to read the Changelog!
    5       /usr/share/doc/icinga-web-<version>/
    6 
    7 For detailed information on
    8 
    9 * how to build a package with provided icinga-web.spec
   10 * how to proceed with setup after package install
   11     - setup the icinga_web database
   12     - configure the backend for IDOUtils and internal Web DB
   13 
   14 Please checkout the official docs for a more detailed introduction
   15 
   16 https://docs.icinga.com
   17 https://docs.icinga.com/latest/en/icinga-web-introduction.html
   18 
   19 Requirements
   20 ~~~~~~~~~~~~
   21 
   22 * Icinga
   23 * Icinga IDOUtils (providing database 'icinga')
   24 * MySQL or Postgresql (for the 'icinga_web' database storing user credentials, sessions, etc)
   25 
   26 
   27 Installation
   28 ~~~~~~~~~~~~
   29 
   30 # zypper install <packagename>
   31 
   32 * icinga-web - main package
   33 * icinga-web-{mysql,pgsql} - database config for 'icinga_web' database
   34 * icinga-web-module-pnp - pnp integration templates
   35 
   36 Database Setup
   37 ~~~~~~~~~~~~~~
   38 
   39 * Create the database, user and permissions.
   40 
   41 # mysql -u root -p
   42 
   43 mysql> 	CREATE DATABASE icinga_web;
   44 
   45 	GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON icinga_web.* TO 'icinga_web'@'localhost' IDENTIFIED BY 'icinga_web';
   46 
   47         quit
   48 
   49 * Import the Icinga Web schema
   50 
   51 # mysql -u root -p icinga_web <  /usr/share/doc/icinga-web-<version>/schema/mysql.sql
   52 
   53 Web Interface
   54 ~~~~~~~~~~~~~
   55 
   56 After installing the package, Icinga Web will be available at
   57 
   58 http://localhost/icinga-web
   59 User: root
   60 Password: password
   61 
   62 You can edit or add users from the admin panel then. Check the icinga
   63 docs for some details on that.
   64 http://docs.icinga.org/latest/en/icinga-web-introduction.html
   65 
   66 Configuration
   67 ~~~~~~~~~~~~~
   68 
   69 Configuration is stored within *.xml files in /etc/icinga-web/conf.d
   70 After editing the config, clearing the cache is required running
   71 
   72 # /usr/bin/icinga-web-clearcache
   73 
   74 If you've chosen different database usernames/passwords please edit
   75 /etc/icinga-web/conf.d/databases.xml in the 'icinga web' and 'icinga
   76 idoutils' sections. 
   77 
   78 Check the documentation for more details
   79 http://docs.icinga.org/latest/en/icinga-web-config.html
   80 
   81 Configuration for Icinga 2
   82 ~~~~~~~~~~~~~~~~~~~~~~~~~~
   83 
   84 Icinga Web 1.x targets a default Icinga Core & IDOUtils installation. You will
   85 need to adjust certain configuration parameters in order to point them to Icinga 2's
   86 locations.
   87 
   88 * IDO DB Backend
   89 
   90 Only if the default credentials have been changed during the setup.
   91 
   92 # vim /etc/icinga-web/conf.d/databases.xml
   93 
   94 * External Command Pipe
   95 
   96 # vim /etc/icinga-web/access.xml
   97 
   98             <write>
   99                 <files>
  100                     <resource name="icinga_pipe">/var/run/icinga2/cmd/icinga.cmd</resource>
  101                 </files>
  102             </write>
  103 
  104 # icinga-web-clearcache
  105 
  106 Logs & Errors
  107 ~~~~~~~~~~~~~
  108 
  109 Icinga Web logs are stored in /var/log/icinga-web
  110 Common errors may also be within apache logs.
  111 
  112 Your browsers developer tools & console may help too.
  113 
  114 File Locations
  115 ~~~~~~~~~~~~~~
  116 
  117 | /etc/icinga-web/conf.d 		| xml configuration
  118 | /usr/share/icinga-web 		| data root dir (where the php, js will live)
  119 | /etc/apache2/conf.d/icinga-web.conf 	| apache config
  120 | /var/log/icinga-web 			| contains all log files
  121 | /var/cache/icinga-web 		| config cache files (cleared with icinga-web-clearcache)
  122 
  123 The icinga package places the external command pipe into '/var/icinga/rw/icinga.cmd'
  124 which will be the default location in the access.xml configuration file.
  125