Difference between revisions of "OCS Inventory Tools"

From SME Server
Jump to navigationJump to search
m (Replaced Template:drawBox* (deprecated) with Template:* box)
(RPM updated. Added new features and cleaned obsolete ones)
Line 1: Line 1:
 
{{Languages|OCS_Reports_and_GLPI}}
 
{{Languages|OCS_Reports_and_GLPI}}
=Credits=
 
This work is based on Daniel's [http://sme.firewall-services.com/spip.php?article42 howto] from [http://sme.firewall-services.com/ smefirewall-services.com]
 
 
It's also based on DLAoctet's old [http://www.dlaoctet.com/index.php/2006/10/12/17-installer-ocs-next-generation-inventory-et-glpi howto]
 
 
Thanks to both of you!
 
  
 
=Maintainer=
 
=Maintainer=
Line 11: Line 5:
 
mailto:sylvaingomez@free.fr
 
mailto:sylvaingomez@free.fr
  
=OCS Inventory Next Generation 1.01 for SME 7.x=
+
Special thanks to [http://remi.collet.free.fr/ Rémi Collet] who provided a working OCS Unified Agent Linux (and so much more!)
 +
 
 +
=Inventory tools for SME 7.x=
  
 
==OCS Inventory NG Description==
 
==OCS Inventory NG Description==
Line 18: Line 14:
 
Used with a IT and Asset Management Software such as open source tool GLPI, you will have a powerfull inventory and asset management software with automatic updates of computer configuration, license management, help desk and more.
 
Used with a IT and Asset Management Software such as open source tool GLPI, you will have a powerfull inventory and asset management software with automatic updates of computer configuration, license management, help desk and more.
  
For more information see ''http://www.ocsinventory-ng.org//''.
+
For more information see ''http://www.ocsinventory-ng.org/''.
 +
 
 +
==GLPI Description==
 +
GLPI is the Information Resource-Manager with an additional Administration- Interface. You can use it to build up a database with an inventory for your company (computer, software, printers...). It has enhanced functions to make the daily life for the administrators easier, like a job-tracking-system with mail-notification and methods to build a database with basic information about your network-topology.
 +
 
 +
For more information see ''http://www.glpi-project.org/''.
 +
 
 +
=Download=
 +
You can download this package ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/smeserver-inventory-tools-1-1.i386.rpm  here]''. You will also need ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz a few dependencies]''.
 +
If you want to save it directly on your SME Server, you can give these commands at the prompt:
 +
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz
 +
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/smeserver-inventory-tools-1-1.i386.rpm
  
