14.8 Re-registering Inventory-Only Devices

There are two options you can use for re-registering Inventory-Only devices.

14.8.1 Re-registering Inventory-Only Devices for All Platforms

This procedure is common to re-register the Inventory-Only devices for all the supported platforms.

  1. Uninstall the existing agent from the device by following the instructions provided for the selected platform in Uninstalling the Inventory-Only Module.

  2. Download the executable agent from the latest module on the ZENworks Server.

    For more information, see Downloading the Module from a ZENworks Server.

14.8.2 Re-registering Inventory-Only Devices for Individual Platforms

This procedure can be used for re-registering Inventory-Only devices for the specified platforms.

Linux

  1. Execute the following command:

    zac ioa cfg <server_ip:port_number>

    • 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, if you are using an authorization key:

      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.

Windows

  1. Go to the C:\Program Files\Novell\ZENworks\bin directory.

  2. In the service manager, stop the Microfocus ZENworks Agent Adaptive Agent.

  3. Edit the uiaconfig.xml file.

  4. Replace the existing Server IP address with the new ZENworks Server IP address.

  5. Save and close the inventory config file.

  6. (Conditional) If necessary modify the register key HKLM\Software\Novell\ZCM to change the default values for server, port, and secure port.

    By default, the server is the DNS name or IP address of the ZENworks Server and the default numbers for the port and secure port are 80 and 443.

  7. In the command line go to cd C:\Program Files\Novell\ZENworks\bin and run the following command to register the device:

    zenioa register

    • 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: zenioa register

      For example, if you are using an Authorization Key:

      zenioa register --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:

      zenioa register --authkey <xyz> --autoAcceptCert

  8. To restart the service in the service manager, start Microfocus ZENworks Adaptive Agent Service.

Macintosh OS X

  1. Execute the following command:

    zac ioa cfg <server_ip:port_number>

    • 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, if you are using an authorization key:

      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.