zac - The command line management interface for the Novell ZENworks Adaptive Agent that is installed and running on Windows managed devices.
zac command options
The zac utility performs command line management functions on the ZENworks managed device, including installing and removing software bundles, applying policies, and registering and unregistering the device.
Most commands have a long form and a short form:
Long form: add-reg-key
Short form: ark
When both forms are available, the command is listed as follows:
add-reg-key (ark) arguments
When using the command, enter only the long form or the short form:
zac add-reg-key arguments
zac ark arguments
Arguments can be mandatory or optional. Mandatory arguments are included in angle brackets <argument>. Optional arguments are included in square brackets [argument]. If an argument includes a space, enclose it in quotation marks:
zac ark "arg 1"
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.
Installs the specified bundle. Use the bundle-list command to get a list of the available bundles and their display names.
Example:
zac bin bundle1
Launches the specified bundle. Use the bundle-list command to get a list of the available bundles and their display names.
Example to launch a bundle based on the display name:
zac bln bundle1
Example to launch a bundle based on the display name and turn selfhealing off if the launch action fails (by default, selfhealing is turned on):
zac bln bundle1 -noSelfHeal
Displays the list of bundles assigned to the device and the logged in user.
Example:
zac bl
Displays the status, version, GUID, and requirements information for the specified bundle. Use the bundle-list command to get a list of the available bundles and their display names.
Example:
zac bln bundle1
Refreshes information about the specified bundle.
Example:
zac br bundle1
Uninstalls the specified bundle. Use the bundle-list command to get a list of installed bundles and their display names.
Example:
zac bu bundle1
Verifies an installed bundle (specified by bundle display name) to ensure that no files have been removed or corrupted. Use the bundle-list command to get a list of the installed bundles and their display names.
Example:
zac bv bundle1
Lists public key certificate information for each known ZENworks server or adds a trusted root certificate to the device trusted store. The file can be in ASN.1 DER format or base-64 encoded delimited by ----BEGIN CERTIFICATE---- and ----END CERTIFICATE--.
Example:
To list the certificate for each known ZENworks server:
zac ci
To add a trusted root certificate to the devices trusted store:
zac ci c:\certs\mytrustcacert.der -u myuser -p mypassword
Validates satellite content by computing the checksum on each file.
The optional log file details results of the checksum comparison.
Example:
zac cchk -l:"C:\Program Files\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:"C:\Program Files\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 c:\import_source_directory -l:"C:\Program Files\Novell\ZENworks\logs\cic.log”
Wakes the Content Distribution Point worker thread. You can use either of the following options:
Examples:
zac cdp
zac cdp replicate
This command is applicable only if the agent is promoted as a satellite.
Runs the cleanup immediately and deletes entries in the MDStatus database that have not been updated for 14 days since the last successful rollup. By default, the cleanup is performed once a day and runs the first time the Agent Service is started. The cleanup method logs appropriate messages to the zmd-messages.log file when the log level is set to DEBUG.
The MDStatus database is used for rolling bundle and policy status from the managed device to the ZENworks Server.
Rolls up statuses to the MDStatus database that have been updated since the last time the status was rolled up successfully. By default, the status sender automatically rolls statuses up every 5 minutes.
The MDStatus database is used for rolling bundle and policy status from the managed device to the ZENworks Server.
Displays, removes, or restores the workstation GUID in the file system in preparation for taking an image.
For example:
To display the GUID value:
zac fsg
To remove the GUID from the file system:
zac file-system-guid -d
To restore the GUID to the file system:
zac file-system-guid -r
Do not specify an option to print the the GUID value:
zac fsg
Runs an inventory scan or opens the Collection Data Form.
Example to run an inventory scan:
zac inv scannow
Example to open the Collection Data Form:
zac inv cdf
Displays the configuration location. The configuration location determines which ZENworks server (or servers) the device connects to for authentication, configuration, content, and collection purposes.
Examples:
zac config-location
zac cl
Displays or changes the security location for the device. The security location determines which security policies (settings) are applied to the device.
Accepts the following optional arguments. If no argument is specified, the view argument is used.
Examples:
Changes or displays the logger configuration for the ZENworks Adaptive Agent.
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
Lists the policies that are currently being enforced on the device (effective policies). To list all policies (effective and non-effective), use the --all option.
Examples:
zac pl
zac pl --all
Applies all of the policies assigned to the device and user.
Example:
zac pr
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
Lists the settings associated with the specified registration key.
Example:
zac gs key1
You can also use the get-settings (gs) command to list settings using various keys. For more information, see get-settings (gs) <key> in the Status Commands section.
Registers the device in a Management Zone.
You can use the following options:
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 device’s 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.
Reestablishes trust with the current Management Zone. The username and password used must be of the Zone Administrator.
Example:
zac retr -u myuser -p mypassword
The -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.
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
NOTE:If your ZENworks administrator has enabled the self defense feature for the ZENworks Adaptive Agent, you must supply an override password before running the zac cc command. Otherwise, you receive the following message:
You do not have permission to clear the cache. Please contact your ZENworks administrator.
You must request the override password from your ZENworks administrator. If he has not set an override password, he must do so before you can use the command. After you receive the password:
Double-click the ZENworks icon (z-icon) in the system tray, click Agent (under Status), then click the Policy Override link in the Agent Security Settings section to display the About box.
Click Override Policy, enter the override password, then click Override.
Go to a command line prompt and run the zac cc command.
After the cache is successfully cleared, return to the About box and click Load Policy to disable the password override.
Outputs the HTML pages displayed in the ZENworks icon’s property pages to files in the specified target directory.
Example:
zac dpp c:\temp
Lists the settings associated with the specified key.
Example:
zac gs key1
All valid ZENworks settings keys are stored in the \Program Files\Novell\ZENworks\cache\zmd\settings directory.
Example to list the Remote Management settings:
zac gs RemoteManagement
Initiates a general refresh to refresh all bundles, policies, registration, and configuration settings; initiates a partial refresh to refresh all policies, 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
Specifies a proxy to contact rather than contacting a ZENworks Server directly. The options are:
Examples:
zac sp 123.456.78.90 administrator novell
zac sp /default 123.456.78.90
If a username and password are not supplied, you are prompted for them.
Queries the Management Zone for proxy work assigned to this device.
Example:
zac wpr
Lists port and tags for registered handlers.
Example:
zac zhs
This command is applicable only if the agent is promoted as a satellite.
Collects ZENworks support information, including cache data, configuration data, debug logs, product installation information, refresh times, status events, and basic system information. The information is packaged into a ZIP file and placed in the location you specify. If you do not specify a location, ${TEMP}\zeninfo-${DateTime}.zip is used for Windows and ${TMPDIR}\zeninfo-${DateTime}.zip is used for Linux. If you are experiencing problems with a managed device, Novell Support might ask you to run this command and send the resulting ZIP file to Novell to help troubleshoot your problem.
To run the zeninfo process in the background, run the following command:
zac zeninfo /tmp/zeninfo/ & echo $! > /tmp/zeninfo/zeninfo.pid
To stop the zeninfo process, run the following command:
kill `cat /tmp/zeninfo/zacinfo.pid`
You can use the following option:
The zeninfo command can be run by the local administrators. If you are not a local administrator and you run the command, the system prompts you to enter the administrator credentials. You can also set the AllowZenInfoWithoutAdminPwd string value to True, which enables any user to run the zeninfo command. To set the AllowZenInfoWithoutAdminPwd string value, do the following:
Open the Registry Editor.
Go to HKLM\Software\Novell\ZCM\.
Set the AllowZenInfoWithoutAdminPwd string value to True.
WARNING:If the AllowZenInfoWithoutAdminPwd string value is set to True, the sensitive ZENworks Configuration Management settings and configuration information is visible also to the users who are not the local administrators.
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
zac zc -l
This command is used to find the status information at the server. The options are:
Rollup - This is used to schedule an immediate rollup of the status information at the server inspite of the pre-scheduled time.
Cleanup - This is used to schedule an immediate cleanup of the status information into the MDStatus database.