From OCS Inventory NG
Jump to: navigation, search

OCS Inventory NG administrieren

Surfen Sie in Ihrem Browser auf die URL "http://administrations_server/ocsreports" und melden Sie sich an der Administrations-Konsole an: Standard Anmeldeinformationen sind "admin" als Login und "admin" als Passwort.

Sie sollten zuerst das Passwort des Default-Administrators ändern oder besser einen neuen hinzufügen und den standardmäßigen entfernen.

Hinweis: Alle diese Funktionen sind nur verfügbar für OCS Inventory NG-Administratoren.

OCS Inventory NG Administrationsserver: Benutzer verwalten.

DE menue benutzer.png Klicke on the toolbar “Benutzer” Menü to display all configured OCS Inventory NG-Administrationserver-Benutzer.


You can add neuen Benutzer by entering their Name, Passwort (der Benutzer will be able to change it when logged in), and selecting their Typ. Sie können wählen aus:

  • Administrator: Benutzer hat die Möglichkeit alle Parameter der Produkts zu konfigurieren.
  • Benutzer: Benutzer kann die Datenbank abfragen und Ergebnisse der Inventarisierung einsehen. Es sieht nur die obere linke Combo-Box der Menü-Symbolleiste, um allgemeine Abfragen zu erstellen.

Um einen Benutzer zu löschen muss man nur auf das "rote Kreuz" am Ende der entsprechenden Zeile klicken.

OCS Inventory NG general Optionen verwalten.

DE menue einstellungen.png Klick on the toolbar “Einstellungen” Menü to display all general Options.


Die Bedeutung jeder Option:

