Download Print this page

Novell ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - COMMAND LINE UTILITIES REFERENCE 10.3 30-03-2010 Command Reference Manual

Command line utilities reference
Hide thumbs Also See for ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - COMMAND LINE UTILITIES REFERENCE 10.3 30-03-2010:

Advertisement

AUTHORIZED DOCUMENTATION
Command Line Utilities Reference
Novell
®
ZENworks
10 Configuration Management SP3
®
10.3
March 30, 2010
www.novell.com
ZENworks 10 Configuration Management Command Line Utilities Reference

Advertisement

loading
Need help?

Need help?

Do you have a question about the ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - COMMAND LINE UTILITIES REFERENCE 10.3 30-03-2010 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Novell ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - COMMAND LINE UTILITIES REFERENCE 10.3 30-03-2010

  • Page 1 AUTHORIZED DOCUMENTATION Command Line Utilities Reference Novell ® ZENworks 10 Configuration Management SP3 ® 10.3 March 30, 2010 www.novell.com ZENworks 10 Configuration Management Command Line Utilities Reference...
  • Page 2 Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
  • Page 3 Novell Trademarks For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/ trademarks/tmlist.html). Third-Party Materials All third-party trademarks are the property of their respective owners.
  • Page 4 ZENworks 10 Configuration Management Command Line Utilities Reference...
  • Page 5 Contents About This Guide 1 ZENworks Command Line Utilities 2 Command Line Utilities for Linux Satellites 3 ZENworks Diagnostic Center Downloading and Extracting ZDC ..........99 Running ZDC .
  • Page 6 ZENworks 10 Configuration Management Command Line Utilities Reference...
  • Page 7 ZENworks 10 Configuration Management documentation (http:// www.novell.com/documentation/zcm10/). Documentation Conventions In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path. ® A trademark symbol ( , etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party trademark.
  • Page 8 ZENworks 10 Configuration Management Command Line Utilities Reference...
  • Page 9 ZENworks Command Line Utilities ® ® The following sections give information on the Novell ZENworks 10 Configuration Management command line utilities: “zman(1)” on page 10 “zeninfocollect(1)” on page 78 “zac(1)” on page 80 ZENworks Command Line Utilities...
  • Page 10 Name zman - The command line interface to Novell ZENworks 10 Configuration Management, which provides comprehensive server, workstation, and user management, and to Novell 10 Asset Management, which provides software and hardware inventory of servers and workstations, software usage tracking, and software license compliance.
  • Page 11 Options Options are of two types: switches and flagged options. Both have a short and long form. The short form is preceded by a single hyphen and the long form is preceded by two hypens. For example, -n and --namefilter are the short and long forms of a flagged option used to filter the display of results by name for the bundle-list command.
  • Page 12 Folders If no folder is specified for commands that take a folder argument, the command targets the root folder. To specify a folder path, list each folder from the root separated by a forward slash For example, if you have a folder named in the root, containing a subfolder (/).
  • Page 13 asset-management-load-purchase-record (amlpr) Loads a purchase record file. The Purchase Record Loader looks for the purchase record file to load on the primary server in the folder ZENWORKS_HOME/temp/PurchaseRecordImport/ . If you have not yet used the Purchase Record Loader from ZENworks Control uploaded Center, you need to create this folder.
  • Page 14 -n, --namefilter=[filter string] - Displays results matching the specified name. The wildcards * and ? can be used if they are enclosed in quotation marks. -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time. admin-list-roles (alr) [options] (ZENworks administrator name) Lists roles assigned to a ZENworks administrator account.
  • Page 15 (file path) [...] - The path of the text files containing zman commands to be executed. Lines starting with are considered as comments, and are not processed. For a sample file, refer to located in BatchExecuteCommands.txt /opt/novell/zenworks/ on a Linux server or share/zman/samples/batch on a Windows Installation_path:\Novell\Zenworks\share\zman\samples\batch server.
  • Page 16 Install Bundle Action needs to be specified for proper functioning of these actions. For the XML format template, refer to located in ActionInfo.xml /opt/novell/zenworks/share/zman/samples/ on a Linux server or bundles Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server. bundles bundle-assign (ba) [options] (device or user type) (bundle or bundle group) (device or user object path) [...]...
  • Page 17 -a, --availability-schedule=[availability schedule XML file] - XML file that contains the availability schedule. For the schedule XML file templates, refer to the XML files located in on a Linux server or /opt/novell/zenworks/share/zman/samples/schedules Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server. schedules -i, --install-immediately - Installs the bundle immediately after distribution.
  • Page 18 XML files can be created from bundles that were created through ZENworks Control Center. For a sample XML file, refer to located WindowsMSIBundle.xml on a Linux server or /opt/novell/zenworks/share/zman/samples/bundles on a Installation_directory:\Novell\Zenworks\share\zman\samples\bundles Windows server. Accepts the following options: -d, --desc=[description] - Description for the bundle.
  • Page 19 Accepts the following option: -f, --folder=[bundle folder] - The path of a bundle folder relative to . If this option is /Bundles specified, the path of the bundle objects is determined relative to this folder. This can be used to specify multiple bundle objects under the same folder. bundle-export-actions (bea) (bundle path) (XML file path) (action set type) [action's positions] [...] Exports the actions added to a bundle's action set to a file.
  • Page 20 Accepts the following option: -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time. bundle-group-remove (bgr) [options] (bundle group path) (bundle path) [...] Removes bundles from a bundle group. Accepts the following option: -f, --folder=[bundle folder] - The path of a bundle folder relative to .
  • Page 21 (action set type) - The type of the action set that contains the action. Valid values are Install , and Launch Verify Uninstall Terminate Preboot [action's positions] [...] - A comma-separated list of position of actions in the action set. The first action is at position 1.
  • Page 22 -I, --icon-location=[application location XML file] - XML file that contains the locations to place the icon for the bundle application. For the XML file format, refer to located in IconLocation.xml /opt/novell/zenworks/share/zman/samples/bundles on a Linux server or Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server.
  • Page 23 ] - XML file that NoSchedule contains the availability schedule or if the schedule must be removed. For the NoSchedule schedule XML file templates, refer to the XML files located in /opt/novell/zenworks/ on a Linux server or share/zman/samples/schedules Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server. schedules -i, --install-immediately=[yes or no] - Install the bundle immediately after distribution, or remove the same option set during bundle assignment.
  • Page 24 -n, --namefilter=[target device name] - Filters on the name of the device. Displays options matching the specified filter. The wildcards * and ? can be used if they are enclosed in quotations. --statusfilter=[status type][...] - Filters on the status of Bundle Distribution and Install Events. Valid values are S, F, and P (Success, Failure, and Pending).
  • Page 25 [schedule SQL file] - File that contains the schedule for backing up the database. The SQL file can contain CREATE EVENT, ALTER EVENT, or DROP EVENT SQL statements. For sample SQL files, refer to the files located in /opt/novell/zenworks/share/zman/ on a Linux server or samples/database...
  • Page 26 (CSV) format, or one IP address or DNS name on each line. -s, --schedule=[launch schedule XML file] - XML file that contains the launch schedule. For the schedule XML file templates, refer to the XML files located in /opt/novell/ on a Linux server or zenworks/share/zman/samples/schedules Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server.
  • Page 27 -t, --timeout=[Time out] - The number of seconds you want the Primary Server to wait for a response from the Windows Proxy. -k, --key=[Registration key] - Registration key for registering the device. deployment-task-delete (dptd) (deployment task name) [...] Deletes the deployment task. deployment-task-list (dptl) [options] Lists the deployment tasks and the status.
  • Page 28 Accepts the following options: -n, --namefilter=[filter string] - Displays results matching the specified name. The wildcards * and ? can be used if they are enclosed in quotation marks. -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time. discovery-task-run-now (dtrn) (discovery task name) Executes the specified discovery task immediately.
  • Page 29 [-f|--folder=folder name including path of the dynamic group folder] - Dynamic group folder’s name, including its full path. [-a|--all] - Refresh all existing dynamic groups. Hotlist Command This command is used to view the list of devices that have unacknowledged warnings or errors. The command begin with in the long form, or with the letter in the short form.
  • Page 30 where is the relative path of the device within the folder/path of device Workstation folder. Server If you have multiple workstations in a directory, and the name of the workstations is prepended by common alphanumeric characters (for example, dev091, dev092,...dev099), use the following command from a Linux server to simultaneously apply the assigned imaging bundle on multiple devices: zman iaaib workstation folderx/dev{09{1,2,3,4,5,6,7,9}}...
  • Page 31 license-refresh (lr) Forces the system to refresh the stored license cache, which is normally updated once per day. Use this command to update the cache at any time, such as when an evaluation license might expire and the cache doesn’t yet reflect that. license-show-active-components (lsac) Lists the current license states of all known ZENworks Configuration Management components and DataModel plug-ins (two separate lists).
  • Page 32 -s, --source - Path of the device or device folder starting with from which Closest /Devices Server rules are to be exported. If not specified, all Closest Server rules will be exported. Examples: To export the Closest Server rules for folder /Devices/Servers C:\rules.xml zman loctf -s /Devices/Servers C:\rules.xml...
  • Page 33 -b, --begin-date=[message logged date] - Messages logged on and after this date are acknowledged. The format for the date is YYYY-MM-DD. -e, --end-date=[message logged date] - Messages logged on and before this date are acknowledged. The format for the date is YYYY-MM-DD. -a, --all - Acknowledges all messages logged for the object.
  • Page 34 -c, --count - Displays only the count of the messages. -o, --sort-order=[sort order] - Sorts the messages based on date, severity, and acknowledged. -A, --asc - Specifies the direction of sorted listing. The default is descending order. -d, --detailed - Returns more information about the messages. -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time.
  • Page 35 For example, the driver file to be installed for a Printer policy is the file content. For the XML format template, refer to ActionInfo.xml located in on a Linux server or /opt/novell/zenworks/share/zman/samples/policies Installation_directory:\Novell\Zenworks\share\zman\ on a Windows server. samples\policies policy-copy (pcp) [options] (policy path) (policy name) [parent folder] Copies a policy.
  • Page 36 Accepts the following option: -f, --folder=[policy folder] - The path of a policy folder relative to . If this option is /Policies specified, the path of the policy objects is determined relative to this folder. This can be used to specify multiple policy objects under the same folder. policy-export-to-file (petf) (policy path) (XML file path) Exports a policy's information (in XML format) to a file.
  • Page 37 Accepts the following option: -f, --folder=[policy folder] - The path of a policy folder relative to . If this option is /Policies specified, the path of the policy objects is determined relative to this folder. This can be used to specify multiple policy objects under the same folder. policy-list (pl) [options] [folder] Lists policy objects.
  • Page 38 policy-settings-export-to-file (psetf) [options] (XML file path) [settings name] [...] Exports settings data (in XML format) to a file. The XML file is to be used as input for creating or modifying settings. (XML file path) - The file into which the settings data is stored in XML format. If the file does not exist, a new file is created.
  • Page 39 policy-view-advanced-deployment-status (pvads) [options] (policy path) Displays the advanced deployment status of a policy. Accepts the following options: -d, --device=[device path] - Displays the deployment status only for the specified device. The path of the device is relative to /Devices -u, --user=[user path] - Displays the deployment status for the specified user only. The path of the user is relative to .
  • Page 40 Queue Commands These commands are used when you need to make modifications to the queue. The queue processes asynchronous events such as client refreshes and content cleanup, and does not need to be modified under most circumstances. Queue commands begin with in the long form, or with the letter queue- in the short form.
  • Page 41 registration-create-key (rck) [options] (device type) (registration key) [registration folder path] Creates a new registration key. (device type) - Type of the registering device. Valid values are server workstation Accepts the following options: -f, --devicefolder=[device folder] - The path of the device folder relative to the root folder of the device type specified.
  • Page 42 -n, --namefilter=[filter string] - Displays results matching the specified name. The wildcards * and ? can be used if they are enclosed in quotation marks. -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time. registration-list-device-groups (rldg) (registration key)(rd) Lists the device groups associated with a registration key.
  • Page 43 report-add-user (rpau) (Username) Adds a new user account to the ZENworks Reporting Server. (Username) - The name of the user to be added to the ZENworks Reporting Server. report-copy (rpc) [options] (report name) (report folder) (report type) Copies a report. (report folder) - Path to the folder containing the report.
  • Page 44 report-deploy (rpd) (file path) (destination folder) [report type] Deploys reports to the ZENworks Reporting Server. The reports are created on the ZENworks Reporting Server with the same name as the report file. (destination folder) - The folder to which reports are to be deployed. [report type] - Filters on the type of the reports to be deployed when a folder containing report files is specified.
  • Page 45 -e, --end-time=[end time] - Filters the report instances generated before a given time. Specify the time in the format of YYYY-MM-DD HH:MM enclosed in double quotation marks. -i, --instance-id=[report instance ID][...] - Displays the ID of the report instances to be exported.
  • Page 46 report-save (rpsv) (destination folder) Saves the reports, reporting rights, and the ownership details from the local ZENworks Reporting Server to the specified folder. The reporting rights are saved in the file rights.xml within the specified folder. The ownership details of objects such as Folders or Reports created in the ZENworks Reporting Server InfoView are saved in the file within the ownership.xml...
  • Page 47 -f, --folder=[folder name] - Full path of a folder. If this option is specified, the path of the objects is determined relative to this folder. This provides convenience if you want to specify multiple objects under the same folder. -H, --Help - Displays detailed help about the categories of rights available, and the root folders of the object types on which the rights can be enforced.
  • Page 48 role-rights-delete (rlrd) (role name) [rights category] Deletes rights assigned to a ZENworks administrator role. [rights category] - Name of the category within which the rights are grouped. To see the list of categories, run zman role-rights-set --Help | more role-rights-info (rlri) [options] (role name) Displays rights assigned to a ZENworks administrator role.
  • Page 49 - Valid operators are Contains, StartsWith, EndsWith and Equals. value - The format and contents of value are determined by the attribute. For a sample, see the file located in AddRulesToRuleSet.txt /opt/novell/zenworks/share/zman/ on a Linux server or samples/rulesets Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server.
  • Page 50 ruleset-info (rsi) (name or position) Displays detailed information about a rule set. ruleset-list (rsl) Lists all rule sets. ruleset-list-device-groups (rsldg) (name or position) Lists the device groups associated with a rule set. ruleset-move (rsmv) (name or position) (new position) Changes the position of a rule set. ruleset-remove-device-groups (rsrdg) [options] (device type) (name or position) (device group path) [...] Removes the association of device groups to a rule set.
  • Page 51 satellite-server-add-content-replication-setting (ssacrs) [options] (Path To Device) (Content Type) (file path) Add a content type replication schedule and throttle setting to the Satellite device. (Path To Device) - The full name of the satellite device to which to add the replication setting. (Content Type) - The name of the content type for the replication setting to add to the satellite device.
  • Page 52 satellite-server-delete (ssd) (Managed device) [(role),(role),...(role)] Allows you to delete Satellite roles from the device. If all roles are removed, the device will be automatically delisted from the Server Hierarchy listing in ZENworks Control Center. Accepts the following options: (Managed device) - The full name of the managed device from which to delete the Satellite roles.
  • Page 53 (Path To Device) - The full name of the satellite device from which to export the replication setting schedule. (Content Type) - The name of the content type for the replication setting to export from the satellite device. (file path) - The full path to a file to which to export the schedule data. satellite-server-list-authentication-settings (sslas) (path to device) Lists the authentication role settings on a Satellite device.
  • Page 54 -I, --icon-location=[application location XML file] - XML file that contains the locations to place the icon for the bundle application. For the XML file format, refer to located in IconLocation.xml /opt/novell/zenworks/share/zman/samples/bundles on a Linux server or Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server.
  • Page 55 To use this option, you must also specify the Distribution schedule. The Distribution schedule can be specified by using the --distribution-schedule, --distribute-now, or --distribute-on- device-refresh option. -n, --distribute-now - Sets the distribution schedule to distribute the bundle immediately. If this option is specified, the --distribution-schedule and --distribute-on-device-refresh options are ignored.
  • Page 56 server-delete (sd) [options] (server object path) [...] Deletes one or more server objects. (server object path) [...] - The path of the server objects (server, server folder or server group) relative to . The wildcard * can be used in the object names if it is enclosed /Devices/Servers in quotation marks.
  • Page 57 server-info (si) (server path) Lists detailed information about a server. server-list (sl) [options] [folder] Lists server objects. Accepts the following options: -r, --recursive - Lists results recursively including subfolders. If this option is not specified, the contents of the subfolders are not listed. -n, --namefilter=[filter string] - Displays results matching the specified name.
  • Page 58 server-remove-bundle (srb) [options] (server object path) (bundle or bundle group) [...] Removes bundles assigned to a server object. Accepts the following option: -f, --folder=[bundle folder] - The path of a bundle folder relative to . If this option is /Bundles specified, the path of the bundle objects is determined relative to this folder.
  • Page 59 server-view-all-policies-status (svaps) [options] (server path) Displays the advanced deployment status of policies assigned to a server. Accepts the following options: --statusfilter=[status type][...] - Filters on the status of Policy Apply Event. Valid values are S, F, and P (Success, Failure, and Pending). A comma-separated list of status types can be given.
  • Page 60 settings-export-to-file (setf) [options] (XML file path) [settings name] [...] Exports settings data (in XML format) to a file. The XML file is to be used as input for creating or modifying settings. (XML file path) - The file into which the settings data is stored in XML format. If the file does not exist, a new file is created.
  • Page 61 system-update-authorize (suaz) (system update or PRU name) Authorizes an update or PRU. (system update or PRU name) - System update or PRU name or UID. system-update-baseline (sub) (system update name) Schedules an attempt to set the specified update as the baseline update. (system update name) - System update name or UID.
  • Page 62 -I, --icon-location=[application location XML file] - XML file that contains the locations to place the icon for the bundle application. For the XML file format, refer to l located in IconLocation.xm /opt/novell/zenworks/share/zman/samples/bundles on a Linux server or Installation_directory:\Novell\Zenworks\share\zman\samples\ on a Windows server.
  • Page 63 To use this option, you must also specify the distribution schedule. The distribution schedule can be specified by using the --distribution-schedule, --distribute-now, or --distribute-on- device-refresh option. -n, --distribute-now - Sets the distribution schedule to distribute the bundle immediately. If this option is specified, the --distribution-schedule and --distribute-on-device-refresh options are ignored.
  • Page 64 user-group-delete (ugd) (ZENworks user group path) [...] Deletes one or more ZENworks user groups. (ZENworks user group path) [...] - The path of the ZENworks user group relative to /Users/ ZENworks User Groups user-group-members (ugm) [options] (user group path) Lists members of a ZENworks user group or LDAP Directory user group. Accepts the following option: -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time.
  • Page 65 user-list-policies (ulp) [options] (user object path) Lists policies assigned to a user object. -a, --all - Lists both effective and non-effective policies. -e, --effective - Lists only effective policies. -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time. user-logged-in-devices (ulid) (user path) Displays the devices on which a user is logged in.
  • Page 66 user-source-create (usc) [options] (user source XML file path) Configures a user source. Accepts the following option: -a, --accept-certificate - Accepts the certificate presented by the user source when SSL mode is chosen. This option is provided to avoid interactive mode for scripting. It is advisable to view the certificate and then accept it.
  • Page 67 For the schedule XML file templates, refer to the XML files located in on a Linux server or /opt/novell/zenworks/share/zman/samples/schedules Installation_directory:\Novell\Zenworks\share\zman\samples\ schedules a Windows server. -i, --install-immediately - Installs the bundle immediately after distribution. To use this option, you must also specify the distribution schedule. The distribution schedule can be specified by using the --distribution-schedule, --distribute-now, or --distribute-on- device-refresh option.
  • Page 68 -C, --retries=[Number of retries] - Number of times the Wake-On-LAN magic packets are sent to the device. This option is used only if you choose to wake up the device by using Wake-On-LAN. The value must be between 0 and 5. The default value is 1. -T, --timeout=[Time interval between retries] - The time interval between two retries.
  • Page 69 Accepts the following option: -f, --folder=[workstation folder] - The path of a workstation folder relative to /Devices/ . If this option is specified, the path of the workstation objects is determined Workstations relative to this folder. This can be used to specify multiple workstation objects under the same folder.
  • Page 70 -s, --scrollsize=[scrollsize] - Number of results to be displayed at a time. -f, --flagfilter=[flag filter][...] - Displays results matching the comma-separated list of flags specified. Valid values are retired notretired workstation-list-bundles (wlb) [options] (workstation object path) Lists bundles assigned to a workstation object. Accepts the following options: -a, --all - Lists both effective and non-effective bundles.
  • Page 71 Accepts the following option: -f, --folder=[policy folder] - The path of a policy folder relative to . If this option is /Policies specified, the path of the policy objects is determined relative to this folder. This can be used to specify multiple policy objects under the same folder. workstation-rename (wr) (workstation object path) (new name) Renames a workstation object.
  • Page 72 -f, --folder=[workstation folder] - The path of a workstation folder relative to /Devices/ . If this option is specified, the path of the workstation objects is determined Workstations relative to this folder. This can be used to specify multiple workstation objects under the same folder.
  • Page 73 zenserver-unretire (zsuret) (server object path) Reactivates the selected server at its next refresh to once again be a Primary Server and reapplies all policy and bundle assignments that the device previously had. Accepts the following option: -i, --immediate - Forces a device refresh to immediately unretire the device. Global Options The following options can be applied to any zman command: -h, --help, ?, -?, /?
  • Page 74 DEBUG_LEVEL: Controls the volume of debug messages logged into the file located zman.log in Windows and Installation_drive:\Novell\zenworks\logs /var/opt/novell/log/ in Linux. Level 3, which is the default, logs the command entered and exception stack zenworks traces if any errors are encountered. Level 4 logs the command entered, the output of the command, and more debug messages.
  • Page 75 Exit Codes zman returns exit codes in the range of 0-255. 0 indicates successful execution of the command; 1- 255 indicate an error in execution. 0 - Success. Exit Codes for Parse Errors: 1 - An unknown parsing error has occurred. 2 - A mandatory argument is not specified.
  • Page 76 33 - The object type is invalid to assign to a device or user. 34 - Assignment of the object to the device is not allowed. For example, the user-specific policy cannot be assigned to a device. Exit Codes for Other General Errors: 41 - The specified name is invalid.
  • Page 77 Exit Codes Specific to Report Commands: 136 - Failed to delete the report. 137 - Failed to submit a request for the report generation. 138 - Invalid report document. Authors Copyright 2005-2010, Novell, Inc (http://www.novell.com). All rights reserved. ZENworks Command Line Utilities...
  • Page 78 Name zeninfocollect - A utility that lets you gather information to help you resolve problems that might arise when using Novell ZENworks 10 Configuration Management or ZENworks 10 Asset Management. Syntax ./zeninfocollect.py <options> Description By default, zeninfocollect gathers cache, server, client, configuration, hardware, and package data as well as log files.
  • Page 79 Do not collect package data. Package data includes all version information for packages in the ZENworks 10 Configuration Management package repository. --no-server Do not collect server data. Authors Copyright 2005-2010, Novell, Inc (http://www.novell.com). All rights reserved. ZENworks Command Line Utilities...
  • Page 80 Name zac - The command line management interface for the Novell ZENworks Adaptive Agent. Syntax zac command options Description 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.
  • Page 81 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.
  • Page 82 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” 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.
  • Page 83 Example: zac cic c:\import_source_directory -l:"C:\Program Files\Novell\ZENworks\logs\cic.log” wake-cdp (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.
  • Page 84 Inventory Commands inventory (inv) inventory [scannow | cdf] 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 Location Commands config-location (cl) Displays the configuration location.
  • Page 85 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 Policy Commands policy-export (pe) <policy type>...
  • Page 86 - Lets you specify the Management Zone administrator’s username. 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).
  • Page 87 (unr) [-f] [-u <username> -p <password>] Removes the device’s registration from the Management Zone. Example: zac unr -u administrator -p novell , and parameters are optional. If you don’t use the parameters, you are prompted to enter a username and password. The parameter ignores the ZENworks database and forces the device to be unregistered locally;...
  • Page 88 ${TEMP}\zeninfo-${DateTime}.zip is used for Linux. If you are experiencing problems ${TMPDIR}\zeninfo-${DateTime}.zip 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. zone-config (zc) [-l] 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.
  • Page 89 Command Line Utilities for Linux Satellites The following section provides information about the command line utilities for Linux Satellites: “zac(1)” on page 90 Command Line Utilities for Linux Satellites...
  • Page 90 Name zac - The command line management interface for the Novell Linux Satellites. Syntax zac command options Description The zac utility performs command line management functions on ZENworks unmanaged devices, including Satellite configuration, and registering and unregistering the device.
  • Page 91 Authentication Satellite Server Commands authentication server reconfigure (asr) [-t all|config|jetty|casa] [-u username] [-p password] 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:...
  • Page 92 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 distribution-info (cdi) [option] Displays statistical information about the Content role. You can use the following options: - Executes all options marked with *.
  • Page 93 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/ directory. cache/settings/ get-pref (get) <preference name> Displays the preferences that are currently set. Example to display all preferences that are set:...
  • Page 94 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: - Specifies the proxy server to use to tunnel the HTTP requests.
  • Page 95 -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.
  • Page 96 satellite-roles (satr) Reports on current Satellite roles and their state. Example: 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.
  • Page 97 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 Authors Copyright 2009-2010, Novell, Inc. All rights reserved. http://www.novell.com Command Line Utilities for Linux Satellites...
  • Page 98 ZENworks 10 Configuration Management Command Line Utilities Reference...
  • Page 99 ZENworks Diagnostic Center ® ® Novell ZENworks 10 Configuration Management SP3 provides a new tool called as ZENworks Diagnostic Center that helps you to verify the health of the Primary Servers and the Management Zone before deploying a system update.
  • Page 100 Update for ZENworks 10 Configuration Management SP2 (10.2.2). The baseline data for ZENworks 10 Configuration Management SP2 or later is available at the Novell User Communities Web site (http://www.novell.com/communities/node/ 9479/zenworks-diagnostics-center). ZDC executable The executable and other configuration files required to run ZDC are included in the zdc_0.5_beta_20100318.zip...
  • Page 101 On Linux: ./zdc verify -v zencontent You can also specify the following command options while running ZDC. -s: session name -l: complete path of the ZDC log filename -r: complete path of the ZDC directory report ZDC runs the diagnostic tests and generates the reports in the HTML format. The reports are stored in the directory on a Windows Primary Server and in the $ZDC_Home/reports/timestamp...
  • Page 102 102 ZENworks 10 Configuration Management Command Line Utilities Reference...
  • Page 103 Command Line Utilities The following sections provide solutions to the problems you might encounter while working with ® ® Novell ZENworks command line utilities: “zman hangs when the output of a command is redirected to a file by using the command line redirection operators such as >...
  • Page 104 Unable to save the report on SLES 10 SP1 by using the zman rpgn command Source: ZENworks 10 Configuration Management; zman. Action: None. The Imaging role added to a Satellite by using the zman ssaimg command is not immediately applied to the server Source: ZENworks 10 Configuration Management;...
  • Page 105 Guidelines for Working with Zman ® ® Follow these guidelines as you work with the zman command line utility of Novell ZENworks Configuration Management: If an XML file that is exported by using the zman commands such as bundle-create contains diacritic or extended ASCII characters such as ñ,ë, and Ä, you must policy-create open the file in an editor using the UTF-8 encoding.
  • Page 106 106 ZENworks 10 Configuration Management Command Line Utilities Reference...
  • Page 107 Documentation Updates This section contains information on documentation content changes that were made in this ® ® Command Line Utilities Reference for Novell ZENworks 10 Configuration Management SP3. The information can help you to keep current on updates to the documentation.
  • Page 108 Location Change “Satellite Commands” on The following zman information has been added: page 50 Added the satellite-server-add-content- replication-setting command to add a content type replication schedule and throttle setting to the Satellite device. Added the satellite-server-configure- authentication-user-source command to configure the user source connections used by a Satellite with the Authentication role.
  • Page 109 Location Change Chapter 3, “ZENworks Added entire section. Diagnostic Center,” on page 99 Documentation Updates 109...
  • Page 110 110 ZENworks 10 Configuration Management Command Line Utilities Reference...

This manual is also suitable for:

Zenworks 10 configuration management sp3