Steps to Creating a SUSE Manager Client
This document (7017577) is provided subject to the disclaimer at the end of this document.
Environment
Situation
Resolution
a. Enter the webUI tool for SUSE Manager.
b. Select the Systems tab at the top of the page.
c. Select the Activation Keys tab on the left-hand side of the page.
d. Click the Create Key link in the upper right-hand corner.
2. Select product(s) to make into channels.i. Description - Enter a description to identify the generated activation key.e. Click Create Activation Key to create the key.
ii. Key - Choose either automatic generation by leaving this field blank or enter the key name that is wanted for generation.
iii. Usage - Determine the maximum amount of systems that may be simultaneously registered to the SUSE Manager with this key, or leave blank for unlimited use.
iv. Base Channels - Specify the channels accessible to the client using this key. If a system using this key is not compatible with the selected channel, it will fall back to the default channel. The default channel will automatically assign channels to the client based on installed products.
v. Add-On Entitlements - Select any additional entitlements for the clients to receive with this key.
vi. Contact Method - Select how clients communicate with the SUSE Manager. Pull waits for the client to check in while push has the server contact the client and pushes updates and actions, etc.
vii. Universal Default - Select whether or not this key should be the primary activation key for this organization.
a. Select the Admin tab at the top of the page.3. Create bootstrap repository.
b. Select the SUSE Products sub-tab.
c. Check the boxes of the products you want to be mirrored by the SUSE Manager.
d. Click the Add Products button at the bottom of the page after selecting the desired products to mirror.
e. Wait for mirroring to complete.
a. Run the following command on the SUSE Manager:
4. Generate the bootstrap script.# mgr-create-bootstrap-repob. Enter the desired product label.
c. Repeat for all products you need your clients to use.
a. Run the following command on the SUSE Manager:
5. Refine the bootstrap script.# mgr-bootstrap
a. Rename the bootstrap script to identify its intended use case.
example: bootstrap-web-servers.shb. Adjust the variables in the script to accurately depict your setup.
6. Use the bootstrap script on the client to finish the connection of the client to the SUSE Manager.i. ACTIVATION_KEYS should list the key name you made earlier.
ii. ORG_GPG_KEY should be set to the name(s) of the corporate public GPG key filename(s) residing in /srv/www/htdocs/pub (comma delimited). This is also where you would include any GPG keys you've made for a custom repository.
iii. CLIENT_OVERRIDES should match the client-config-verrides.txt file. If the file has been customize it should also have a custom name and this should reflect the new name.
iv. HOSTNAME should already be set, however this is where you would verify it has the correct hostname for the SUSE Manager.
v. ORG_CA_CERT should match the name of the ssl cert rpm file in the /srv/www/htdocs/repo directory. This should match by default.
vi. Above are the most commonly used variables. Read documentation for more detail on any other variables if you aren't sure they are correct.vii. Enable the script by commenting out the instruction section at the top of the bootstrap script or at least comment out (with #'s) the exit command just below the instructions in the script. It will also say this within the instructions.
a. This can be done in more than one way: Concatenating the file through an ssh pipe to the client, wget, curl, etc. You can also scp the file to the client, change it's ownership so that it's executable, and then run the script on the client. The first given example would be run with the following command on the SUSE Manager:
# cat bootstrap-EDITED-NAME.sh | ssh root@CLIENT_MACHINE /bin/bash
Additional Information
https://www.suse.com/documentation/suse_manager/book_susemanager_user/data/s2-sm-systems-activation-keys.html
https://www.suse.com/documentation/suse_manager/singlehtml/book_susemanager_clientconf/book_susemanager_clientconf.html#s1-bootstrap-prep
Disclaimer
This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.
- Document ID:7017577
- Creation Date: 05-May-2016
- Modified Date:03-Mar-2020
-
- SUSE Manager
For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]suse.com