"Fossies" - the Fresh Open Source Software Archive

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

    1 # Installation
    2 
    3 ## Packages
    4 
    5 Look into your distribution's package repository if there are
    6 packages available. If not, ask the distribution upstream.
    7 
    8 ## Source
    9 
   10 There is a detailed from scratch installation guide available:
   11 http://docs.icinga.org/latest/en/icinga-web-scratch.html
   12 
   13 Call `./configure --help` and `make` to get a list of available options.
   14 
   15 ## Build Requirements
   16 
   17 * Apache 2.2+, Nginx or any other webserver
   18 * PHP 5.2.6+ (cli, pear, xmlrpc, xsl, soap, gd, ldap, json, gettext, sockets)
   19 * PHP PDO MySQL or PostgreSQL
   20 * MySQL or PostgreSQL database for the internal backend (sesssions, etc)
   21 * XML Syntax-highlighting for your preferred editor
   22 
   23 ## Database Schema
   24 
   25 The database schema files are located in `etc/schema`. You can import them manually.
   26 
   27 ### MySQL
   28        # mysql -u root -p
   29 
   30               CREATE USER `icinga_webweb`@`localhost` IDENTIFIED BY 'icinga_webweb';
   31               CREATE DATABASE `icinga_web`;
   32               GRANT ALL PRIVILEGES ON `icinga_web`.* TO `icinga_web`@`localhost`;
   33               FLUSH PRIVILEGES;
   34               quit
   35 
   36        # mysql -u root -p icinga_web < etc/schema/mysql.sql
   37 
   38 
   39 
   40 ### PostgreSQL
   41 
   42        #> su - postgres
   43 
   44        $ psql
   45 
   46        postgres=#  CREATE USER icinga_web WITH PASSWORD 'icinga_web';
   47        postgres=#  CREATE DATABASE icinga_web;
   48        postgres=#  \q
   49 
   50 
   51 Add the `icinga_web` user to trusted authentication in the `pg_hba.conf` configuration
   52 file and restart the PostgreSQL server.
   53 
   54        local   icinga_web      icinga_web                            trust
   55        host    icinga_web      icinga_web      127.0.0.1/32          trust
   56        host    icinga_web      icinga_web      ::1/128               trust
   57 
   58 Install the schema
   59 
   60        $ psql -U icinga_web -d icinga_web -a -f etc/schema/pgsql.sql
   61 
   62 ## Building Release Tarballs
   63 
   64 In order to build a release tarball you should first check out the Git repository
   65 in a new directory. If you're using an existing check-out you should make sure
   66 that there are no local modifications:
   67 
   68 $ git status
   69 
   70 Here's a short check-list for releases:
   71 
   72 * Update `etc/make/version.m4` and run `autoconf` generating a new version and date.
   73 * Update the .mailmap and AUTHORS files
   74     $ git log --use-mailmap | grep ^Author: | cut -f2- -d' ' | sort | uniq > doc/AUTHORS
   75 * Bump the version in icinga-web.spec.
   76 * Update the doc/CHANGELOG-$majorversion file.
   77 * Commit these changes to the "support/$majorversion" branch and create a signed tag (tags/v<VERSION>).
   78     $ git commit -v -a -m "Release version <VERSION>"
   79     $ git tag -u <yourid> -m "Version <VERSION>" v<VERSION>
   80     $ git push --tags
   81 * Merge the "support/$majorversion" branch into the "master" branch (using --ff-only).
   82     $ git checkout master
   83     $ git merge --ff-only support/$majorversion
   84     $ git push origin master
   85 * Merge the "support/$majorversion" branch into the "next" branch
   86 
   87 Use "git archive" to build the release tarball:
   88 
   89 $ VERSION=1.13.0
   90 $ git archive --format=tar --prefix=icinga-web-$VERSION/ tags/v$VERSION | gzip >icinga-web-$VERSION.tar.gz
   91 $ md5sum icinga-web-$VERSION.tar.gz > icinga-web-$VERSION.tar.gz.md5
   92 
   93 Finally you should verify that the tarball only contains the files it should contain:
   94 
   95 $ VERSION=1.13.0
   96 $ tar ztf icinga-web-$VERSION.tar.gz | less