[icinga-checkins] icinga.org: icinga-web/mhein/default: * Added a install file for the configure installation

git at icinga.org git at icinga.org
Thu Jan 14 15:09:13 CET 2010


Module: icinga-web
Branch: mhein/default
Commit: 8a0791b0df50fbf4fbe67469e320cbb125bca914
URL:    https://git.icinga.org/?p=icinga-web.git;a=commit;h=8a0791b0df50fbf4fbe67469e320cbb125bca914

Author: Marius Hein <marius.hein at netways.de>
Date:   Thu Jan 14 15:08:53 2010 +0100

* Added a install file for the configure installation

---

 doc/INSTALL |   95 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 95 insertions(+), 0 deletions(-)

diff --git a/doc/INSTALL b/doc/INSTALL
new file mode 100644
index 0000000..fbf180e
--- /dev/null
+++ b/doc/INSTALL
@@ -0,0 +1,95 @@
+
+THIS INSTALLATION DOCUMENT IS STILL EXPERIMENTAL,
+please report bugs to dev.icinga.org
+
+1) Prerequisits
+
+Based on the fact that you have a running mysql and php (with PEAR and CLI) environment. Also icinga and ido (ido2db)
+are running you can continue with the second step.
+
+2) The beautiful GNU install conglomerate
+
+The installation is based on autoconf and make now. If the existing configure script fails, try to recreate one
+with autoconf. On Debian/Ubuntu systems you'll need some packages like 'make' and 'autoconf'.
+
+	2.1 Creating a configure file
+		
+		Quite simple. If you have autoconf installed, type autoconf to invoke the GNU tool.
+		
+	2.2 Invoking configure
+	
+		The configure tool helps you to set some important parameter for the software. Also it creates
+		some config or build files for you.
+		
+		To determine which options are provided try 'sh configure --help' to see what's available
+		
+		After you have created your own build command you can fire up the whole thing like:
+		
+		sh configure \
+			--prefix=/usr/local/icinga-web \
+			--with-web-user=www-data \
+			--with-web-group=www-data \
+			--with-db-user=my_icinga_user \
+			--with-db-pass=XXXXX 
+		
+		If the command runs out without errors you have a ready configured icinga-web.
+		
+	2.3 The make command and its targets
+	
+		After the configuration step you can install icinga-web by invoking make.
+		
+		Type make to see what is possible.
+		
+		To install to the desired location type 'sudo make install' at you prompt. Be sure to use root
+		privileges to to this.
+		
+		Install also overwrites your existing directory and all containing configuration. To avoid 
+		data loss make backups or backup your configure command to match you needs.
+		
+		Also make can install and upgrade your new or existing database with the following targets:
+		
+		make db-initialize	- To create a spick-and-span database use this target
+		make db-drop 		- Drops your database with security query to safe you from casualties
+		make db-upgrade		- To upgrade old tables to the new version (Just the same as db-initialize
+							  only with a better name ;-))
+							  
+		To use the database creation commands you have to privilege the user which executes the commands
+		on your dbms. If the configure user differs from a highly privileged one, you can alter
+		'etc/build.properties' to match your requirements of a root user.
+		
+		Also you can read the install-fromscratch.txt to get deeper involved how to use the phing build
+		system for icinga-web
+
+3) Database
+
+	Section 2.3 or the install-fromscratch.txt file should give you enough information to do this.
+
+4) Webserver configuration
+
+	Three things have to done on system side: Apache have to be running with php5 support and mod_rewrite loaded.
+	
+	After that you should include the pub (htdocs) directory of icinga-web with an alias directive in global scope
+	(like apache.conf or there your icinga configuration lives):
+	
+		Alias /icinga-web /path/to/pub
+		<directory /path/to/pub>
+			AllowOverride All
+		</directory>
+		
+	The 'AllowOverride All' construct allows us to use a .htaccess configuration in the pub directory.
+	
+	Also, you should take a look to '/path/to/pub/.htaccess'. Mod_rewrite of Apache needs 'RewriteBase'
+	to operate in subdirectories. Please change this to your webpath (NOT THE PHYSICALLY ONE) .
+
+5) Running the interface and be glad
+
+	After a restart of apache you be able to run the interface in your browser.
+	
+	Use the URL your apache is configured to, e.g. like http://localhost/icinga-web.
+	
+	You can login with the following credentials:
+	
+		User: root
+		Pass: password
+		
+	Have fun!
\ No newline at end of file





More information about the icinga-checkins mailing list