zac for Linux (1)


zac - The command line management interface for the Novell ZENworks Adaptive Agent that is installed and running on Linux managed devices.


zac command options


The zac utility performs command line management functions on ZENworks unmanaged devices, including Satellite configuration, and registering and unregistering the device.

NOTE:After installing the Linux Satellite, you must open a new terminal to run the zac commands.

Guide to Usage

Most commands have a long form and a short form:

When both forms are available, the command is listed as follows:

add-reg-key (ark) options

When using the command, enter only the long form or the short form:

zac add-reg-key options

zac ark options

If an option includes a space, enclose it in quotation marks:

zac ark "option 1"

Help Commands

/? or --help

Displays help for the system.


Displays the description for a specified command.

/g or --group

Displays commands of the specified group.

List of Commands

Authentication Satellite Server Commands

authentication server reconfigure (asr) [-t all|config|jetty|casa] [-u username] [-p password]

Reconfigures an enabled Authentication Satellite.


To fetch the configuration files from the server:

zac asr -t config

To reconfigure the CASA signing certificate:

zac asr -t casa

To reconfigure the Jetty web server:

zac asr -t jetty -u Administrator -p password

To reconfigure the entire Satellite:

zac asr -t all -u Administrator -p password

If a username and password is required but is not provided on the command line you will be prompted.

import-authentication-cert(iac)[-pk <private-key.der>] [-c <signed-server-certificate.der>] [-ca <signing-authority-public-certificate.der>] [-ks <keystore.jks>] [-ksp <keystore-pass-phrase>] [-a <signed-cert-alias>] [-ks <signed-cert-passphrase>] [-u username] [-p password]

Configures an Authentication Satellite device with externally signed certificates.

Collection Rollup Commands

collection-clients (crc)

Displays devices that have uploaded files to this Collection.


zac crc

collection-queued (crq)

Displays collected files that have not yet been rolled up.


zac crq

collection-state (crs)

Displays the current state of the Satellite Collection role.


zac crs

collection-upload-orphans (cuo)

Finds orphaned files on the Satellite device and rolls them up to the parent collection server or deletes them if they have already been rolled up.

This command builds a list of the files in the folders under /var/opt/novell/zenworks/work/collection (except for the collectionStatsDB folder) and then tries to find the original upload information for each entry in the collection stats database.

If there is an entry for a file in the database, and it shows that the file has not been rolled up, it rolls the file up. If the entry shows that the file has already been rolled up, it deletes the file on the Satellite device. If there is no entry for a file in the database, the file is rolled up. This command also lists any files that were not uploaded or deleted.

Before running this command, you should run the zac crw command to send any pending files to the parent server.


zac cuo

collection-wake (crw)

Sends collected files to the parent server.


zac crw

Content Distribution Commands

cdp-checksum (cchk) [-l:<path to log>]

Validates satellite content by computing the checksum on each file.

The optional log file details results of the checksum comparison.


zac cchk -l:"/var/opt/novell/zenworks/logs/cchk.log”

cdp-verify-content (cvc) [-c] [-l:<path to log>]

Compares the list of content IDs and their sync states on this CDP with what the Primary Servers thinks it should have.

You can use the following options:

  • c - Computes the checksum on the local content.


zac cvc -l:"/var/opt/novell/zenworks/logs/cvc.log”

cdp-import-content (cic) <content path> [<path to log>]

Imports missing content from the directory specified by content-path, logging to the file specified by log-path.


zac cic /usr/content_Dir /var/opt/novell/zenworks/logs/cic.log

distribution-info (cdi) [option]

Displays statistical information about the Content role. You can use the following options:

  • all - Executes all options marked with *.
  • ss - Shows sync status *.
  • rs - Gets the Content Repository size *.
  • da - Lists devices that have retrieved data from this device *.
  • ne - Gets the number of content distribution errors *.
  • ds - Gets the size of data served by this device *.
  • fs - Gets the number of files served *.
  • ah [n] - Displays n (default all) entries from the access history.
  • ch - Clears the history.
  • eh <file> - Exports the access history to <file>, where the path is included and the file itself must not exist.


zac cdi

zac cdi rs

distribution-state (cds)

Displays the state of the Satellite Content role. Displays if the role is enabled/disabled, the status (Starting, Active, Stopping, Stopped), the Parent URLs, and the replication schedule.


zac cds

distribution-wake (cdp) [replicate | cleanup]

Wakes the Content Distribution Point worker thread. You can use either of the following options:

  • replicate - Downloads any new or changed content from the Content Distribution Point’s parent ZENworks Server.
  • cleanup - Removes any content that should no longer be stored on the Content Distribution Point.


zac cdp

zac cdp replicate

Core Commands

get-settings (gs) <registration key>

Lists the effective settings associated with the specified registration key.


zac gs key1

Example to list the Remote Management settings:

zac gs RemoteManagement

All the valid ZENworks settings keys are stored in the /var/opt/novell/zenworks/zmd/cache/settings/ directory.

get-pref (get) <preference name>

Displays the preferences that are currently set.

Example to display all preferences that are set:

zac get-pref

