Skip to content

Latest commit

 

History

History
129 lines (92 loc) · 3.99 KB

SUSEConnect.8.ronn

File metadata and controls

129 lines (92 loc) · 3.99 KB
Raw

SUSEConnect(8) - 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 [SUSE Customer Center][scc]

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: //

  • -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 a system or a single product (if specified with -p) and removes all services installed by SUSEConnect. After de-registration, the system no longer consumes a subscription slot in SCC.

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

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

  • --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

BEFORE

suse_register -a email=<email> -a regcode-sles=<regcode> -L <logfile>

AFTER

SUSEConnect --url <registration-server-url> -r <regcode> >> <logfile>

USE WITH SMT

SUSEConnect can also be used to register systems with a local SUSE Subscription Management Tool instead of the SUSE Customer Center. Use SUSEConnect --url <smt-server-url> to register systems with SMT and set [proxies][ENVIRONMENT] as required.

IMPLEMENTATION

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

ENVIRONMENT

SUSEConnect respects the HTTP_PROXY and HTTPS_PROXY environment variables.

FILES

  • /etc/SUSEConnect: Configuration file containing server URL, regcode and language for registration.

AUTHOR

SUSE Linux Products GmbH scc-feedback@suse.de

LINKS

[SUSE Customer Center][scc]

[SUSEConnect on GitHub][scc-github]

SEE ALSO

SUSEConnect(5)