Konfigurationsoption Bedeutung
AUTO_DUPLICATE_LVL Choose what value you want to enable to detect double computers (renamed, reinstalled…). If you check multiple values, server will try to detect double comparing these values.
DEPLOY Activates oder not the automatic deployment of new agent release option.
DOWNLOAD Activates oder not package deployment feature. Turning off DOWNLOAD stop this functionnality on the Server AND on the Agents. With DOWNLOAD off, once Agents will have contacted OCS Server, they will stop current download WITHOUT cleaning packages.
DOWNLOAD_CYCLE_LATENCY Zeit in Sekunden to wait between each downalod cycle (siehe #§ 8.1 How does it work?)
DOWNLOAD_FRAG_LATENCY Zeit in Sekunden to wait between each fragment download (siehe #§ 8.1 How does it work?)
DOWNLOAD_PERIOD_LATENCY Zeit in Sekunden to wait between each download period (siehe #§ 8.1 How does it work?)
DOWNLOAD_PERIOD_LENGTH Anzahl of cycles per period (siehe #§ 8.1 How does it work?)
DOWNLOAD_TIMEOUT Validity in Tagen of a package on an Agent. If the Zeit used to download a package is over DOWNLOAD_TIMEOUT Tage, package will be cleaned und ERR_TIMEOUT will be sent to OCS-Server.
FREQUENCY Specify the frequency in Tagen of inventories.
INVENTORY_DIFF Enable oder not differential inventory to speed up the server. With differential inventory, only changes are stored by the Server, not full inventory.
INVENTORY_TRANSACTION Enable oder not transaction on Server. With transaction, an inventory is stored only if all data have been processed correctly.
IPDISCOVER Specify the number of Agent to ask running IP discovery feature for each gateway (Teil-Netzwerk). If you leave the default value 2, this mean that the Kommunikationserver will ask the 2 most active computers of each Teil-Netzwerk to run IP discovery feature. If you set it to 0, IP discovery will be disabled.
IPDISCOVER_LATENCY Zeit in Sekunden to wait between scan of each IP-Adresse. (siehe #§ 7.2 How does it work?)
IPDISCOVER_MAX_ALIVE Maximum number of days between two inventories for an IP Discovery enabled computer to hold his status of IP discovery computer. An IP discovery enabled computer will lose his status if it has not been seen by the Kommunikationserver for more days than the number of days defined in this setting. Another computer in the same Teil-Netzwerk will then be designated.
LOCAL_PORT IP-Port des OCS Inventory NG-Kommunikationservers.
LOCAL_SERVER IP-Adresse oder DNS-Name des OCS Inventory NG-Kommunikationservers.
LOGLEVEL Enable or not detailed log for Kommunikationserver. If enabled, server will write logs to file “ocsinventory-NG.log” in directory “/var/log/ocsinventory-NG” für Linux and “…\xampp\apache\logs” für Windows.
PROLOG_FREQ Number of hours between two run of the Agent (useful for the service). Therefore, the Agent will contact (not necessary send an inventory if inventory is not older than FREQUENCY days) ocs Server every PROLOG_FREQ hours.
REGISTRY Activates or not the registry query function (for Windows agent only).
TRACE_DELETED Activates or not tracking of deleted/renamed computers for integration with GLPI. Enable this feature only if you use integration with GLPI asset management Software.
UPDATE Not used, always set to OFF.

Click “Update” button when you set all changes.

Uploading Agent for deployement through launcher “OcsLogon.exe”.

Dies funktioniert nur für am Netzwerk angeschlossene Computer, die eine Verbindung zum Kommunikationsserver herstellen können.

OCS Inventory NG is able to automatically install agent on computers when launcher “OcsLogon.exe” is used through login script oder GPO. Agent’s files are downloaded from the Kommunikationsserver.

You just have to upload the agent package into the Administrationskonsole and to activate the deployment feature by setting “DEPLOY” general option to ON (see § 6.2 Managing OCS Inventory NG general options.).

Uploaded file must be one of the following:

  • “ocsagent.exe” file for Windows agent, to deploy Agent without Windows-Dienst. This file is included in package OCSNG_WIN32_AGENT_XX.zip.
  • “ocspackage.exe” file, created using OCS Inventory NG Packager, to deploy Windows service version of Agent, even if user connected does not have Administrator privileges.

To create “ocspackage.exe” file, just run OCS Inventory NG Packager, and fill in following informations:

  • Path to file “OcsAgentSetup.exe”, installer of OCS Inventory NG service Agent, included in package OCSNG_WIN32_AGENT_XX.zip.
  • Path to the Certificate file to use, for checking server certificate when using package deployement feature.
  • Optionally, another file to include in setup.
  • Command line parameters for running “OcsAgentSetup.exe” service installer, at least “/S” to run installer in silent mode, and “/SERVER:my_ocs_com_server_address” to specify “my_ocs_com_server” as address of OCS Inventory NG Kommunikationserver.
  • Username (account@domain for Active Directory account and domain\account for a NT4 account) and password of an Administrator account on client computers. “OcsAgentSetup.exe” will be run under this account on client computers, to allow installing service even if user connected does not have Administrator privileges.

Hinweis: Refer to OCS Inventory NG Packager documentation for more informations on how to use Packager.

“OcsAgentSetup.exe” supports the following Kommandozeilenschalter (und alle "Kommandozeilenschalter des Agenten":

  • /S Use quiet, silent installation
  • /SERVER:IP_ADRESSE Verwende folgende IP-Adresse des Kommunikationsservers: “IP_ADRESSE”
  • /PNUM:XX Verwende Port XX anstelle des Standard-HTTP-Ports 80.
  • /NP Nicht die Proxy-Einstellungen des Microsoft Internet Explorer verwenden
  • /DEBUG Produce a Logbuch-Datei of OCS Inventory NG-Agent execution. This mode is automatically used unter Windows to launch Agent as a service through an entry in registry key HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunServices.

This will create the file “ocspackage.exe” to upload into Administrationskonsole.

DE menue agent.png Klicke “Agent” toolbar Menü, browse your hard drive to select Agent file und klicke auf den “send”-Button.


Hinweis: If you encounter error while uploading Aagent, refer to common errors § 11.2.3 PHP Requested content-length.)

Using Registry Query feature.

OCS Inventory NG agent for Windows is able to query the registry of inventoried computers for a value of a key or for all values of a key under registry hives HKEY_CLASSES_ROOT, HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_CURRENT_CONFIG (and HKEY_DYN_DATA for Windows 9X based computers).

You have to enable this feature in the general settings “REGISTRY”.

DE-menue registry.png You can then define your registry query by clicking “Registry” toolbar menu.


Click “Add” button to add a new query. Enter a name for this query, beispielsweise MS Office XP if you want to retrieve MS Office XP registration number, select the registry hive (HKEY_LOCAL_MACHINE in this example), enter the registry key (SOFTWARE\Microsoft\Office\10.0\Registration\{9011040C-6000-11D3-8CFE-0050048383C9}) and the value name to query (ProductID) and validate. Put star (*) in field “Name of the key” to get all values of the key (This is useful to get all values of key “HKLM\Software\Microsoft\Windows\CurrentVersion\Run” to know which process are automatically started for example).


After that, each time a Windows client connects; it will retrieve and store all the values corresponding to these keys.

Doppelte Computer verwalten

OCS Inventory NG ist in der Lage einen umbenannten Computer, einen neu installierten Computer, ... zu erkennen

Generally, it will handle that alone. But sometimes, it is impossible for the Server to know whether two Computers are the same oder nicht, beispielsweise when it has no Netzwerkadapter (keine Mac-Adresse) oder when the Seriennummer was not properly set by the constructor (If you change a Computername, the application won’t be able to recognize it if it has no serial or no Mac-Adresse, and thus a duplicate fake Computer may be created).

DE menue doppelte computer.png This page accessible by clicking “Duplicates” toolbar Menü is used to solve this Problem.


You may choose the kind of comparison you want in the top right combo-box.

  • Redundancy summary – Shows the Anzahl of redundant Computers detected with each comparison method.
  • “Hostname + Serial number”, “Hostname + MAC-Adresse”, “MAC-Adresse + Seriennummer” - These are the two criteria comparison methods, the more reliable. It returns all computers that have two criteria in common.
  • “Hostname only”, “Serial only”, “Nur MAC-Adresse” - These are the one criterion comparison methods; it only shows alle Computers that shares one Parameter.

Once Computers are shown, it’s up to you to check whether several Computers are redundant oder nicht.


After that, you only have to select (checkbox) Computers that look the same, and click “merge redundant Computers”: all the data from checked Computers will be merged.

The administrative data of the oldest Computer are kept on the merged device.

Hinweis: When those filters are applied, some values are filtered out (Beispielsweise: 'NNNNNNN' oder 'xxxxxxxxxxx' für die Seriennummer).

Administrative informationen bearbeiten

OCS Inventory NG allows you to store custom information for each inventoried computers. Zum Beispiel, you can add administrative information to specify the owner of the computer, or the location of the computer.

This administrative information is stored both on the server and on the client to avoid any loss of data.

Zum Beispiel, if the database is lost, all clients will come back with their administrative information.

Menue AdminInfo.png You can define the administrative information you want for each computer by clicking “Admininfo” toolbar menu.


You can add new administrative information definition by entering their name (space or special characters are not allowed) and selecting their type. You can choose type between:

  • Text (Max. 255 Zeichen)
  • Integer
  • Real
  • Datum

To delete an administrative information definition, klicken Sie auf das Symbol mit dem roten Kreuz am Ende der entsprechenden Zeile.

Zum Beispiel, we will add administrative Information corresponding to the buy date of Computer.


You can now browse all your Computers to set the buy date for each.

Beschriftung (Label) für TAG-Abfrage bearbeiten

Wenn die “DEPLOY”-Option aktiviert ist, erhalten Clients die “Beschriftungs”-Datei. Der Text wird beim ersten Ausführen des Agenten auf dem Client angezeigt und soll dem Benutzer dazu auffordern einen bestimmten Wert (Text) in das TAG-Eingabefeld einzugeben.

Dieser “TAG”-Wert kann verwendet werden um Computer zu klassifizieren. Er kann beispielsweise eine Inventarnummer, die Bezeichnung für eine Abteilung ihrer Firma oder eine Raumnummer sein.

Menue Label.png Diese “Beschriftungs”-Datei wird während der Serverinstallation angelegt und kann über das “Label”-Menü bearbeitet werden.

DE Label bearbeiten.png

Wenn eine Leere beschriftung gespeichert wird, wird die Beschriftungsdatei auf dem server gelöscht. Auf den Clients wird kein Eingabefenster mehr angezeigt.

Importing inventory for non Netzwerk connected Computers.

With Administration server through your Webbrowser

For non Netzwerk connected computers, you can import inventory results from a file created on the Computer by the Agent run in local mode (see § 3.2 We have chosen to package OCS inventory NG Server for Windows as an integrated package containing all required components. As is, the 3 main components of Managementserver (Datenbankserver, Web-Kommunikationserver and Web-Administrationserver) are installed on the same Computer.). We assume that you’re able to save this file in your hard disk from your Mailbox, or any other way.

Hinweis: If Kommunikationserver is not running on standard HTTP-Port 80, oder on the same Computer wie die Administrationskonsole, you must update General Options. See § 6.2 Managing OCS Inventory NG general options.)

DE menue local.png

Klicke “Local import” toolbar Menü, browse your hard drive to select the “.ocs” file created by Agent release and klicke auf den “send”-Button.


With Kommunikationserver through a Perl script

Kommunikationserver provides the ability to import inventory from a file created on the computer. This file has “.ocs” extension.

We assume that administrator can get the file from somewhere, his mailbox, a USB drive or any other place.

Go to the directory where you’ve installed Kommunikationserver, “/usr/local/ocsinventory-NG” for us, and run the script “Ocsinventory_local.pl” with path to file which contains inventory results as argument.

Hinweis: With OCSInventory NG Server für Windows, import script “local_import.bat” is located in “INSTALLDIR\binutils” directory, where “INSTALLDIR” is the installation folder selected during Server setup.

This will import inventory results into the Datenbank.

[root@l16753101aao ocsinventory-NG]# Ocsinventory_local.pl ST32491DL-2005-06-23-10-04-02.ocs
OK for ST32491DL-2005-06-23-10-04-02.ocs
Successly inventoried : 1
Errors : 0
Abbildung 6: Beispiel für import of a single inventory results file

If you have multiple files to import, you can put them in a directory und then launch the script “Ocsinventory_local.pl” without argument, but within the directory where resides files to import.

[root@l16753101aao home]# Ocsinventory_local.pl
OK for ST32491DL-2005-06-23-10-04-02.ocs
Successly inventoried : 1
Errors : 0
Abbildung 7: Sample of multiple inventory results files in directory home.

Using software dictionary for GLPI integration.

Software dictionary is used to categorize detected software. This feature is very useful when you use OCS Inventory NG combined with GLPI. As is, you can group Software in a Kategorie und GLPI will import them with the name of Kategorie.

Zum Beispiel, you have many Version of Microsoft Office (97, 2000, XP, 2003 …), but you don’t care about Version. You just want to manage total number of MS Office. You can create a Kategorie “Microsoft Office” und insert in this category all Version of MS Office. In GLPI, you will only see “Microsoft Office”. Software dictionary acts as a rename oder group utility for GLPI.

Dictionnaire a.png Klicke “Dictionary” toolbar Menü.

Es gibt Standardmäßig 3 Kategorien:

  • NEW: include all new oder not yet categorized Software.
  • IGNORED: you can put in this Kategorie all Software you don’t want to import in GLPI.
  • UNCHANGED: you can put in this Kategorie all Software you don’t want to “rename” in GLPI. These Software will be imported as is.


You can search software with part of his name by fill in input und clicking “Search Software EVERYWHERE” button.

If you manage many Kategorien, you can search a Kategorie by fill in part of his name in input und clicking “Search Kategorie” button.

Click on a Kategoriename to display Software included.


You can select Software to move to new Kategorie (you must fill in the new Kategoriename) oder to an existing Kategorie (select it in the dropdown).

If you check “Move all”, all Software, even those not displayed, will be moved to the desired Kategorie, not only the selected ones.

You can select all displayed Software by clicking “The page” und deselect all displayed Software by clicking “Nothing”.