Installation and Administration Guide Version 1.9 For use with OCS Inventory NG 1.01 or higher Powerful, OpenSource inventory and package deployment tool for Windows and Unix like computers http://ocsinventory.sourceforge.net Installation and Administration Guide Page 2 / 167 Version 1.8 Table of Contents 1 Introduction. ............................................................................................................................. 6 2 Important notes ........................................................................................................................ 7 3 Setting up management server. ................................................................................................ 9 3.1 Under Linux Operating System. ..................................................................................... 10 3.1.1 Requirements. .......................................................................................................... 10 3.1.2 Installing Communication server required PERL modules. .................................... 11 3.1.3 Installing Administration console required PHP modules ....................................... 12 3.1.4 Installing management server. ................................................................................. 13 3.1.5 Configuring management server. ............................................................................. 25 3.1.6 Upgrading management server. ............................................................................... 28 3.2 Under Windows Operating System. ................................................................................ 30 3.2.1 Installing management server. ................................................................................. 31 3.2.2 Configuring management server. ............................................................................. 36 3.2.3 Updating security of XAMPP components. ............................................................. 39 3.2.4 Upgrading management server. ............................................................................... 45 4 Setting up agent on client computers. .................................................................................... 48 4.1 Under Windows Operating Systems. .............................................................................. 48 4.1.1 Which version of Windows Agent does i have to use ? ........................................... 48 4.1.2 Manually installing Service version of Agent. ......................................................... 51 4.1.3 Manually installing standalone Agent (without service). ........................................ 54 4.1.4 Deploying Agent using launcher OcsLogon.exe through Login Script or Active D irectory GPO. ................................................................................................................. 55 4.1.5 Agent’s command line switches .............................................................................. 62 4.2 Under Linux Operating Systems. .................................................................................... 64 4.2.1 Requirements. .......................................................................................................... 64 4.2.2 Installing the agent interactively. ............................................................................. 66 4.2.3 Deploying agent through scripted installation without user interaction. ................. 71 4.2.4 Agent’s command line switches .............................................................................. 72 5 Querying inventory results. .................................................................................................... 74 5.1 All computers. ................................................................................................................. 75 5.2 TAG / number of PC repartition. .................................................................................... 80 5.3 Search with various criteria. ............................................................................................ 80 6 Administration of OCS Inventory NG. .................................................................................. 84 6.1 Managing OCS Inventory NG Administration server users. .......................................... 84 6.2 Managing OCS Inventory NG general options. .............................................................. 85 6.3 Uploading Agent for deployement through launcher “OcsLogon.exe”. ......................... 87 6.4 Using Registry Query feature. ........................................................................................ 89 6.5 Managing duplicates computers. ..................................................................................... 91 6.6 Editing administrative information. ................................................................................ 92 6.7 Editing the label .............................................................................................................. 94 6.8 Importing inventory for non network connected computers. .......................................... 95 6.8.1 With Administration server through your web browser .......................................... 95 6.8.2 With Communication server through a Perl script ................................................... 96 6.9 Using software dictionary for GLPI integration. ............................................................ 97 7 Using IP discovery feature. .................................................................................................. 100 7.1 Introduction. .................................................................................................................. 100 Copyleft OCS Inventory Next Generation Team – http://ocsinventory.sourceforge.net Installation and Administration Guide Page 3 / 167 Version 1.8 7.2 How does it work? ........................................................................................................ 100 7.2.1 Retrieving information. .......................................................................................... 100 7.2.2 Election mechanism. .............................................................................................. 101 7.2.3 How do agents work? ............................................................................................. 101 7.2.4 Server tuning .......................................................................................................... 101 7.3 Working with results. .................................................................................................... 102 7.3.1 Manage names of your networks. .......................................................................... 102 7.3.2 Show list of networks ............................................................................................. 103 7.3.3 Show inventoried hosts in the network. ................................................................. 104 7.3.4 Show uninventoried network devices. ................................................................... 105 7.3.5 Show IPDISCOVER enabled hosts. ...................................................................... 107 7.3.6 Show known or identified hosts. ............................................................................ 107 7.3.7 Managing known device types. .............................................................................. 107 7.3.8 Registering known hosts. ....................................................................................... 108 7.3.9 Scanning an IP address .......................................................................................... 109 8 Deploying packages or executing commands on client hosts. ............................................. 111 8.1 How does it work? ........................................................................................................ 111 8.2 Requirements. ............................................................................................................... 114 8.3 Creating packages. ........................................................................................................ 114 8.3.1 Deploying package through “Launch” command. ................................................. 116 8.3.2 Deploying package through “Execute” command. ................................................ 118 8.3.3 Command through “Execute” command. .............................................................. 120 8.3.4 Stored package through “Store” command. ........................................................... 121 8.4 Activating package ........................................................................................................ 123 8.5 Affecting packages to computers. ................................................................................. 126 8.6 Unactivating packages. ................................................................................................. 128 8.7 Deployment statistics and success validation. .............................................................. 129 8.8 Using SSL certificates in Package deployment. ........................................................... 131 8.8.1 Using self signed certificates. ................................................................................ 131 8.8.2 Using PKI with Certificate Authority. ................................................................... 138 8.9 Example: Deploying new version