3.0 Troubleshooting ZENworks Command Line Utilities

The following sections provide solutions to the problems you might encounter while working with Novell ZENworks 11 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 > or >>

Source: ZENworks 11 ; zman.
Possible Cause: zman requires the ZENworks administrator username and password for executing each command. If the credentials are not provided with the command, you are prompted to enter the same. However, if the output of the command is redirected to file, you are not prompted to enter the credentials because the prompts for username and password are also redirected to the file. Consequently, zman hangs, waiting for the credentials to be entered.
Action: Specify the credentials as part of the command by using -U|--User and -P|--Password options.
Action: Store the credentials by using the admin-store-credential command and then execute the command.
Action: Redirect the output to a file by using the -R|--Redirect option instead of a redirection operator such as > or >>.

An incorrect success message is displayed when the "stage group name" optional argument is not passed to the system-update-staging-group-create command

Source: ZENworks 11 ; zman.
Explanation: zman displays the following incorrect message if the stage group name optional argument is not passed to the system-update-staging-group-create command:
Successfully created the object "null"
Action: To view the list of staging groups that would include the newly created staging group, execute the system-update-staging-group-list (susgl) command at the console prompt.

Unable to save the report on SLES 10 SP1 by using the zman rpgn command

Source: ZENworks 11 ; 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 11 ; zman.
Explanation: If you configure the Imaging role by the using the zman ssaimg command, the role is immediately added to the device. If the role is not immediately added, it is added only during the next device refresh schedule.
Action: If you want to immediately apply the role to the device, you must manually refresh the device in one of the following ways:
  • At the command prompt, run the zman workstation-refresh|wrf command. If the managed device is a server, run the zman server-refresh|srf command.

  • On the managed device, right-click the ZENworks icon icon, then click Refresh.

The zman commands do not work for non-root users on a ZENworks Linux server

Source: ZENworks 11 ; zman.
Explanation: If a non-root user executes the zman commands on a ZENworks Linux server, the following error message is displayed:

You do not have sufficient privileges to run zman commands. As a non-root user in Linux, you should be part of the zmanusers group to run zman commands.

Action: Add the non-root user to the zmanusers group before executing the zman commands.
  1. Log in to the ZENworks server as root.

  2. At the server console prompt:

    • If the user already exists on the Linux device, execute the following command:

      groupmod -A non-rootusername zmanusers

    • If the user does not exist on the Linux device, execute the following command:

      useradd -G zmanusers non-rootusername

  3. Log in to the ZENworks server as a non-root user.

A non-root user is unable to configure a Satellite role by using the zman ssc command

Source: ZENworks 11 ; zman.
Explanation: If a non-root user tries to configure a Satellite role by using the zman ssc command on a Linux Primary Server, the following error message is displayed:
The role you specified (Satellite_role_name) is not a valid satellite server role. Valid roles are:
ZoneConfig.ROLE_COLLECTION
ZoneConfig.ROLE_CONTENT
ZoneConfig.ROLE_AUTHENTICATION
Action: Do the following:
  1. Ensure that the non-root has been added to the zmanusers group.

    1. Log in to the ZENworks server as root.

    2. At the server console prompt:

      • If the user already exists on the Linux device, execute the following command:

        groupmod -A non-rootusername zmanusers

      • If the user does not exist on the Linux device, execute the following command:

        useradd -G zmanusers non-rootusername

  2. Add the non-root user to the ZENworks user group by using the usermod -A non-root_username command. Subsequently, the non-root user can configure Satellite roles.

Unable to use the zman sui command to import the ZENworks system update to a ZENworks Server, on an RHEL-5.x Server

Source: ZENworks 11; zman.
Explanation: On an RHEL-5.x server, if the size of the system update zip file is more than 2 GB, unzipping does not work, and you cannot import the system update by using the zman sui command.
Action: Perform the following steps:
  1. Navigate to the Red Hat vvitek directory.

  2. Install unzip-5.52-3.0.bz497482.el5_7.i386.rpm on the RHEL 5.x server.

  3. Run the rpm -Uvh unzip-5.52-3.0.bz497482.el5_7.i386.rpm command.

  4. Run the zman sui <zip file path> command.