NAME¶

SUSEConnect - SUSE Customer Center registration tool

SYNOPSIS¶

SUSEConnect [<optional>...] -p PRODUCT

DESCRIPTION¶

Register SUSE Linux Enterprise installations with the SUSE Customer Center. Registration allows access to software repositories (including updates) and allows online management of subscriptions and organizations.

By default, SUSEConnect registers the base SUSE Linux Enterprise product installed on a system. It can also be used to register extensions and modules.

To register an extension or a module, use the --product <PRODUCT-IDENTIFIER> option together with the product identifier of the extension or module. You can see a list of all available extensions and modules for your system by using the --list-extensions option.

Manage subscriptions at the SUSE Customer Center: https://scc.suse.com

OPTIONS¶

-p, --product <PRODUCT>

Specify a product for activation/deactivation. Only one product can be processed at a time. Defaults to the base SUSE Linux Enterprise product on this system. Product identifiers can be obtained with --list-extensions. Format: <name>/<version>/<architecture>

-r, --regcode <REGCODE>

Subscription registration code for the product to be registered. Relates that product to the specified subscription and enables software repositories for that product.

-d, --de-register

De-registers the system and base product, or in conjunction with --product, a single extension, and removes all its services installed by SUSEConnect. After de-registration, the system no longer consumes a subscription slot in SCC.

-l, --list-extensions

List all extensions and modules available for installation on this system.

--instance-data <path to file>

Path to the XML file holding the public key and instance data for cloud registration with SMT.

-e, --email <email>

Email address for product registration.

--url <URL>

URL of registration server (e.g. https://scc.suse.com).

--namespace <NAMESPACE>

Namespace option for use with SMT staging environments.

-s, --status

Get current system registration status in json format.

--status-text

Get current system registration status in text format.

--keepalive

Send a keepalive call to the registration server, so it can detect which systems are still running.

--write-config

Write options to config file at /etc/SUSEConnect.

--cleanup

Remove old system credentials and all zypper services installed by SUSEConnect.

--rollback

Revert the registration state in case of a failed migration.

--root <PATH>

Path to the root folder, uses the same parameter for zypper.

--gpg-auto-import-keys

Automatically trust and import new repository signing keys.

--version

Print program version.

--debug

Provide debug output.

-h, --help

Show help message.

EXIT CODES¶

SUSEConnect sets the following exit codes:

•

0: Registration successful

•

64: Connection refused

•

65: Access error, e.g. files not readable

•

66: Parser error: Server JSON response was not parseable

•

67: Server responded with error: see log output

COMPARED TO SUSE_REGISTER¶

USE WITH REGISTRATION PROXY¶

SUSEConnect can also be used to register systems with a local SUSE registration proxy (RMT/SMT) instead of the SUSE Customer Center. Use SUSEConnect --url <registration-proxy-server-url> to register systems with RMT/SMT.

IMPLEMENTATION¶

SUSEConnect is implemented in Golang. It communicates with the registration server using a RESTful JSON API over HTTP using TLS encryption.

ENVIRONMENT¶

SUSEConnect respects the HTTP_PROXY environment variable. See https://www.suse.com/support/kb/doc/?id=000017441 for more details on how to manually configure proxy usage.

FILES¶

/etc/SUSEConnect

Configuration file containing server URL, regcode and language for registration.

AUTHOR¶

SUSE LLC (<scc-feedback@suse.de>)

LINKS¶

SUSE Customer Center: https://scc.suse.com

SUSEConnect on GitHub: https://github.com/SUSE/connect-ng

SEE ALSO¶

SUSEConnect(5)