rug - The command line interface for the Novell ZENworks Linux Management Agent.
rug is the command-line interface to the ZENworks Linux Management agent. It works with the ZENworks Linux Management daemon to install, update, and remove software according to the commands you give it. The software that it installs can be from ZENworks 7.x Linux Management, ZENworks 6.6.x Linux Management servers, YUM repositories, the ZYPP service, as well as local files.
ZENworks Linux Management servers sort software by category into catalogs, which are groups of similar software. For example, one catalog can contain software from the operating system vendor, and another catalog can contain the SUSE Linux Enterprise Desktop. You can subscribe to individual catalogs to control the display of available packages and prevent the accidental installation of unwanted software. By default, all operations are performed on software from within catalogs to which you are subscribed, although you may alter this with the --allow-unsubscribed flag. The rug utility also provides other features, such as rollback, locks, history and preferences to easily manage packages and bundles.
Depending on the type of managed device, the location of the rug utility varies.
For SUSE Linux Enterprise Server 10 (SLES 10) and SUSE LINUX Enterprise Desktop 10 (SLED 10) devices, the rug utility is located in the following directory:
/usr/bin
On all other managed devices, the rug utility is installed in the following location:
/opt/novell/zenworks/bin
This section contains a guide to general command formatting and conventions.
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 folder1 in the root, containing a subfolder named subfolder1, you would reference this folder as folder1/subfolder1. Each specified folder must already exist.
An ellipsis indicates that a command accepts multiple entries of the last argument type. For example, the ellipsis in the following command indicates that catalog-add-bundle can accept multiple bundles:
rug bundle-history [options] [search-string] [...]
Commands that do not have command-specific options (they accept only the standard option flags) do not have options listed as an argument in the command reference. For example, the reference entry for the following command does not list options because it accepts only the standard flags:
rug list-updates (lu) [catalog]
However, the following command lists options because the command has a command-specific option (-a):
rug bundle-history [options] [search-string] [...]
rug provides a number of commands (shown as [command] in the Syntax section). Each command accepts the option flags listed in the Global Options section. In addition, many commands have specific option flags that are listed with the commands.
The most commonly used command is rug update which downloads and installs updates in catalogs to which you are subscribed.
Searches the bundle log entries for the strings specified by [search-string]. Accepts the following option flags:
Installs the specified bundles. rug attempts to find the specified bundles in catalogs to which you are subscribed. Use bundle-upgrade to upgrade a bundle that you already have installed. Accepts the following option flags:
NOTE:The -N and -r options is not applicable for File bundles.
Lists available bundles in catalogs to which you are subscribed.
The output for this command is presented in the following columns: Status, Catalog, Name, Version, and Type. The columns provide the details of every bundle assigned or available for the managed device. The Catalog, Name, Version, and Type represent the catalog name, bundle name, bundle version, and bundle type respectively.
The Status field is empty if the bundle is not installed, displays “i” if the bundle is installed, “v” if the bundle is installed but is of a different version compared to the one displayed in the list, and “*” if the bundle is partially installed.
By default, the command shows the display bundle name.
Accepts the following option flags:
Adds a bundle lock rule. This prevents changes to the installation state of the bundle that is not specified in the lock. The bundle name can be specified individually, with wildcard patterns, or even with version number relations. For example, the command rug bla gnome* refuses to remove any bundles beginning with “gnome”. Accepts the following options:
-c, --catalog - Catalog to match in lock.
Deletes the bundle lock you specify by its number. You can find the numbers for each bundle lock with the lock-list (bll) command.
Lists the locks that have been put in place. Locks are sorted by ID number.
Removes the specified bundles. Accepts the following option flags:
NOTE:The -N and -r options are not applicable for File bundles.
Searches for bundles matching the query string. Accepts the following option flags:
Lists the available bundle types.
Upgrades the bundles. Accepts the following option flags:
NOTE:The -N and -r options are not applicable for File bundles.
Lists the catalogs available for the services you have added. Accepts the following option flags:
-u, --uri - Show the service uri.
Subscribes to the specified catalogs. Each specified catalog must be available from one of the services you have added. Accepts the following option flags:
Unsubscribes the specified catalogs. Accepts the following option flags:
Shows the files in a given file bundle. Accepts the following option flag:
The Status column is empty if the file is not installed. It displays “i” if the file is installed,“c” if the file is in the compressed form, or “p” if the file is of a lower version than that installed on the device.
Shows the packages in a given bundle. Accepts the following option flags:
If the --show-nevra option is not specified, the output for this command is presented in the Status, Catalog, Name, Version, and Arch columns. These provide the details of every package that is part of the given bundle. Catalog, Name, Version, and Arch represent the catalog name, package name, package version, and package architecture respectively.
The Status column is empty if the package is not installed. It displays “i” if the package is installed, “v” if a different version of the package is installed on the device, or “s” if the package in the bundle is of a lower version than that installed on the device.
The description of these columns is the same with other package commands.
If the --show-nevra option is specified, the output for this command is presented in the Status, Catalog, Name, Epoch, Version, Release, and Arch columns.
Adds a checkpoint. If the date is not specified, adds a check point with the current date.
Removes the specified checkpoints.
Gets a list of saved checkpoints.
Gets a dump of system information as a SQLite database.
Lists files within a package.
Searches package history for the search term you specify. By default, searches package names for the search term, displaying the package version history. Use the following option flags to perform a different search:
Displays complete information for the specified package. Accepts the following option flags:
Lists all conflicts for the specified package.
Lists all obsoletes for the specified package.
Lists the information provided by the specified package.
Lists package requirements. Accepts the following option flags:
Installs the specified resolvables. If a user requests a package with a version, zmd installs the exact version of the package. If the package version is not specified, zmd installs the best version of the package. On SLES 10 and SLED 10 platforms, the resolvableType can be a package, pattern, product, or patch; by default it is package. Accepts the following option flags:
Lists the available resolvable types.
Displays available updates in the specified catalogs. Adding catalogs as arguments limits the list to those catalogs you specify. If you are not subscribed to a catalog, no updates will be available, even if you name the catalog as an argument; you must subscribe to list updates.
If the output from this command does not match the pending updates listed on the server, it is because the pending updates list on the server shows updates for all available catalogs, not just catalogs to which the client is subscribed. For the lists to match, the client must be subscribed to all available catalogs.
Accept the following option flags:
-t, --type - Specify the type of updates.
Adds a package lock rule. This prevents changes to the installation state of the package that is specified in the lock. The package name can be specified individually, with wildcard patterns, or even with version number relations.
The package_name can include wildcard characters. The following table explains the valid relational operators that can be used with the package in the command:
If you want to install a specific version of the package, ZENworks first checks if the package version has been locked, then installs the package version only if it is not locked. For example, lets assume that all the later versions of the package, “X 1.7” have been locked by using the rug la X >1.7 command. If you try to install X 1.9 package by using the rug in X (1.9)command, the installation fails.
Deletes the package lock you specify by its number. You can find the number for each lock with the lock-list (ll) command.
Lists the package locks that have been put in place. Locks are sorted by ID number.
Gets the package which contains the specified file.
Displays the packages in a given catalog. If no catalog is specified, all packages in all catalogs are listed. Accepts the following option flags:
If the --show-nevra option is not specified, the output for this command is presented in the Status, Bundle, Name, Version, and Arch columns. These provide the details of every package that is part of the given bundle. Bundle, Name, Version, and Arch represent the bundle name, package name, package version, and package architecture respectively. The Status field is empty if the package is not installed, and displays “i” if the package is installed, or “v” if the package is installed but is of a different version compared to the one displayed in the list.
The description of these columns is the same with other package commands.
If the --show-nevra option is specified, the output for this command is presented in the Status, Bundle, Name, Epoch, Version, Release, and Arch columns.
Searches for patches matching a pattern. Accepts the following option flags:
Removes the specified packages. Accepts the following option flags:
Rolls back package transactions to the time and date you specify. Sets the rollback preference, which is disable by default. Accept the following option flags:
Searches for packages matching a pattern. Accepts the following option flags:
If the --show-nevra option is not specified, the output for this command is presented in Status, Catalog, Bundle, Name, Version, and Arch columns. These provide the details of every package that is part of the given bundle. Catalog, Bundle, Name, Version, and Arch represent the catalog name, bundle name, package name, package version, and package architecture respectively. The Status field is empty if the package is not installed, and displays “i” if the package is installed, or “v” if the package is installed but is of a different version compared to the one displayed in the list.
The description of these columns is the same with other package commands.
If the --show-nevra option is specified, the output for this command is presented in the Status, Catalog, Bundle, Name, Epoch, Version, Release, and Arch columns.
Shows a summary of available updates for each catalog.
Downloads and installs updates. With no arguments, this installs updates for all subscribed catalogs. Provide the catalog name to keep the updates specific to the mentioned catalogs. For single bundles or packages, use rug install. If you are not subscribed to a catalog, there are no updates available, even if you list the catalog as an argument; you must subscribe to install updates. Accepts the following option flags:
Verifies system dependencies. If system dependencies are not satisfied, rug suggests removal or installation of packages necessary to resolve conflicts. Accepts the following option flags:
Lists packages that conflict with the item you specify.
Displays packages that provide the library, program, or package that you specify as [querystring].
Lists packages that require the library, program, or package you specify as [querystring].
Shows the patches in a given catalog. Accepts the following option flags:
Shows detailed information for a patch.
Shows detailed information for a pattern.
Shows the patterns in a given catalog. Accepts the following option flags:
Lists the effective policies assigned to the devices along with their schedule details.
Displays the value of the specified preference token. If no token is provided, all preferences are displayed. Accepts the following option flag:
Sets a preference variable.
Use rug get to display the preferences and current values.
Shows detailed information for a product.
Shows the products in a given catalog. Accepts the following option flags:
Adds to the list of whitelisted keys for a service.
Removes from the list of whitelisted keys for a service.
Displays whitelisted keys for a service.
Mounts a directory as a catalog, adding all packages within the directory to the catalog. The platform for the catalog is assumed to be the same as the platform of the server. Accepts the following option flags:
Refreshes the specified services. If no service is specified, all services are refreshed. You must add a service using the rug service-add command before you can refresh. Use rug service-list to view the current list of services. The service argument can be the service number from the service-list output.
Registers the client against the specified server.
Adds the specified server as a service. In most cases, the URI is the URL of your ZENworks Linux Management server, for example https://zlmserver. Accepts the following option flags:
Deletes the specified services. Accepts the following option flag:
Lists the available services.
Lists the available service types.
Cleans the HTTP cache.
Loads ZENworks Management Daemon (zmd) modules.
Pings the ZMD deamon running on the client.
Restarts the ZLM daemon. Accepts the following option flags:
Shows scheduled items.
Halts the ZLM daemon. Accepts the following option flags:
Put the daemon to sleep. Accept the following option flags:
Cleans the YOU cache directory, /var/lib/YaST2/mnt on SLES 9, Novell Linux Desktop, and OES.
Adds a new user with the specified username and privileges. The following privileges can be granted: install, lock, remove, subscribe, trusted, upgrade, view, superuser. If you do not provide arguments, you are prompted for them. After the user is added, rug user-update is launched automatically. Use this tool to grant additional privileges. Accept the following option flags:
Deletes the specified users.
Edits an existing user. This command is interactive: it first lists privileges, then offers you a prompt. Enter the plus (+) or minus (-) symbol and then the name of the privilege, then press Enter. For example, to permit the user to install software, you would type +install. To save and quit, press Enter on a blank line. The following privileges can be granted or revoked: install, lock, remove, subscribe, trusted, upgrade, view, superuser.
Lists users. To view the list of users, you need to have either the readonly or the superuser privilege. The readonly privilege can be enabled by using either the user-add or user-edit command.
The following options can be applied to any rug transaction:
Normal output (the default mode). This is somewhere between debug output and terse output.
Terse output.
No abbreviation.
Quiet output; prints only error messages.
Debug output, prints full exception traces.
Prints the rug version and exits.
Copyright 2005-2009, Novell, Inc.. All rights reserved.
zlman (1), zmd (8), zrmservice (1), zlm-debug (1), zlmmirror (1)
To report problems with this software or its documentation, visit Novell Bugzilla.