9.6 Adding and Removing Bundle Locks

You can configure bundle locks for Linux and Patch bundles on the managed devices to prevent them from being installed.

You can add or remove bundle locks either by using the ZENworks Icon or from the command line utility.

--lock-install option locks the bundle and prevents the installation of the bundle that is specified in the lock. The Deny Install column of zac bundle-lock-list command displays the value of the configured lock-install option.

This section describes how to add or remove bundle locks by using the command line utility.

For more information on how to lock or unlock packages by using the ZENworks Icon, see the ZENworks Command Line Utilities Reference.

9.6.1 Adding a Bundle Lock

Bundle locks are applicable only for Install action set.

  1. List all the bundles installed on the managed device by using the zac bundle-list command. From the list, select the bundle you want to lock.

  2. Lock the bundle by using the zac bundle-lock-add [options] bundle_name command.

    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'.

    For more information on this command, see the ZENworks Command Line Utilities Reference.

  3. Ensure that the bundle is locked by entering the zac bundle-lock-list command. This displays all the locked bundles except those that are locked on the server by the administrator.

9.6.2 Removing a Bundle Lock

  1. List all the bundles that are locked on the managed device by using the zac bundle-lock-list command. This displays the bundle name and the bundle lock index.

  2. Select the bundle that you want to unlock.

  3. Remove the bundle lock by using the zac bundle-lock-remove [options] bundle_index command.

    For more information on this command, see the ZENworks Command Line Utilities Reference.

  4. Ensure that the lock for the bundle is removed by entering the zac bundle-lock-list command. This displays only the locked bundles.

9.6.3 Impact of a Bundle Lock on Bundle Operations

Depending on the value of the configured lock-install option and the status of the bundle, the following table describes the impact of bundle operations when you add a bundle lock:

Bundle Operations

With lock-install

Without lock-install

Install

You cannot install or upgrade a new version of the bundle.

When you assign a bundle to an Agent, you can successfully install a bundle for the first time. You cannot upgrade to a new version of the bundle.

Launch

If a bundle is already in the installed state when you add the bundle lock, then you can launch only the installed version of the bundle. If a bundle is not installed when you add the bundle lock, then you cannot launch the bundle.

If a bundle is already installed, you can launch the installed version of the bundle. If an earlier version of the bundle is already installed but a later version of the bundle is assigned, then you cannot launch the assigned new version of the bundle. If a bundle is not installed, then the assigned bundle is automatically installed before being launched.

Repair

If a bundle is already in the installed state when you add the bundle lock, then you can repair the installed version of the bundle. If a bundle is not installed when you add the bundle lock, then you cannot repair the bundle.

If a bundle is not installed, then you can install the bundle. If a version of the bundle is already installed, then only the installed version of the bundle is repaired.

Uninstall

You cannot uninstall a bundle.

You cannot uninstall a bundle.