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.
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"
Displays help for the system.
Displays the description for a specified command.
Displays commands of the specified group.
Reconfigures an enabled Authentication Satellite.
Examples:
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.
Configures an Authentication Satellite device with externally signed certificates.
Displays devices that have uploaded files to this Collection.
Example:
zac crc
Displays collected files that have not yet been rolled up.
Example:
zac crq
Displays the current state of the Satellite Collection role.
Example:
zac crs
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.
Example:
zac cuo
Sends collected files to the parent server.
Example:
zac crw
Validates satellite content by computing the checksum on each file.
The optional log file details results of the checksum comparison.
Example:
zac cchk -l:"/var/opt/novell/zenworks/logs/cchk.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:
Example:
zac cvc -l:"/var/opt/novell/zenworks/logs/cvc.log”
Imports missing content from the directory specified by content-path, logging to the file specified by log-path.
Example:
zac cic /usr/content_Dir /var/opt/novell/zenworks/logs/cic.log
Displays statistical information about the Content role. You can use the following options:
Examples:
zac cdi
zac cdi rs
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.
Example:
zac cds
Wakes the Content Distribution Point worker thread. You can use either of the following options:
Examples:
zac cdp
zac cdp replicate
Lists the effective settings associated with the specified registration key.
Example:
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.
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
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:
Changes the logger configuration.
You can use the following options:
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
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.
Example:
zac ark key12
Registers the device in a Management Zone.
Examples:
zac reg -k key1 https://123.456.78.90
zac reg -k key1 -u administrator -p novell https://zenserver.novell.com:8080
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.
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.
Examples:
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
Removes the device’s registration from the Management Zone.
Example:
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.
Reads Satellite roles from cache.
Example:
zac satcfg
Clears Satellite configuration information from cache.
Example:
zac satcc
Refreshes Satellite roles.
Example:
zac satrc
Reports on current Satellite roles and their state.
Example:
zac satr
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 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.
Example:
zac iss status
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.
Example:
zac agp
zac agent-properties
Clears the ZENworks cache on the device. This removes all entries in the cache database and deletes any cache files associated with those entries.
Example:
zac cc
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.
Examples:
zac ref general bypasscache
zac ref partial bypasscache
zac ref bypasscache
Lists port and tags for registered handlers.
Example:
zac zhs
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.
Examples:
zac zc
Copyright 2009-2010, Novell, Inc. All rights reserved. http://www.novell.com