Setup OCS Inventory 1.02.X – 1.3.X under Windows with d'Apache ...

Setup OCS Inventory 1.02.X – 1.3.X
under Windows with d'Apache 2.2 and
MySQL 5.1 already installed
This document explains how to setup OCS Inventory NG Server under Windows without
setting up XAMPP, but using existing Apache and MySQL installation.

Contents
1. Components to download ............................................................................................................... 3
2. Installing PERL .................................................................................................................................. 3
3. Installing PERL modules ................................................................................................................... 3
4. Installing mod_perl for Apache ....................................................................................................... 4
4.1. Downloading mod_perl ........................................................................................................... 4
4.2. Configuring Apache ................................................................................................................. 4
5. Installing OCS Inventory NG Server ................................................................................................. 5
5.1. Installing Communication Server PERL module ...................................................................... 5
5.2. Updating Apache configuration file (httpd.conf) .................................................................... 5
6. Installing Administration console and database ............................................................................. 6
6.1. Configuring MySQL .................................................................................................................. 6
6.2. Installing Administration console ............................................................................................ 6
6.3. Creating ocsweb database and initial configuration ............................................................... 6
7. Test OCS Inventory NG Server ......................................................................................................... 7

1. Components to download
We assume that Apache 2.2 and Mysql 5.1 are already installed.
Download and unpack the following packages:
OCS Inventory NG Server for Linux in folder (preferred
C:\Program Files\OCS Inventory NG)
OCS Inventory NG Agent for Windows in folder
ActivePerl (http://www.activestate.com)
NMake (http://support.microsoft.com/default.aspx?scid=kb;en-us;Q132084)
In this document, extract folder for files will be named
2. Installing PERL
Run ActivePerl setup, using default parameters (Must be installed in a path without space, or
this make many troubles for next steps).
Copy files nmake.err and nmake.exe in folder C:\Perl\bin
3. Installing PERL modules
Needed PERL module list is available in file README from folder
//README :
XML::Simple (2.12 or higher - Already installed)
Compress:Zlib (1.33 or higher - Already installed)
DBI (1.40 or higher - Already installed)
DBD::Mysql (2.9004 or higher)
Apache::DBI (0.93 or higher)
Net::IP
(1.21 or higher)
Some PERL module are already installed with ActivePerl. To view list of installed PERL
modules, run command ppm to open PERL package manager. By default, DBI, XML::Simple
and Compress::Zlib are already installed.
Ensure that module version are greater than the required once listed in README.
To setup the other modules, you just have to run the following command (need Internet
connection 1 ) :
ppm install (take care to the case).
For example :
ppm install DBD::Mysql
ppm install Apache::DBI
ppm install Net::IP
If you want to use SOAP web service, you must also install modules SOAP::Lite (0.66 or
higher), and XML::Entities (0.02 or higher).
1 If you are below a proxy, you must create an environnement variable called « HTTP_proxy » with var =
http:login:password@ip:port

4. Installing mod_perl for Apache
4.1. Downloading mod_perl
Just run (need Internet connection) depending of your Perl version :
Perl 5.8 :
ppm install http://theoryx5.uwinnipeg.ca/ppms/mod_perl.ppd
Perl 5.10 :
ppm repo add http://cpan.uwinnipeg.ca/PPMPackages/10xx/
ppm install mod_perl
Perl 5.12 :
ppm repo add http://cpan.uwinnipeg.ca/PPMPackages/12xx/
ppm install mod_perl
During the install process, you will be asked for Apache module folder, where to copy
mod_perl.so file (default is C:\Program Files\Apache Software
Foundation\Apache2.2\modules).
For more informations about mod_perl setup, refer to :
http://perl.apache.org/docs/2.0/os/win32/install.html#PPM_Packages
4.2. Configuring Apache
Edit Apache configuration file httpd.conf and add following lines depending of your Perl
version:
Perl 5.8 :
LoadFile "C:/Path/to/Perl/bin/perl58.dll"
LoadModule perl_module modules/mod_perl.so
Perl 5.10 :
LoadFile "C:/Path/to/Perl/bin/perl510.dll"
LoadModule perl_module modules/mod_perl.so
Perl 5.12 :
LoadFile " C:/Path/to/Perl/bin/perl512.dll "
LoadModule perl_module modules/mod_perl.so
Then restart Apache service.

5. Installing OCS Inventory NG Server
5.1. Installing Communication Server PERL module
Open a command prompt in folder
//Apache.
Read file INSTALL and then run the following commands :
perl MakeFile.PL
nmake
nmake install
5.2. Updating Apache configuration file (httpd.conf)
Copy the file

6. Installing Administration console and database
6.1. Configuring MySQL (optional)
Ensure that InnoDB database engine is enabled in MySQL configuration file : my.ini.
You must uncomment line skip innodb.
You must comment line sqlmode="STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"
to
permit correct OCS installation.
Then, restart MySQL service.
6.2. Installing Administration console
Copy folder //ocsreports to the document
root directory of your Apache web server.
6.3. Creating ocsweb database and initial configuration
If you specifiy UTF-8 for your MySQL, OCS installation hang on creating some table.
You must modify those two entries in OCSREPORTS\files\ ocsbase.sql:
Original
CREATE TABLE files (
NAME VARCHAR(255) NOT NULL,
VERSION VARCHAR(255) NOT NULL,
OS VARCHAR(255) NOT NULL,
CONTENT LONGBLOB NOT NULL,
PRIMARY KEY (NAME, OS, VERSION)
) ENGINE=MYISAM ;
Modified
CREATE TABLE files (
NAME VARCHAR(255) NOT NULL,
VERSION VARCHAR(255) NOT NULL,
OS VARCHAR(255) NOT NULL,
CONTENT LONGBLOB NOT NULL,
PRIMARY KEY (NAME, OS, VERSION)
) ENGINE=INNODB ;
CREATE TABLE tags (
Tag VARCHAR(255) NOT NULL default '',
Login VARCHAR(255) NOT NULL default '',
PRIMARY KEY (Tag,Login),
KEY Tag (Tag),
KEY Login (Login)
) ENGINE=MyISAM;
CREATE TABLE tags (
Tag VARCHAR(255) NOT NULL default '',
Login VARCHAR(255) NOT NULL default '',
PRIMARY KEY (Tag,Login),
KEY Tag (Tag),
KEY Login (Login)
) ENGINE=INNODB;
In your favorite web browser, open URL
http:///ocsreports/install.php to run OCS Inventory NG
setup process.
Then, update if asked file PHP_DIR\php.ini (openssl, file size and restart Apache
service).
Look for :
- post_max_size = 8M replace by post_max_size = 32M
- upload_max_filesize = 2M replace by upload_max_filesize = 32M
Follow instructions to create database and insert initial configuration into database.

7. Test OCS Inventory NG Server
In folder /, run ocsAgent.exe.
This command creates a folder C:\ocs-ng where OCS Inventory NG agent is installed.
Open a command prompt in this folder and run command
ocsinventory /server:127.0.0.1 /pnum: /debug
Check in Administration console that your computer has been added in inventory.
Setup is now finished and OCS Inventory NG Server may work without any problem.
8. Secure OCS Inventory NG Server
Please go to http://wiki.ocsinventory-ng.org/index.php/Documentation:Secure for securing
your OCS Inventory NG installation.

Originally written by Frédéric Prost (frederic.prost@laposte.net) 16/09/2006
Originally translated from French by par Didier Liroulet (ocsinventory@liroulet.net)
Updated for 1.2.x and 1.3.x by Thierry Barrau