3,250
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + + + + − =Maintainer=+ + Line 7:
Line 11: − + Line 15:
Line 19: − Information about Hardware and Operating System are collected.+ + + + + Line 27:
Line 35: − You can download this package ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/smeserver-inventory-tools-1-4.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]''.+ − wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/smeserver-inventory-tools-1-4.i386.rpm Line 43:
Line 50: − yum localinstall smeserver-inventory-tools-1-4.i386.rpm+ + + + + + Line 59:
Line 71: − + Line 65:
Line 77: − + − Where'' "'''x'''" ''is the new version number+ + + + + + + + + + + + + + + + + + + + + Line 108:
Line 140: − + + + + + − + + + + − + − Or just wait a day for the automatic update.+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − For a RPM based distro use the above rpms. For others download the generic linux tar.gz,+ − − The first inventory is launched during install.+ + + + + + + Line 214:
Line 312: − + + + + Line 225:
Line 326: − + + + + − + + Line 255:
Line 360: − + − + Line 268:
Line 373: + + + + + + + + + + + + + + − + + + + Line 278:
Line 400: − + − 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 | off | 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! Line 303:
Line 421: + + + − + +
no edit summary
{{Languages|OCS_Reports_and_GLPI}}
{{Languages|OCS Inventory Tools}}
{{Outdated}}
{{Warning box|This contribs is only available on SME7 and has not been updated since 2007. We ask you to rather use the upto date package on SME8 [[OCS_Inventory]]}}
=Maintainer=
'''Unmaintained'''
formerly maintained by :
[[User:Cool34000|Sylvain Gomez]]<br/>
[[User:Cool34000|Sylvain Gomez]]<br/>
mailto:sylvaingomez@free.fr
mailto:sylvaingomez@free.fr
Special thanks to [http://remi.collet.free.fr/ Rémi Collet] who provided a working OCS Unified Agent Linux (and so much more!)
Special thanks to [http://remi.collet.free.fr/ Rémi Collet] who provided a working OCS Unified Agent Linux (and so much more!)
Big thanks to Didier Liroulet and OCS team for this full documentated software (See '''''/opt/inventory/ocs/ocsreports/files/guide.pdf''''')
Big thanks to Didier Liroulet and OCS team for this full documented software (See '''''/opt/inventory/ocs/ocsreports/files/guide.pdf''''')
And last but not least, thanks to [[User:Snoble|Stefen Noble]] for testings, time spent and help provided!
And last but not least, thanks to [[User:Snoble|Stefen Noble]] for testings, time spent and help provided!
==OCS Inventory NG Description==
==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.
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.
It is also able to detect all active devices on your network, such as switch, router, network printer and unattended devices. For each one, it stores MAC and IP addresses and allows you to classify them.
Last, but not least, OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages (software setup, commands or only files to store on client computers) which will be downloaded through HTTP/HTTPS and launched by agent on client computer.
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.
=Server Installation=
=Server Installation=
==Download==
==Download==
You will 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:
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/dependencies/ocs_perl_deps.tar.gz
==Install==
==Install==
yum localinstall ./ocs_perl_deps/*.rpm
yum localinstall ./ocs_perl_deps/*.rpm
Finally, you can install OCS Reports and GLPI with the following command:
Finally, you can install OCS Reports and GLPI with the following command:
yum install smeserver-inventory-tools --enablerepo=smecontribs
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''.
To save some bandwidth, the help file was split from ''1-6+ RPM versions''. Please download this file separately and copy it in ''/opt/inventory/ocs/ocsreports/files/''. Until you put this file in the right place, the help icon in ocs interface will not work. (we may merge the help file back into the rpm later)
cd /opt/inventory/ocs/ocsreports/files/
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf
==Update==
==Update==
yum localinstall ./ocs_perl_deps/*remi*.rpm
yum localinstall ./ocs_perl_deps/*remi*.rpm
And then install the new version with
And then install the new version with
yum localinstall smeserver-inventory-tools-1-4.i386.rpm
yum install smeserver-inventory-tools --enablerepo=smecontribs
=== New RPM version===
=== New RPM version===
Use YUM to update:
Use YUM to update:
yum localinstall smeserver-inventory-tools-1-'''x'''.i386.rpm
yum update smeserver-inventory-tools --enablerepo=smecontribs
==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 | off | Enable/Disable forced https mode of web interfaces
# PublicAccess | local/global | local | Accessibility of web interfaces
# MaxUpload | xM | 100M | Max uploadable file size
# InventoryAccess | local/global | global | Accessibility of OCS Server (to receive inventories)
# InventoryDelay | >1 | 600 | Time to wait (sec) to avoid server overload (Agent cron)
# URL | new alias | | Optionnal aliases for ocs and glpi web interfaces
After any change to OCS or GLPI configuration, you should apply modifications by typing the following at the prompt:
signal-event domain-modify
It will expand and restart needed templates and services in one command!
example:
config setprop ocs HTTPS on PublicAccess global
config setprop glpi HTTPS on PublicAccess global
signal-event domain-modify
==Uninstallation==
==Uninstallation==
==OCS Agent for Windows==
==OCS Agent for Windows==
Download the latest client software, OCSNG_WIN32_AGENT_1.xx_repack.zip, this contains three alternatives, it is suggested you use OcsAgentSetup.exe. See Section 4.1 in the internal OCS help file.
There are 2 differents ways of sending inventories on Windows. Download the latest client software, OCSNG_WIN32_AGENT_1.xx_repack.zip from ocs website. This archive contains 3 executables.
See Section 4.1 in the internal OCS help file.
===Service use===
Using OCS as a service is what you will probably need.
Launch the first inventory by typing the following in the 'execute box':
Launch the install of ''OcsAgentSetup.exe'' and provide default settings of the service.
[[Image:OCS-winagent-setup.png]]<br>
----
Then launch the first inventory by typing the following in the 'execute box':
"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:your_tag
"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,
Wait a few seconds and go to http://your-server/ocs, you should see your computer's inventory.
By default, Agent will contact the Server once a day.
You can override this default behaviour in ocs web interface options. Your changes will be applied next time the Agent contacts the Server.
----
For troubleshooting, look at the log file in ''C:\Program Files\OCS Inventory Agent\COMPUTER_NAME.log''
===Standalone use===
You can also make inventories on Windows without installing the service.
OCS standalone client is cut into 2 executables:
*''ocsagent.exe'' - This file contains all needed files for the launcher
*''OcsLogon.exe'' - This file is the standalone executable (launcher)
Of course, ''ocsagent.exe'' must be uncompressed before launching the standalone executable.
This can be done by executing directly ''ocsagent.exe'': files will uncompress in ''c:\ocs-ng''.
You can also import this file into ocs' MySQL database so that the standalone executable can download it if needed. This is documented in [http://wiki.contribs.org/index.php?title=OCS_Inventory_Tools&action=submit#MySQL_importation section MySQL importation].
The command line is the same as for the service:
"C:\Path_to_file\OcsLogon.exe" /server:yourdomain.com /np /debug /tag:your_tag
For easier and faster inventorying, you can also rename this standalone executable to your domain name (don't forget ''.exe''):
"C:\Path_to_file\yourdomain.com'''.exe'''" /np /debug /tag:your_tag
For troubleshooting, look at the log file in ''C:\ocs-ng\COMPUTER_NAME.log''
----
===Importing ''ocsagent.exe'' in MySQL===
The main advantage of this method is that you can send the standalone executable by Internet very quickly or even put the standalone executable on a floppy disk as it's only 65KB! How powerful looks your old floppy disk drive now?
This also allows to update files archived in ''ocsagent.exe'' on your clients (can be service or standalone executable).
A [http://prdownloads.sourceforge.net/ocsinventory/OCSNG_PACKAGER_1.01.zip?download packager] is available at ocs website. This will allow you to repackage ''ocsagent.exe'' with your own modifications (i.e. an SSL certificate!)
[[Image:OCS-packager.png]]<br>
----
1st thing you need is to copy ''ocsagent.exe'' (modified or not) in '''''/opt/inventory/ocs/ocsreports/files/'''''.
Installer is locked (install.php), you need to change perms with the following command:
chmod 660 /opt/inventory/ocs/ocsreports/dbconfig.inc.php
Then, you can import this file in the database. Go to http://yourdomain.com/ocs/install.php
Use the pre-configured account 'ocs' for that:
[[Image:OCS-installphp.png]]<br>
----
If you get a warning message (cannot alter database), refresh the page and you should see a successful import.
[[Image:OCS-installphp-ocsagent.png]]<br>
----
''ocsagent.exe'' is now in the database!
{{Warning box|install.php has reset ocs password to 'ocs'. Re-apply your changes with following command:
signal-event domain-modify
This will also reset chmod to 440 on ''dbconfig.inc.php''
}}
You can now use ''OcsLogon.exe'' alone, it will download/update ''ocsagent.exe'' if needed!
If you want to remove ''ocsagent.exe'' from your database, simply delete the file from the server and redo install.php. This will delete the file from the database.
==OCS Agent for Linux==
==OCS Agent for Linux==
Download the generic linux tar.gz, unpack, read the README, and as root, run the setup script.
unpack, read the README, and as root, run the setup script.
You may required additional perl- packages, use you package management tools to search for the missing dependencies based on the README or the error messages. See Section 4.2 in the internal OCS help file.
You may required additional perl- packages, use you package management tools to search for the missing dependencies based on the README or the error messages. See Section 4.2 in the internal OCS help file.
To run an inventory
ocsinventory-client.pl -server=server.net -tag=network3
Check the time (will the PC be on) and command given in
/etc/cron.d/ocsinventory-client
=OCS Inventory NG Usage=
=OCS Inventory NG Usage=
Full documentation can be found in the ocs help file, the help icon in ocs interface.
==Access==
==Access==
OCS Reports' web interface can be reached at http://your-server/ocs
OCS Reports' web interface can be reached at http://your-server/ocs
'''Don't try to deploy other file type.'''
'''Don't try to deploy other file type.'''
There are many options to deploy packages, see section 8.3 of the help file.
There are many options to deploy packages,
for an overview see [http://www.ocsinventory-ng.org/index.php?page=package-deployment the ocs website]
for detail see section 8.3 of the help file,
for [http://alufis35.uv.es/OCS-Deployment-Tips-and-tricks.html Tips and tricks] see Pablo Iranzo's site
[[Image:OCS-buildpackage.png]]<br>
[[Image:OCS-buildpackage.png]]<br>
----
----
[[Image:OCS-activate-package1.png]]<br>
[[Image:OCS-activate-package1.png]]<br>
----
----
Provide paths to download folder. As this feature is LAN ONLY, provide internal names for both fields!
Provide paths to download folder. As this feature is LAN ONLY, provide internal name or IP address for both fields.
Be careful, this path will be resolved by the agent (value ''localhost'' forbidden here!)
[[Image:OCS-activate-package2.png]]<br>
[[Image:OCS-activate-package2.png]]<br>
----
----
Don't pay attention to the warning message when activating.
Don't pay attention to the warning messages when activating, Just click Yes.
[[Image:OCS-activate-package3.png]]<br>
[[Image:OCS-activate-package3.png]]<br>
----
----
You can also ignore any warning messages when deleting a package, the package is removed.
====Activated deployment packages====
====Activated deployment packages====
[[Image:OCS-deploy-single-pc3.png]]<br>
[[Image:OCS-deploy-single-pc3.png]]<br>
----
----
Next time the Agent will contact the server, the package should be deployed! As usual, you can manually launch the agent to force the update.
Next time the Agent contacts the server, it is notified of the package, and sometime later should be deployed! As usual, you can manually launch the agent to force the update.
See section 8. of the help file to understand how download works
See section 8.1 of the help file to understand how download works
=GLPI Usage=
=GLPI Usage=
{{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 by default.
GLPI's web interface is only available from inside your network for security reasons by default.
==Basics==
[http://glpi-project.org/wiki/doku.php?id=en:welcome GLPI Wiki]
[http://glpi-project.org/wiki/doku.php?id=en:begin What's next?]
{{Incomplete}}
===External authentication===
You can configure GLPI so that your SME users can login. For this, we will use SME integrated IMAP feature.
In GLPI interface, clic on ''Administration'' icon and open ''Setup'' menu. Then clic on ''External Authentications''.
Settings are on the screenshot:
[[Image:GLPI-imap-auth.png]]<br>
----
Apply your changes. SME users can now connect with their existing user+password into GLPI interface!
==Sync GLPI with OCS==
Logout and login with an existing SME account:
[[Image:GLPI-user-interface.png]]<br>
----
===Sync GLPI with OCS===
You can import OCS inventories into GLPI.
You can import OCS inventories into GLPI.
Simply clic on ''OCSNG'' in ''Tools'' menu.
Simply clic on ''OCSNG'' in ''Tools'' menu.
----
----
=Special commands=
==Advanced==
===Sync GLPI with LDAP===
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]
{{Incomplete}}
===Sync GLPI with Active Directory===
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]
{{Incomplete}}
==Plugins==
[http://glpi-project.org/wiki/doku.php?id=en:plugins Related GLPI Wiki article]
{{Incomplete}}
=Additional information=
=Additional information=
*[http://sme.firewall-services.com/spip.php?article42 Howto]
*[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]
*[http://www.dlaoctet.com/index.php/2006/10/12/17-installer-ocs-next-generation-inventory-et-glpi Old version howto]
''Stefen Noble (Snoble)''
''Sylvain Gomez (Cool34000)''
''Sylvain Gomez (Cool34000)''
----
----
[[Category: Contrib]]
[[Category: Deprecated Contrib]]
[[Category: Administration:Monitoring]]