Example to display all preferences that have names beginning with abc:

zac get-pref abc

set-pref (set) <preference name> <preference value>

Sets the value for a preference.

Example to set the value of preference abc to 123:

zac set-pref abc 123

The following preferences are used to set a proxy:

  • proxy-host - Specifies the proxy server to use to tunnel the HTTP requests.
  • proxy-port - Specifies the port to connect to the proxy server.
  • proxy-username - Specifies the username to use to connect to the proxy server.
  • proxy-password - Specifies the password to use to connect to the proxy server.

Logging Commands

logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] |managedlevel]

Changes the logger configuration.

You can use the following options:

  • resetlog - Resets the log.
  • level - If used without a level, displays the current managed logging level. If used with one of the levels, changes the logging level to the specified level.
  • managedlevel - Displays the current managed logging level.

Example to reset the log file:

zac logger resetlog

Example to show the current log level:

zac logger level

Example to set the log level to DEBUG and above:

zac logger level DEBUG MANAGED

Registration Commands

add-reg-key (ark) <registration key>

Registers the device by using the specified key. Registration with keys is additive. If the device has previously been registered with a key and you register it with a new key, the device receives all group assignments associated with both keys.


zac ark key12

register (reg) [-k <key>] [-u <username> -p <password] <ZENworks Server address:port>

Registers the device in a Management Zone.


zac reg -k key1 https://123.456.78.90

zac reg -k key1 -u administrator -p novell

The port number is required only if the ZENworks Server is not using the standard HTTP port (80). If a username and password are not supplied, you are prompted for them.

reregister (rereg)[-u <username> -p <password>] <new guid>

Registers a device in the current zone and assigns it the GUID of an existing device object. The currently associated device object is deleted.

For example, if you image a device after replacing the hard drive, the device might get a new GUID. However, by using the reregister command, you can assign the same GUID that it had before you replaced the hard drive.


To reregister, specify a username and password:

zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4

To reregister and be prompted for a username and password:

zac reregister eaa6a76814d650439c648d597280d5d4

unregister (unr) [-f] [-u <username> -p <password>]

Removes the device’s registration from the Management Zone.


zac unr -u administrator -p novell

The -f, -u, and -p parameters are optional. If you don’t use the -u and -p parameters, you are prompted to enter a username and password. The -f parameter ignores the ZENworks database and forces the device to be unregistered locally; this option is necessary only if the device object has already been deleted from the ZENworks database or if the device cannot connect to the database.

Satellite Role Commands

satellite-cachecfg (satcfg)

Reads Satellite roles from cache.


zac satcfg

satellite-clearcache (satcc)

Clears Satellite configuration information from cache.


zac satcc

satellite-refreshcfg (satrc)

Refreshes Satellite roles.


zac satrc

satellite-roles (satr)

Reports on current Satellite roles and their state.


zac satr

imgsatserver status (iss status)

Displays the device’s imaging role properties, including its current status, PXE service status, image files, and imaging statistics.

Current Status: Displays whether your device is currently configured to perform Imaging operations. The current status is Active when the device is promoted to a satellite with the Imaging role.

PXE Service Status: Displays whether the Proxy DHCP service is enabled on the device.

PXE Requests: The number of imaging requests of any kind that have been received by the Imaging Server since it was last started. This includes requests that failed, were denied, or were referred to other Imaging Servers. Information about each of these requests, such as the source, type, date/time, and results, is logged on the Imaging Server.

Images Sent: The number of images that the Imaging Server has sent to imaging clients since the Imaging Server was last started. This includes only images that were retrieved from this Imaging Server.

Images Received: The number of new images that have been received and stored on the Imaging Server since it was last started. This includes images that were received through client referrals.


zac iss status

Status Commands

agent-properties (agp)

Provides information about the ZENworks Adaptive Agent. The following fields provide information about the ZENworks Adaptive Agent:

Device Address. The IP address of your device.

Device Name. The computer name for your device.

Device State. The state of the device - Managed, Unmanaged, Retired, or Unknown. The Unknown state is displayed only if there is an error.

Last Contact With Server. The last time the Adaptive Agent contacted the ZENworks Server.

Next Contact With Server. The time scheduled for the Adaptive Agent to contact the ZENworks Server.

Primary User. The currently logged in user.


zac agp

zac agent-properties

cache-clear (cc)

Clears the ZENworks cache on the device. This removes all entries in the cache database and deletes any cache files associated with those entries.


zac cc

refresh (ref)[general [bypasscache] | partial [bypasscache] | bypasscache]

Initiates a general refresh to refresh all registration and configuration settings; or initiates a partial refresh to refresh all registration and configuration settings.

Use bypasscache to avoid using data from the server cache during the refresh. This option is useful for testing or troubleshooting.


zac ref general bypasscache

zac ref partial bypasscache

zac ref bypasscache


Lists port and tags for registered handlers.


zac zhs

zone-config (zc)

Displays information about the ZENworks Server that the device is accessing for configuration information (the Configuration server) or lists the information for the Configuration server.


zac zc


Copyright 2009-2010, Novell, Inc. All rights reserved.