==Download==
+
=Installation=
You can download this package ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/ocsreports/smeserver-ocs_inventory_ng-1.01-4.noarch.rpm  here]''. You will also need ''[http://sme.firewall-services.com/downloads/ocs/rpms/perl-deps-ocs.tar.gz a few dependencies]''.
+
First, you need to install a few dependencies.
If you would like to save it directly on your SME Server, you should give this command at a linux-prompt
 
wget http://sme.firewall-services.com/downloads/ocs/rpms/perl-deps-ocs.tar.gz
 
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/ocsreports/smeserver-ocs_inventory_ng-1.01-4.noarch.rpm
 
  
==Installation and Uninstall==
+
According to your SME version, you may also need to install mod_perl
For installation, you first need to install dependencies: just hit the following commands
 
 
  yum install mod_perl
 
  yum install mod_perl
  tar xvzf ./perl-deps-ocs.tar.gz
+
Other Perl dependencies have been packaged in one file for easy downloading. Simply uncompress the tarball and install RPMs using yum:
  yum localinstall ./perl-deps-ocs/*.rpm
+
  tar -xzf ./ocs_perl_deps.tar.gz
Then you can install OCS with the following command
+
  yum install ./ocs_perl_deps/*.rpm
  yum localinstall *.rpm
+
Finally, you can install OCS Reports and GLPI with the following command:
For uninstall just hit the following command
+
  yum install smeserver-inventory-tools-1-1.i386.rpm
yum remove smeserver-ocs_inventory_ng
+
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.
You should also uninstall all dependencies...
 
  
 +
=Update=
 +
Update from old RPMs (''smeserver-ocs_inventory_ng'' and ''smeserver-glpi'') is not possible.
 +
 +
'''You must uninstall both RPMs first!'''
 +
 +
If you want to keep your datas, you need to uninstall old versions with following commnands:
 +
rpm -e smeserver-glpi --noscripts
 +
rpm -e smeserver-ocs_inventory_ng --noscripts
 +
And then install the new version with
 +
yum install smeserver-inventory-tools-1-1.i386.rpm
 +
 +
=Uninstallation=
 +
To uninstall OCS Reports and GLPI, just hit the following command:
 +
yum remove smeserver-inventory-tools
 
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.
 
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.
  
==Use==
+
To completly remove OCS Reports and GLPI (installation files ; MySQL user+database ; OCS Agent) you will need the following command:
 +
sh /root/OCS_GLPI-Full-Uninstall.sh
 +
You should also uninstall all dependencies if you don't need them anymore...
 +
 
 +
=Use=
 +
 
 +
==OCS Inventory NG==
 
OCS Reports' web interface can be reached at http://your-server/ocs
 
OCS Reports' web interface can be reached at http://your-server/ocs
  
Before to login, please choose your language (flags on the top right corner)
+
'''Before to login, please choose your language (flags on the top right corner)'''
  
 
Login  : admin
 
Login  : admin
Line 48: Line 70:
 
Password: admin
 
Password: admin
 
{{Warning box|For security-reasons, change admin's password after your first login!}}
 
{{Warning box|For security-reasons, change admin's password after your first login!}}
 +
Inventories can be done from WAN but the web interface is only available from inside your network for security reasons by default.
 
The client side is available [http://www.ocsinventory-ng.org/index.php?page=1-01 on all platforms]. Download the latest client version according to your OS.
 
The client side is available [http://www.ocsinventory-ng.org/index.php?page=1-01 on all platforms]. Download the latest client version according to your OS.
 
After installing the Agent, you should launch it manually to upload your first inventory (as it's updated once per day by default)
 
After installing the Agent, you should launch it manually to upload your first inventory (as it's updated once per day by default)
  
Under Windows, this can be done by typing the following in the 'execute box':
+
==OCS Agent Linux for SME 7.x==
"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:your_tag
+
The client-side of OCS will already be installed if you install ''smeserver-inventory-tools''.
Wait a few seconds and go to http://your-server/ocs, you should see your first inventory!
 
  
Inventories can be done from WAN but the web interface is only available from inside your network for security reasons.
+
You should see an inventory of your SME Server in OCS web interface after the RPM install.
  
=GLPI 0.68.3 for SME 7.x=
+
If you want to inventory other SME Servers (without installing the server-side and web interfaces), you only need following packages in the dependencies tarball:
 +
*monitor-edid-1.11-1.el4.remi.i386.rpm
 +
*ocsinventory-agent-0.0.6-1.el4.remi.noarch.rpm
 +
*ocsinventory-ipdiscover-1.01-2.el4.remi.i386.rpm
 +
Then edit ''/etc/ocsinventory-agent/ocsinv.conf'' and modify following lines:
 +
OCSSERVER=yourdomain.com
 +
OCSTAG=your_tag
 +
Then restart crond as this isn't done by these RPMs:
 +
/etc/rc.d/init.d/crond restart
 +
And finally launch the 1st inventory manually:
 +
ocsinventory-agent -s yourdomain.com -t your_tag
  
==GLPI Description==
+
==OCS Agent for Windows==
GLPI is the Information Resource-Manager with an additional Administration- Interface. You can use it to build up a database with an inventory for your company (computer, software, printers...). It has enhanced functions to make the daily life for the administrators easier, like a job-tracking-system with mail-notification and methods to build a database with basic information about your network-topology.
+
Under Windows, once the Agent is installed, you can make inventories by typing the following in the 'execute box':
 
+
"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:your_tag
For more information see ''http://www.glpi-project.org/''.
+
Wait a few seconds and go to http://your-server/ocs, you should see your computer's inventory!
 
 
==Download==
 
You can download this package ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/glpi/smeserver-glpi-0.68.3-3.noarch.rpm  here]''.
 
If you would like to save it directly on your SME Server, you should give this command at a linux-prompt
 
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/glpi/smeserver-glpi-0.68.3-3.noarch.rpm
 
 
 
==Installation and Uninstall==
 
For installation just hit the following command
 
yum localinstall *.rpm
 
For uninstall just hit the following command
 
yum remove smeserver-glpi
 
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.
 
  
GLPI will not install if OCS rpm is not installed for dependency reasons.
+
==GLPI==
You can install GLPI without OCS. Just skip OCS install (and its dependencies) and hit the following command:
 
rpm -Uvh smeserver-glpi-0.68.3-3.noarch.rpm --nodeps
 
 
 
==Use==
 
 
GLPI's web interface can be reached at http://your-server/glpi
 
GLPI's web interface can be reached at http://your-server/glpi
  
Line 87: Line 103:
 
Password: glpi
 
Password: glpi
 
{{Warning box|For security-reasons, change admin's password after your first login!}}
 
{{Warning box|For security-reasons, change admin's password after your first login!}}
GLPI's web interface is only available from inside your network for security reasons.
+
GLPI's web interface is only available from inside your network for security reasons by default.
  
 
=Special commands=
 
=Special commands=
To view OCS and GLPI's passwords, you can type the following at a Linux prompt:
+
To view OCS and GLPI's configuration, you can type the following at the prompt:
 
  config show ocs
 
  config show ocs
 
  config show glpi
 
  config show glpi
To change MySQL passwords, you can type the following at a Linux prompt:
+
You can change a few parameters:
  config setprop ocs DbPassword my_new_password
+
    DB parameter  |    Options  | Default | Explanation
  config setprop glpi DbPassword "my new password"
+
  # HTTPS          | on/off      | on      | enable/disable https mode
Then you should apply modifications by typing the following at a Linux prompt:
+
  # PublicAccess    | local/global | local  | Accessibility of web interface
  signal-event ocs-update
+
# InventoryAccess | local/global | global  | Accessibility of OCS Server (to receive inventories)
signal-event glpi-update
+
# InventoryDelay  | >1          | 600    | Time to wait (sec) to avoid server overload (Agent cron)
You could also apply DbPassword modifications by typing the following at a Linux prompt (but why would you?)
+
 
signal-event post-upgrade
+
After any change to OCS or GLPI configuration, you should apply modifications by typing the following at the prompt:
signal-event reboot
+
  signal-event ocsglpi-update
'''Please remember that GLPI has OCS' DbPassword written in its MySQL database, so if you change OCS' DbPassword you will need to update GLPI with the appropriate signal-event command!'''
+
It will expand and restart needed templates and services in one command!
 +
 
 
=Additional information=
 
=Additional information=
 
*[http://www.ocsinventory-ng.org/ OCS website]
 
*[http://www.ocsinventory-ng.org/ OCS website]
Line 108: Line 125:
 
*[http://www.ocsinventory-ng.org/index.php?page=1-01 OCS download section]
 
*[http://www.ocsinventory-ng.org/index.php?page=1-01 OCS download section]
 
*[http://forums.ocsinventory-ng.org/ OCS forums ]
 
*[http://forums.ocsinventory-ng.org/ OCS forums ]
 +
*[http://remi.collet.free.fr/rpms/ Rémi Collet's RPMs repo]
  
 
+
Initial howtos:
 +
*[http://sme.firewall-services.com/spip.php?article42 Howto]
 +
*[http://www.dlaoctet.com/index.php/2006/10/12/17-installer-ocs-next-generation-inventory-et-glpi Old version howto]
  
 
''Sylvain Gomez (Cool34000)''
 
''Sylvain Gomez (Cool34000)''
  
 
----
 
----
[[Category: Howto]]
+
[[Category: Contrib]]

Revision as of 12:25, 3 November 2007


Maintainer

Sylvain Gomez
mailto:sylvaingomez@free.fr

Special thanks to Rémi Collet who provided a working OCS Unified Agent Linux (and so much more!)

Inventory tools for SME 7.x

OCS Inventory NG Description

Open Computer and Software Inventory Next Generation is an application designed to help a network or system administrator keep track of the computers configuration and software that are installed on the network. Information about Hardware and Operating System are collected. Used with a IT and Asset Management Software such as open source tool GLPI, you will have a powerfull inventory and asset management software with automatic updates of computer configuration, license management, help desk and more.

For more information see http://www.ocsinventory-ng.org/.

GLPI Description

GLPI is the Information Resource-Manager with an additional Administration- Interface. You can use it to build up a database with an inventory for your company (computer, software, printers...). It has enhanced functions to make the daily life for the administrators easier, like a job-tracking-system with mail-notification and methods to build a database with basic information about your network-topology.

For more information see http://www.glpi-project.org/.

Download

You can download this package here. You will also need a few dependencies. If you want to save it directly on your SME Server, you can give these commands at the prompt:

wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/smeserver-inventory-tools-1-1.i386.rpm

Installation

First, you need to install a few dependencies.

According to your SME version, you may also need to install mod_perl

yum install mod_perl

Other Perl dependencies have been packaged in one file for easy downloading. Simply uncompress the tarball and install RPMs using yum:

tar -xzf ./ocs_perl_deps.tar.gz
yum install ./ocs_perl_deps/*.rpm

Finally, you can install OCS Reports and GLPI with the following command:

yum install smeserver-inventory-tools-1-1.i386.rpm

You can ignore the yum-comments signal event post-upgrade and signal-event reboot.

Update

Update from old RPMs (smeserver-ocs_inventory_ng and smeserver-glpi) is not possible.

You must uninstall both RPMs first!

If you want to keep your datas, you need to uninstall old versions with following commnands:

rpm -e smeserver-glpi --noscripts
rpm -e smeserver-ocs_inventory_ng --noscripts

And then install the new version with

yum install smeserver-inventory-tools-1-1.i386.rpm

Uninstallation

To uninstall OCS Reports and GLPI, just hit the following command:

yum remove smeserver-inventory-tools

You can ignore the yum-comments signal event post-upgrade and signal-event reboot.

To completly remove OCS Reports and GLPI (installation files ; MySQL user+database ; OCS Agent) you will need the following command:

sh /root/OCS_GLPI-Full-Uninstall.sh

You should also uninstall all dependencies if you don't need them anymore...

Use

OCS Inventory NG

OCS Reports' web interface can be reached at http://your-server/ocs

Before to login, please choose your language (flags on the top right corner)

Login : admin

Password: admin

Warning.png Warning:
For security-reasons, change admin's password after your first login!


Inventories can be done from WAN but the web interface is only available from inside your network for security reasons by default. The client side is available on all platforms. Download the latest client version according to your OS. After installing the Agent, you should launch it manually to upload your first inventory (as it's updated once per day by default)

OCS Agent Linux for SME 7.x

The client-side of OCS will already be installed if you install smeserver-inventory-tools.

You should see an inventory of your SME Server in OCS web interface after the RPM install.

If you want to inventory other SME Servers (without installing the server-side and web interfaces), you only need following packages in the dependencies tarball:

  • monitor-edid-1.11-1.el4.remi.i386.rpm
  • ocsinventory-agent-0.0.6-1.el4.remi.noarch.rpm
  • ocsinventory-ipdiscover-1.01-2.el4.remi.i386.rpm

Then edit /etc/ocsinventory-agent/ocsinv.conf and modify following lines:

OCSSERVER=yourdomain.com
OCSTAG=your_tag

Then restart crond as this isn't done by these RPMs:

/etc/rc.d/init.d/crond restart

And finally launch the 1st inventory manually:

ocsinventory-agent -s yourdomain.com -t your_tag

OCS Agent for Windows

Under Windows, once the Agent is installed, you can make inventories by typing the following in the 'execute box':

"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:your_tag

Wait a few seconds and go to http://your-server/ocs, you should see your computer's inventory!

GLPI

GLPI's web interface can be reached at http://your-server/glpi

Login : glpi

Password: glpi

Warning.png Warning:
For security-reasons, change admin's password after your first login!


GLPI's web interface is only available from inside your network for security reasons by default.

Special commands

To view OCS and GLPI's configuration, you can type the following at the prompt:

config show ocs
config show glpi

You can change a few parameters:

   DB parameter   |    Options   | Default | Explanation
# HTTPS           | on/off       | on      | enable/disable https mode
# PublicAccess    | local/global | local   | Accessibility of web interface
# InventoryAccess | local/global | global  | Accessibility of OCS Server (to receive inventories)
# InventoryDelay  | >1           | 600     | Time to wait (sec) to avoid server overload (Agent cron)

After any change to OCS or GLPI configuration, you should apply modifications by typing the following at the prompt:

signal-event ocsglpi-update

It will expand and restart needed templates and services in one command!

Additional information

Initial howtos:

Sylvain Gomez (Cool34000)