Documentation:MacAgent

From OCS Inventory NG
Jump to: navigation, search

OCS MacOSX agent 2.0 documentation

Installing OCS MacOSX agent 2.0

Note: OCS MacOSX agent 2.0 agent is full compatible under MacOSX 10.6 Snow Leopard and more. Under MacOSX 10.4 Tiger and MacOSX 10.5 Leopard, SSL layer and packages deployment feature won't work but inventory using HTTP connection will work. If you want to run OCS MacOSX agent under older MacOSX systems, you have to use the old OCS MacOSX 1.1 beta1 agent.


Download OCS MacOSX agent from OCS Inventory NG website download page (http://www.ocsinventory-ng.org/en/download/download-agent.html), unzip the file and double click "Ocsinventory_Agent_MacOSX.pkg".

EN macosx agent pkg icon.png

Click "Next".

EN macosx agent install introduction.png

Validate license agreement by clicking "Continue" and "Agree".

EN macosx agent install licence.png

If you already made an OCS MacOSX agent installation, you may be asked if you want to launch OCS MacOSX configuration. Click on "Yes" to launch configuration panel or "No" to skip this step.

Warning: If you click on "Yes", /etc/ocsinventory-agent/ocsinventory-agent.cfg file content will be erased !


EN macosx agent install configuration warn.png

Set your OCS MacOSX agent configuration by choosing serveral options:

  • Http or https for MacOSX agent communication to OCS server ("http" by default).
  • OCS server server name ("ocsinventory-ng" by default).
  • MacOSX agent TAG value (optional).
  • Log file path for OCS MacOSX agent ("/var/log/ocsng.log" by default).
  • Activate or Unactivate OCS MacOSX agent debug mode for logs (activated by default).
  • Activate or Unactivate OCS MacOSX agent packages download feature (activated by default).
  • Certificate file path (mandatory if you activate OCS MacOSX agent packages download feature). Certificate file must be named as "cacert.pem".

Click on "Continue" to validate configuration.

EN macosx agent install configuration.png

If you activate OCS MacOSX agent packages download feature without specifying a certificate file path, you may have this warning.

Warning: If you activate OCS MacOSX agent packages download feature without specifying a certificate file path, OCS MacOSX agent packages download feature won't work !!!


EN macosx agent configuration download warn.png

Set how OCS MacOSX agent will be launched by MacOSX Launchd daemon by choosing several options:

  • Periodicity for OCS MacOSX agent to be launched by Launchd daemon (5 hours by default).
  • Activate or Unactivate OCS MacOSX agent launch at Launchd daemon start (activated by default).
  • Activate or Unactivate OCS MacOSX agent launch, using Launchd daemon, after installation (unactivated by default)
EN macosx agent install daemon options.png

Select hard drive where you want to install OCS MacOSX agent and click "Continue".

EN macosx agent install destination.png

Click "Install".

EN macosx agent install type.png

Click "Close" to end installation.

EN macosx agent install end.png

Launch MacOSX agent

To launch MacOSX agent, open a new Finder window, go to Applications and then double click on OCSNG.app.

EN macosx agent finder icon.png

A new window appears and click Yes to launch agent or No to cancel.

EN macosx agent launch window.png

During agent launch you will see an icon in your Dock and this will disappear when agent launch will be ended.