File SUSEConnect.8 of Package SUSEConnect.26640

.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "SUSECONNECT" "8" "March 2022" "" "SUSEConnect"
.
.SH "NAME"
\fBSUSEConnect\fR \- SUSE Customer Center registration tool
.
.SH "SYNOPSIS"
\fBSUSEConnect [<optional>\.\.\.] \-p PRODUCT\fR
.
.SH "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\.
.
.P
By default, SUSEConnect registers the base SUSE Linux Enterprise product installed on a system\. It can also be used to register extensions and modules\.
.
.P
To register an extension or a module, use the \fB\-\-product <PRODUCT\-IDENTIFIER>\fR 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 \fB\-\-list\-extensions\fR option\.
.
.P
Manage subscriptions at the SUSE Customer Center: https://scc\.suse\.com
.
.SH "OPTIONS"
.
.TP
\fB\-p\fR, \fB\-\-product <PRODUCT>\fR
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 \fB\-\-list\-extensions\fR\. Format: \fIname\fR/\fIversion\fR/\fIarchitecture\fR
.
.TP
\fB\-r\fR, \fB\-\-regcode <REGCODE>\fR
Subscription registration code for the product to be registered\. Relates that product to the specified subscription and enables software repositories for that product\.
.
.TP
\fB\-d\fR, \fB\-\-de\-register\fR
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\.
.
.TP
\fB\-\-list\-extensions\fR
List all extensions and modules available for installation on this system\.
.
.TP
\fB\-\-instance\-data <path to file>\fR
Path to the XML file holding the public key and instance data for cloud registration with SMT\.
.
.TP
\fB\-e\fR, \fB\-\-email <email>\fR
Email address for product registration\.
.
.TP
\fB\-\-url <URL>\fR
URL of registration server (e\.g\. https://scc\.suse\.com)\.
.
.TP
\fB\-\-namespace <NAMESPACE>\fR
Namespace option for use with SMT staging environments\.
.
.TP
\fB\-s\fR, \fB\-\-status\fR
Get current system registration status in json format\.
.
.TP
\fB\-\-status\-text\fR
Get current system registration status in text format\.
.
.TP
\fB\-\-keepalive\fR
Send a keepalive call to the registration server, so it can detect which systems are still running\.
.
.TP
\fB\-\-write\-config\fR
Write options to config file at /etc/SUSEConnect\.
.
.TP
\fB\-\-cleanup\fR
Remove old system credentials and all zypper services installed by SUSEConnect\.
.
.TP
\fB\-\-rollback\fR
Revert the registration state in case of a failed migration\.
.
.TP
\fB\-\-root <PATH>\fR
Path to the root folder, uses the same parameter for zypper\.
.
.TP
\fB\-\-version\fR
Print program version\.
.
.TP
\fB\-\-debug\fR
Provide debug output\.
.
.TP
\fB\-h\fR, \fB\-\-help\fR
Show help message\.
.
.SH "EXIT CODES"
SUSEConnect sets the following exit codes:
.
.IP "\(bu" 4
0: Registration successful
.
.IP "\(bu" 4
64: Connection refused
.
.IP "\(bu" 4
65: Access error, e\.g\. files not readable
.
.IP "\(bu" 4
66: Parser error: Server JSON response was not parseable
.
.IP "\(bu" 4
67: Server responded with error: see log output
.
.IP "" 0
.
.SH "COMPARED TO SUSE_REGISTER"
.
.SS "BEFORE"
\fBsuse_register \-a email=<email> \-a regcode\-sles=<regcode> \-L <logfile>\fR
.
.SS "AFTER"
\fBSUSEConnect \-\-url <registration\-server\-url> \-r <regcode> >> <logfile>\fR
.
.SH "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 \fBSUSEConnect \-\-url <registration\-proxy\-server\-url>\fR to register systems with RMT/SMT\.
.
.SH "IMPLEMENTATION"
SUSEConnect is implemented in Ruby\. It communicates with the registration server using a RESTful JSON API over HTTP using TLS encryption\.
.
.SH "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\.
.
.SH "FILES"
.
.TP
\fB/etc/SUSEConnect\fR
Configuration file containing server URL, regcode and language for registration\.
.
.SH "AUTHOR"
SUSE Linux Products GmbH (\fIscc\-feedback@suse\.de\fR)
.
.SH "LINKS"
SUSE Customer Center: https://scc\.suse\.com
.
.P
SUSEConnect on GitHub: https://github\.com/SUSE/connect
.
.SH "SEE ALSO"
SUSEConnect(5)
openSUSE Build Service is sponsored by