mgr-sync

8 Version 0.1

mgr-sync

Management utility for adding, syncing, and enabling SUSE Customer Center channels.

        mgr-sync global-option(s) <command> command-option(s) <arguments>

## Description

The mgr-sync command is a utility that allows you to work with SUSE Customer Center (SCC) for adding or syncing of products and channels. As well as enabling and refreshing SCC data.

## Global Options

`-h`, `--help`

- Display usage and exit.

`--version`

- Print the version.

`-v`, `--verbose`

- Enable verbose output.

`-s`, `--store-credentials`

- Store user's credentials to the local dot file (~/.mgr-sync).

  Note well: passwords are stored as plain text.

`-d DEBUG`, `--debug=DEBUG`

- Set the debug level (1-3, default: 1).

## Commands

mgr-sync provides a number of commands. Each command accepts the options listed in the Global Options section. These options must be specified before the command name. In addition, many commands have specific options, which are listed in this section. These command-specific options must be specified after the name of the command and before any of the command arguments.

### `list`

        list option(s) channel|channels

        list option(s) product|products

        list option(s) credentials

List channel(s), product(s), or credentials.

`-c`, `--compact`

- Compact output.

`-e`, `--expand`

- Expands all children if parent is not subscribed.

`-f `FILTER``, `--filter `FILTER``

- Filter the output by what contains the filter word.

`--from-mirror`

- URL of a local mirror like SMT. Only used for downloading RPMs.

`-h`, `--help`

- Show help menu for this command.

`--no-optional`

- Don't show optional channels.

### `add`

        add option(s) channel|channels CHANNEL

        add option(s) product|products

        add option(s) credentials

Add products, channels or credentials. Channels will automatically be synced. `product|products` will add mandatory channels for the given product interactively. Channels can have dependencies to other channels. Dependencies are automatically resolved and all required channels will be added when adding a product or channel.

Root products can recommend extensions. Recommended extensions are marked with "(R)" in the product listing. When adding a root product recommended extensions are automatically added as well. While using the option `--no-recommends` no recommended extension will be added.

`--from-mirror`

- URL of a local mirror like SMT. Only used for downloading RPMs.

`--no-optional`

- Don't show optional channels in interactive mode.

`--no-recommends`

- Do not enable recommended extension automatically.

`-h`, `--help`

- Show help menu for this command.

`--primary`

- Designate SCC organization credentials as primary.

### `refresh`

        refresh option(s)

Refresh installed channels.

`--refresh-channels`

- Schedule a refresh of all installed channels.

`--from-mirror`

- URL of a local mirror like SMT. Only used for downloading RPMs.

`--schedule`

- Schedule a refresh asynchronously (always enabled in case of ISS).

`-h`, `--help`

- Show help menu for this command.

### `delete`

        delete TARGET

SCC organization credentials to delete

`-h`, `--help`

- Show help menu for this command.

## Logging

By default mgr-sync writes basic debug information to `/var/log/rhn/mgr-sync.log`. Further debugging information can be obtained by either using the `--debug` option or adding mgrsync.debug = DEBUGLEVEL to `/etc/rhn/rhn.conf`.

## Examples

Get an expanded list of channels.

-     mgr-sync list -e channels

Add all mandatory channels for products interactively. In case a root product is selected which has recommended extensions, they will be added as well.

-     mgr-sync add product

Add all mandatory channels for products interactively. Recommended extensions will not be added automatically.

-     mgr-sync add product --no-recommends

Add the channel `My Channel` from SCC.

-     mgr-sync add channel "My Channel"

## Authors

- Flavio Castelli fcastelli@suse.com