Changes

Jump to navigation Jump to search
3,037 bytes added ,  21:07, 17 April 2021
no edit summary
Line 1: Line 1:  
{{Languages|OCS Inventory Tools}}
 
{{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=
   −
=Maintainer=
+
'''Unmaintained'''
 +
formerly maintained by :
 
[[User:Cool34000|Sylvain Gomez]]<br/>
 
[[User:Cool34000|Sylvain Gomez]]<br/>
 
mailto:sylvaingomez@free.fr
 
mailto:sylvaingomez@free.fr
Line 7: Line 11:  
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!
Line 15: Line 19:  
==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.
Information about Hardware and Operating System are collected.
+
 
 +
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.
   Line 27: Line 35:  
=Server Installation=
 
=Server Installation=
 
==Download==
 
==Download==
You can download this package ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/smeserver-inventory-tools-1-6.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]''.
+
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
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/smeserver-inventory-tools-1-6.i386.rpm
      
==Install==
 
==Install==
Line 43: Line 50:  
  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 localinstall smeserver-inventory-tools-1-6.i386.rpm
+
  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==
Line 59: Line 71:  
  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-6.i386.rpm
+
  yum install smeserver-inventory-tools --enablerepo=smecontribs
    
=== New RPM version===
 
=== New RPM version===
Line 65: Line 77:     
Use YUM to update:
 
Use YUM to update:
  yum localinstall smeserver-inventory-tools-1-'''x'''.i386.rpm
+
  yum update smeserver-inventory-tools --enablerepo=smecontribs
Where'' "'''x'''" ''is the new version number
+
 
 +
==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==
Line 111: Line 143:     
See Section 4.1 in the internal OCS help file.
 
See Section 4.1 in the internal OCS help file.
===OcsAgentSetup.exe===
+
===Service use===
 
Using OCS as a service is what you will probably need.
 
Using OCS as a service is what you will probably need.
   Line 126: Line 158:  
----
 
----
 
For troubleshooting, look at the log file in ''C:\Program Files\OCS Inventory Agent\COMPUTER_NAME.log''
 
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)
   −
===ocsagent.exe===
+
Of course, ''ocsagent.exe'' must be uncompressed before launching the standalone executable.
'''Since version 1-6, this file is no more included directly in the RPM to save bandwidth.'''
     −
This file only contains files needed by the standalone executable ''OcsLogon.exe''. Files will uncompress in '''''c:\ocs-ng\'''''
+
This can be done by executing directly ''ocsagent.exe'': files will uncompress in ''c:\ocs-ng''.
   −
There are different ways of using this file...
+
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].
====Manual launch====
  −
This file can be manually launched on any computer to uncompress needed files.
     −
Procedure is pretty easy: double-clic on ''ocsagent.exe'' to uncompress files! ''ocsagent.exe'' will not be needed anymore (unless you delete ''C:\ocs-ng\'')
+
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
   −
Go the ''OcsLogon.exe'' section.
+
For troubleshooting, look at the log file in ''C:\ocs-ng\COMPUTER_NAME.log''
====MySQL importation====
+
----
The other method is to import this file in ocs' MySQL database so that the standalone executable can download it.
+
===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?
   −
The main advantage of this method is that you can then 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/'''''.
   −
1st thing you need is to copy this file in '''''/opt/inventory/ocs/ocsreports/files/'''''.
+
Installer is locked (install.php), you need to change perms with the following command:
{{Incomplete}}
+
chmod 660 /opt/inventory/ocs/ocsreports/dbconfig.inc.php
===OcsLogon.exe===
  −
This is the standalone executable. This is the alternate method of running ocs as a service.
     −
You must use one of the above method before using it.
+
Then, you can import this file in the database. Go to http://yourdomain.com/ocs/install.php
   −
The command line is the same as for the service:
+
Use the pre-configured account 'ocs' for that:
"C:\Path_to_file\OcsLogon.exe" /server:yourdomain.com /np /debug /tag:your_tag
+
[[Image:OCS-installphp.png]]<br>
For easier and faster inventorying, you can also rename this standalone executable to your domain name:
+
----
"C:\Path_to_file\yourdomain.com.exe" /np /debug /tag:your_tag
+
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>
 
----
 
----
For troubleshooting, look at the log file in ''C:\ocs-ng\COMPUTER_NAME.log''
+
''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==
For a RPM based distro use the above rpms. For others download the generic linux tar.gz,
+
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.
Line 172: Line 220:     
=OCS Inventory NG Usage=
 
=OCS Inventory NG Usage=
Full documentation can be found in the 6 mb [http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf guide.pdf].
+
Full documentation can be found in the ocs help file, the help icon in ocs interface.
   −
To save some bandwidth, this file is no more included since ''1-6 RPM version''. Please download this file separately and copy it in ''/opt/inventory/ocs/ocsreports/files/''. You can use the following code to download it:
  −
cd /opt/inventory/ocs/ocsreports/files/
  −
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf
  −
{{Note box|Until you put this file in the right place, the help icon in ocs interface will not work.}}
   
==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
Line 271: Line 315:  
for an overview see [http://www.ocsinventory-ng.org/index.php?page=package-deployment the ocs website]
 
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 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]
+
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>
 
----
 
----
Line 321: Line 365:     
=GLPI Usage=
 
=GLPI Usage=
{{Incomplete}}
   
==Access==
 
==Access==
 
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 330: Line 373:  
{{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''.
   −
==Sync GLPI with OCS==
+
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!
 +
 
 +
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.
Line 340: Line 400:  
----
 
----
   −
=Special commands=
+
==Advanced==
To view OCS and GLPI's configuration, you can type the following at the prompt:
+
===Sync GLPI with LDAP===
config show ocs
+
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]
config show glpi
+
{{Incomplete}}
You can change a few parameters:
+
===Sync GLPI with Active Directory===
    DB parameter  |    Options  | Default | Explanation
+
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]
# HTTPS          | on/off      | off    | enable/disable https mode
+
{{Incomplete}}
# PublicAccess    | local/global | local  | Accessibility of web interface
+
==Plugins==
# InventoryAccess | local/global | global  | Accessibility of OCS Server (to receive inventories)
+
[http://glpi-project.org/wiki/doku.php?id=en:plugins Related GLPI Wiki article]
# InventoryDelay  | >1          | 600    | Time to wait (sec) to avoid server overload (Agent cron)
+
{{Incomplete}}
 
  −
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=
 
=Additional information=
Line 365: Line 421:  
*[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]]
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu