zac - The command line management interface for the Micro Focus ZENworks Agent that is installed and running on Linux 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.
This section contains a guide to general command formatting and conventions.
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"
Arguments enclosed inside parentheses ( ) are mandatory and those enclosed by square brackets [ ] are optional.
An ellipsis indicates that a command accepts multiple entries of the last argument type. The arguments must be separated by space or commas, depending on the command. For example:
zac <command> [options] (server) (bundle) [...]
The ellipsis indicates that <command> can accept multiple bundles. In the command level help, the multiple entry argument help is given as [(bundle) (bundle) ... (bundle)] for more clarity.
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 entire Satellite:
zac asr -t all
Installs the specified bundles based on the display name that match the specified regular expression or string, or the bundle GUID. Use the bundle-list command to get a list of the available bundles and their display names.
The following regular expressions are supported:
|
Regular Expression |
Functionality |
|---|---|
|
^abc |
Matches string starting with 'abc'. |
|
[abc] |
Matches string containing 'a', 'b', or 'c'. |
|
a*c |
Matches zero or more times 'a' followed by 'c', 'ac','aac','aaac',or 'c'. |
Accepts the following option:
An example to install a bundle based on the bundle name:
zac bin bundle1
Launches the specified bundle. The actions in the Launch Action set are executed.
If you try to launch a bundle that is not installed, the bundle is first installed and then launched.
Use the bundle-list command to get a list of the available bundles and their display names.
An example to launch a bundle based on the display name:
zac bln bundle1
Example to launch a bundle based on the display name and to turn self-healing 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.
The output of this command is displayed in columns and provide the details of every bundle assigned or available for the managed device. The Display Name, Version, and Bundle Type columns represent the bundle display name, the version number of the bundle or sandbox if the bundle is a sandbox version, and the bundle type, respectively.The Status column displays the following states:
This command accepts the following options:
An example to list all the bundles:
zac bl -a
Locks the specified bundles that match the specified regular expression or string from being upgraded or removed.
The following regular expressions are supported:
|
Regular Expression |
Functionality |
|---|---|
|
^abc |
Matches string starting with 'abc'. |
|
[abc] |
Matches string containing 'a', 'b', or 'c'. |
|
a*c |
Matches zero or more times 'a' followed by 'c', 'ac','aac','aaac',or 'c'. |
Accepts the following options:
NOTE:Bundle locks are applicable only for Install action set.
Lists the bundle locks. The bundle locks are sorted by ID number.
Example:
zac bll
Removes the bundle lock that you specify by its number. You can find the number for each lock by using the bundle-lock-list (bll) command.
Accepts the following options:
An example to remove a bundle lock abc:
zac blr -n abc
An example to remove all bundle locks:
zac blr --remove-all
Refreshes information about the specified bundle.
Example:
zac br bundle1
Searches for bundles that match the specified regular expression or string.
The following regular expressions are supported:
|
Regular Expression |
Functionality |
|---|---|
|
a+bc |
Matches one or more times ‘a’ followed by ‘bc’. For example, matches one or more times ‘a’ followed by ‘abc’ or ‘aabc’. |
|
[a-z]\* |
Matches the empty string and strings with names containing only alphabetic characters. For example, matches the empty string "", or strings with names such as acb and xyz with only alphabetic characters. |
|
a*bc |
Matches zero or more times 'a' followed by ‘bc'. For example, matches zero or more times ‘a’ followed by ‘abc’, ‘aabc’, ‘aaabc’, or ‘bc’. |
The output of this command is similar to the output of the zac bl command.
Accepts the following option:
Uninstalls the specified bundle. The actions that support the Undo action are executed while uninstalling the bundle. After the bundle uninstall is complete, the bundle state is displayed as Not Installed.
Use the bundle-list command to get a list of the installed bundles and their display names.
Example:
zac bu bundle1
Reinstalls the bundle and executes the Verify Action sets 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
Verifies if the server certificate and key file copied to the remint repository are valid and updates the results to the server.
Displays devices that have uploaded files to this Collection.
Example:
zac crc
Shows the status and configuration of the collection role.
Example:
collection-point [wake]
wake - Wakes the modules that perform collection (Inventory, MD status, Message sender)
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/microfocus/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
zac cdp linux-bundle
This command is applicable only if the agent is promoted as a Satellite Server.
The content types include:
Default
linux-bundle
Policy
Macintosh-Bundle
Patch-Informational-Bundles
zscm-policy
subscription-default
Patch-Critical-Bundles
Patch-System-Bundles
subscription-optional
Patch-Recommended-Bundles
subscription-recommended
Imaging
SystemUpdate-Agent
Patch-Software-Bundles
subscription-security
Windows-Bundle
NOTE:The content types are case-sensitive.
Settings are downloaded by the Settings Module to the local cache on every refresh. This will return the effective settings associated with the given 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/microfocus/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
NOTE:If you want to configure a proxy server for a managed device, ensure that the managed device has both the proxy-host and proxy-port preferences configured. If the proxy server requires authentication, the managed device must additionally have the proxy-username and proxy-password preferences configured.
Specifies a proxy to contact rather than contacting a ZENworks Server directly.
The options are:
Examples:
IPv4:
zac sp 123.456.78.90:2349 administrator novell
zac sp /default 123.456.78.90:2349
zac sp /clear
IPv6:
zac sp /ipv6 [2001:db8:0:1:1:1:1:1]:2349 administrator novell
zac sp /default /ipv6 [2001:db8:0:1:1:1:1:1]:2349
zac sp /clear /ipv6
If a username and password is not specified, then you will be prompted to enter them.
Retrieves the system update when it is assigned to a device.
NOTE:This command is not applicable on Satellite Servers.
Enables administrators to resend the system update status to the server immediately.
These commands are used to manage external services.
Adds external package repositories like YUM, ZYPP, or the Local directory that contains the RPMs. All the type-specific properties should start with -D.
You can list the service types that you can add by using the zac est command.
It supports the following types:
YUM: Adds repository of type YUM. Accepts the following properties:
For example, run the following command to add a YUM service type:
zac esa --type YUM -Dusername=username -Dpassword=passwd https://nu.novell.com/sles11 sles11-yum-repo
ZYPP: Adds repository of type ZYPP. Accepts the following properties:
For example, run the following command to add a ZYPP service type:
zac esa --type ZYPP http://zypp.source.com/sles11/x86_64 sles11-zypp-repo
Mount: Adds a repository of type Mount. A Mount type adds a service from the Local directory that contains the RPMs. Accepts the following properties:
For example, run the following command to add packages recursively from all directories by using the Mount service type:
zac esa --type mount -Drecursive=true file:///mnt/sles11-cd/i586 sles11-rpms
NOTE:The ZYPP or Mount services do not synchronize with the YUM Package Management Tool on Red Hat devices.
Removes the specified external services.
The --all option deletes all the external services.
Lists all the external services.
The Source column displays the ZENworks Agents that were added by using the zac command and displays the ZENworks Server that was added through an External Service Policy.
The Status column displays whether the external service is active or inactive. You cannot refresh the external services that display their status as Inactive.
The State column displays whether the external service is enabled or disabled.
Refreshes the specified external services.
The --all option refreshes all the services.
Enables or disables the specified external services.
The --all option changes the service state of all the services.
Lists the available service types.
Removes and restores the workstation GUID in the file system in preparation for taking an image.
Example to remove the GUID from the file system:
zac file-system-guid -d
Example to restore the GUID to the file system:
zac file-system-guid -r
Example to print 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
These commands are used only for Inventory-Only Agents (IOA).
Configures the Linux Inventory-Only Agent (IOA) device to the mentioned server ip. To ensure that only authorized Inventory-Only Agents (IOA) are registered to the zone, you should provide an Authorization Key in this command. If you do not have an Authorization Key, then the device should be pre-approved before executing this command.
Example to configure an Inventory-Only agents using an authorization key:
zac ioa cfg <ip_address>"auth_key"
Displays the version of the Inventory-Only Agent (IOA).
Runs an inventory scan.
An example to run an inventory scan:
zac inv scannow
These commands are used to manage local users and their privileges.
Adds a local user to the ZENworks privilege store.
Example:
zac ua username
Deletes a local user from the ZENworks privilege store.
Example:
zac ud username
Lists the following:
Example:
zac ul
Edits the local user privileges. You use + (plus) to add a new privilege and - (minus) to remove an existing privilege.
By default, a newly created local user has the View privilege. The local users that are not added to the ZENworks privilege store inherit the privilege assigned to the default user that is represented by * (asterisk). You can change the privileges assigned to any local user and assign the user the following privileges:
|
Privilege |
Functionality |
|---|---|
|
View |
View or list the information on bundles, policies, configuration, and so on. |
|
Install |
Install or uninstall bundles, policies, packages, and so on. |
|
Configure |
Run the configuration commands. |
|
SuperUser |
Execute all the zac commands because a SuperUser is assigned all the privileges. By default, the root user is assigned the SuperUser privilege, which cannot be modified. |
Examples:
If you want to allow the local users in the ZENworks privilege store to view, install, and uninstall bundles and policies, you can assign the View and Install privileges to these users by running the following command:
zac ue username +Install
If you want to allow the local users that are not added to the ZENworks privilege store to view, install, and uninstall bundles and policies, you can assign the View and Install privileges to to the * user by running the following command:
zac ue '*' +Install
Exports a list of local users and their privileges to a specified .xml file for reusing this list on other managed devices.
Example:
zac upe /tmp/privileges.xml
After exporting the list, you can import it to other managed devices by running the user-privilege-import (upi) command.
Imports a list of local users and their privileges to other managed devices from a specified .xml file. This list can be exported to the .xml file by running the user-privilege-export (upe) command.
Example:
zac upi /tmp/privileges.xml
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
Creates a location and (optionally) assigns network environments to the location.
(location name) - The name you want assigned to the new location.
[network environment name] - The name of an existing network environment that you want to assign to the location. You can add multiple network environments. Adding network environments during creation of a location is optional. You can use the location-nwenv-assign command to add network environments after creation.
[network environment name] - The name of an existing network environment that you want to assign to the location. You can add multiple network environments. Adding network environments during creation of a location is optional. You can use the location-nwenv-assign command to add network environments after creation.
Accepts the following options:
-d |--desc=description: Specify a description for the location.
-t | -- downloadThrottle=Download Throttle rate: Specify a download throttle rate.
-u | -- uploadThrottle=Upload Throttle rate Specify an upload throttle rate.
-a | -- auditUpload=Audit upload data Specify 0 to enable or 1 to disable the audit upload data.
-e | -- Preferred protocol for communication Based on your preferred protocol for communication, specify either IPv4 or IPv6.
Specify IPv4 if you want the devices in this location to try communicating with the servers using IPv4 URLs first before attempting IPv6 URLs.
Specify IPv6 if you want the devices in this location to try communicating with the servers using IPv6 URLs first before attempting IPv4 URLs.
C | -- cifsServer=CIFS Server: Specify a CIFS server that allows you to provide share access.
-i | --proxyAddress=IPv4 HTTP Proxy Address Specify an IPv4 proxy address.
-p | --proxyPort= IPv4 HTTP Proxy Port: Specify the port number on which the proxy server should listen.
-r | --proxyCidr=IPv4 HTTP Proxy CIDR: Specify the range of IPv4 address using CIDR notation.
-x | --ipv6ProxyAddress=IPv6 HTTP Proxy Address Specify an IPv6 proxy address
-y –ipv6ProxyPort=IPv6 HTTP Proxy Port: Specify the port number on which the proxy server should listen.
-z | -- ipv6ProxyCidr=IPv6 HTTP Proxy CIDR: Specify the range of IPv6 address using CIDR notation.
Edits an existing location.
<location name>: Specify a name for the location.
Accepts the following options:
IPv4: Specify IPv4 if you want the devices in this location to try communicating with the servers using IPv4 URLs first before attempting IPv6 URLs.
IPv6: Specify IPv6 if you want the devices in this location to try communicating with the servers using IPv6 URLs first before attempting IPv4 URLs.
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
Adds a checkpoint. If the date is not specified, adds a check point with the current date.
Lists the saved checkpoints.
Removes the specified checkpoints.
Displays package information for the specified package that matches the specified pattern.
The following regular expressions are supported:
|
Regular Expression |
Functionality |
|---|---|
|
^abc |
Matches string starting with 'abc'. |
|
[abc] |
Matches string containing 'a', 'b', or 'c'. |
|
a*c |
Matches zero or more times 'a' followed by 'c', 'ac','aac','aaac',or 'c'. |
The command displays the Name, Version, Architecture, and Description of the packages.
Accepts the following options:
Installs the specified packages. If you specify a package with a version, the exact version of the package is installed. If you specify a package with a name, the best version of the package is installed.
NOTE:If you want to downgrade a package, specify the version to which you want to downgrade the package.
Accepts the following options:
The following regular expressions are supported:
|
Regular Expression |
Functionality |
|---|---|
|
^abc |
Matches string starting with 'abc'. |
|
[abc] |
Matches string containing 'a', 'b', or 'c'. |
|
a*c |
Matches zero or more times 'a' followed by 'c', 'ac','aac','aaac',or 'c'. |
Additionally, the command also lists the dependent packages to successfully complete the installation.
Displays available updates in the specified bundles and services. You can specify a single bundle or service, or multiple bundles or services for which you want to display the updates. If no bundle or service is specified, the command displays all the available updates.
Accepts the following option:
Adds a package lock rule. This command locks the specified packages, which if they match the specified regular expression or string, are not upgraded or removed. The package name can be specified individually, with wildcard patterns, or even with version number relations. The version number should be specified within single or double quotes.
|
Relational Operator |
Functionality |
|---|---|
|
= |
Locks only the specific package version. |
|
< |
Locks all versions of the package older than the specified version, excluding the specified version. |
|
> |
Locks all versions of the package later than the specified version, excluding the specified version. |
|
<= |
Locks all versions of the package older than the specified version, as well as the specified version. |
|
>= |
Locks all versions of the package later than the specified version, as well as the specified version. |
If you want to install a specific version of the package, this command first checks if the package version has been locked, then installs the package version only if it is not locked. For example, assume that all the later versions of the package “X 1.7” have been locked by using the zac la X '>' 1.7 command. If you try to install the X 1.9 package by using the zac in X (1.9) command, the installation fails.
Deletes the package lock that you specify by its number. You can find the number for each lock with the lock-list (ll) command.
Lists the package locks.
Lists package transaction history that is performed by using ZENworks. This command displays the package name, date, operation, version, and release.
Accepts the following option flags:
Removes the specified packages.
Accepts the following options:
The following regular expressions are supported:
|
Regular Expression |
Functionality |
|---|---|
|
^abc |
Matches string starting with 'abc'. |
|
[abc] |
Matches string containing 'a', 'b', or 'c'. |
|
a*c |
Matches zero or more times 'a' followed by 'c', 'ac','aac','aaac',or 'c'. |
Additionally, this command also lists the dependent packages to successfully complete the removal of the specified package.
Rolls back package transactions to the time and date you specify, if the rollback preference is set. By default, the rollback preference is disabled. You can enable the rollback preference by running the zac set rollback true command.
If you want to roll back to a particular version of the package, that version of the package and its dependencies should be available as part of the service or the assigned bundle. If the version of the package or its dependencies is not available, the rollback fails.
Additionally, this command also lists the dependent packages that are required to successfully roll back.
Accepts the following options:
Searches for packages that match the specified pattern. If no arguments are provided, it displays all the packages. This command displays the source name, source type, package name, version, and architecture.
Accepts the following options:
Updates the installed packages. You can specify a single bundle or service name, or multiple bundles or service names, for which to update the packages. If no bundle or service name is specified, all the packages are updated.
If there are installed packages that have the same name and architecture but different versions, only packages with the higher version are upgraded.
Accepts the following options:
Displays packages that provide the library, program, or package that matches the specified pattern. Only the * wildcard pattern is supported.
Example to display the packages ending with a:
zac wp *a
Lists packages that require the library, program, or package that matches the specified pattern.
An example to display packages starting with a:
zac wr a*
Scans the device for patches that are not applied, using the device's current patch signature (DAU) file. The results are then uploaded to the server.
An example to run a patch scan:
zac ps
Uploads the last scan results to the server; it does not run a new detection scan.
An example to run a quick patch scan:
zac ps --quick
Scans the device for patches that are not applied, using an updated patch signature (DAU) file. The results are then uploaded to the server.
An example to run a complete patch scan:
zac ps --complete
Updates devices with the latest version of all patch policies.
An example to run a patch apply policy:
zac pap
If you want to update the device with one or more patch policies, specify the patch policy names or IDs. An example: zac pap patch1 patch2
Releases any quarantined patches on the device where the command is run from quarantine so that a one-time installation attempt can occur, either from a patch policy schedule or a remediation schedule.
An example to run a patch quarantine release:
zac pqr
Distribute all patch policies to the device. This will attempt to distribute all patches that do not match the policy.
Distribute all patch policies to the device. An example to run a patch distribution policy: zac pdp
If you want to distribute one or more patch policies to the device, specify the patch policy names or IDs. An example: zac pdp patch1 patch2
Downloads the content associated with the specified patch names.
Syntax: zac patch-download (pd) [options]
The following are the available options:
--patch: Name of the patches that should be installed. If you want to install multiple patches, then specify the name of the patches separated by a comma.
Example: zac pd --patch patch_name1, name2, name3
Downloads the catalog used for scanning the patches.
Syntax: zac patch-download-catalog (pdc)
Exports the patch details in the catalog to the PatchMetadata.csv file.
Syntax: zac patch-export-catalog (pec)
Installs the downloaded patches.
Syntax: zac patch-install (pi) [options]
The following are the available options:
--patch: Name of the patch that should be installed.
Example 1: zac pi --patch name
Lists all the required patches.
Syntax: zac patch-list (plp) [options]
The following are the available options:
--all: List all the patches, including the installed patches.
This command returns a list of the policies that are currently enforced on the device. By default, this displays the effective (non-filtered) policies.
zac pl –all
Displays both filtered and non-filtered policies.
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
Option 1: [-a <authorization key>]
Option 2: [-k <RegKey>] <ZENworks Server address:port>
Registers the device in a Management Zone.
To execute this command you must have Create/Delete device rights for the folder that you are attempting to register.
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
To add or modify the authorization key:
zac register -a c24e-b9b42
c24e-b9b42 is the authorization key.
The port number is required only if the ZENworks Server is not using the standard HTTP port. If a username and password are not supplied, you are prompted for them.
NOTE:
The -g and -k options will not be honored if the corresponding device object is already present on the server and reconciliation takes place with that device object.
When you modify or update the GUID using the -g option, then audit and messages generated with the old GUID will be lost.
Registers a device in the current zone and assigns it the GUID of an existing device object. The currently associated device object is deleted. To execute this command you must have Create/Delete device rights for the folder you are attempting to reregister.
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
NOTE:
The -g and -k options will not be honored if the corresponding device object is already present on the server and reconciliation takes place with that device object.
When you modify or update the GUID using the -g option, then audit and messages generated with the old GUID will be lost.
Removes the device’s registration from the Management Zone. To execute this command you must have Create/Delete device rights for the folder you are attempting to unregister.
Example:
To force a device to unregister locally when a server cannot be contacted:
zac unr -f -u myuser -p mypassword
To unregister locally and suppress prompting for a user name and password:
zac unr -s
Use -a option to unregister asynchronously. With this option server deletes the device asynchronously.
The -a, -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. If -a option is specified, ZENworks server returns the unregister call quickly, but deletes the device object asynchronously from the database at a later point of time. If your device deletion is not complete and tries to register the device again, then the ZENworks server displays an error. If there is large amount of data associated with the device in the database, it might take long time to delete the device. Ensure that -a option is used when actual device deletion on server takes long time and causes the agent unregister command to timeout.
NOTE:Running the UNR command might cause high utilization of the database. This might be due to any of the following reasons:
The UNR command is running on the server.
The zone contains a large number of managed devices.
The managed devices have a huge history.
Patch Management is enabled.
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.
Remints the SSL certificate for Satellite Servers and reconfigures the Jetty web server.
Example: zac rsc
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 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.
Example:
zac iss status
Provides information about the ZENworks Agent. The following fields provide information about the ZENworks 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 ZENworks Agent contacted the ZENworks Server.
Next Contact With Server. The time scheduled for the ZENworks 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
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, ${TMPDIR}\zeninfo-${DateTime}.zip is used. If you are experiencing problems with a managed device, Micro Focus Support might ask you to run this command and send the resulting ZIP file to Micro Focus 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`
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 status of the web server.
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
Settings are downloaded by the Settings Module to the local cache on every refresh. This will return the effective settings associated with the given key.
Example:
zac gs key1
All valid ZENworks settings keys are stored in the /var/opt/microfocus/zenworks/zmd/cache/settings/ directory.
Example to list the Remote Management settings:
zac gs RemoteManagement
This command rolls up status information to the Primary Server. You can either roll up information that was updated since the last time the status was rolled-up or you can roll up the complete status information.
Examples:
To roll up status information that was updated since the last successful status roll up:
zac sts rollup
To roll up complete status information:
zac sts rollup full