14.5 Installing Inventory-Only Agent (IOA) on Macintosh OS X

  1. Make sure you have downloaded the ZENworks_Inventory_Only_Agent_OSX.dmg disk image to the target Macintosh device.

    For more information on how to download the ZENworks_Inventory_Only_Agent_OSX.dmg disk image, see Downloading the Module from a ZENworks Server.

  2. Double-click the ZENworks_Inventory_Only_Agent_OSX.dmg file.


    Run the hdiutil attach filename.dmg command to mount the disk on all versions of macOS mini.

  3. Double-click the ZENworks_Adaptive_Agent_OSX file, so that it gets mounted.

  4. Browse to the mounted drive and locate the extracted folder.

    For example, /Volumes/ZENworks_Inventory_Only_Agent_OSX

  5. Run the install.sh script.

  6. After the installation is complete, log out and log in to the terminal.

  7. After the installation program completes its execution, register the Inventory-Only Agent (IOA) device to the server by running the following command:

    zac ioa cfg <server_ip:port_number>

    NOTE:Ensure that you do not provide the Admin port while installing the Inventory-Only Agent.

    • To run this command, either specify an authorization key for the secure registration of the device or ensure that the device is added in the list of pre-approved devices.

      For example, if the device is pre-approved:

      zac ioa cfg <server_ip:port_number>

      For example,

      zac ioa cfg <server_ip:port_number> --authkey <xyz>

    • While registering the device to the zone, you need to trust the root certificate. A prompt to trust the root certificate will be displayed during device registration. If you do not trust the certificate, then you will not be able to register the device. You also have the option of auto accepting the certificate while running the command:

      For example, to auto accept the certificate:

      zac ioa cfg <server_ip:port_number> --authkey <xyz> --autoAcceptCert

    • If you are using the default port, then specify only the IP address.

      For example:

      • IPv4: zac ioa cfg <server_ip:port_number>

      • IPv6: zac ioa cfg <[server_ip]:port_number>

      In the above command, replace the <server_ip> with the actual IP address.

  8. The Inventory-Only module is added to the Inventoried Devices page in ZENworks Control Center (Devices tab > Inventoried tab > Workstations folder).

    NOTE:To debug any issues that you might face while registering the device, see the zmd-messages.log in \novell\zenworks\logs\localstore on the device that you want to register to the zone. You can also refer to service-messages.log on the server to which you are registering the device.