Changes between Initial Version and Version 1 of HaCiInstall


Ignore:
Timestamp:
Oct 31, 2009, 4:12:24 AM (12 years ago)
Author:
larsux
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • HaCiInstall

    v1 v1  
     1= Install =
     2== Overview ==
     3  !HaCi is a web frontend for administrating Networks. It consist of a (perl) CGI and a (mySQL) Database as backend.
     4
     5== Requirements ==
     6  All you need is a Webserver (e.g.: Apache), a Database (e.g.: mySQL) and an OS which supports perl.
     7
     8  - Perl    (check with "{{{$ perl -M<MODULE> -e 1 2>/dev/null && echo 'Ok' || echo 'Failed'}}}")
     9    - CGI
     10    - CGI::Session
     11    - CGI::Cookie
     12    - CGI::Ajax
     13    - Math::!BigInt v1.87
     14    - Math::BigInt::GMP (optional, but proposed for more performance!)
     15    - Template
     16    - Class::!MakeMethods
     17    - Net::IPv6Addr
     18    - Cache::Cache
     19    - Digest::SHA
     20    - Locale::gettext
     21    - Time::Local
     22    - Net::SNMP
     23    - Net::DNS
     24    - Log::!LogLite
     25    - Net::Ping::External
     26    - Socket6
     27    - IO::Socket::INET6
     28    - DNS::!ZoneParse
     29    - DBD::mysql
     30    - Config::General
     31    - Net::CIDR
     32    - Text::CSV_XS (optional for importing CSV-Files)
     33  - HTTP Server
     34  - SQL Database
     35
     36  You can use the Script '{{{bin/checkPerlDependencies.sh}}}' to check for Dependencies.
     37
     38== Installation ==
     391)
     40 First, extract the Archiv into a Directory, from which the HTTP Server will process it and check Dependencies.
     412)
     42 If needed, accommodate the File/Directory Permissions, so the HTTP Server will have no problems.
     43  <installDir>/logs   : HTTPServer (rwx)[[BR]]
     44  <installDir>/spool  : HTTPServer (rwx)
     453)
     46 Modify the !HaCi.conf.sample (<installDir>/etc) for your needs.
     47 It can be stored either in '/etc/HaCi.conf' or '<installDir>/etc/HaCi.conf'.
     48 '/etc/HaCi.conf' has precedence.
     494)
     50 Configure your Database and Webserver, for serving your new Tool.
     51 e.g.:
     52  - mySQL
     53{{{
     54USE mysql;
     55
     56REPLACE INTO user (host, user, password)
     57  VALUES (
     58    'localhost',
     59    'HaCi',
     60-- IMPORTANT: Change this password!
     61    PASSWORD('geheim!')
     62);
     63
     64REPLACE INTO db (host, db, user, select_priv, insert_priv, update_priv, delete_priv, create_priv, drop_priv, index_priv, Alter_priv, Create_tmp_table_priv, Lock_tables_priv)
     65  VALUES (
     66    'localhost',
     67    'HaCi%',
     68    'HaCi',
     69    'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y'
     70);
     71FLUSH PRIVILEGES;
     72CREATE DATABASE HaCi;
     73}}}
     74  - Apache  (httpd.conf)
     75{{{
     76<VirtualHost *:80>
     77  ServerName  haci.domain.tld
     78  DocumentRoot  /var/www/HaCi/html
     79  ScriptAlias   /cgi-bin/  /var/www/HaCi/cgi-bin/
     80
     81  <Directory /var/www/HaCi/cgi-bin>
     82    # If you want to use Mod-Perl ---
     83    PerlRequire   /var/www/HaCi/etc/startup.pl
     84    SetHandler    perl-script
     85    # PerlHandler   Apache::Registry       # mod-perl1
     86    PerlResponseHandler ModPerl::Registry  # mod-perl2
     87    #--------------------------------
     88    Options       +ExecCGI
     89  </Directory>
     90</VirtualHost>
     91}}}
     92  - lighttpd
     93   - standalone (/etc/lighttpd/lighttpd.conf):
     94{{{
     95server.document-root  = "/var/www/HaCi/html"
     96server.errorlog    = "/var/www/HaCi/logs/error.log"
     97alias.url    += ("/cgi-bin/" => "/var/www/HaCi/cgi-bin/")
     98}}}
     99   - VHost (/etc/lighttpd/conf-available/20-!HaCi.conf):
     100{{{
     101server.modules                 += ( "mod_simple_vhost" )
     102simple-vhost.server-root        = "/var/www"
     103simple-vhost.document-root      = "/html/"
     104simple-vhost.default-host       = "HaCi"
     105alias.url                      += ( "/cgi-bin/" => "/var/www/HaCi/cgi-bin/" )
     106}}}
     107
     108   - activate CGI
     109    - Debian:
     110{{{
     111$ ln -s /etc/lighttpd/conf-available/10-cgi.conf /etc/lighttpd/conf-enabled/
     112}}}
     113     Edit '/etc/lighttpd/conf-available/10-cgi.conf' and comment the alias-Line out:
     114{{{
     115# alias.url       += ( "/cgi-bin/" => "/usr/lib/cgi-bin/" )
     116}}}
     117
     118    - SuSE:[[BR]]
     119     Edit '/etc/lighttpd/modules.conf' and enable following line:
     120{{{
     121include "conf.d/cgi.conf"
     122}}}
     123 5)
     124  !HaCi Daemon (bin/HaCid.pl)[[BR]]
     125  The !HaCi Daemon is responsible for the recurrent Plugins. It runs them in defined intervals.[[BR]]
     126  You can start it with the Parameter '-c' therewith it exists after one full run and you can start it by Crontab.[[BR]]
     127  The Daemon stores its PID in 'spool' and writes its Logfile in 'logs'. So it must have write Permissions to this directories.
     128 6)
     129  For exporting the last CVS Version call
     130{{{
     131$ cvs -z3 -d:pserver:anonymous@haci.cvs.sourceforge.net:/cvsroot/haci export -D NOW HaCi
     132}}}
     133 7)
     134  FINISHED