"Fossies" - the Fresh Open Source Software Archive

Member "icinga-web-1.14.1/doc/README.RHEL" (19 Dec 2017, 3615 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.RHEL": 1.13.1_vs_1.14.0.

    1 Icinga Web as package on RHEL
    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 check out 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 * Additional packages: 
   26 
   27 # yum install php php-cli php-pear php-xmlrpc php-xsl php-pdo php-soap php-gd php-ldap php-mysql
   28 
   29 NOTE: On RHEL5 PHP 5.3 is available through the package 'php53'.
   30 
   31 Installation
   32 ~~~~~~~~~~~~
   33 
   34 # yum install <packagename>
   35 
   36 * icinga-web - main package
   37 * icinga-web-{mysql,pgsql} - database config for 'icinga_web' database
   38 * icinga-web-module-pnp - pnp integration templates
   39 
   40 Database Setup
   41 ~~~~~~~~~~~~~~
   42 
   43 * Create the database, user and permissions.
   44 
   45 # mysql -u root -p
   46 
   47 mysql> 	CREATE DATABASE icinga_web;
   48 
   49 	GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON icinga_web.* TO 'icinga_web'@'localhost' IDENTIFIED BY 'icinga_web';
   50 
   51         quit
   52 
   53 * Import the Icinga Web schema
   54 
   55 # mysql -u root -p icinga_web <  /usr/share/doc/icinga-web-<version>/schema/mysql.sql
   56 
   57 Web Interface
   58 ~~~~~~~~~~~~~
   59 
   60 After installing the package, Icinga Web will be available at
   61 
   62 http://localhost/icinga-web
   63 User: root
   64 Password: password
   65 
   66 You can edit or add users from the admin panel then. Check the icinga
   67 docs for some details on that.
   68 http://docs.icinga.org/latest/en/icinga-web-introduction.html
   69 
   70 Configuration
   71 ~~~~~~~~~~~~~
   72 
   73 Configuration is stored within *.xml files in /etc/icinga-web/conf.d
   74 After editing the config, clearing the cache is required running
   75 
   76 # /usr/bin/icinga-web-clearcache
   77 
   78 If you've chosen different database usernames/passwords please edit
   79 /etc/icinga-web/conf.d/databases.xml in the 'icinga web' and 'icinga
   80 idoutils' sections. 
   81 
   82 Check the documentation for more details
   83 http://docs.icinga.org/latest/en/icinga-web-config.html
   84 
   85 Configuration for Icinga 2
   86 ~~~~~~~~~~~~~~~~~~~~~~~~~~
   87 
   88 Icinga Web 1.x targets a default Icinga Core & IDOUtils installation. You will
   89 need to adjust certain configuration parameters in order to point them to Icinga 2's
   90 locations.
   91 
   92 * IDO DB Backend
   93 
   94 Only if the default credentials have been changed during the setup.
   95 
   96 # vim /etc/icinga-web/conf.d/databases.xml
   97 
   98 * External Command Pipe
   99 
  100 # vim /etc/icinga-web/conf.d/access.xml
  101 
  102             <write>
  103                 <files>
  104                     <resource name="icinga_pipe">/var/run/icinga2/cmd/icinga.cmd</resource>
  105                 </files>
  106             </write>
  107 
  108 # icinga-web-clearcache
  109 
  110 Logs & Errors
  111 ~~~~~~~~~~~~~
  112 
  113 Icinga Web logs are stored in /var/log/icinga-web
  114 Common errors may also be within apache logs.
  115 
  116 Your browsers developer tools & console may help too.
  117 
  118 File Locations
  119 ~~~~~~~~~~~~~~
  120 
  121 | /etc/icinga-web/conf.d 		| xml configuration
  122 | /usr/share/icinga-web 		| data root dir (where the php, js will live)
  123 | /etc/httpd/conf.d/icinga-web.conf 	| apache config
  124 | /var/log/icinga-web 			| contains all log files
  125 | /var/cache/icinga-web 		| config cache files (cleared with icinga-web-clearcache)
  126 
  127 The icinga package places the external command pipe into '/var/spool/icinga/cmd/icinga.cmd'
  128 which will be the default location in the access.xml configuration file.
  129